Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Django Globalisation Tools

Project Description

Django Globalisation

What is it?

  • A Django app that helps in with internationalisation and localisation.

What problem does it solve?

  • Guess the origin country of the request.
  • Return the currency a country uses.
  • Fetch the language code.
  • Does not use commercial databases, uses original data sources.
  • Both IPv4 and IPv6.
  • Has a reasonable model layout.

How do I install it?

$ pip install django-g11n

Use django-integrator to integrate this app to your django instance, alternatively you can do it the common manual way.

How do I use it?

# To fill initial data use the command
$ python g11n_setup
# To guess someones IP
$ python guess_tld_by_ip
# To find out what the currency is most likely associated with an tld
$ python currency_by_tld gb

Of course you most likely want to use it via a request instance, for that have a look at, this has the following functions:

  • ipaddress(request)
  • guess_country(request)
  • guess_language(request)
  • guess_currency(request)
  • guess_country_language_currency(request)

The will return data as you may guess from the functions name.

However since all the data is inside models, it is also usuable in an interactive shell session like so:

In [1]: from import iprange_by_ip

In [2]: iprange = iprange_by_ip('')

In [3]: iprange.__dict__
{'_state': <django.db.models.base.ModelState at 0x7f581dd9f9e8>,
 'broadcast_hex': '000000000000000000000000c23c3fff',
 'dts_delete': None,
 'dts_insert': datetime.datetime(2016, 10, 10, 10, 19, 55, 241150, tzinfo=<UTC>),
 'dts_update': None,
 'id': 58935,
 'identifier': 'rigb4_0_24_c23c3fff_0_24_c23c0000',
 'ipv': 4,
 'network_hex': '000000000000000000000000c23c0000',
 'reference_id': 235,
 'regional_nic': 'ripencc',
 'tld': 'GB'}

In [4]: country = iprange.reference

In [5]: country.__dict__
{'_state': <django.db.models.base.ModelState at 0x7f581dd9fda0>,
 'code_2': 'GB',
 'code_3': 'GBR',
 'dts_delete': None,
 'dts_insert': datetime.datetime(2016, 10, 10, 10, 18, 31, 274177, tzinfo=<UTC>),
 'dts_update': None,
 'id': 235,
 'iso3166': True,
 'numeric': 826,
 'obsolete': False}

In [6]: country.languagecountry_set.all()
Out[6]: [<LanguageCountry: en-GB>]

In [7]: language_country = country.languagecountry_set.all()[0]

In [8]: language_country.language.__dict__
{'_state': <django.db.models.base.ModelState at 0x7f581dd3cba8>,
 'bibliographic': 'eng',
 'code_a2': 'en',
 'dts_delete': None,
 'dts_insert': datetime.datetime(2016, 10, 10, 10, 20, 1, 110024, tzinfo=<UTC>),
 'dts_update': None,
 'english': 'English',
 'french': 'anglais',
 'id': 123,
 'iso639_2': True,
 'obsolete': False,
 'terminologic': ''}

In [9]: country.countryname_set.all()
Out[9]: [<CountryName: United Kingdom>, <CountryName: United Kingdom of Great Britain and Northern Ireland>]

In [10]: country.countryname_set.all()[1].__dict__
{'_country_cache': <Country: GB>,
 '_state': <django.db.models.base.ModelState at 0x7f581dd43d30>,
 'country_id': 235,
 'default': False,
 'dts_delete': None,
 'dts_insert': datetime.datetime(2016, 10, 10, 10, 18, 31, 337353, tzinfo=<UTC>),
 'dts_update': None,
 'id': 248,
 'iso3166': True,
 'language_id': 42,
 'value': 'United Kingdom of Great Britain and Northern Ireland'}

In [11]: country.currency_set.all()
Out[11]: [<Currency: GBP 826>]

In [12]: country.currency_set.all()[0].__dict__
{'_reference_cache': <Country: GB>,
 '_state': <django.db.models.base.ModelState at 0x7f581dd49940>,
 'code': 'GBP',
 'decimals': 2,
 'default': True,
 'dts_delete': None,
 'dts_insert': datetime.datetime(2016, 10, 10, 10, 18, 31, 670707, tzinfo=<UTC>),
 'dts_update': None,
 'id': 754,
 'is_fund': False,
 'iso4217': True,
 'name': 'Pound Sterling',
 'numeric': 826,
 'reference_id': 235}

In [13]: country.region_set.all()
Out[13]: [<Region: 826 United Kingdom of Great Britain and Northern Ireland>]

In [14]: region = country.region_set.all()[0]

In [15]: region.__dict__
{'_reference_cache': <Country: GB>,
 '_state': <django.db.models.base.ModelState at 0x7f581dd4e4a8>,
 'dts_delete': None,
 'dts_insert': datetime.datetime(2016, 10, 10, 10, 20, 1, 369095, tzinfo=<UTC>),
 'dts_update': datetime.datetime(2016, 10, 10, 10, 20, 5, 295071, tzinfo=<UTC>),
 'english': 'United Kingdom of Great Britain and Northern Ireland',
 'id': 116,
 'numeric': '826',
 'obsolete': False,
 'reference_id': 235,
 'unsd_m49': True}

In [16]: def print_regions(region):
   ....:     while True:
   ....:         print(region.numeric, ' - ', region.english)
   ....:         chains = region.chains_region_is_lower.all()
   ....:         if chains.count() == 0:
   ....:             break
   ....:         region = chains[0].upper

In [17]: print_regions(region)
826  -  United Kingdom of Great Britain and Northern Ireland
154  -  Northern Europe
150  -  Europe
001  -  World

In [18]:

As you can see above that most models refer back to the Country model via the ‘reference’ field, this is done because most tables are filled from outside source. For country, language and currencies we use ISO, for regions we use UN-SD M49 and the ipranges are downloaded from the regional NIC’s. Since all of them have slightly different representation of the country names, the country names in each table has been preserved on import and after import the system tries to find the appropriate foreign relationship to the Country table.

What license is this?

Two-clause BSD

How can I get support?

Please use the repo’s bug tracker to leave behind any questions, feedback, suggestions and comments. I will handle them depending on my time and what looks interesting. If you require guaranteed support please contact me via e-mail so we can discuss appropriate compensation.

Signing Off

Is my work helpful or valuable to you? You can repay me by donating via:


Thank you!

Release History

Release History

This version
History Node

History Node

History Node

History Node

History Node

History Node

History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
Django-G11N- (28.9 kB) Copy SHA256 Checksum SHA256 Source Oct 10, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting