Metadata-Version: 1.1
Name: django-teryt
Version: 0.2.0
Summary: TERYT database implementation for Django
Home-page: https://github.com/scibi/django-teryt
Author: Patryk Ściborek
Author-email: patryk@sciborek.com
License: MIT
Description: =============================
        django-teryt
        =============================
        
        .. image:: https://badge.fury.io/py/django-teryt.png
            :target: http://badge.fury.io/py/django-teryt
            
        .. image:: https://travis-ci.org/scibi/django-teryt.png?branch=master
                :target: https://travis-ci.org/scibi/django-teryt
        
        .. image:: https://pypip.in/d/django-teryt/badge.png
                :target: https://crate.io/packages/django-teryt?version=latest
        
        
        django-teryt is a Django app that implements TERYT database.
        TERYT (Polish: "Krajowy Rejestr Urzędowy Podziału Terytorialnego Kraju",
        English: "National Official Register of Territorial Division of the Country")
        is a register maintained by Polish Central Statistical Office (Polish: Główny
        Urząd Statystyczny; GUS). Among other things it contains:
        
        * identifiers and names of units of territorial division,
        * identifiers and names of localities,
        * identifiers and names of streets
        
        This app parses XML files from GUS and it imports them to the database.
        It is meant to be used as a part of a larger system.
        
        Documentation
        -------------
        
        The full documentation is at http://django-teryt.rtfd.org.
        
        Quickstart
        ----------
        
        Install django-teryt::
        
            pip install django-teryt
        
        If you are using Django 1.6 or lower you have to install South::
        
            pip install 'south>=1.0'
        
        Add ``teryt`` to ``INSTALLED_APPS`` in your ``settings.py`` and run::
        
            ./manage.py migrate teryt
        
        Then download TERYT data from
        `GUS website <http://www.stat.gov.pl/broker/access/prefile/listPreFiles.jspa>`_,
        unpack it and then import it::
        
             ./manage.py teryt_parse /path/to/WMRODZ.xml /path/to/TERC.xml /path/to/SIMC.xml /path/to/ULIC.xml
        
        Features
        --------
        
        * It can import all data from all TERYT files
        * It deals with updates (just run ./manage.py teryt_parse --update TERC.xml)
        * It keeps flag (aktywny) telling you if some record is still present in TERYT
          (there are some minor changes in territorial division from time to time)
        
        Support
        -------
        
        All bug reports and pull requests are welcome. You can report them at
        https://github.com/scibi/django-teryt/issues.  It can be in English
        or in Polish ;)
        
        
        
        
        
        History
        -------
        
        0.1.0 (2013-12-31)
        ++++++++++++++++++
        
        * First release on PyPI.
        
        0.2.0 (2015-01-08)
        ++++++++++++++++++
        
        * Added support for Django 1.7 migrations
        * Moved common data to abstract base class
        * Added common flag filed (aktywny)
        * Added 3 model managers to JednostkaAdministracyjna
        * Fixed PEP 8 compliance in main source files
        
Keywords: django-teryt
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
