Skip to main content

Python SDK for accessing the TravelPerk API

Project description

travelperk-http-python tag build codecov Lint

TravelPerk Python SDK

About

This is an unofficial package for acessing the TravelPerk official Web API from your Python language project. It is designed so you can easily query and retrieve all data hold on their platform and accessible through the API.

Installation

This package is hosted on PyPi, you can install it using any python package manager.

$ pip install travelperk-http-python

Getting started

Before getting started retrieving querying information from the TravelPerk Web API you first need to get an API Key.

Getting a TravelPerk instance

For querying the data you need to get a TravelPerk instance, here are two ways to get a TravelPerk API instance depending on how you authenticate with their API.

At TravelPerk there are two ways to authenticate, using an API Key or OAuth2.

For API Key Authentication

If you have an API Key for authenticating you need to call the Service Provider's build method passing your api key, and a boolean indicating if you will be using the sandbox environment or not like this:

from travelperk_http_python.builder.builder import build
is_sandbox = False
travelperk = build("YOUR_API_KEY", is_sandbox)

For OAuth Authentication

Due to time constrains the OAuth authentication flow is not fully implemented so is not supported yet, see this GitHub issue

Retrieving data

Everything is ready, you can start asking for the data.

travelperk.expenses().invoices().all()

For further information refer to the documentation linked in the next section.

Documentation

The full documentation can be found in the wiki section of this github repository. Also you can refer to the official TravelPerk Web API documentation

License

MIT

Contributing

Any suggestion, bug reports, prs or any other kind enhacements are welcome. Just open an issue first, for creating a PR remember this project has linting checkings and unit tests so any PR should comply with both before beign merged, this checks will be automatically applied when opening or modifying the PRs.

Local development

This project comes with a docker-compose.yml file so if you use Docker and docker-compose you can develop without installing anything on your local environment. Just run docker-compose up --build for the first time to setup the container and launch the tests. Pytest is configured as the entrypoint so just run docker-compose up everytime you want the tests to execute on the Dockerized Python development container.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

travelperk-http-python-1.2.2.tar.gz (23.8 kB view details)

Uploaded Source

Built Distribution

travelperk_http_python-1.2.2-py3-none-any.whl (53.2 kB view details)

Uploaded Python 3

File details

Details for the file travelperk-http-python-1.2.2.tar.gz.

File metadata

File hashes

Hashes for travelperk-http-python-1.2.2.tar.gz
Algorithm Hash digest
SHA256 9ab42efd0102bfcf0f3939247c90cb5d70f3695957cda3b3106f09132415ec79
MD5 0d45050454ba056f880e53d2394c4d01
BLAKE2b-256 2fac9c277f01150882229f6daf5345da2e4edfd08182b0e1f69e3a330e7061c1

See more details on using hashes here.

File details

Details for the file travelperk_http_python-1.2.2-py3-none-any.whl.

File metadata

File hashes

Hashes for travelperk_http_python-1.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 9ce33ac7f85d99784655e7f86d82e0fb67711c53b34849b96c3a6d5ffb0726a0
MD5 e740104dde46e8fa7b7cfcd339fb5244
BLAKE2b-256 68409100259abc89306b54e92d550b472254396288f11962b1f03d84262eb59b

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page