Metadata-Version: 1.1
Name: GB2260
Version: 0.3.1
Summary: The Python implementation for looking up the Chinese administrative divisions.
Home-page: https://github.com/cn/GB2260.py
Author: Jiangge Zhang
Author-email: tonyseek@gmail.com
License: BSD
Description: GB2260
        ======
        
        The Python implementation for looking up the Chinese administrative divisions.
        
        
        Installation
        ------------
        
        ::
        
            $ pip install GB2260
        
        
        Basic Usage
        -----------
        
        The way to look up a administrative division by its GB2260 code is
        the basic interface ``gb2260.get(code)``:
        
        .. code-block:: python
        
            >>> import gb2260
            >>>
            >>> division = gb2260.get(360426)
            >>> print(division)
            <gb2260.Division 360426 江西省/九江市/德安县>
        
        The data of a division is accessible to interfaces as following:
        
        .. code-block:: python
        
            >>> division.code
            u'360426'
            >>> division.name
            u'德安县'
            >>> division.is_county
            True
            >>> division.is_province
            False
            >>> division.is_prefecture
            False
            >>> print(division.province)
            <gb2260.Division 360000 江西省>
            >>> print(division.prefecture)
            <gb2260.Division 360400 江西省/九江市>
            >>> print(division.county)
            <gb2260.Division 360426 江西省/九江市/德安县>
        
        The hierarchic divisions could be generated with a iterator method:
        
        .. code-block:: python
        
            >>> division.stack()
            <generator object stack at 0x103e26a50>
            >>> for current in division.stack():
            ...     print(u'{0} {1}'.format(current.name, current.code))
            江西省 360000
            九江市 360400
            德安县 360426
        
        
        Issues
        ------
        
        If you want to report bugs or request features, please create issues on
        `GitHub Issues <https://github.com/cn/GB2260/issues>`_.
        
        
        External Links
        --------------
        
        - `GB/T 2260-2002 in Wikipedia <https://zh.wikipedia.org/zh-cn/GB/T_2260-2002>`_
        - `Codes for administrative divisions of PRC <http://www.stats.gov.cn/tjsj/tjbz/xzqhdm/201401/t20140116_501070.html>`_
        
        .. |GB/T 2260| image:: http://img.shields.io/badge/GB%2FT-2260-blue.svg?style=flat
           :target: https://github.com/cn/GB2260
           :alt: GB/T 2260
        .. |Build Status| image:: https://img.shields.io/travis/cn/GB2260.py.svg?style=flat
           :target: https://travis-ci.org/cn/GB2260.py
           :alt: Build Status
        .. |Coverage Status| image:: https://img.shields.io/coveralls/cn/GB2260.py.svg?style=flat
           :target: https://coveralls.io/r/cn/GB2260.py
           :alt: Coverage Status
        .. |Wheel Status| image:: https://pypip.in/wheel/GB2260/badge.svg?style=flat
           :target: https://warehouse.python.org/project/GB2260
           :alt: Wheel Status
        .. |PyPI Version| image:: https://img.shields.io/pypi/v/GB2260.svg?style=flat
           :target: https://pypi.python.org/pypi/GB2260
           :alt: PyPI Version
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: Chinese (Simplified)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
