Skip to main content

The common location package for Catalpa's projects

Project description


The common location package used for catalpa's projects. A hierarchical tree of geographical locations supporting location type and GIS data.


The admin site is set up to use Modeltranslations (if available in the parent app)

For modeltranslations, please remember to run sync_translation_fields in order to get name_en, name_tet etc. fields.


This is intended to be compatible with:

  • Django 3.1, 3.2, 4.0
  • Python 3.7, 3.8, 3.9
gh repo clone catalpainternational/simple_locations
cd simple_locations
python -m venv env
. env/bin/activate
pip install pip-tools
pip-sync requirements.txt dev.txt
pre-commit install

Pre Commit

If pre-commit is installed your code will be checked before commit. This includes

  • black
  • flake8
  • isort
  • mypy

The same checks are run on push. See pytest.yaml for details on the checks being run.

New Release

For a new release, change the version property in pyproject.toml and push a git tag with the version number For instance at time of writing the version is 3.1.4 with the tag v3.1.4

See build.yaml for details on release tagging


  • Version 3.1.4

    • Migrating JSON views from openly
  • Version 3.1.3

    • Added intersects_area function
  • Version 3.1.2

    • Uses psycopg2-binary for development environment
  • Version 3.1.1

    • Added "border" fields
    • Added a model for "projected" areas in EPSG:3857
    • Added commands for border generation and
    • ./ and associated project code
  • Version 3.0.1

    • Poetry for dependency + packaging
    • Releases are automated by pushing a vx.x.x tag to github
  • Version 3.0 (not on pypi)

    • Code style changes (black, flake8)
  • Version 2.77

    • first pass of updates for Python 3.8+ and Django 3.1+
  • Version 2.75

    • add modeltranslations
  • Version 2.74

    • fix CORS issue breaking maps in AreaAdmin
    • typo in AreaChildrenInline
  • Version 2.73

    • add an inline showing children to the Area admin
    • make the geom field optional
  • Version 2.72

    • optionally use django_extensions' ForeignKeyAutocompleteAdmin in admin interface

Manually Uploading a new version to PyPi

Bump pyproject.toml Then run poetry build and poetry publish

poetry build
poetry publish

See the file build.yml for the workflow

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

simple_locations-4.0.0.tar.gz (49.9 kB view hashes)

Uploaded source

Built Distribution

simple_locations-4.0.0-py3-none-any.whl (66.5 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page