Metadata-Version: 2.1
Name: commcare-api
Version: 0.1.0a0
Summary: Python library for interacting with the CommCareHQ API
Home-page: https://github.com/thecassion/commcare-api
Author: Pierre Robentz Cassion
Author-email: pierrerobentz.cassion@gmail.com
License: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Description-Content-Type: text/markdown
Requires-Dist: requests

# CommCare API Python Package

[![PyPI version](https://badge.fury.io/py/commcare-api.svg)](https://badge.fury.io/py/commcare-api)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)

## Overview

The `commcare_api` package is a Python library that simplifies interaction with the CommCareHQ API. It provides convenient methods for performing operations such as retrieving cases, forms, and performing bulk uploads. This package is designed to streamline CommCareHQ integration tasks in Python applications.

## Installation

You can easily install the `commcare_api` package using `pip`:

```bash
pip install commcare-api
```

## Usage

To use this package, follow these steps:

1. Import the `CommCareAPI` class from the package:

```python
from commcare_api.commcare_api import CommCareAPI
```

2. Create an instance of the `CommCareAPI` class by providing your CommCare domain and API version:

```python
api = CommCareAPI(domain="your_domain", version="your_version")
```

3. Utilize the methods of the `CommCareAPI` class for various operations. For example, to retrieve cases:

```python
cases = api.get_cases(type="case_type", limit=10)
# ... (perform other operations)
```

4. Customize the package according to your application's needs.

### Example: Printing Case Data

```python
for case in cases:
   print(case)
```

Remember to replace `"your_domain"` and `"your_version"` with your actual CommCare domain and version.

## Documentation

For in-depth documentation, detailed usage examples, and API reference, please refer to the [official documentation](link-to-your-documentation).

## Contributing

We welcome contributions to improve this package. Please read our [Contributing Guidelines](CONTRIBUTING.md) for more information on how to contribute.

## License

This package is distributed under the [MIT License](LICENSE).

## Acknowledgments

We would like to express our gratitude to the open-source community and all contributors for their valuable contributions to this project.

## Contact

If you have any questions, suggestions, or encounter issues, please don't hesitate to reach out to us at [pierrerobentz.cassion@gmail.com](mailto:pierrerobentz.cassion@gmail.com).

Make sure to replace placeholders like `your_domain`, `your_version`, `link-to-your-documentation`, `your-email@example.com`, and customize the content as needed for your package.# commcare-api
