Metadata-Version: 2.4
Name: groundhog-sdk
Version: 0.1.0
Summary: Thin Python client for the Groundhog v1 Unix-socket API
Author: Ground Systems
License-Expression: Apache-2.0
Project-URL: Repository, https://github.com/GroundSystems/groundhog-sdk-python
Project-URL: Issues, https://github.com/GroundSystems/groundhog-sdk-python/issues
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# groundhog-sdk-python

Python client for the M1 Groundhog API. It connects to a running Groundhog
process over its Unix socket and exposes event construction, atomic JSON batch
ingest, replay, JSON query, and catalog operations.

```sh
python -m pip install groundhog-sdk
```

```python
from groundhog_sdk import Ground, upserted

ground = Ground("unix:data/ground.sock")
receipt = ground.send(
    "stripe",
    [upserted("customers", "cus_123", {"id": "cus_123"})],
    batch_id="stripe/customers/page-1",
)
```
