Metadata-Version: 2.1
Name: camtrapdp
Version: 0.1.0
Summary: Python library for working with the Camtrap Data Package format.
Author: Benjamin C. Evans
Project-URL: Homepage, https://github.com/bencevans/camtrap-dp-py
Project-URL: Issues, https://github.com/bencevans/camtrap-dp-py/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: pandas <3,>2

# Camtrap Data Package Python Library

The Camtrap Data Package Python Library is a Python library for working with the [Camtrap Data Package](https://camtrap-dp.tdwg.org/) version 1.0 format.

## Installation

```bash
pip install camtrapdp
```

## Usage

The `camtrapdp` package provides classes for working with the Camtrap Data Package format, reading and writing to CSV and Pandas DataFrames.

### Read an Deployments CSV file

```python
from camtrapdp import Deployment

# Read a deployments CSV file
deployments = Deployment.from_csv('deployments.csv')

# Print the first deployment
print(deployments[0])
```

### Write a Deployments CSV file

```python
from camtrapdp import Deployment

# Create a deployment
deployments = [
    Deployment(...),
    Deployment(...)
]

# Write a deployments CSV file
Deployment.to_csv(deployments, 'deployments.csv')
```

## Related

- [Camtrap Data Package](https://camtrap-dp.tdwg.org/) - The Camtrap Data Package specification
- [Camtrap Data Package Rust Library](https://github.com/bencevans/camtrap-dp-rs) - A Rust library for working with the Camtrap Data Package format
