Metadata-Version: 2.1
Name: cdp-gh-utils
Version: 0.1.0
Summary: Utility functions and scripts to manage CDP GitHub repositories.
Author-email: Eva Maxfield Brown <evamaxfieldbrown@gmail.com>
License: MIT License
Project-URL: Homepage, https://github.com/CouncilDataProject/cdp-gh-utils
Project-URL: Bug Tracker, https://github.com/CouncilDataProject/cdp-gh-utils/issues
Project-URL: Documentation, https://CouncilDataProject.github.io/cdp-gh-utils
Project-URL: User Support, https://github.com/CouncilDataProject/cdp-gh-utils/issues
Classifier: Development Status :: 4 - Beta
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: ghapi (>=1.0.3)
Requires-Dist: pandas (>=1)
Requires-Dist: python-dotenv (>=1.0.0)
Requires-Dist: tqdm (>=4)
Provides-Extra: dev
Requires-Dist: ipython (>=8.4.0) ; extra == 'dev'
Provides-Extra: docs
Requires-Dist: m2r2 (>=0.2.7) ; extra == 'docs'
Requires-Dist: Sphinx (>=4.0.0) ; extra == 'docs'
Requires-Dist: furo (>=2022.4.7) ; extra == 'docs'
Requires-Dist: numpydoc ; extra == 'docs'
Requires-Dist: sphinx-copybutton ; extra == 'docs'
Requires-Dist: docutils (<0.19,>=0.18) ; extra == 'docs'
Provides-Extra: lint
Requires-Dist: black (>=22.3.0) ; extra == 'lint'
Requires-Dist: check-manifest (>=0.48) ; extra == 'lint'
Requires-Dist: ruff (>=0.0.216) ; extra == 'lint'
Requires-Dist: mypy (>=0.790) ; extra == 'lint'
Requires-Dist: pre-commit (>=2.20.0) ; extra == 'lint'
Provides-Extra: test
Requires-Dist: coverage (>=5.1) ; extra == 'test'
Requires-Dist: pytest (>=5.4.3) ; extra == 'test'
Requires-Dist: pytest-cov (>=2.9.0) ; extra == 'test'
Requires-Dist: pytest-raises (>=0.11) ; extra == 'test'

# cdp-gh-utils

[![Build Status](https://github.com/CouncilDataProject/cdp-gh-utils/workflows/CI/badge.svg)](https://github.com/CouncilDataProject/cdp-gh-utils/actions)
[![Documentation](https://github.com/CouncilDataProject/cdp-gh-utils/workflows/Documentation/badge.svg)](https://CouncilDataProject.github.io/cdp-gh-utils)

Utility functions and scripts to manage CDP (and other) GitHub repositories.

---

## Installation

**Stable Release:** `pip install cdp-gh-utils`<br>
**Development Head:** `pip install git+https://github.com/CouncilDataProject/cdp-gh-utils.git`

## Backfilling Instances

⚠️ ⚠️ Note: prior to using this library, be sure to create a 
[GitHub Personal Access Token](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token) 
and store it to a `GITHUB_TOKEN` environment variable (`.env` file also works). ⚠️ ⚠️

```bash
backfill-cdp-instance evamaxfield cdp-dev 2023-02-01 2023-03-01
```

## Documentation

For full package documentation please visit [CouncilDataProject.github.io/cdp-gh-utils](https://CouncilDataProject.github.io/cdp-gh-utils).

## Development

See [CONTRIBUTING.md](CONTRIBUTING.md) for information related to developing the code.

**MIT License**
