django-cities-light -- Simple django-cities alternative

This add-on provides models and commands to import country, region/state, and city data in your database.

The data is pulled from GeoNames and contains cities, regions/states and countries.

Spatial query support is not required by this application.

This application is very simple and is useful if you want to make a simple address book for example. If you intend to build a fully featured spatial database, you should use django-cities.

Requirements:

Python 2.7 or 3.3,
Django 1.4 or 1.5 or 1.6,
MySQL or PostgreSQL or SQLite.
django-south is optionnal, but recommended.

Upgrade

See CHANGELOG.

Installation

Install django-cities-light:

pip install django-cities-light

Or the development version:

pip install -e git+git@github.com:yourlabs/django-cities-light.git#egg=cities_light

Add cities_light to your INSTALLED_APPS.

Now, run syncdb, it will only create tables for models that are not disabled:

./manage.py syncdb

Note that this project supports django-south. It is recommended that you use south too else you're on your own for migrations/upgrades.

Danger

Since version 2.4.0, django-cities-light uses django migrations by default. This means that django-south users should add to settings:

SOUTH_MIGRATION_MODULES = {
    'cities_light': 'cities_light.south_migrations',
}

Data update

Finally, populate your database with command:

./manage.py cities_light

This command is well documented, consult the help with:

./manage.py help cities_light

Resources

You could subscribe to the mailing list ask questions or just be informed of package updates.

About

A simple app providing three models: Country, Region and City model. Also provided, a command to insert or update data from geonames database dumps. Status: stable.

http://django-cities-light.rtfd.org/

MIT License