Metadata-Version: 2.0
Name: django-postcode-lookup
Version: 0.2.0
Summary: Pluggable postcode lookup endpoint
Home-page: https://github.com/labd/django-postcode-lookup
Author: Michael van Tellingen
Author-email: michaelvantellingen@gmail.com
License: MIT
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 1.8
Classifier: Framework :: Django :: 1.9
Classifier: Framework :: Django :: 1.10
Classifier: License :: OSI Approved :: MIT License
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
Requires-Dist: Django (>=1.8)
Requires-Dist: attrs
Requires-Dist: djangorestframework (<4,>=3)
Requires-Dist: requests (>=2.7)
Requires-Dist: six (>=1.1)
Provides-Extra: docs
Requires-Dist: sphinx (>=1.4.0); extra == 'docs'
Provides-Extra: test
Requires-Dist: flake8 (==3.0.3); extra == 'test'
Requires-Dist: flake8-blind-except (==0.1.1); extra == 'test'
Requires-Dist: flake8-debugger (==1.4.0); extra == 'test'
Requires-Dist: freezegun (==0.3.8); extra == 'test'
Requires-Dist: isort (==4.2.5); extra == 'test'
Requires-Dist: pretend (==1.0.8); extra == 'test'
Requires-Dist: pytest (==3.0.5); extra == 'test'
Requires-Dist: pytest-cov (==2.4.0); extra == 'test'
Requires-Dist: pytest-django (==3.1.2); extra == 'test'
Requires-Dist: requests-mock (==1.1.0); extra == 'test'

======================
django-postcode-lookup
======================

This Django app providers a pluggable postcode django restframework endpoint. It currently only works
for postcodes in The Netherlands.

Currently supports the following services:
 - ApiWise
 - Webservices.nl


Status
======
.. image:: https://travis-ci.org/LabD/django-postcode-lookup.svg?branch=master
    :target: https://travis-ci.org/LabD/django-postcode-lookup

.. image:: http://codecov.io/github/LabD/django-postcode-lookup/coverage.svg?branch=master 
    :target: http://codecov.io/github/LabD/django-postcode-lookup?branch=master

.. image:: https://img.shields.io/pypi/v/django-postcode-lookup.svg
    :target: https://pypi.python.org/pypi/django-postcode-lookup/

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

.. code-block:: shell

   pip install django_postcode_lookup

Usage
=====

Add the following to your urls.py:


.. code-block:: python

    url(r'^postcode-lookup/', include('django_postcode_lookup.urls')),


Add a setting with the required backend

.. code-block:: python

    POSTCODE_LOOKUP = {
        'default': {
            'backend': 'django_postcode_lookup.backends.Webservices',
            'OPTIONS': {
                'username': 'someuser',
                'password': 'somepassword',
            }
        }
    }


To offer some form of protection to the api endpoint for usage by others a 
valid csrf token is required.


