Pykkelabels 1.1.1

Provides access to the pakkelabels.dk web service.

# Pykkelabels

Python implementation of the Pakkelabels.dk php package for interacting with the Pakkelabels.dk web service. For documentation on usage and the methods, see the documentation [here](https://www.pakkelabels.dk/integration/api/).

## Compatibility

The package and tests are all compatible with Python 2 and 3. And are tested on Python 2.7, 3.4 and 3.5.

## Installation

Easiest way is to install the package using pip: ` pip install Pykkelabels `

Alternatively, download the repository from github and put the Pykkelabels folder into your project folder.

## Usage

Import the package and accompanying exceptions using: ` from pykkelabels import Pykkelabels, ConnError, PageError `

The first thing required is to login: ` label = Pykkelabels('api_user', 'api_key') `

This will login and fetch the required token. The token is then automatically added to any subsequent calls.

To see the generated token you can use: ` print(label.getToken()) `

### Examples:

Get all Post Danmark labels shipped to Denmark: ` labels = label.shipments({'shipping_agent': 'pdk', 'receiver_country': 'DK'}) `

Get the PDF for a specific label: ` import base64 base64 = label.pdf(31629) pdf = base64.b64decode(base64) `

### Exceptions:

If there is problems with the connectivity to the server, or if the returned data is not parsable, a ConnError is raised. If the server returns an error a PageError exception is raised, with a message containing the error message from the server.

## Contributing

See the github guide to contributing [here](https://guides.github.com/activities/contributing-to-open-source/).

## History

• v0.1: First working release. Most of the functionality is still untested.

• v0.1.1: Added unittests to the methods where it is possible

• v0.1.2: Prepared pypi release

• v0.1.3: Added better error handling, and added custom exception. Added testing for bad inputs. Implemented better test of pdf generation.

• v0.1.4: Removed unwanted files from pypi release

• v1.0.0: Made the package compatible with Python 2 and 3. Renamed exception.

• v1.1.0: Better error handling

• v1.1.1: Sets user_agent

## Credits

Python package by Anders Winther Brandt

Original PHP module by Pakkelabels.dk

Tweaks from Jan Christensen from Pakkelabels.dk

## License

MIT, see LICENSE file