Skip to main content

A Django-based Countries data toolkit. Part of the Valuehorizon application ecosystem.

Project description

A Django-based Countries data toolkit. It also includes documentation, test coverage and the official ISO-3166 seed data for all current (and former) countries. This app is a part of the Valuehorizon application ecosystem.

Why a new Countries app?

This app is not a fork of the excellent django-countries app. The aim of valuehorizon-countries is to provide similar functionality but to actually include a Country model. From an architectural point-of-view, we prefer this method for the following reasons:

  • Country data are constantly evolving. ISO-3166 aims to keep track of all recognized countries and their current status. For example, in 1991, the country known as Yugoslavia split into several states. We want to be able to keep a “Yugoslavia” object, but set its status to something “non-current”;
  • We want to keep the aforementioned country data as up-to-date as possible. Valuehorizon provides an API to do so;
  • We want to make ORM queries on that data; and
  • We want the data to be part of the database, and not hard-coded in our source-code. This allows us to maintain the country data without changing or adding source code.

Again, this app is not meant to replace django-countries, but simply to provide similar functionality via Django models and not a field.


Please file bugs and send pull requests to the GitHub repository and issue tracker.

Commercial Support

This project is sponsored by Valuehorizon. If you require assistance on your project(s), please contact us:

Project details

Download files

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

Files for valuehorizon-countries, version 0.2.1
Filename, size File type Python version Upload date Hashes
Filename, size valuehorizon_countries-0.2.1-py2-none-any.whl (13.7 kB) File type Wheel Python version 2.7 Upload date Hashes View
Filename, size valuehorizon-countries-0.2.1.tar.gz (10.4 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page