Metadata-Version: 2.4
Name: govdelivery
Version: 1.5
Summary: Python module for interacting with the GovDelivery API
Home-page: https://github.com/cfpb/govdelivery
Author: CFPB
Author-email: tech@cfpb.gov
License: CC0
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: CC0 1.0 Universal (CC0 1.0) Public Domain Dedication
Classifier: License :: Public Domain
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
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: Topic :: Communications :: Email
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests<3,>=2.22.0
Provides-Extra: testing
Requires-Dist: coverage; extra == "testing"
Requires-Dist: responses; extra == "testing"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: license-file
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# govdelivery

A quite incomplete client for the GovDelivery Communications Cloud API v1.

Currently, you can subscribe a user; manage their topics, categories, and
question responses; and get the list of available topics.

The GovDelivery Communications Cloud API is described here:
https://developer.govdelivery.com/api/comm_cloud_v1/Default.htm


## Status

Officially supports Python 3.10 and above.


## Installation

`pip install govdelivery`


## Running the tests

To lint the code and execute the unit tests,
we recommend using [tox](https://tox.readthedocs.io/).

1. Install tox in a virtualenv or in your global Python environment by running
   `pip install tox`.

   Alternately, we also like using [pipx](https://github.com/pipxproject/pipx)
   for installing and running system-wide tools like tox.
1. Run all the tests in one go with `tox`.
1. If you want to run just the linting tools (flake8 and isort), you can run
   `tox -e lint`.
1. If you want to run tests in a specific Python version, you can run
   `tox -e py310` or `tox -e py313`.


## Changelog

### 1.5 - 2025-11-17

- Drop support for Python < 3.10
- Modernize PyPI release publishing

### 1.4.0 - 2021-06-21

- Drop Python 2 support
- Pin dependency on requests to a range

### 1.3 – 2019-11-25

- Add Python 3 support
- Improve test coverage and add tox support for easy test running
- Fix a few assorted bugs

### 1.2 – 2018-09-17

- Support updating a subscriber's response to a select question (as opposed to
  a free response question)

### 1.1 – 2017-11-06

- Allow SMS subscriptions
- Allow notifications to be enabled on certain method calls

### 1.0 – 2017-01-31

Initial public release.


## Open source licensing info

1. [`TERMS.md`](TERMS.md)
2. [`LICENSE`](LICENSE)
3. [CFPB Source Code Policy](https://github.com/cfpb/source-code-policy)
