Description

Postcodes ********* Postcodes is a small library for getting information about, postcodes in the UK. At its core, the postcode data is provided by the `Ordnance Survey OS OpenData`_ initiative, but this library is actually a wrapper for a `web\-service`_ provided by `Stuart Harrison`_. .. _Stuart Harrison: http://twitter.com/pezholio .. _web-service: http://www.uk-postcodes.com/ .. _Ordnance Survey OS OpenData: http://www.ordnancesurvey.co.uk/oswebsite/products/os-opendata.html Installation ============ If you use pip then installation is simply:: $ pip install postcodes or, if you want the latest github version:: $ pip install git+git://github.com/e-dard/postcodes.git You can also install Postcodes via Easy Install:: $ easy_install postcodes Features ======== Postcodes allows you to do the following: * Lookup the postcode data associated with a specific postcode; * Get the nearest postcode data associated to a specific geographical point; * Get all of the postcode data within a specific distance to a geographical point; * Get all of the postcode data within a specific distance to a known postcode. As well as being a thin wrapper over the `uk-postcodes`_ `web-service`_, Postcodes also provides a simple caching and validation layer, in the form of the `PostCoder` object, meaning you don't have to worry about keeping track of any previously requested data. .. _uk-postcodes: http://www.uk-postcodes.com/ .. _Edward Robinson: http://twitter.com/eddrobinson