Python 3 library for the Exonet API.
Install using pip:
pip install exonetapi
Example to get the user details of the authorised user:
from exonetapi import Client
# Create a new Client.
client = Client('https://api.exonet.nl')
# Authorize with a personal access token.
client.authenticator.set_token('<YOUR_TOKEN>')
# Make an API call. Get details of the authorized user.
user_details = client.resource('me').get()
# Print user's name.
print('Autorized as: {name}'.format(
name=user_details.attribute('name')
))
See the /docs
directory for complete documentation and additional code snippets.
The /examples
directory contains ready to use scripts to help you get started. These examples can be executed with your personal access token. One of them gets a ticket with it's emails and prints the details::
$ python examples/ticket_details.py <YOUR-TOKEN>
This should make two API calls and print the ticket and email details for one of your tickets.
Please see releases for more information on what has changed recently.
When contributing to this repository, please first discuss the change you wish to make via issue, email, or any other method with the owners of this repository before making a change.
Please note we have a code of conduct, please follow it in all your interactions with the project.
You've found a bug in the source code, a mistake in the documentation or maybe you'd like a new feature? You can help us by submitting an issue to our GitHub Repository. Before you create an issue, make sure you search the archive, maybe your question was already answered.
Even better: You could submit a pull request with a fix / new feature!
-
Search our repository for open or closed pull requests that relates to your submission. You don't want to duplicate effort.
-
You may merge the pull request in once you have the sign-off of two other developers, or if you do not have permission to do that, you may request the second reviewer to merge it for you.
This Python project is fully managed using the Poetry dependency manager.
You need at least:
- Python 3.8+
- Poetry
Install all packages, including all development requirements:
poetry install
Poetry creates by default an virtual environment where it installs all necessary pip packages, to enter or exit the venv run the following commands:
poetry shell
exit
Now you're all set to get started!
To run the Python tests:
poetry run pytest
To run the bandit checks:
poetry run bandit
If you discover any security related issues please email [email protected] instead of using the issue tracker.