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

Library of ISO 3166, MCC and MNC codes

Project Description

Contains the country codes from ISO 3166-1 based on the code based on:

https://github.com/deactivated/python-iso3166/

But also has the MCC and MNC codes based on the Wikipedia page:

http://en.wikipedia.org/wiki/List_of_mobile_country_codes

As well as the latest released listing from ITU:

http://www.itu.int/dms_pub/itu-t/opb/sp/T-SP-E.212B-2014-PDF-E.pdf

Note that MCC codes for a country can be:

  • None (no MCC code)
  • a string (where a country has one code)
  • a tuple of strings (where a country has more than one code)

Installation

$ pip install mobile-codes

Usage

>>> import mobile_codes

Lookup by Mobile Country Code (MCC):

>>> mobile_codes.mcc("648")
[Country(name=u'Zimbabwe', alpha2='ZW', alpha3='ZWE', numeric='716', mcc='648')]
>>> mobile_codes.mcc("311")
[Country(name=u'Guam', alpha2='GU', alpha3='GUM', numeric='316', mcc=('310', '311')),
 Country(name=u'United States', alpha2='US', alpha3='USA', numeric='840', mcc=('310', '311', '313', '316'))]
>>> mobile_codes.mcc("313")
[Country(name=u'United States', alpha2='US', alpha3='USA', numeric='840', mcc=('310', '311', '313', '316'))]

Lookup by name, alpha2, alpha3 (all case insensitive):

>>> mobile_codes.alpha3("CAN")
Country(name=u'Canada', alpha2='CA', alpha3='CAN', numeric='124', mcc='302')
>>> mobile_codes.alpha2("CA")
Country(name=u'Canada', alpha2='CA', alpha3='CAN', numeric='124', mcc='302')
>>> mobile_codes.name('canada')
Country(name=u'Canada', alpha2='CA', alpha3='CAN', numeric='124', mcc='302')

Lookup operators by mcc (returns a list of all operators):

>>> mobile_codes.operators('302')
[Operator(mcc='302', mnc='220', brand='Telus', operator=u'Telus'),
 Operator(mcc='302', mnc='221', brand='Telus', operator=u'Telus'),...

Lookup operator by mcc and Mobile Network Code (MNC):

>>> mobile_codes.mcc_mnc('722', '070')
Operator(mcc='722', mnc='070', brand='Movistar', operator=u'Movistar')

All lookups raise a KeyError if the requested value is not found.

Development

If you want to do development on the library, follow these steps:

  • Create a virtualenv
  • bin/pip install -r requirements/tests.txt
  • bin/nosetests -s mobile_codes

Contributors

  • Hanno Schlichting (hannosch)
  • Jared Kerim (jaredkerim)

Changes

0.6 - 2014-10-14

  • Move network and country constants into JSON files
  • Incorporate ITU data for operators

0.5 - unreleased

0.4 - 2014-06-13

  • Declare compatibility with Python 3.4.
  • Fix a number of country to mcc mappings.
  • Issue #9: Fix typo in mcc for Yemen.
  • Issue #10: Allow 310 as a mcc value for Puerto Rico.

0.3 - 2014-05-14

  • Changed mcc API to always return a list, possibly empty, possibly containing multiple countries.

0.2.2 - 2014-04-22

  • Some tests, docs changes and updates to the records, thanks hannosch.

0.2 - 2013-10-26

  • Added in MNC codes and a script to scrape them.

0.1 - 2013-10-22

  • Added in MCC codes and a lookup.
  • Made completely lazy, no records generated or indexed until first asked for.
Release History

Release History

This version
History Node

0.7

History Node

0.4

History Node

0.3

History Node

0.2.2

History Node

0.2.1

History Node

0.2

History Node

0.1.1

History Node

0.1

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
mobile-codes-0.7.tar.gz (82.0 kB) Copy SHA256 Checksum SHA256 Source Nov 4, 2014

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