Heron Python
This library provides easy access to the Heron Data API from applications written in Python.
Documentation
No language-specific docs are currently maintained. For documentation on the raw REST API this library uses behind the scenes, see our OpenAPI Docs.
Installation
If you just want to use the package, just run:
pip install --upgrade heron-data
Install from source with:
python setup.py install
Requirements
- Python 3.8+
Usage
Import the heron package and set your config:
import os
import heron
heron.basic_auth_username = os.getenv("HERON_USERNAME")
heron.basic_auth_password = os.getenv("HERON_PASSWORD")
# Experimental: if you pull from a fintech API, specify it here to get
# automatic conversion into a Heron Data API format. Supported: plaid,
# finicity, yodlee, truelayer
heron.provider = "plaid"
Alternatively, set HERON_USERNAME and HERON_PASSWORD as environment variables which will be automatically picked up.
Then you can issue API requests using Python classes:
end_user = heron.EndUser.create(...)
transactions = heron.Transaction.create_many([...])
You can see a longer example in the examples/ directory.
Contributing
Fork this repository, and install dev dependencies:
pip install -r requirements.dev.txt
Run tests and capture coverage with:
coverage run -m unittest
See test coverage with:
coverage report
Run linting with flake8 and black:
flake8 . && black .
Make a PR against the main branch and it will be reviewed.
3 Sep 8, 2022
20 Jun 18, 2022
10 Nov 21, 2022
147 Dec 15, 2022
4 Dec 22, 2021
1 Nov 21, 2021
39 Jan 4, 2023
20 Sep 16, 2022
3 Jan 8, 2022
5 Nov 12, 2022
22 Nov 14, 2022
2 Dec 06, 2021
3 Jan 04, 2022
130 Dec 29, 2022
32 Nov 12, 2022
0 Jan 06, 2022
9 Dec 11, 2021
5 Dec 13, 2021
4 Nov 23, 2021
186 Dec 22, 2022
3 Feb 27, 2022
1 Feb 04, 2022
74 Jun 09, 2022
5 Apr 28, 2022
2 May 24, 2022
1 Jan 06, 2022
32 Feb 09, 2022
9 Sep 13, 2022
7 Oct 23, 2022