Skip to main content

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 http://poco.co.za. 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 http://poco.co.za/api/.

Project details


Download files

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

Source Distribution

python-poco-0.1.0.tar.gz (3.2 kB view details)

Uploaded Source

File details

Details for the file python-poco-0.1.0.tar.gz.

File metadata

  • Download URL: python-poco-0.1.0.tar.gz
  • Upload date:
  • Size: 3.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for python-poco-0.1.0.tar.gz
Algorithm Hash digest
SHA256 d4ff8cfb05a30e962e5a70f504540a6f82ac4655978f621771de36d49930e1fb
MD5 91f0347f3bf4b62f00f8e6ac3287ab39
BLAKE2b-256 782a62e7f6b50dfdda24c25718aa6b38d7747671f36f5f5035151e407c29d18b

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page