Metadata-Version: 2.4
Name: hecdss-rs
Version: 0.1.0
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Rust
Classifier: Programming Language :: Python :: Implementation :: CPython
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: Topic :: Scientific/Engineering :: Hydrology
Requires-Dist: numpy
Summary: Pure Rust HEC-DSS version 7 file reader/writer with Python bindings
Keywords: hec-dss,hydrology,dss,usace,water-resources,hec-ras,hec-hms
Author: Tyler Hatch
License: MIT
Requires-Python: >=3.9
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Documentation, https://hatch-tyler.github.io/hec-dss-rs/
Project-URL: Homepage, https://github.com/hatch-tyler/hec-dss-rs
Project-URL: Repository, https://github.com/hatch-tyler/hec-dss-rs

# dss-python

PyO3 native Python module for HEC-DSS version 7 files. Zero C library dependency.

## Installation

```bash
cd crates/dss-python
pip install maturin
maturin build --release
pip install ../../target/wheels/dss_python-*.whl
```

## Quick Start

```python
import hecdss_rs
import numpy as np

with hecdss_rs.DssFile.create("example.dss") as dss:
    # Time series
    dss.write_ts("/A/B/FLOW/01JAN2020/1HOUR/SIM/",
                 np.array([100.0, 200.0, 300.0]), "CFS", "INST-VAL")
    values = dss.read_ts("/A/B/FLOW/01JAN2020/1HOUR/SIM/")  # numpy array

    # Catalog with wildcards
    entries = dss.catalog(filter="/*/*/FLOW///*/")

    # Date conversion
    j = hecdss_rs.DssFile.date_to_julian("15MAR2020")
    y, m, d = hecdss_rs.DssFile.julian_to_ymd(j)
```

## All Operations

35+ methods covering: text, regular/irregular time series, paired data, arrays, location, grids, delete/undelete, squeeze, copy, aliases, CRC tracking, date utilities, wildcard catalog filtering.

See [Python API Reference](../../docs/src/api/python.md) for complete documentation.

