Metadata-Version: 2.1
Name: depo
Version: 0.2.0
Summary: DEPO Delivery Service Bindings for Python
Home-page: https://www.backbone.sk/en/
Author: Palo Sopko
Author-email: pavol@sopko.sk
License: MIT
Project-URL: Bug Tracker, https://github.com/palosopko/depo-python/issues
Project-URL: Source Code, https://github.com/palosopko/depo-python
Keywords: depo
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*
Description-Content-Type: text/markdown
Requires-Dist: requests (>=2.21.0)
Requires-Dist: six (>=1.3.0)

# DEPO Delivery Service Bindings for Python

Python wrapper for [DEPO](https://depo.sk)'s application interface. At the moment, it provides easy access to contracted places (input / output) and placing and canceling orders.

Detailed information of DEPO's API can be found at [their website](https://admin.depo.sk/apigility/documentation/Api-v2). If you feel like you need covering additional API methods, please open an issue or create a pull request.

## Setup

You can install this package by using `pip`:

	pip install depo

If you fancy `pipenv` use:

	pipenv install depo

To install from source, run:

	python setup.py install

For the API client to work you would need Python 2.7+ or Python 3.4+.

To install via `requirements` file from your project, add the following for the moment before updating dependencies:

	git+git://github.com/palosopko/depo-python.git#egg=depo

## Usage

First off, you need to require the library and provide authentication information by providing your user name and password do [DEPO's admin interface](https://admin.depo.sk`)

	import depo
	dibuk.api_credentials = ('email', 'password')

**Getting contracted places** is accomplished by calling `depo.Place.all()`. The method returns a list with `depo.Place` objects containing all the relevant details. Please note boolean properties `is_input` and `is_output` – if you are just trying to implement DEPO's service for your customers to get their orders, you will only be interested in the latter.

To **place a new order** you need to run `depo.Order.create()` with code of a place (or `Place` object), recipient's name, phone, email and order's amount, product amount and optionally an order reference. Method returns dictionary with delivery details including reference number under the `number` key.

## Contributing

1.  Check for open issues or open a new issue for a feature request or a bug.
2.  Fork the repository and make your changes to the master branch (or branch off of it).
3.  Send a pull request.

## Development

Run all tests on all supported Python versions:

	make test

Run the linter with:

	make lint

The client library uses Black for code formatting. Code must be formatted with Black before PRs are submitted. Run the formatter with:

	make fmt

## Changelog

### v0.2.0: 30/09/2019

Python 3 compatibility for real, code formatting is covered by Black and various small fixes to make everything better and easier including first test.

### v0.1.1: 04/04/2017

Fixes creating order from place's identifiers sent as unicode.

### v0.1.0: 28/03/2017

Initial version with support for getting pickup places.


