Metadata-Version: 2.4
Name: shef-parser
Version: 1.7.2
Summary: Module to extract data from SHEF formated files with ability to save output as flat file, HEC-DSS file, or directly into Corps water management systems (CWMS) database
License: LICENSE
License-File: LICENSE
Keywords: SHEF,USACE,CWMS,DSS
Author: Hydrologic Engineering Center
Requires-Python: >=3.9,<4.0
Classifier: License :: Other/Proprietary 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
Provides-Extra: docs
Requires-Dist: sphinx (>=7.0,<8.0) ; extra == "docs"
Requires-Dist: sphinx-design (>=0.5,<0.6) ; extra == "docs"
Requires-Dist: sphinx_rtd_theme (>=2.0,<3.0) ; extra == "docs"
Project-URL: Repository, https://github.com/HydrologicEngineeringCenter/SHEF_processing
Description-Content-Type: text/markdown

# Package SHEF Parser

A python based package to parse SHEF files and optionally load them into various data stores. It also provides functionality for generating SHEF
text from various data stores.

Parsing and loading can be performed by using module in python or through command line. Generating SHEF text from a data store is currenly limited
to using the module in python.

See User Guide at [https://shef-processing.readthedocs.io/en/latest/](https://shef-processing.readthedocs.io/en/latest/)

See API Documentation at [https://hydrologicengineeringcenter.github.io/shef-parser/index.html](https://hydrologicengineeringcenter.github.io/SHEF_processing/)

## Install

```sh
pip install shef-parser
```

## Loading via command line
```sh
#CWMS CDA loader
shefParser -i input_filename --loader cda[$API_ROOT][$API_KEY]
```

```sh
#HEC-DSS loader
shefParser -i input_filename --loader dss[<dss_file>][<sensors_file>][<parameters_file>]
```

## Loading via module
```python
#CWMS CDA loader
import os
from shef import shef_parser

cda_url: str = os.getenv("CDA_API_ROOT")
cda_api_key: str = os.getenv("CDA_API_KEY")

shef_parser.parse(
    input_name=input_filename,
    loader_spec=f"cda[{cda_url}][{cda_api_key}]",
)
```

```python
#HEC-DSS loader
from shef import shef_parser

dss_filename: str = "/path/to/dss_file"
sensors_filename: str = "/path/to/sensors_file"
parameters_filename: str = "/path/to/parameters_file"

shef_parser.parse(
    input_name=input_filename,
    loader_spec=f"dss[{dss_filename}][{sensors_filename}][{parameters_filename}]",
)
```

## Generating SHEF Text
```python
#CWMS CDA loader
import os
from datetime import datetime, timedelta
from shef.exporters import CdaExporter

cda_url: str = os.getenv("CDA_API_ROOT")
office_id: str = os.getenv("CDA_OFFICE_ID")
tsids: list[str] = [
    ...
]

exporter = CdaExporter(cda_url, office_id)
exporter.start_time = datetime.now() - timedelta(days=1)
exporter.end_time = datetime.now()
with open("/path/to/output_file", "w") as f:
    exporter.set_output(f)
    for (tsid in tsids):
        exporter.export(tsid)
```

```python
#HEC-DSS loader
from datetime import datetime, timedelta
from shef.exporters import DssExporter

dss_filename: str = "/path_to_dss_file"
sensors_filename: str = "/path/to/sensors_file"
parameters_filename: str = "/path/to/parameters_file"
pathnames: list[str] = [
    ...
]

exporter = DssExporter(
    dss_filename,
    sensors_filename,
    parameters_filename
)
exporter.start_time = datetime.now() - timedelta(days=1)
exporter.end_time = datetime.now()
with open("/path/to/output_file", "w") as f:
    exporter.set_output(f)
    for (pathname in pathnames):
        exporter.export(pathname)
```

