Metadata-Version: 1.1
Name: redturtle.entiterritoriali
Version: 0.3.1
Summary: Package contatins all italian enti territoriali in sqlite db
Home-page: http://plone.org/products/redturtle.entiterritoriali
Author: RedTurtle Technology
Author-email: sviluppoplone@redturtle.net
License: GPL
Description: Introduction
        ============
        This package provides vocabulary for all italian 'enti territoriali'.
        For storage we are using sqlite3 database wrapped with sqlalchemy.
        
        First lets import the vocabulary (which should have already a vocabulary object)::
        
            >>> from redturtle.entiterritoriali import EntiVocabulary as EV
        
        Now let's try the simple query: for regione, provincia and comune::
        
            >>> EV.regione('Emilia-Romagna')
            MappedRegioni(regione=u'Emilia-Romagna',...)
        
            >>> EV.provincia('Ferrara')
            MappedProvince(provincia=u'Ferrara',...)
        
            >>> EV.comune('Ferrara')
            MappedComuni(comune_id=4105,comune=u'Ferrara',...)
        
        
        Then let's check if we have all of them::
        
            >>> len(EV.allRegioni())
            20
        
            >>> len(EV.allProvince())
            108
        
            >>> len(EV.allComuni())
            8101
        
        
        Now we can try to use `like` statesment. We can use helper methods::
        
            >>> EV.comuniByLetter('Mod')
            [MappedComuni(comune_id=4013,comune=u'Modena',provincia=u'MO',...u'http://www.comune.modugno.ba.it/')]
        
            >>> EV.provinceByLetter('Bo')
            [MappedProvince(provincia=u'Bologna',...u'http://www.provinz.bz.it/')]
        
            >>> EV.regioniByLetter('L')
            [MappedRegioni(regione=u'Lazio',capoluogo=u'Roma'...u'postaweb@regione.lombardia.it')]
        
        
        ... but you can also build your own filters using sqlalchemy and pass them as list of arguments::
        
            >>> sql_filter1 = (EV.engine.comuni.provincia == 'BO')
            >>> sql_filter2 = (EV.engine.comuni.comune.like('Gal%'))
            >>> EV.comuni([sql_filter1, sql_filter2])
            [MappedComuni(comune_id=4065,comune=u'Galliera',...http://www.comune.galliera.bo.it/')]
        
        
        You can find more at http://www.sqlalchemy.org/docs/05/ormtutorial.html#querying
        
        Now some more advanced querying - getting all comuni for provincia::
        
            >>> EV.comuni4provincia('BO')
            [MappedComuni(comune_id=4038,comune=u"Anzola dell'Emilia"...u'http://www.comune.zolapredosa.bo.it/')]
        
        and all province for given regione::
        
            >>> EV.province4regione('03') #Lombardia
            [MappedProvince(provincia=u'Bergamo',...sito_provincia=u'http://www.provincia.va.it/')]
        
        
        Finally we can also map vocabulary to DisplayList (for Archetypes use case)::
        
            >>> from redturtle.entiterritoriali.vocabulary import mapDisplayList
            >>> mapDisplayList(EV.allRegioni())
            [(u'13', u'Abruzzo'), (u'17', u'Basilicata'),...(u'05', u'Veneto')]
        
        
        But it should work also for different enti in one vocabulary, like here::
        
            >>> regione1 = EV.regione('Lombardia')
            >>> comune1 = EV.comune('Ferrara')
            >>> enti = [regione1,comune1]
            >>> mapDisplayList(enti)
            [(u'03', u'Lombardia'), (u'038008', u'Ferrara')]
        
        
        Credits
        =======
        
        Developed with the support of  `Regione Emilia Romagna`__;  Regione Emilia Romagna supports the `PloneGov initiative`__.
        
        __ http://www.regione.emilia-romagna.it/
        __ http://www.plonegov.it/
        
        
        Authors
        =======
        
        This product was developed by RedTurtle Technology team.
        
        .. image:: http://www.redturtle.net/redturtle_banner.png
            :alt: RedTurtle Technology Site
            :target: http://www.redturtle.it/
        
        
        Data credits
        ------------
        * `Italian National Institute of Statistics`__
        
        .. image:: http://en.istat.it/images/istat.gif
            :alt: ISTAT - logo
        
        __ http://en.istat.it/
        
        HISTORY
        =========
        
        0.3.1 (2014-11-07)
        ------------------
        
        - Updated with new italian districts [cekk]
        
        
        0.3 (2013-12-16)
        ----------------
        
        - compatibility with SQLAlchemy 0.8 [amleczko]
        
        
        0.2.2 (2013-11-12)
        ------------------
        
        - fixed site url for Zerba [cekk]
        
        
        0.2.1 (2013-08-20)
        ------------------
         * fixed codice istat for Casteldelci, Maiolo, Novafeltria, Pennabilli, San Leo, Sant'Agata Feltria, Talamello [cekk]
        
        0.2 (2011-08-03)
        ----------------
         * cleanup, docs update [amleczko]
        
        0.1.10 (2011-07-08)
        -------------------
         * fixed bertinoro website [cekk]
        
        0.1.9 (2011-05-16)
        ------------------
         * fixed casalfiumanese website [cekk]
        
        0.1.8 (2011-04-18)
        ------------------
         * fixed some other websites [cekk]
        
        0.1.7 (2011-04-08)
        ------------------
         * fixed some other websites [cekk]
        
        0.1.6 (2011-03-28)
        ------------------
         * fixed other websites for some comuni [cekk]
        
        0.1.5 (2011-03-21)
        ------------------
         * added new websites for some comuni [cekk]
        
        0.1.4 (2010-09-01)
        ------------------
         * declaring egg zip unsafe, otherwise it is not possible to access sqllite db [alert]
        
        0.1.3 (2010-08-31)
        ------------------
         * UTF-8 fixes [keul]
        
        0.1.2 (2009-10-09)
        ------------------
         * move Casteldelci, Maiolo, Novafeltria, Pennabilli, San Leo, 
           Sant'Agata Feltria and Talamello to Rimini province [amleczko] 
        
        0.1.1 (2009-10-06)
        ------------------
         * SQLite3Vocab is now singleton - you should always use 
           'from redturtle.entiterritoriali import EntiVocabulary' not SQLite3Vocab directly
           [amleczko]
        
        0.1.0 (2009-07-07)
        ------------------
         * Refactoring [amleczko]
        
        0.0.4 (2009-06-24)
        ------------------
         * Add Monza e della Brianza province [amleczko]
        
        0.0.3 (2009-06-11)
        ------------------
         * Add EntiCriteria (topic criteria) and all functionality behind it [amleczko]
        
        0.0.2 (2009-05-24)
        ------------------
         * Add the "comuniByLetter" method used to catch comuni that start with one or more character [lucabel]
        
        0.0.1 (2009-04-20)
        ------------------
         * First release [amleczko]
        
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Framework :: Plone
Classifier: Development Status :: 5 - Production/Stable
Classifier: Topic :: Software Development :: Libraries :: Python Modules
