django-siruta 0.3.0

A bunch of form fields and utilities for Romanian counties and localities using SIRUTA codes.

docs
tests
package

A bunch of form fields and utilities for Romanian counties and localities using SIRUTA codes.

• Free software: BSD 2-Clause License

Data:

Localities: https://data.gov.ro/dataset/activity/siruta-2024

Counties: https://data.gov.ro/dataset/activity/siruta

Form fields are designed to pass around integers (assuming you will have the most compact storage).

Form widgets use selectize. JS/CSS not bundled or included in media - you are free to load those however you like.

Installation

pip install django-siruta

You can also install the in-development version with:

pip install https://github.com/ionelmc/django-siruta/archive/main.zip

Documentation

Add siruta to your INSTALLED_APPS and use something like this:

class DemoForm(forms.Form):
    county = CountyField(label="Delivery county")
    locality = LocalityField(label="Delivery locality")

    billing_county = CountyField()
    billing_locality = LocalityField(county_field="billing_county")

With bootstrap5 would look like this:

Complete code: https://github.com/ionelmc/django-siruta/blob/main/tests/testproject/views.py

Sphinx docs: https://django-siruta.readthedocs.io/

Development

To run all the tests run:

tox

Note, to combine the coverage data from all the tox environments run:

Windows	set PYTEST_ADDOPTS=--cov-append tox
Other	PYTEST_ADDOPTS=--cov-append tox

Changelog

v0.3.0 (2026-04-10)

• Changed minimum Python to 3.10.

• Added mapping of ANAF locality ids in siruta.anaf.

• Added siruta.data.LOCALITY_ALIASES - mapping parents to most important child. This is not ideal but ANAF uses the parent instead of the child for company data.

v0.2.1 (2025-10-19)

• Move msgspec to optional dependencies (it has some big issues on 3.14). It’s not really optional but perhaps a fork may work better on 3.14.

v0.2.0 (2025-10-13)

• Replace siruta.extras.LOCALITIES_BY_NAME with siruta.extras.LOCALITIES_BY_COUNTY_ID_BY_NAME (to avoid name collisions).

v0.1.1 (2025-10-10)

• First release on PyPI.