datalink-client 1.0.0__tar.gz

datalink_client-1.0.0/.gitignore

@@ -0,0 +1,32 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+build/
+dist/
+*.egg-info/
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.nox/
+
+# Misc
+*.manifest
+.DS_Store

datalink_client-1.0.0/PKG-INFO

@@ -0,0 +1,58 @@
+Metadata-Version: 2.4
+Name: datalink-client
+Version: 1.0.0
+Summary: DataLink protocol 1.1 client for reading and writing data using the DataLink protocol (e.g. EarthScope ringserver).
+License: MIT
+Keywords: datalink,earthscope,ringserver,seismology
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# datalink-client
+
+DataLink protocol client for reading and writing data using the DataLink protocol. DataLink is a simple, packet-based streaming protocol used in seismological data systems, primarily with EarthScope's [ringserver](https://github.com/earthscope/ringserver) software.
+
+## Installation
+
+```bash
+pip install datalink-client
+```
+
+## Usage
+
+### Python API
+
+```python
+from datalink_client import DataLink
+
+with DataLink("localhost", 16000) as dl:
+    dl.match("FDSN:IU_COLA_.*")
+    dl.position_set("LATEST", 0)
+    dl.stream()
+    for packet in dl.collect():
+        print(packet.streamid, len(packet.data))
+```
+
+### Command-line client
+
+An interactive client is available after install:
+
+```bash
+datalink-client [host:port]
+```
+
+Default is `localhost:16000`. Use `datalink-client --help` for options (timeout, TLS, auth).
+
+## Async usage
+
+This package provides a synchronous client. For async/await support (e.g. with asyncio), use the [simpledali](https://github.com/crotwell/simpledali) package.

datalink_client-1.0.0/README.md

@@ -0,0 +1,38 @@
+# datalink-client
+
+DataLink protocol client for reading and writing data using the DataLink protocol. DataLink is a simple, packet-based streaming protocol used in seismological data systems, primarily with EarthScope's [ringserver](https://github.com/earthscope/ringserver) software.
+
+## Installation
+
+```bash
+pip install datalink-client
+```
+
+## Usage
+
+### Python API
+
+```python
+from datalink_client import DataLink
+
+with DataLink("localhost", 16000) as dl:
+    dl.match("FDSN:IU_COLA_.*")
+    dl.position_set("LATEST", 0)
+    dl.stream()
+    for packet in dl.collect():
+        print(packet.streamid, len(packet.data))
+```
+
+### Command-line client
+
+An interactive client is available after install:
+
+```bash
+datalink-client [host:port]
+```
+
+Default is `localhost:16000`. Use `datalink-client --help` for options (timeout, TLS, auth).
+
+## Async usage
+
+This package provides a synchronous client. For async/await support (e.g. with asyncio), use the [simpledali](https://github.com/crotwell/simpledali) package.

datalink_client-1.0.0/pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "datalink-client"
+dynamic = ["version"]
+description = "DataLink protocol 1.1 client for reading and writing data using the DataLink protocol (e.g. EarthScope ringserver)."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.9"
+authors = []
+keywords = ["datalink", "seismology", "ringserver", "earthscope"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Science/Research",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Scientific/Engineering",
+]
+
+[project.scripts]
+datalink-client = "datalink_client:main"
+
+[tool.hatch.version]
+path = "src/datalink_client/__init__.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/datalink_client"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/datalink_client"]

datalink_client-1.0.0/src/datalink_client/__init__.py

@@ -0,0 +1,37 @@
+"""
+DataLink protocol 1.1 client for reading and writing data using the DataLink protocol.
+
+DataLink is a simple, packet-based streaming protocol used in some seismological
+data systems, primarily with EarthScope's ringserver software.
+
+Quick start::
+
+    from datalink_client import DataLink
+
+    with DataLink("localhost", 16000) as dl:
+        dl.match("FDSN:IU_COLA_.*")
+        dl.position_set("LATEST", 0)
+        dl.stream()
+        for packet in dl.collect():
+            print(packet.streamid, len(packet.data))
+
+Interactive client::
+
+    datalink-client [host:port]
+"""
+
+from .client import DataLink
+from .cli import main
+from .protocol import DataLinkError, DataLinkPacket, DataLinkResponse
+from .time_utils import timestring_to_ustime, ustime_to_timestring
+
+__version__ = "1.0.0"
+__all__ = [
+    "DataLink",
+    "DataLinkError",
+    "DataLinkPacket",
+    "DataLinkResponse",
+    "main",
+    "timestring_to_ustime",
+    "ustime_to_timestring",
+]