Metadata-Version: 1.1
Name: python-poco
Version: 0.1.0
Summary: Tool to integrate your Python app with Poco.
Home-page: https://github.com/johanmeiring/python-poco
Author: Johan Meiring
Author-email: johanmeiring@gmail.com
License: LICENSE
Description: ===========
        python-poco
        ===========
        
        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/.
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.3
