Metadata-Version: 2.1
Name: sirutalib
Version: 1.2.1
Summary: Work with the Romanian settlement database, SIRUTA
Home-page: http://proiecte.strainu.ro/siruta/
Author: Andrei Cipu
Author-email: siruta@strainu.ro
License: 3-clause BSD
Platform: UNKNOWN
Description-Content-Type: text/markdown

[This project](http://proiecte.strainu.ro/siruta/) aims to create a
library that can import a
[SIRUTA](http://colectaredate.insse.ro/senin/classifications.htm?selectedClassification=&action=&classificationName=SIRUTA&classificationVersion=Versiune)
database and offer simple access to the different elements of the
database.

# What is SIRUTA?

[SIRUTA](http://colectaredate.insse.ro/senin/classifications.htm?selectedClassification=&action=&classificationName=SIRUTA&classificationVersion=Versiune)
is the official clasification of the Romanian towns and villages
(hereafter called entity). It is maintained by the [National Statistics
Institute](http://www.insse.ro/).

It gives every entity a 6 digit code (5-digit unique code and 1-digit
checksum). The whole classification is hierachical, with Romania (the
country) as root, then 40 counties + Bucharest. Bucharest contains the
city of Bucharest, which in turn contains 6 sectors. Every county has
municipalities, citiess and communes, and each of those is comprised of
towns and villages.

The SIRUTA archives contain detailed documentation about the whole
classification, including the algoritm for the checksum.

::: {.note}
::: {.title}
Note
:::

This library makes the assumption that SIRUTA codes shorter than 6
characters are filled with 0 to the left in order to calculate the
checksum. There are 77 codes that do not respect this assumption. Out of
those, 76 can be calculated if the code is filled with 0\'s to the
*right*. The remaining code is 9026.
:::

# Getting the library

You can either [download the tar
file](https://github.com/strainu/SIRUTA/releases/download/v1.2.1/SIRUTAlib-1.2.1.tar.gz)
([mirror](http://proiecte.strainu.ro/siruta/SIRUTAlib-1.2.1.tar.gz)) or
get the source code, as described in the
`development-label`{.interpreted-text role="ref"} section.

In both cases, you will also get a copy of the most recent SIRUTA
database in `CSV (Comma-Separated Values)`{.interpreted-text
role="abbr"} format.

# Development {#development-label}

## Dependencies

> -   a recent version of **python** is required in order to develop
>     with SIRUTAlib
> -   this library uses **Git** for source control, so you\'ll need that
>     if you want to get the full source code.
> -   if you want to build the help files, you\'ll also need **sphinx**
>     and **make** (the latter is optional)

## Getting the source

To work on the SIRUTAlib code, you only need a local repository
checkout:

    $ git clone https://github.com/strainu/SIRUTA.git
    $ cd siruta

You will find 2 python files:

:   -   `sirutalib.py` contains the actual library
    -   `testsiruta.py` contains the tests needed to check the code.

That\'s it, enjoy!

## Using the library

A simple usage example is available in the INSTALL file.

## Contributing

If you plan to contribute code to SIRUTAlib, please keep a few things in mind:

:   -   code should be formatted according to `8`{.interpreted-text
        role="pep"}
    -   tests should be written for all the new code, as long as you
        don\'t need to change class internals to test it

Then prepare a patch and submit a pull request on
[github](https://github.com/strainu/SIRUTA/issues).

For more contact options, see `contact-label`{.interpreted-text
role="ref"}.

# Feedback and contact {#contact-label}

You can register a bug, feature request or pull request on github:
<https://github.com/strainu/SIRUTA/issues>

If you want to contact the author, you can do it by emailing
`siruta [at] strainu.ro`. All the latest information is available on
[the project\'s page](http://proiecte.strainu.ro/siruta/).


