Metadata-Version: 2.1
Name: koordinates
Version: 0.5.3
Summary: A Python client library for a number of Koordinates web APIs
Home-page: https://github.com/koordinates/python-client
Author: Koordinates Limited
Author-email: support@koordinates.com
License: BSD
Keywords: koordinates api
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Scientific/Engineering :: GIS
Requires-Dist: python-dateutil (<3,>=2)
Requires-Dist: pytz
Requires-Dist: requests (<3,>=2.5)
Requires-Dist: requests-toolbelt (<1,>=0.4)
Requires-Dist: six (<2,>=1.10.0)
Requires-Dist: contextlib2 ; python_version=="2.7"

==============================
Koordinates Python API Client
==============================

A BSD-licensed Python client library for a number of `Koordinates <https://koordinates.com>`_ web APIs.

The library provides easy access to Koordinates web services, particularly the `Publisher Admin APIs <https://help.koordinates.com/api/publisher-admin-api/>`_.

.. image:: https://badge.buildkite.com/5ce9ace71272791038722b9443fd4bb23620aec8041c10ea46.svg?branch=master
    :target: https://buildkite.com/koordinates/python-client

Installation
============

To install the latest stable release of the library, simply::

    $ pip install koordinates

The library is compatible with Python 2.7 & Python 3.3+.


Documentation
=============

* `Documentation for the Python library <http://koordinates-python.readthedocs.org>`_.
* `Documentation on the APIs and available actions <https://help.koordinates.com/api/publisher-admin-api/>`_.


Support & Contributions
=======================

Please report bugs as `Github issues <https://github.com/koordinates/python-client/issues>`_. For general technical support for the APIs and libraries, please contact us via `support.koordinates.com <https://support.koordinates.com>`_.

We welcome contributions as pull requests - please open a new issue to start a discussion around a feature idea or bug. See the `Contributing notes <http://koordinates-python.readthedocs.org/en/latest/user/contributing.html>`_ for more details.

Code formatting
===============

We use [Black](https://github.com/psf/black) to ensure consistent code formatting. We recommend integrating black with your editor:

* Sublime Text: install [sublack](https://packagecontrol.io/packages/sublack) via Package Control
* VSCode [instructions](https://code.visualstudio.com/docs/python/editing#_formatting)

We use the default settings, and target python 2.7 and 3.3+.

One easy solution is to install [pre-commit](https://pre-commit.com), run `pre-commit install --install-hooks` and it'll automatically validate your changes code as a git pre-commit hook.


