signalk-cli 2.2.1__tar.gz → 3.0.1__tar.gz

signalk_cli-2.2.1/README.md → signalk_cli-3.0.1/PKG-INFO

@@ -1,3 +1,40 @@
+Metadata-Version: 2.4
+Name: signalk-cli
+Version: 3.0.1
+Summary: Query SignalK v2 APIs and export data as CSV, JSON or Apache Arrow Feather from command line or as a Python API
+Keywords: signalk,sailing,marine,boating,nmea,dataframe,cli,pyarrow,nanoarrow
+Author: jey burrows
+Author-email: jey burrows <jrb@rhizomatics.org.uk>
+License-Expression: Apache-2.0
+Classifier: Development Status :: 5 - Production/Stable
+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: nanoarrow>=0.9.0,<1.0.0
+Requires-Dist: niquests[ws]>=2.28
+Requires-Dist: niquests[ws]>=3.21.0 ; sys_platform == 'emscripten'
+Requires-Dist: zeroconf>=0.149.16,<0.152.0 ; sys_platform != 'emscripten'
+Requires-Dist: pyarrow>=17.0 ; extra == 'arrow'
+Requires-Dist: pyarrow>=17.0 ; extra == 'feather'
+Requires-Python: >=3.13
+Project-URL: Homepage, https://signalk-cli.rhizomatics.org.uk
+Project-URL: Repository, https://github.com/rhizomatics/signalk-cli
+Project-URL: Issues, https://github.com/rhizomatics/signalk-cli/issues
+Project-URL: Changelog, https://github.com/rhizomatics/signalk-cli/blob/main/CHANGELOG.md
+Provides-Extra: arrow
+Provides-Extra: feather
+Description-Content-Type: text/markdown
+
+---
+title: SignalK CLI
+description: Command line access to SignalK APIs and streaming data, for piping within console, or export to CSV, JSON or Apache Arrow Feather for dataframe analysis.
+---
+
 # SignalK CLI
 
 [![Rhizomatics Open Source](https://img.shields.io/badge/rhizomatics%20open%20source-lightseagreen)](https://github.com/rhizomatics)
@@ -13,9 +50,33 @@
 [![Dependabot Updates](https://github.com/rhizomatics/signalk-cli/actions/workflows/dependabot/dependabot-updates/badge.svg)](https://github.com/rhizomatics/signalk-cli/actions/workflows/dependabot/dependabot-updates)
 [![boat tech directory](https://boat-tech-directory.rhizomatics.org.uk/images/badge.svg)](https://boat-tech-directory.rhizomatics.org.uk)
 
-Query and explore NMEA and other boat data from SignalK APIs using the command line, and export data as CSV, Apache Arrow Feather, or JSON.
+Query and explore NMEA and other boat data from SignalK APIs using the command line or the Python API.  Export data as CSV, Apache Arrow Feather, or JSON or use as dataframes in scripts or data notebooks.
 
-APIs supported:
+`signalk_cli` goes beyond raw API data extraction to automatically handle metrics and 'wide' tables that bring together aggregates like 'max' or 'avg' into separate columns for simpler queries. It also has an analysis tools to summarize data variability.
+
+<!-- termynal -->
+```
+$ uv run --with signalk-cli signalk_cli.history list-providers
+provider,isDefault
+kip,False
+signalk-parquet,True
+
+uv run --with signalk-cli signalk_cli.history query 'environment.outside.wind.gust:max' 'environment.wind.speedApparent:avg' --duration P7D --resolution 1m
+timestamp,path,value
+2026-10-03T09:11:00Z,environment.wind.speedApparent,5.8
+2026-10-03T09:12:00Z,environment.outside.wind.gust,45.36699999999996
+2026-10-03T09:12:00Z,environment.wind.speedApparent,5.8
+2026-10-03T09:13:00Z,environment.outside.wind.gust,15.317000000000009
+
+uv run --with signalk-cli signalk_cli.stream deltas 'environment.outside.wind.*' --follow
+timestamp,context,source,path,value
+2026-10-03T09:08:21.042Z,vessels.urn:mrn:signalk:uuid:64f1567b-2fc2-474f-8b23-4e9c43b61ffb,simulator.0,environment.outside.wind.gust,44.29449999999997
+2026-10-03T09:08:23.042Z,vessels.urn:mrn:signalk:uuid:64f1567b-2fc2-474f-8b23-4e9c43b61ffb,simulator.0,environment.outside.wind.gust,45.29449999999997
+...
+
+```
+
+## APIs supported:
 
 ### [SignalK v2 History API](https://demo.signalk.org/documentation/Developing/REST_APIs/History_API.html). 
 
@@ -43,17 +104,18 @@ Python is required to run this, version 3.13 or above. [uv](https://docs.astral.
 
 For Apache Arrow Feather export, use the optional dependency: ```pip install 'signalk-cli[feather]'```
 
-### Pyodide / slim install
+### Pyodide / WebAssembly
 
-`zeroconf` (used only for mDNS host discovery) can't run in Pyodide, and is optional at runtime. Install without dependencies and add the rest explicitly:
+The same wheel installs in Pyodide (e.g. marimo in the browser). Platform markers skip `zeroconf`, which can't run there, and require `niquests>=3.21.0`:
 
 ```python
 import micropip
-await micropip.install(["click", "niquests[ws]>=3.21.0"])
-await micropip.install("signalk-cli", deps=False)
+await micropip.install("signalk-cli")
 ```
 
-Without `zeroconf`, the host must be given with `--host` or `SIGNALK_HOST` (or come from the cache).
+Without `zeroconf` there's no mDNS discovery, so the host must be given with `--host` or `SIGNALK_HOST` (or come from the cache).
+
+See [signalk-datalab-plugin](https://github.com/rhizomatics/signalk-datalab-plugin) for a working example of this.
 
 ### Local Copy
 
@@ -65,7 +127,7 @@ cd signalk-cli
 uv sync
 ```
 
-## Temporary Installation
+## Use without Installing
 
 Use `uv` to run without installing the module permanently, for example:
 
@@ -77,6 +139,26 @@ uv run --with signalk-cli signalk_cli.history list-providers
 uv run --with signalk-cli signalk_cli.stream deltas navigation.position --follow
 ```
 
+Wildcards to follow multiple paths need to be quoted
+
+```bash
+uv run --with signalk-cli signalk_cli.stream deltas 'environment.outside.wind.*' --follow
+```
+
+## Python library
+
+Everything the CLI does is also available from Python, returning tables that load straight into polars, pandas, pyarrow or DuckDB:
+
+```python
+from signalk_cli import HistoryClient, TimeRange
+import polars as pl
+
+with HistoryClient("http://boat.local:3000") as client:
+    df = pl.DataFrame(client.query(["navigation.*"], TimeRange(duration="P1D")))
+```
+
+See the [Python library guide](https://signalk-cli.rhizomatics.org.uk/library/) and API reference.
+
 ## Running
 
 Run via `python -m signalk_cli.history <command>` or `python -m signalk_cli.stream <command>` or without installing the module with `uv run --with signalk-cli signalk_cli.history <command>`.
@@ -107,6 +189,7 @@ Commands:
   query           Query history and write results as CSV, Feather, or JSON.
 ```
 
+
 ## Commands
 
 
@@ -122,7 +205,7 @@ 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.
+- **Regex / glob patterns** — any argument containing a pattern character (`*`, `?`, `+`, `[`, `(`, `{`, `|`, `^`, `$` or `\`) is matched against the server's `/paths` endpoint. A `.` on its own doesn't count, so a plain dotted path is always literal. 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
@@ -426,11 +509,9 @@ python -m signalk_cli.stream deltas [OPTIONS] [PATH...]
 ```
 
 By default, prints the next delta message and exits — useful for a quick check.
-Use `--follow` to keep tailing until interrupted with Ctrl-C, optionally capped
-with `--count`.
+Use `--follow` to keep tailing until interrupted with Ctrl-C, optionally capped with `--count`.
 
-**PATH** arguments are sent verbatim to the server as an explicit subscription,
-one per path. They may be literal SignalK paths (e.g. `navigation.speedOverGround`)
+**PATH** arguments are sent verbatim to the server as an explicit subscription, one per path. They may be literal SignalK paths (e.g. `navigation.speedOverGround`)
 or use the SignalK subscription wildcard `*`, matched server-side per the
 [Subscription Protocol](https://signalk.org/specification/1.8.2/doc/subscription_protocol.html)
 — unlike `history`'s PATH patterns, which the client resolves by matching
@@ -574,3 +655,7 @@ Typical combinations:
 ## Default 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.
+
+## Too Much Streaming Data
+
+If the data is too noisy, like GPS positions with dubious centimeter differences, then [signalk-delta-squelch-plugin](https://github.com/rhizomatics/signalk-delta-squelch-plugin) can cut this down hugely, and also filter out GPS glitches that suggest your boat moves at warp speed.

signalk_cli-2.2.1/PKG-INFO → signalk_cli-3.0.1/README.md

@@ -1,30 +1,7 @@
-Metadata-Version: 2.4
-Name: signalk-cli
-Version: 2.2.1
-Summary: Query SignalK v2 APIs and export data as CSV, JSON 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 :: 5 - Production/Stable
-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[ws]>=2.28
-Requires-Dist: zeroconf>=0.149.16,<0.152.0
-Requires-Dist: pyarrow>=17.0 ; extra == 'feather'
-Requires-Python: >=3.13
-Project-URL: Homepage, https://signalk-cli.rhizomatics.org.uk
-Project-URL: Repository, https://github.com/rhizomatics/signalk-cli
-Project-URL: Issues, https://github.com/rhizomatics/signalk-cli/issues
-Project-URL: Changelog, https://github.com/rhizomatics/signalk-cli/blob/main/CHANGELOG.md
-Provides-Extra: feather
-Description-Content-Type: text/markdown
+---
+title: SignalK CLI
+description: Command line access to SignalK APIs and streaming data, for piping within console, or export to CSV, JSON or Apache Arrow Feather for dataframe analysis.
+---
 
 # SignalK CLI
 
@@ -41,9 +18,33 @@ Description-Content-Type: text/markdown
 [![Dependabot Updates](https://github.com/rhizomatics/signalk-cli/actions/workflows/dependabot/dependabot-updates/badge.svg)](https://github.com/rhizomatics/signalk-cli/actions/workflows/dependabot/dependabot-updates)
 [![boat tech directory](https://boat-tech-directory.rhizomatics.org.uk/images/badge.svg)](https://boat-tech-directory.rhizomatics.org.uk)
 
-Query and explore NMEA and other boat data from SignalK APIs using the command line, and export data as CSV, Apache Arrow Feather, or JSON.
+Query and explore NMEA and other boat data from SignalK APIs using the command line or the Python API.  Export data as CSV, Apache Arrow Feather, or JSON or use as dataframes in scripts or data notebooks.
+
+`signalk_cli` goes beyond raw API data extraction to automatically handle metrics and 'wide' tables that bring together aggregates like 'max' or 'avg' into separate columns for simpler queries. It also has an analysis tools to summarize data variability.
+
+<!-- termynal -->
+```
+$ uv run --with signalk-cli signalk_cli.history list-providers
+provider,isDefault
+kip,False
+signalk-parquet,True
+
+uv run --with signalk-cli signalk_cli.history query 'environment.outside.wind.gust:max' 'environment.wind.speedApparent:avg' --duration P7D --resolution 1m
+timestamp,path,value
+2026-10-03T09:11:00Z,environment.wind.speedApparent,5.8
+2026-10-03T09:12:00Z,environment.outside.wind.gust,45.36699999999996
+2026-10-03T09:12:00Z,environment.wind.speedApparent,5.8
+2026-10-03T09:13:00Z,environment.outside.wind.gust,15.317000000000009
 
-APIs supported:
+uv run --with signalk-cli signalk_cli.stream deltas 'environment.outside.wind.*' --follow
+timestamp,context,source,path,value
+2026-10-03T09:08:21.042Z,vessels.urn:mrn:signalk:uuid:64f1567b-2fc2-474f-8b23-4e9c43b61ffb,simulator.0,environment.outside.wind.gust,44.29449999999997
+2026-10-03T09:08:23.042Z,vessels.urn:mrn:signalk:uuid:64f1567b-2fc2-474f-8b23-4e9c43b61ffb,simulator.0,environment.outside.wind.gust,45.29449999999997
+...
+
+```
+
+## APIs supported:
 
 ### [SignalK v2 History API](https://demo.signalk.org/documentation/Developing/REST_APIs/History_API.html). 
 
@@ -71,17 +72,18 @@ Python is required to run this, version 3.13 or above. [uv](https://docs.astral.
 
 For Apache Arrow Feather export, use the optional dependency: ```pip install 'signalk-cli[feather]'```
 
-### Pyodide / slim install
+### Pyodide / WebAssembly
 
-`zeroconf` (used only for mDNS host discovery) can't run in Pyodide, and is optional at runtime. Install without dependencies and add the rest explicitly:
+The same wheel installs in Pyodide (e.g. marimo in the browser). Platform markers skip `zeroconf`, which can't run there, and require `niquests>=3.21.0`:
 
 ```python
 import micropip
-await micropip.install(["click", "niquests[ws]>=3.21.0"])
-await micropip.install("signalk-cli", deps=False)
+await micropip.install("signalk-cli")
 ```
 
-Without `zeroconf`, the host must be given with `--host` or `SIGNALK_HOST` (or come from the cache).
+Without `zeroconf` there's no mDNS discovery, so the host must be given with `--host` or `SIGNALK_HOST` (or come from the cache).
+
+See [signalk-datalab-plugin](https://github.com/rhizomatics/signalk-datalab-plugin) for a working example of this.
 
 ### Local Copy
 
@@ -93,7 +95,7 @@ cd signalk-cli
 uv sync
 ```
 
-## Temporary Installation
+## Use without Installing
 
 Use `uv` to run without installing the module permanently, for example:
 
@@ -105,6 +107,26 @@ uv run --with signalk-cli signalk_cli.history list-providers
 uv run --with signalk-cli signalk_cli.stream deltas navigation.position --follow
 ```
 
+Wildcards to follow multiple paths need to be quoted
+
+```bash
+uv run --with signalk-cli signalk_cli.stream deltas 'environment.outside.wind.*' --follow
+```
+
+## Python library
+
+Everything the CLI does is also available from Python, returning tables that load straight into polars, pandas, pyarrow or DuckDB:
+
+```python
+from signalk_cli import HistoryClient, TimeRange
+import polars as pl
+
+with HistoryClient("http://boat.local:3000") as client:
+    df = pl.DataFrame(client.query(["navigation.*"], TimeRange(duration="P1D")))
+```
+
+See the [Python library guide](https://signalk-cli.rhizomatics.org.uk/library/) and API reference.
+
 ## Running
 
 Run via `python -m signalk_cli.history <command>` or `python -m signalk_cli.stream <command>` or without installing the module with `uv run --with signalk-cli signalk_cli.history <command>`.
@@ -135,6 +157,7 @@ Commands:
   query           Query history and write results as CSV, Feather, or JSON.
 ```
 
+
 ## Commands
 
 
@@ -150,7 +173,7 @@ 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.
+- **Regex / glob patterns** — any argument containing a pattern character (`*`, `?`, `+`, `[`, `(`, `{`, `|`, `^`, `$` or `\`) is matched against the server's `/paths` endpoint. A `.` on its own doesn't count, so a plain dotted path is always literal. 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
@@ -454,11 +477,9 @@ python -m signalk_cli.stream deltas [OPTIONS] [PATH...]
 ```
 
 By default, prints the next delta message and exits — useful for a quick check.
-Use `--follow` to keep tailing until interrupted with Ctrl-C, optionally capped
-with `--count`.
+Use `--follow` to keep tailing until interrupted with Ctrl-C, optionally capped with `--count`.
 
-**PATH** arguments are sent verbatim to the server as an explicit subscription,
-one per path. They may be literal SignalK paths (e.g. `navigation.speedOverGround`)
+**PATH** arguments are sent verbatim to the server as an explicit subscription, one per path. They may be literal SignalK paths (e.g. `navigation.speedOverGround`)
 or use the SignalK subscription wildcard `*`, matched server-side per the
 [Subscription Protocol](https://signalk.org/specification/1.8.2/doc/subscription_protocol.html)
 — unlike `history`'s PATH patterns, which the client resolves by matching
@@ -602,3 +623,7 @@ Typical combinations:
 ## Default 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.
+
+## Too Much Streaming Data
+
+If the data is too noisy, like GPS positions with dubious centimeter differences, then [signalk-delta-squelch-plugin](https://github.com/rhizomatics/signalk-delta-squelch-plugin) can cut this down hugely, and also filter out GPS glitches that suggest your boat moves at warp speed.

{signalk_cli-2.2.1 → signalk_cli-3.0.1}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "signalk-cli"
-version = "2.2.1"
-description = "Query SignalK v2 APIs and export data as CSV, JSON or Apache Arrow Feather"
+version = "3.0.1"
+description = "Query SignalK v2 APIs and export data as CSV, JSON or Apache Arrow Feather from command line or as a Python API"
 readme = "README.md"
 requires-python = ">=3.13"
 license = "Apache-2.0"
@@ -9,8 +9,12 @@ keywords = [
     "signalk",
     "sailing",
     "marine",
-    "nmea",
     "boating",
+    "nmea",
+    "dataframe",
+    "cli",
+    "pyarrow",
+    "nanoarrow",
 ]
 classifiers = [
     "Development Status :: 5 - Production/Stable",
@@ -24,8 +28,10 @@ classifiers = [
 ]
 dependencies = [
     "click>=8.3.3",
+    "nanoarrow>=0.9.0,<1.0.0",
     "niquests[ws]>=2.28",
-    "zeroconf>=0.149.16,<0.152.0",
+    "niquests[ws]>=3.21.0; sys_platform == 'emscripten'",
+    "zeroconf>=0.149.16,<0.152.0; sys_platform != 'emscripten'",
 ]
 
 [[project.authors]]
@@ -34,6 +40,7 @@ email = "jrb@rhizomatics.org.uk"
 
 [project.optional-dependencies]
 feather = ["pyarrow>=17.0"]
+arrow = ["pyarrow>=17.0"]
 
 [project.urls]
 Homepage = "https://signalk-cli.rhizomatics.org.uk"
@@ -55,9 +62,13 @@ dev = [
     "pytest-xdist",
     "mypy",
     "coverage",
+    "bandit",
     "genbadge[all]",
     "icdiff",
     "codespell",
+    "polars>=1.44.2,<3.0.0",
+    "duckdb>=1.5.5,<3.0.0",
+    "pandas>=3.0.6,<4.0.0",
 ]
 docs = [
     "properdocs",
@@ -67,10 +78,14 @@ docs = [
     "mkdocs-pagetree-plugin",
     "mkdocs-coverage",
     "pymdown-extensions",
+    "mkdocs-homepage-copier",
     "mkdocs-meta-descriptions-plugin",
     "pngquant",
+    "termynal",
+    "pillow>=13.0.0",
     "mkdocs-htmlproofer-plugin",
     "mkdocs-llmstxt>=0.5.0,<0.6.0",
+    "mkdocstrings[python]>=1.0.6,<2.0.0",
 ]
 
 [tool.bandit]
@@ -95,7 +110,7 @@ branch = true
 source = ["src"]
 
 [tool.coverage.report]
-fail_under = 0
+fail_under = 90
 
 [tool.coverage.xml]
 output = "cov.xml"
@@ -113,7 +128,10 @@ ignore-words-list = "hass,referer,uint"
 mypy_path = ["./src"]
 
 [[tool.mypy.overrides]]
-module = "pyarrow.*"
+module = [
+    "pyarrow.*",
+    "nanoarrow.*",
+]
 ignore_missing_imports = true
 
 [tool.ty.analysis]
@@ -129,6 +147,8 @@ exclude-newer = "7 days"
 add-bounds = "major"
 
 [tool.uv.exclude-newer-package]
+certifi = false
+pillow = false
 uv_build = "2 days"
 
 [tool.uv.build-backend]
@@ -136,5 +156,5 @@ module-root = "src"
 module-name = "signalk_cli"
 
 [build-system]
-requires = ["uv_build>=0.12.0,<0.13.0"]
+requires = ["uv_build>=0.12.0"]
 build-backend = "uv_build"

{signalk_cli-2.2.1 → signalk_cli-3.0.1}/pyproject.toml.orig

@@ -1,7 +1,7 @@
 [project]
 name = "signalk-cli"
-version = "2.2.1"
-description = "Query SignalK v2 APIs and export data as CSV, JSON or Apache Arrow Feather"
+version = "3.0.1"
+description = "Query SignalK v2 APIs and export data as CSV, JSON or Apache Arrow Feather from command line or as a Python API"
 readme = "README.md"
 requires-python = ">=3.13"
 license="Apache-2.0"
@@ -9,7 +9,9 @@ authors = [
     { name = "jey burrows", email = "jrb@rhizomatics.org.uk" }
 ]
 
-keywords = ["signalk", "sailing", "marine", "nmea","boating"]
+keywords = ["signalk", "sailing", "marine", "boating",
+            "nmea",
+            "dataframe","cli","pyarrow","nanoarrow"]
 classifiers = [
     "Development Status :: 5 - Production/Stable",
     "Environment :: Console",
@@ -23,12 +25,18 @@ classifiers = [
 
 dependencies = [
     "click>=8.3.3",
+    "nanoarrow>=0.9.0,<1.0.0",
     "niquests[ws]>=2.28",
-    "zeroconf>=0.149.16,<0.152.0",
+    # Pyodide/WASM: niquests needs >=3.21 there, and zeroconf can't run (no raw sockets)
+    "niquests[ws]>=3.21.0; sys_platform == 'emscripten'",
+    "zeroconf>=0.149.16,<0.152.0; sys_platform != 'emscripten'",
 ]
 
 [project.optional-dependencies]
+# pyarrow, only needed to write Feather files from the CLI
 feather = ["pyarrow>=17.0"]
+# alias of feather
+arrow = ["pyarrow>=17.0"]
 [dependency-groups]
 dev = [
     "ruff>=0.16.0",
@@ -39,9 +47,13 @@ dev = [
     "pytest-xdist",
     "mypy",
     "coverage",
+    "bandit",
     "genbadge[all]",
     "icdiff",
-    "codespell"
+    "codespell",
+    "polars>=1.44.2,<3.0.0",
+    "duckdb>=1.5.5,<3.0.0",
+    "pandas>=3.0.6,<4.0.0",
 ]
 
 docs=[
@@ -52,10 +64,14 @@ docs=[
     "mkdocs-pagetree-plugin",
     "mkdocs-coverage",
     "pymdown-extensions",
+    "mkdocs-homepage-copier",
     "mkdocs-meta-descriptions-plugin",
     "pngquant",
+    "termynal",
+    "pillow>=13.0.0",
     "mkdocs-htmlproofer-plugin",
     "mkdocs-llmstxt>=0.5.0,<0.6.0",
+    "mkdocstrings[python]>=1.0.6,<2.0.0",
 ]
 
 [project.urls]
@@ -95,7 +111,7 @@ branch = true
 source = ["src"]
 
 [tool.coverage.report]
-fail_under=0
+fail_under=90
 
 [tool.coverage.xml]
 output="cov.xml"
@@ -113,7 +129,7 @@ ignore-words-list="hass,referer,uint"
 mypy_path=["./src"]
 
 [[tool.mypy.overrides]]
-module = "pyarrow.*"
+module = ["pyarrow.*", "nanoarrow.*"]
 ignore_missing_imports = true
 
 [tool.ty.analysis]
@@ -124,11 +140,11 @@ allowed-unresolved-imports = ["pyarrow", "pyarrow.**"]
 compile-bytecode = true
 managed = true
 exclude-newer = "7 days"
-exclude-newer-package = {"uv_build"="2 days"}
+exclude-newer-package = {certifi=false, pillow=false,"uv_build"="2 days"}
 add-bounds = "major"
 
 [build-system]
-requires = ["uv_build>=0.12.0,<0.13.0"]
+requires = ["uv_build>=0.12.0"]
 build-backend = "uv_build"
 
 

signalk_cli-3.0.1/src/signalk_cli/__init__.py

@@ -0,0 +1,33 @@
+"""signalk_cli — Python clients and CLI for SignalK APIs.
+
+The clients are importable from here or from their packages:
+
+```python
+from signalk_cli import HistoryClient, StreamClient, TimeRange
+```
+"""
+
+import logging
+
+from ._arrow import ArrowTable
+from .errors import SignalKError
+from .history import HistoryClient, HistoryResult, TimeRange
+from .net import discover_host
+from .stream import DeltaMessage, DeltaRow, DeltaStream, StreamClient
+
+# Library convention: stay silent unless the application configures logging.
+# The CLI attaches its own stderr handler per command.
+logging.getLogger("signalk_cli").addHandler(logging.NullHandler())
+
+__all__ = [
+    "ArrowTable",
+    "DeltaMessage",
+    "DeltaRow",
+    "DeltaStream",
+    "HistoryClient",
+    "HistoryResult",
+    "SignalKError",
+    "StreamClient",
+    "TimeRange",
+    "discover_host",
+]