Bearer Python
Bearer Python client
Installation
pip install bearer
Usage
Get your Bearer Secret Key and integration id from the Dashboard and use the Bearer client as follows:
Calling any APIs
from bearer import Bearer
bearer = Bearer('BEARER_SECRET_KEY') # find it on https://app.bearer.sh/keys
github = (
bearer
.integration('your integration id') # you'll find it on the Bearer dashboard https://app.bearer.sh
.auth('your auth id') # Create an auth id for your integration via the dashboard
)
print(github.get('/repositories').json())
We use requests internally and we return the response from this library from the request methods (request, get, head, post, put, patch, delete).
More advanced examples:
# With query parameters
print(github.get('/repositories', query={ 'since': 364 }).json())
# With body data
print(github.post('/user/repos', body={ 'name': 'Just setting up my Bearer.sh' }).json())
Setting the request timeout, and other http client settings
Bearer client is written on top of excellent requests library. Bearer provides reasonable defaults but you can adjust http client configuration by using any keyword argument which is accepted by requests.request method using http_client_settings keyword argument. By default bearer client times out after 5 seconds. Bearer allows to increase the timeout to up to 30 seconds
from bearer import Bearer
bearer = Bearer('BEARER_SECRET_KEY', http_client_settings={"timeout": 10}) # increase the request timeout to 10 seconds globally
# you can specify client settings per integration as well
github = bearer.integration('github', http_client_settings={"timeout": 2}) # github api is super fast 2 seconds should be plenty
print(github.get('/user/repos'))
Development
# setup venv
$ python -m venv venv
# install dependencies
$ venv/bin/python setup.py develop
# start the console
$ venv/bin/python
2.9k Dec 30, 2022
281 Dec 29, 2022
19 Jan 11, 2022
368 Dec 9, 2022
655 Dec 29, 2022
677 Dec 21, 2022
259 Dec 28, 2022
52 Nov 25, 2022
7.3k Jan 1, 2023
5 Nov 03, 2021
43 Jan 06, 2023
421 Jan 05, 2023
1.9k Jan 06, 2023
1.5k Jan 09, 2023
157 Dec 28, 2022
0 Nov 17, 2022
17 Aug 24, 2022
4 Dec 26, 2022
254 Dec 29, 2022
996 Dec 28, 2022
37 Aug 13, 2022
82 Dec 27, 2022
3.5k Jan 02, 2023
2 Oct 22, 2021
22 Nov 12, 2022
33 Oct 21, 2022
0 Oct 16, 2021
19 Apr 08, 2022
168 Dec 19, 2022