Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Tool to integrate your Python app with Poco.

Project Description

python-poco provides classes that can be used to integrate your software with the South African postal code lookup service at Basic usage is crazy simple:

#!/usr/bin/env python

from poco.poco import PocoSearcher

results = PocoSearcher.results_as_dicts('Wingate Park')
objects = PocoSearcher.results_as_objects('Wingate Park')

In the above example, ‘results’ is a list which contains dictionaries with the following keys: id, suburb, area, postal, street. Similarly, ‘objecst’ is a list which contains objects of the PocoLocation class. The PocoLocation class has the same keys mentioned above as class attributes. So basically, use results_as_dicts or results_as_objects, depending on what your application needs.

One important caveat: The following rules apply:

  • The search term cannot be empty.
  • The search term must contain at least 3 characters.

An exception of type requests.exceptions.HTTPError will be raised if the above requirements are not met.

For reference, the Poco API documentation is available at

Release History

Release History

This version
History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
python-poco-0.1.0.tar.gz (3.2 kB) Copy SHA256 Checksum SHA256 Source Feb 6, 2014

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting