signalk-cli 1.0.0__tar.gz

signalk_cli-1.0.0/PKG-INFO

@@ -0,0 +1,281 @@
+Metadata-Version: 2.4
+Name: signalk-cli
+Version: 1.0.0
+Summary: Query the SignalK v2 History API and export data as CSV or Apache Arrow Feather
+Keywords: signalk,sailing,marine,nmea,boating
+Author: jey burrows
+Author-email: jey burrows <jrb@rhizomatics.org.uk>
+License-Expression: Apache-2.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Natural Language :: English
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Scientific/Engineering
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: click>=8.3.3
+Requires-Dist: niquests>=2.28
+Requires-Dist: pyarrow>=17.0
+Requires-Dist: zeroconf>=0.149.16,<0.150.0
+Requires-Python: >=3.13
+Project-URL: Homepage, https://github.com/rhizomatics/signalk-cli
+Project-URL: Repository, https://github.com/rhizomatics/signalk-cli
+Description-Content-Type: text/markdown
+
+# SignalK CLI
+
+Query and explore SignalK APIs from the command line, and export data as CSV or Apache Arrow Feather. 
+
+Presently the [SignalK v2 History API](https://signalk.org/https://demo.signalk.org/documentation/Developing/REST_APIs/History_API.html) is supported.
+
+## Installation
+
+### PyPi
+
+```pip install signalk-cli``` or ```uv pip install signalk-cli```
+
+### Local Copy
+
+Requires Python 3.13+ and [uv](https://docs.astral.sh/uv/).
+
+```bash
+git clone https://github.com/rhizomatics/signalk-cli
+cd signalk-cli
+uv sync
+```
+
+## Running
+
+Run via `python -m signalk_cli.history <command>`. 
+
+## Determining SignalK host name
+
+If not host name set as an argument, the CLI will look for a `SIGNALK_HOST` environment variable, and failing that attempt to automatically discover
+the host using mDNS (aka Bonjour).
+
+```bash
+export SIGNALK_HOST=192.168.6.99   # http:// is added automatically if omitted
+```
+
+## Help
+
+Run with no arguments to list available commands:
+
+```
+$ python -m signalk_cli.history
+Usage: signak_cli.history [OPTIONS] COMMAND [ARGS]...
+
+  SignalK v2 history CLI.
+
+Commands:
+  list-contexts   List contexts that have historical data for the given time range.
+  list-paths      List paths that have data for the given time range.
+  list-providers  List registered history providers.
+  query           Query history and write results as CSV or Feather.
+```
+
+## Commands
+
+
+### `query`
+
+Fetch historical values for one or more paths and write to a file (default) or stdout. Aggregation can be controlled in the same way as the History API itself
+or a default form where `min_value`,`avg_value` and `max_value` are returned for every period.
+
+```
+python -m signalk_cli.history query [OPTIONS] PATH...
+```
+
+**PATH** arguments may be:
+- **Literal paths** — e.g. `navigation.speedOverGround`
+- **Regex / glob patterns** — any argument containing metacharacters (`*`, `.`, `[`, `(`, etc.) is matched against the server's `/paths` endpoint. Bare `*` is treated as a glob wildcard.
+- **Inline path specs** — `path:method` or `path:method:param`, e.g. `navigation.speedOverGround:sma:5`. These pass through to the server unchanged.
+
+#### Options
+
+| Option | Default | Description |
+|---|---|---|
+| `--host` | `$SIGNALK_HOST` | Server base URL. `http://` added if scheme omitted. |
+| `--from DATETIME` | — | Start of range (ISO 8601, e.g. `2026-05-26T00:00:00Z`) |
+| `--to DATETIME` | now | End of range (ISO 8601) |
+| `--duration DURATION` | — | Duration as seconds (`3600`) or ISO 8601 (`PT1H`, `PT15M`). Combined with `--from` or `--to`, or alone for a window ending now. |
+| `--resolution RESOLUTION` | server default | Sample window size: seconds or time expression (`1s`, `1m`, `1h`, `1d`). |
+| `-c, --context TEXT` | `vessels.self` | SignalK context |
+| `--provider TEXT` | fetched & cached | History provider plugin id |
+| `--no-cache` | — | Ignore the cached default provider |
+| `--aggregation / --agg` | — | Aggregation method: `average`, `min`, `max`, `first`, `last`, `mid`, `middle_index`, `sma`, `ema`. Omit for wide mode (see below). |
+| `--samples N` | server default | Sample count for `--agg sma` |
+| `--alpha FLOAT` | server default | Alpha (0–1) for `--agg ema` |
+| `--format [csv\|feather]` | from extension, else csv | Output format. Auto-detected from `.feather`, `.arrow`, `.fea` extensions. |
+| `--no-header` | — | Suppress the CSV header row |
+| `-o / --output FILE` | auto-named | Output file. Use `-` to write CSV to stdout. |
+| `--stdout` | — | Print CSV to stdout. If `--output` is also given, writes to both. Not supported with feather. |
+| `--bare` | — | Print CSV to stdout with **no informational messages** (server, provider, progress, row count). Ideal for piping to other tools. Implies `--stdout`. Not supported with feather. |
+
+Output files are auto-named `signalk-history-<server>-<timestamp>.<ext>` in the current directory.
+
+If no time range is given, the tool defaults to the hour ending now.
+
+#### Output columns
+
+**Wide mode** (default — no `--aggregation` and no inline specs): fetches `min`, `average`, and `max` for each path and writes them as separate columns:
+
+```
+timestamp, path, min_value, avg_value, max_value
+```
+
+**Narrow mode** (explicit `--aggregation` or inline path specs): single value column:
+
+```
+timestamp, path, value
+```
+
+Structured values (positions, arrays) are JSON-encoded in the value column.
+
+Feather output produces the same columns as Apache Arrow Feather, readable with pandas, Polars, R, pyarrow, etc.
+
+#### Examples
+
+```bash
+# Last hour of speed — wide mode (min/max/avg columns), auto-named CSV
+python -m signalk_cli.history query --host 10.36.10.21 --duration PT1H \
+    navigation.speedOverGround
+
+# Wide mode printed to stdout
+python -m signalk_cli.history query --host 10.36.10.21 --duration PT1H --stdout \
+    navigation.speedOverGround
+
+# Simple moving average (5 samples), narrowed to one value column
+python -m signalk_cli.history query --host 10.36.10.21 --duration PT1H \
+    --agg sma --samples 5 \
+    navigation.speedOverGround
+
+# EMA with alpha 0.2
+python -m signalk_cli.history query --host 10.36.10.21 --duration PT1H \
+    --agg ema --alpha 0.2 \
+    navigation.speedOverGround
+
+# Inline spec — path:method, multiple paths with different methods
+python -m signalk_cli.history query --host 10.36.10.21 --duration PT1H --stdout \
+    'navigation.speedOverGround:max' 'navigation.courseOverGroundTrue:average'
+
+# Multiple literal paths, 1-minute resolution
+python -m signalk_cli.history query --host 10.36.10.21 --duration PT1H --resolution 1m \
+    navigation.speedOverGround navigation.courseOverGroundTrue
+
+# All navigation paths, specific date range, write to named file
+python -m signalk_cli.history query --host 10.36.10.21 \
+    --from 2026-05-26T00:00:00Z --to 2026-05-27T00:00:00Z \
+    --output may26.csv \
+    'navigation\..*'
+
+# Glob wildcard — all paths for the last 30 minutes as Feather
+python -m signalk_cli.history query --host 10.36.10.21 --duration PT30M --format feather '*'
+
+# Extension auto-selects feather format
+python -m signalk_cli.history query --host 10.36.10.21 --duration PT1H \
+    -o out.feather navigation.speedOverGround
+
+# Write to both a file and stdout
+python -m signalk_cli.historyquery --host 10.36.10.21 --duration PT1H \
+    --output out.csv --stdout navigation.speedOverGround
+
+# Duration in seconds, suppress header, pipe to another tool
+python -m signalk_cli.history query --host 10.36.10.21 --duration 3600 --no-header --stdout \
+    navigation.speedOverGround | cut -d, -f1,3
+
+# --bare: pure CSV output, no informational noise — pipe-friendly
+python -m signalk_cli.history query --host 10.36.10.21 --duration PT1H --bare \
+    navigation.speedOverGround | awk -F, 'NR>1 {print $2, $3}'
+
+# Different context
+python -m signalk_cli.history query --host 10.36.10.21 --duration PT1H -c vessels.urn:mrn:imo:mmsi:123456789 \
+    navigation.speedOverGround
+```
+
+---
+
+### `list-paths`
+
+List all SignalK paths that have recorded data in a given time range.
+
+```
+python -m signalk_cli.history list-paths [OPTIONS]
+```
+
+Outputs one path per line to stdout. Defaults to the last hour if no time range is given. Accepts the same `--from`/`--to`/`--duration`, `--provider`/`--no-cache`, `-c/--context`, and `--bare` options as `query`.
+
+```bash
+# Paths recorded in the last hour
+python -m signalk_cli.history list-paths --host 10.36.10.21
+
+# Paths available on a specific day
+python -m signalk_cli.historylist-paths --host 10.36.10.21 \
+    --from 2026-05-26T00:00:00Z --to 2026-05-27T00:00:00Z
+
+# Pipe into grep
+python -m signalk_cli.history list-paths --host 10.36.10.21 --duration PT24H | grep navigation
+```
+
+---
+
+### `list-providers`
+
+List all registered history provider plugins and identify the default. Supports `--bare` to suppress the "Server:" and provider-count lines.
+
+```
+python -m signalk_cli.history list-providers --host 10.36.10.21
+```
+
+Example output:
+
+```
+kip (default)
+signalk-parquet
+2 provider(s)
+```
+
+The default provider is used automatically when `--provider` is not specified on other commands. It is fetched once and cached in `~/.cache/signalk-cli/`.
+
+---
+
+### `list-contexts`
+
+List SignalK contexts (vessels, aircraft, etc.) that have recorded data in a given time range.
+
+```bash
+python -m signalk_cli.history list-contexts [OPTIONS]
+```
+
+Defaults to the last hour if no time range is given.
+
+```bash
+python -m signalk_cli.history list-contexts --host 10.36.10.21
+
+python -m signalk_cli.history list-contexts --host 10.36.10.21 \
+    --from 2026-05-26T00:00:00Z --to 2026-05-27T00:00:00Z
+```
+
+---
+
+## Time range
+
+All commands that query data accept the same three time parameters. At least one of `--from` or `--duration` must be provided (or the tool supplies a one-hour default).
+
+| Parameter | Format | Examples |
+|---|---|---|
+| `--from` | ISO 8601 timestamp | `2026-05-26T00:00:00Z` |
+| `--to` | ISO 8601 timestamp | `2026-05-27T00:00:00Z` |
+| `--duration` | ISO 8601 duration or integer seconds | `PT1H`, `PT15M`, `3600` |
+
+Typical combinations:
+
+- `--duration PT1H` — last hour ending now
+- `--from T --duration PT1H` — hour starting at T
+- `--from T1 --to T2` — explicit range
+- `--duration PT1H --to T` — hour ending at T
+
+## Provider caching
+
+The default history provider is fetched from the server once and cached per host in `~/.cache/signalk-history-cli/`. Pass `--no-cache` to force a fresh lookup, or `--provider <id>` to target a specific provider explicitly.

signalk_cli-1.0.0/README.md

@@ -0,0 +1,256 @@
+# SignalK CLI
+
+Query and explore SignalK APIs from the command line, and export data as CSV or Apache Arrow Feather. 
+
+Presently the [SignalK v2 History API](https://signalk.org/https://demo.signalk.org/documentation/Developing/REST_APIs/History_API.html) is supported.
+
+## Installation
+
+### PyPi
+
+```pip install signalk-cli``` or ```uv pip install signalk-cli```
+
+### Local Copy
+
+Requires Python 3.13+ and [uv](https://docs.astral.sh/uv/).
+
+```bash
+git clone https://github.com/rhizomatics/signalk-cli
+cd signalk-cli
+uv sync
+```
+
+## Running
+
+Run via `python -m signalk_cli.history <command>`. 
+
+## Determining SignalK host name
+
+If not host name set as an argument, the CLI will look for a `SIGNALK_HOST` environment variable, and failing that attempt to automatically discover
+the host using mDNS (aka Bonjour).
+
+```bash
+export SIGNALK_HOST=192.168.6.99   # http:// is added automatically if omitted
+```
+
+## Help
+
+Run with no arguments to list available commands:
+
+```
+$ python -m signalk_cli.history
+Usage: signak_cli.history [OPTIONS] COMMAND [ARGS]...
+
+  SignalK v2 history CLI.
+
+Commands:
+  list-contexts   List contexts that have historical data for the given time range.
+  list-paths      List paths that have data for the given time range.
+  list-providers  List registered history providers.
+  query           Query history and write results as CSV or Feather.
+```
+
+## Commands
+
+
+### `query`
+
+Fetch historical values for one or more paths and write to a file (default) or stdout. Aggregation can be controlled in the same way as the History API itself
+or a default form where `min_value`,`avg_value` and `max_value` are returned for every period.
+
+```
+python -m signalk_cli.history query [OPTIONS] PATH...
+```
+
+**PATH** arguments may be:
+- **Literal paths** — e.g. `navigation.speedOverGround`
+- **Regex / glob patterns** — any argument containing metacharacters (`*`, `.`, `[`, `(`, etc.) is matched against the server's `/paths` endpoint. Bare `*` is treated as a glob wildcard.
+- **Inline path specs** — `path:method` or `path:method:param`, e.g. `navigation.speedOverGround:sma:5`. These pass through to the server unchanged.
+
+#### Options
+
+| Option | Default | Description |
+|---|---|---|
+| `--host` | `$SIGNALK_HOST` | Server base URL. `http://` added if scheme omitted. |
+| `--from DATETIME` | — | Start of range (ISO 8601, e.g. `2026-05-26T00:00:00Z`) |
+| `--to DATETIME` | now | End of range (ISO 8601) |
+| `--duration DURATION` | — | Duration as seconds (`3600`) or ISO 8601 (`PT1H`, `PT15M`). Combined with `--from` or `--to`, or alone for a window ending now. |
+| `--resolution RESOLUTION` | server default | Sample window size: seconds or time expression (`1s`, `1m`, `1h`, `1d`). |
+| `-c, --context TEXT` | `vessels.self` | SignalK context |
+| `--provider TEXT` | fetched & cached | History provider plugin id |
+| `--no-cache` | — | Ignore the cached default provider |
+| `--aggregation / --agg` | — | Aggregation method: `average`, `min`, `max`, `first`, `last`, `mid`, `middle_index`, `sma`, `ema`. Omit for wide mode (see below). |
+| `--samples N` | server default | Sample count for `--agg sma` |
+| `--alpha FLOAT` | server default | Alpha (0–1) for `--agg ema` |
+| `--format [csv\|feather]` | from extension, else csv | Output format. Auto-detected from `.feather`, `.arrow`, `.fea` extensions. |
+| `--no-header` | — | Suppress the CSV header row |
+| `-o / --output FILE` | auto-named | Output file. Use `-` to write CSV to stdout. |
+| `--stdout` | — | Print CSV to stdout. If `--output` is also given, writes to both. Not supported with feather. |
+| `--bare` | — | Print CSV to stdout with **no informational messages** (server, provider, progress, row count). Ideal for piping to other tools. Implies `--stdout`. Not supported with feather. |
+
+Output files are auto-named `signalk-history-<server>-<timestamp>.<ext>` in the current directory.
+
+If no time range is given, the tool defaults to the hour ending now.
+
+#### Output columns
+
+**Wide mode** (default — no `--aggregation` and no inline specs): fetches `min`, `average`, and `max` for each path and writes them as separate columns:
+
+```
+timestamp, path, min_value, avg_value, max_value
+```
+
+**Narrow mode** (explicit `--aggregation` or inline path specs): single value column:
+
+```
+timestamp, path, value
+```
+
+Structured values (positions, arrays) are JSON-encoded in the value column.
+
+Feather output produces the same columns as Apache Arrow Feather, readable with pandas, Polars, R, pyarrow, etc.
+
+#### Examples
+
+```bash
+# Last hour of speed — wide mode (min/max/avg columns), auto-named CSV
+python -m signalk_cli.history query --host 10.36.10.21 --duration PT1H \
+    navigation.speedOverGround
+
+# Wide mode printed to stdout
+python -m signalk_cli.history query --host 10.36.10.21 --duration PT1H --stdout \
+    navigation.speedOverGround
+
+# Simple moving average (5 samples), narrowed to one value column
+python -m signalk_cli.history query --host 10.36.10.21 --duration PT1H \
+    --agg sma --samples 5 \
+    navigation.speedOverGround
+
+# EMA with alpha 0.2
+python -m signalk_cli.history query --host 10.36.10.21 --duration PT1H \
+    --agg ema --alpha 0.2 \
+    navigation.speedOverGround
+
+# Inline spec — path:method, multiple paths with different methods
+python -m signalk_cli.history query --host 10.36.10.21 --duration PT1H --stdout \
+    'navigation.speedOverGround:max' 'navigation.courseOverGroundTrue:average'
+
+# Multiple literal paths, 1-minute resolution
+python -m signalk_cli.history query --host 10.36.10.21 --duration PT1H --resolution 1m \
+    navigation.speedOverGround navigation.courseOverGroundTrue
+
+# All navigation paths, specific date range, write to named file
+python -m signalk_cli.history query --host 10.36.10.21 \
+    --from 2026-05-26T00:00:00Z --to 2026-05-27T00:00:00Z \
+    --output may26.csv \
+    'navigation\..*'
+
+# Glob wildcard — all paths for the last 30 minutes as Feather
+python -m signalk_cli.history query --host 10.36.10.21 --duration PT30M --format feather '*'
+
+# Extension auto-selects feather format
+python -m signalk_cli.history query --host 10.36.10.21 --duration PT1H \
+    -o out.feather navigation.speedOverGround
+
+# Write to both a file and stdout
+python -m signalk_cli.historyquery --host 10.36.10.21 --duration PT1H \
+    --output out.csv --stdout navigation.speedOverGround
+
+# Duration in seconds, suppress header, pipe to another tool
+python -m signalk_cli.history query --host 10.36.10.21 --duration 3600 --no-header --stdout \
+    navigation.speedOverGround | cut -d, -f1,3
+
+# --bare: pure CSV output, no informational noise — pipe-friendly
+python -m signalk_cli.history query --host 10.36.10.21 --duration PT1H --bare \
+    navigation.speedOverGround | awk -F, 'NR>1 {print $2, $3}'
+
+# Different context
+python -m signalk_cli.history query --host 10.36.10.21 --duration PT1H -c vessels.urn:mrn:imo:mmsi:123456789 \
+    navigation.speedOverGround
+```
+
+---
+
+### `list-paths`
+
+List all SignalK paths that have recorded data in a given time range.
+
+```
+python -m signalk_cli.history list-paths [OPTIONS]
+```
+
+Outputs one path per line to stdout. Defaults to the last hour if no time range is given. Accepts the same `--from`/`--to`/`--duration`, `--provider`/`--no-cache`, `-c/--context`, and `--bare` options as `query`.
+
+```bash
+# Paths recorded in the last hour
+python -m signalk_cli.history list-paths --host 10.36.10.21
+
+# Paths available on a specific day
+python -m signalk_cli.historylist-paths --host 10.36.10.21 \
+    --from 2026-05-26T00:00:00Z --to 2026-05-27T00:00:00Z
+
+# Pipe into grep
+python -m signalk_cli.history list-paths --host 10.36.10.21 --duration PT24H | grep navigation
+```
+
+---
+
+### `list-providers`
+
+List all registered history provider plugins and identify the default. Supports `--bare` to suppress the "Server:" and provider-count lines.
+
+```
+python -m signalk_cli.history list-providers --host 10.36.10.21
+```
+
+Example output:
+
+```
+kip (default)
+signalk-parquet
+2 provider(s)
+```
+
+The default provider is used automatically when `--provider` is not specified on other commands. It is fetched once and cached in `~/.cache/signalk-cli/`.
+
+---
+
+### `list-contexts`
+
+List SignalK contexts (vessels, aircraft, etc.) that have recorded data in a given time range.
+
+```bash
+python -m signalk_cli.history list-contexts [OPTIONS]
+```
+
+Defaults to the last hour if no time range is given.
+
+```bash
+python -m signalk_cli.history list-contexts --host 10.36.10.21
+
+python -m signalk_cli.history list-contexts --host 10.36.10.21 \
+    --from 2026-05-26T00:00:00Z --to 2026-05-27T00:00:00Z
+```
+
+---
+
+## Time range
+
+All commands that query data accept the same three time parameters. At least one of `--from` or `--duration` must be provided (or the tool supplies a one-hour default).
+
+| Parameter | Format | Examples |
+|---|---|---|
+| `--from` | ISO 8601 timestamp | `2026-05-26T00:00:00Z` |
+| `--to` | ISO 8601 timestamp | `2026-05-27T00:00:00Z` |
+| `--duration` | ISO 8601 duration or integer seconds | `PT1H`, `PT15M`, `3600` |
+
+Typical combinations:
+
+- `--duration PT1H` — last hour ending now
+- `--from T --duration PT1H` — hour starting at T
+- `--from T1 --to T2` — explicit range
+- `--duration PT1H --to T` — hour ending at T
+
+## Provider caching
+
+The default history provider is fetched from the server once and cached per host in `~/.cache/signalk-history-cli/`. Pass `--no-cache` to force a fresh lookup, or `--provider <id>` to target a specific provider explicitly.

signalk_cli-1.0.0/pyproject.toml

@@ -0,0 +1,97 @@
+[project]
+name = "signalk-cli"
+version = "1.0.0"
+description = "Query the SignalK v2 History API and export data as CSV or Apache Arrow Feather"
+readme = "README.md"
+requires-python = ">=3.13"
+license="Apache-2.0"
+authors = [
+    { name = "jey burrows", email = "jrb@rhizomatics.org.uk" }
+]
+
+keywords = ["signalk", "sailing", "marine", "nmea","boating"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Natural Language :: English",
+    "Intended Audience :: Developers",
+    "Topic :: Scientific/Engineering",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14"
+]
+
+dependencies = [
+    "click>=8.3.3",
+    "niquests>=2.28",
+    "pyarrow>=17.0",
+    "zeroconf>=0.149.16,<0.150.0",
+]
+[dependency-groups]
+dev = [
+    "ruff>=0.15.0",
+    "pre-commit>=4.4.0",
+    "pytest>=9.0.0",
+    "pytest-mock>=3.15.0",
+    "pytest-cov>=7.0.0",
+    "pytest-xdist",
+    "coverage",
+    "icdiff",
+    "codespell"
+]
+
+[project.urls]
+Homepage = "https://github.com/rhizomatics/signalk-cli"
+Repository = "https://github.com/rhizomatics/signalk-cli"
+
+[tool.bandit]
+exclude_dirs = ["tests"]
+
+[tool.ruff.format]
+# Like Black, use double quotes for strings.
+quote-style = "double"
+
+# Like Black, indent with spaces, rather than tabs.
+indent-style = "space"
+
+# Like Black, respect magic trailing commas.
+skip-magic-trailing-comma = false
+
+# Like Black, automatically detect the appropriate line ending.
+line-ending = "auto"
+
+[tool.pytest.ini_options]
+pythonpath = ["src", "."]
+asyncio_mode = "auto"
+testpaths = [
+    "tests",
+]
+norecursedirs = [
+    ".git"
+]
+
+
+[tool.coverage.run]
+branch = true
+source = ["src"]
+
+[tool.mypy]
+mypy_path=["./src"]
+
+[tool.uv]
+compile-bytecode = true
+managed = true
+exclude-newer = "5 days"
+add-bounds = "major"
+
+[build-system]
+requires = ["uv_build>=0.11.13,<0.12.0"]
+build-backend = "uv_build"
+
+
+[tool.uv.build-backend]
+module-root = "src"
+module-name = "signalk_cli"
+
+[project.scripts]
+myproj = "signalk_cli.history:cli"

signalk_cli-1.0.0/src/signalk_cli/__init__.py

@@ -0,0 +1 @@
+"""signalk_cli — Python clients and CLI for SignalK APIs."""

signalk_cli-1.0.0/src/signalk_cli/__main__.py

@@ -0,0 +1,7 @@
+"""Entry point for `python -m signalk` — lists supported API modules."""
+
+print("Supported SignalK APIs:")
+print("  signalk_cli.history  — SignalK v2 History API")
+print()
+print("Usage: python -m signalk_cli.<api> [COMMAND] [OPTIONS]")
+print("       python -m signalk_cli.history --help")

signalk_cli-1.0.0/src/signalk_cli/history/__init__.py

@@ -0,0 +1,31 @@
+"""signalk_cli.history — Python client and CLI for the SignalK v2 History API."""
+
+from .history_api import (
+    HISTORY_BASE,
+    api_error,
+    apply_time_default,
+    expand_paths,
+    fetch_default_provider,
+    fetch_server_paths,
+    get_cached_provider,
+    normalise_host,
+    resolve_provider,
+    save_cached_provider,
+)
+from .output import extract_rows, write_csv, write_feather
+
+__all__ = [
+    "HISTORY_BASE",
+    "api_error",
+    "apply_time_default",
+    "expand_paths",
+    "extract_rows",
+    "fetch_default_provider",
+    "fetch_server_paths",
+    "get_cached_provider",
+    "normalise_host",
+    "resolve_provider",
+    "save_cached_provider",
+    "write_csv",
+    "write_feather",
+]

signalk_cli-1.0.0/src/signalk_cli/history/__main__.py

@@ -0,0 +1,3 @@
+from signalk_cli.history.cli import cli
+
+cli()