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.

See CHANGELOG.

Install django-cities-light:

pip install django-cities-light

Or the development version:

pip install -e [email protected]: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.

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

Finally, populate your database with command:

./manage.py cities_light

This command is well documented, consult the help with:

./manage.py help cities_light

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

• Mailing list graciously hosted by Google
• Git graciously hosted by GitHub,
• Documentation graciously hosted by RTFD,
• Package graciously hosted by PyPi,
• Continuous integration graciously hosted by Travis-ci