Metadata-Version: 2.4
Name: dods
Version: 0.1.0
Summary: Unified DODS toolkit (includes dods-datagen, dods-analyze, etc.)
Author-email: Maximilian Häusler <mahaeu@yahoo.de>
License: Apache-2.0
Project-URL: Homepage, https://github.com/mahaeu
Project-URL: Repository, https://github.com/mahaeu/dods
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
Requires-Dist: dods-datagen>=0.1.1
Requires-Dist: dods-analyze>=0.1.0
Provides-Extra: all
Dynamic: license-file

# dods

Unified DODS toolkit.

`dods` is the meta package that bundles the DODS modules into one install.  
You can either install everything via `dods`, or install individual modules.

## Install

### Option A — Install the full toolkit (recommended)

```bash
pip install dods
```

This installs:
- `dods-datagen` (synthetic data generation)
- `dods-analyze` (data analysis utilities)

### Option B — Install modules individually

```bash
pip install dods-datagen
pip install dods-analyze
```

## Usage

### Data generation (`dods-datagen`)

```python
import dods.datagen as dg

dg.create_template()      # creates template.yaml
df = dg.run("template")   # reads template.yaml and generates the CSV (output_path/filename are in the YAML)
```

### Data analysis (`dods-analyze`)

```python
from dods.analyze import DataAnalyzer
import pandas as pd

df = pd.read_csv("data/customers.csv")
dfa = DataAnalyzer(df)

dfa.summary()
```

## Notes

- Python imports use the `dods.*` namespace:
  - `import dods.datagen as dg`
  - `from dods.analyze import DataAnalyzer`
- Each module is also available as a standalone PyPI package:
  - `dods-datagen`
  - `dods-analyze`

## Links

- Homepage: https://github.com/mahaeu/
- PyPI: https://pypi.org/project/dods/
- PyPI (datagen): https://pypi.org/project/dods-datagen/
- PyPI (analyze): https://pypi.org/project/dods-analyze/

