Metadata-Version: 1.0
Name: redturtle.entiterritoriali
Version: 0.2
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')]
        
        
        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.2 - 2011/08/03
        ----------------
         * cleanup, docs update [amleczko]
        
        0.1.10 - 2011/07/08
        -------------------
         * fixed bertinoro website [andrea]
        
        0.1.9 - 2011/05/16
        ------------------
         * fixed casalfiumanese website [andrea]
        
        0.1.8 - 2011/04/18
        ------------------
         * fixed some other websites [andrea]
        
        0.1.7 - 2011/04/08
        ------------------
         * fixed some other websites [andrea]
        
        0.1.6 - 2011/03/28
        ------------------
         * fixed other websites for some comuni [andrea]
        
        0.1.5 - 2011/03/21
        ------------------
         * added new websites for some comuni [andrea]
        
        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
