Show a data source's account and the sensors it wrote to

[BelhsanHmida]

Description

• Add a --show-sensors flag to flexmeasures show data-sources, listing the sensors which hold data recorded by a source, together with the asset each sensor belongs to.
• Require --id for that flag: DataSource.sensors scans the timed_belief table, so we do not want to run it once per source in a full listing. Without --id the command exits with a UsageError.
• Add an Account ID column to the table, bringing the CLI in line with what GET /api/v3_0/sources already returns for the same object.
• Added changelog item in documentation/changelog.rst (and in documentation/cli/change_log.rst)

Look & Feel

$ flexmeasures show data-sources --id 1312 --show-sensors
type: forecaster
==========
  ID  Name          Account ID    User ID    Model                 Version
----  ------------  ------------  ---------  --------------------  ---------
1312  FlexMeasures                           TrainPredictPipeline


Sensors with data from data source 1312:

  ID  Name    Unit    Asset
----  ------  ------  ----------------
 913  power   kW      Campus (ID: 242)

A source which recorded nothing says so, rather than printing an empty table:

$ flexmeasures show data-sources --id 42 --show-sensors
...
No sensors hold data recorded by data source 42.

And the flag is refused for a full listing:

$ flexmeasures show data-sources --show-sensors
Usage: flexmeasures show data-sources [OPTIONS]
Try 'flexmeasures show data-sources --help' for help.

Error: --show-sensors requires --id.

--show-sensors combines with --show-attributes.

Related Items

Closes #2400

[read-the-docs-community]

Documentation build overview

📚 flexmeasures | 🛠️ Build #33935082 | 📁 Comparing 559f6bc against latest (dc1fe3b)

  🔍 Preview build  

10 files changed · ± 10 modified

± Modified

• changelog.html
• api/v3_0.html
• cli/change_log.html
• dev/docker-compose.html
• tut/toy-example-expanded.html
• tut/toy-example-from-scratch.html
• tut/toy-example-multiasset-curtailment.html
• tut/toy-example-process.html
• tut/toy-example-reporter.html
• tut/toy-example-setup.html

[nhoening]

Thanks!