acquiring-sdk-python 0.1.0

Description:

acquiringsdkpython 0.1.0

Introduction
The Python SDK helps you to communicate with the Worldline Acquiring API. Its primary features are:

convenient Python library for the API calls and responses

marshals Python request objects to HTTP requests
unmarshals HTTP responses to Python response objects or Python exceptions


handling of all the details concerning authentication
handling of required metadata

See the Worldline Acquiring Documentation for more information on how to use the SDK.


Structure of this repository
This repository consists out of four main components:

The source code of the SDK itself: /worldline/acquiring/sdk/
The source code of the SDK unit tests: /tests/unit/
The source code of the SDK integration tests: /tests/integration/

Note that the source code of the unit tests and integration tests can only be found on GitHub.


Requirements
Python 3.7 or higher is required. In addition, the following packages are required:

requests 2.25.0 or higher
requests-toolbelt 0.8.0 or higher

These packages will be installed automatically if the SDK is installed manually or using pip following the below instructions.


Installation
To install the SDK using pip, execute the following command:
pip install acquiring-sdk-python
Alternatively, you can install the SDK from a source distribution file:

Download the latest version of the Python SDK from GitHub. Choose the acquiring-sdk-python-x.y.z.zip file from the releases page, where x.y.z is the version number.
Execute the following command in the folder where the SDK was downloaded to:
pip install acquiring-sdk-python-x.y.z.zip




Uninstalling
After the Python SDK has been installed, it can be uninstalled using the following command:
pip uninstall acquiring-sdk-python
The required packages can be uninstalled in the same way.


Running tests
There are two types of tests: unit tests and integration tests. The unit tests will work out-of-the-box; for the integration tests some configuration is required.
First, some environment variables need to be set:

acquiring.api.oauth2.clientId for the OAUth2 client id to use.
acquiring.api.oauth2.clientSecret for the OAuth2 client secret to use.
acquiring.api.merchantId for your merchant ID.

In addition, to run the proxy integration tests, the proxy URI, username and password should be set in the tests/resources/configuration.proxy.ini file.
In order to run the unit and integration tests, the mock backport and mockito are required. These can be installed using the following command:
pip install mock mockito
The following commands can now be executed from the tests directory to execute the tests:

Unit tests:
python run_unit_tests.py

Integration tests:
python run_integration_tests.py

Both unit and integration tests:
python run_all_tests.py