{ "info": { "author": "Gregory Oschwald", "author_email": "goschwald@maxmind.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Environment :: Web Environment", "Intended Audience :: Developers", "Intended Audience :: System Administrators", "License :: OSI Approved :: Apache Software License", "Programming Language :: Python", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7", "Topic :: Internet", "Topic :: Internet :: Proxy Servers" ], "description": "========================\nMaxMind DB Python Module\n========================\n\nDescription\n-----------\n\nThis is a Python module for reading MaxMind DB files. The module includes both\na pure Python reader and an optional C extension.\n\nMaxMind DB is a binary file format that stores data indexed by IP address\nsubnets (IPv4 or IPv6).\n\nInstallation\n------------\n\nIf you want to use the C extension, you must first install `libmaxminddb\n`_ C library installed before\ninstalling this extension. If the library is not available, the module will\nfall-back to a pure Python implementation.\n\nTo install maxminddb, type:\n\n.. code-block:: bash\n\n $ pip install maxminddb\n\nIf you are not able to use pip, you may also use easy_install from the\nsource directory:\n\n.. code-block:: bash\n\n $ easy_install .\n\nUsage\n-----\n\nTo use this module, you must first download or create a MaxMind DB file. We\nprovide `free GeoLite2 databases\n`_. These files must be\ndecompressed with ``gunzip``.\n\nAfter you have obtained a database and imported the module, call\n``open_database`` with a path, or file descriptor (in the case of MODE_FD),\nto the database as the first argument. Optionally, you may pass a mode as the\nsecond argument. The modes are exported from ``maxminddb``. Valid modes are:\n\n* MODE_MMAP_EXT - use the C extension with memory map.\n* MODE_MMAP - read from memory map. Pure Python.\n* MODE_FILE - read database as standard file. Pure Python.\n* MODE_MEMORY - load database into memory. Pure Python.\n* MODE_FD - load database into memory from a file descriptor. Pure Python.\n* MODE_AUTO - try MODE_MMAP_EXT, MODE_MMAP, MODE_FILE in that order. Default.\n\n**NOTE**: When using ``MODE_FD``, it is the *caller's* responsibility to be\nsure that the file descriptor gets closed properly. The caller may close the\nfile descriptor immediately after the ``Reader`` object is created.\n\nThe ``open_database`` function returns a ``Reader`` object. To look up an IP\naddress, use the ``get`` method on this object. The method will return the\ncorresponding values for the IP address from the database (e.g., a dictionary\nfor GeoIP2/GeoLite2 databases). If the database does not contain a record for\nthat IP address, the method will return ``None``.\n\nIf you wish to also retrieve the prefix length for the record, use the\n``get_with_prefix_len`` method. This returns a tuple containing the record\nfollowed by the network prefix length associated with the record.\n\nExample\n-------\n\n.. code-block:: pycon\n\n >>> import maxminddb\n >>>\n >>> reader = maxminddb.open_database('GeoLite2-City.mmdb')\n >>>\n >>> reader.get('1.1.1.1')\n {'country': ... }\n >>>\n >>> reader.get_with_prefix_len('1.1.1.1')\n ({'country': ... }, 24)\n >>>\n >>> reader.close()\n\nExceptions\n----------\n\nThe module will return an ``InvalidDatabaseError`` if the database is corrupt\nor otherwise invalid. A ``ValueError`` will be thrown if you look up an\ninvalid IP address or an IPv6 address in an IPv4 database.\n\nRequirements\n------------\n\nThis code requires Python 2.7+ or 3.5+. Older versions are not supported. The C\nextension requires CPython. The pure Python implementation has been tested with\nPyPy.\n\nOn Python 2, the `ipaddress module `_ is\nrequired.\n\nVersioning\n----------\n\nThe MaxMind DB Python module uses `Semantic Versioning `_.\n\nSupport\n-------\n\nPlease report all issues with this code using the `GitHub issue tracker\n`_\n\nIf you are having an issue with a MaxMind service that is not specific to this\nAPI, please contact `MaxMind support `_ for\nassistance.", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://www.maxmind.com/", "keywords": "", "license": "Apache License, Version 2.0", "maintainer": "", "maintainer_email": "", "name": "maxminddb", "package_url": "https://pypi.org/project/maxminddb/", "platform": "", "project_url": "https://pypi.org/project/maxminddb/", "project_urls": { "Homepage": "http://www.maxmind.com/" }, "release_url": "https://pypi.org/project/maxminddb/1.5.1/", "requires_dist": null, "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*", "summary": "Reader for the MaxMind DB format", "version": "1.5.1" }, "last_serial": 5898169, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "b598aacf3889ac78f3ad357fa0823213", "sha256": "01606b2dec9dcb05605be210aed03dd4e0a792bd26ba8a0c2e93a94b28af198b" }, "downloads": -1, "filename": "maxminddb-0.1.0.tar.gz", "has_sig": false, "md5_digest": "b598aacf3889ac78f3ad357fa0823213", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 24131, "upload_time": "2013-10-02T20:12:37", "url": "https://files.pythonhosted.org/packages/55/af/8d7786d527fe25a8b83f8a051cc193b28c21ab603084d26dd6955e9d939a/maxminddb-0.1.0.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "eea8e687628b525609ece943f27951e7", "sha256": "3b5a52bd0b3a1fdd8b7d52c792cd2668d4ed0ec8edb13677575ba806fe6c3052" }, "downloads": -1, "filename": "maxminddb-0.1.1.tar.gz", "has_sig": false, "md5_digest": "eea8e687628b525609ece943f27951e7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 1191185, "upload_time": "2013-10-04T00:10:30", "url": "https://files.pythonhosted.org/packages/de/17/60b8b913368db5519ea5c313f487c1921baf25691f4646fbb40f6744c1d8/maxminddb-0.1.1.tar.gz" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "03a863a4ec5026ad079512d2c81506a8", "sha256": "9b82e9ee5efc703be65967e8cfed77c4c18242e3e59b5ce60a8c24c25e79bd8b" }, "downloads": -1, "filename": "maxminddb-0.2.0.tar.gz", "has_sig": false, "md5_digest": "03a863a4ec5026ad079512d2c81506a8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 1191354, "upload_time": "2013-10-15T17:49:20", "url": "https://files.pythonhosted.org/packages/63/9d/6ad9b9fc5751c4270e4f633f9c9b86e761fefa1df61a557d60d145dd3e9a/maxminddb-0.2.0.tar.gz" } ], "0.2.1": [ { "comment_text": "", "digests": { "md5": "b582acbc62d0e8767df4dcd60df56e74", "sha256": "32a946100178bd90db7393738240db9928facae5ebd229279a52e5e9e7af6b84" }, "downloads": -1, "filename": "maxminddb-0.2.1.tar.gz", "has_sig": false, "md5_digest": "b582acbc62d0e8767df4dcd60df56e74", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 1191417, "upload_time": "2013-12-18T18:45:27", "url": "https://files.pythonhosted.org/packages/20/cc/970356441f10767438845ae9aa88402654cde34e8bfd5f2534eaeafb979d/maxminddb-0.2.1.tar.gz" } ], "0.3.0": [ { "comment_text": "", "digests": { "md5": "da24e6ada9a51230dd643a79292273b2", "sha256": "4cdd2ede0928f3b1b55d5e7c0c420124bf6bb36c6e5d06009fc75d98f46e02d6" }, "downloads": -1, "filename": "maxminddb-0.3.0.tar.gz", "has_sig": false, "md5_digest": "da24e6ada9a51230dd643a79292273b2", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 1196715, "upload_time": "2014-02-11T23:28:52", "url": "https://files.pythonhosted.org/packages/37/18/b39513bdc278836d09505b8ae591a85843a6524aeede91f3c4537d1b520c/maxminddb-0.3.0.tar.gz" } ], "0.3.1": [ { "comment_text": "", "digests": { "md5": "149a4f4e0e685ebaa31b149bfdeaa5b1", "sha256": "4e1392b2a22392f27c4408c171a4a67c8a8e486013fd8e9aadb1b4e8c5ef680a" }, "downloads": -1, "filename": "maxminddb-0.3.1.tar.gz", "has_sig": false, "md5_digest": "149a4f4e0e685ebaa31b149bfdeaa5b1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 1200063, "upload_time": "2014-02-12T02:42:40", "url": "https://files.pythonhosted.org/packages/9f/c8/0b754e1fb10c6bc111e2ef134c36d7293cb5815c5782873eefe1e7877990/maxminddb-0.3.1.tar.gz" } ], "0.3.2": [ { "comment_text": "", "digests": { "md5": "28af216b83355388b8573be3c779d8f7", "sha256": "1ab82e5f78c59ef849a90a6c71b5909275f511be9f69618738703d082e6302cf" }, "downloads": -1, "filename": "maxminddb-0.3.2.tar.gz", "has_sig": false, "md5_digest": "28af216b83355388b8573be3c779d8f7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 1171567, "upload_time": "2014-03-28T21:32:47", "url": "https://files.pythonhosted.org/packages/51/40/bf2be22d8ce04c63d9899fd75f42c1957fcce998b6aa3773444a6c18e98f/maxminddb-0.3.2.tar.gz" } ], "0.3.3": [ { "comment_text": "", "digests": { "md5": "36e1ca4e46e3220aa6a2aee1b58d9d88", "sha256": "d207434cb16030e877e19a268495f78e37f8de6588ea3ffc22f977a28dfa35fd" }, "downloads": -1, "filename": "maxminddb-0.3.3.tar.gz", "has_sig": false, "md5_digest": "36e1ca4e46e3220aa6a2aee1b58d9d88", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 1171870, "upload_time": "2014-04-09T20:39:16", "url": "https://files.pythonhosted.org/packages/e7/bb/b2a671d844b3bff9529438fd46d6c7634dfa8e3c7fe934628359351e8b5f/maxminddb-0.3.3.tar.gz" } ], "1.0.0": [ { "comment_text": "", "digests": { "md5": "4dd086c49e337f741dd12898d029a7c9", "sha256": "3270e0ed0549fac83d9a7d1c435edbdfc674f9ced54612578a5706f5abd7562d" }, "downloads": -1, "filename": "maxminddb-1.0.0.tar.gz", "has_sig": false, "md5_digest": "4dd086c49e337f741dd12898d029a7c9", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 1172024, "upload_time": "2014-09-22T16:11:26", "url": "https://files.pythonhosted.org/packages/e9/a8/bca85694a49895a9f33fd0961bccfcdecaa1360b52edc42f91e3f57045a1/maxminddb-1.0.0.tar.gz" } ], "1.1.0": [ { "comment_text": "", "digests": { "md5": "4fa25ce94194530b7d41c2836fdd9964", "sha256": "356392ffe787afc2ebbf6f81b341b5fae7d2cf0d2bf069ba182f65a2fed244e4" }, "downloads": -1, "filename": "maxminddb-1.1.0.tar.gz", "has_sig": false, "md5_digest": "4fa25ce94194530b7d41c2836fdd9964", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 1174738, "upload_time": "2014-12-09T18:49:59", "url": "https://files.pythonhosted.org/packages/04/4c/88577ae413a874e604c9ecd75c4334dace025804660c42e7a1a61ad11a73/maxminddb-1.1.0.tar.gz" } ], "1.1.1": [ { "comment_text": "", "digests": { "md5": "70a6d2a4b70f08e5b509fbb83f239795", "sha256": "cfb6361593e2bf9dc57bfd39d57eb2f14e3e461cee333ac2ffedb0f873f797cd" }, "downloads": -1, "filename": "maxminddb-1.1.1.tar.gz", "has_sig": false, "md5_digest": "70a6d2a4b70f08e5b509fbb83f239795", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 1174944, "upload_time": "2014-12-10T15:45:45", "url": "https://files.pythonhosted.org/packages/01/88/422b8189bd4aa948011fb01beb9b256c0d1db313061e2c459f476a273bad/maxminddb-1.1.1.tar.gz" } ], "1.2.0": [ { "comment_text": "", "digests": { "md5": "2c5b4b602568b578ec1f7ef5cd89b681", "sha256": "00bf6c469a11316b052f732ab326363acadb6b3bd610eabfb479f4621baffab8" }, "downloads": -1, "filename": "maxminddb-1.2.0.tar.gz", "has_sig": false, "md5_digest": "2c5b4b602568b578ec1f7ef5cd89b681", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 1273673, "upload_time": "2015-04-07T22:18:28", "url": "https://files.pythonhosted.org/packages/51/3d/d2208ae2fc3b1691ece233cda966d7ec26e81170294fde4f19f57d4f696e/maxminddb-1.2.0.tar.gz" } ], "1.2.1": [ { "comment_text": "", "digests": { "md5": "c530f9aede2748b59d07eeebb7e7448e", "sha256": "b7f845e0bfb8ee05a805b796790414d75329a71d25a8089c54726629cf148684" }, "downloads": -1, "filename": "maxminddb-1.2.1.tar.gz", "has_sig": false, "md5_digest": "c530f9aede2748b59d07eeebb7e7448e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 1349423, "upload_time": "2016-06-10T15:59:02", "url": "https://files.pythonhosted.org/packages/9d/b0/eaad0edc7570e568e713730f9bc2f40888c1a25f96dc6bee0e7413b0025a/maxminddb-1.2.1.tar.gz" } ], "1.2.2": [ { "comment_text": "", "digests": { "md5": "eba5d26eb3c0ac39094464d95bb73b55", "sha256": "b97c4b410b91cacfbd4a9b09cd64f7f3961b65133f80684534a9419753b2c77c" }, "downloads": -1, "filename": "maxminddb-1.2.2.tar.gz", "has_sig": false, "md5_digest": "eba5d26eb3c0ac39094464d95bb73b55", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 1350193, "upload_time": "2016-11-21T22:31:33", "url": "https://files.pythonhosted.org/packages/81/02/12d28bb15db17a6f6c729dfa3d594d84ba08615edb1d8b11d7bb425a7bd4/maxminddb-1.2.2.tar.gz" } ], "1.2.3": [ { "comment_text": "", "digests": { "md5": "6235e2c036a661511e10964d562f1b10", "sha256": "585905793aab72b0462b06205459089358a0ee6f47c426097e6431356d31eb4a" }, "downloads": -1, "filename": "maxminddb-1.2.3.tar.gz", "has_sig": false, "md5_digest": "6235e2c036a661511e10964d562f1b10", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 1420151, "upload_time": "2017-01-11T17:30:52", "url": "https://files.pythonhosted.org/packages/ac/d5/d676086127f869fd639417254686104f6f06d800446d280de08e92c1dd03/maxminddb-1.2.3.tar.gz" } ], "1.3.0": [ { "comment_text": "", "digests": { "md5": "3b1dac458e4d1ac6cfb4ccac50ad1787", "sha256": "972399b6d08b4cbb7889f2d2489266d18811c5ef6109cc52eb28de4102bbc4be" }, "downloads": -1, "filename": "maxminddb-1.3.0.tar.gz", "has_sig": false, "md5_digest": "3b1dac458e4d1ac6cfb4ccac50ad1787", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 1428863, "upload_time": "2017-03-13T15:58:18", "url": "https://files.pythonhosted.org/packages/f8/7a/bac498d2b7491dd8b837dff8831a7e7628db72c4b840b54743961a8f0454/maxminddb-1.3.0.tar.gz" } ], "1.4.0": [ { "comment_text": "", "digests": { "md5": "a7f2696838ba27ab74e95b2243f7dc16", "sha256": "5c10bc71b4a4d76ec90fa8587684f480bbd88a853b9d5e8abbee7683da0791eb" }, "downloads": -1, "filename": "maxminddb-1.4.0.tar.gz", "has_sig": false, "md5_digest": "a7f2696838ba27ab74e95b2243f7dc16", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 264476, "upload_time": "2018-05-25T20:02:21", "url": "https://files.pythonhosted.org/packages/6e/2b/c2d75b754617a795089f9b178ff20c7bfc63ac11222d7d44cb9dad167f79/maxminddb-1.4.0.tar.gz" } ], "1.4.1": [ { "comment_text": "", "digests": { "md5": "a472f6bb4b55e4c410412ff1389737ac", "sha256": "df1451bcd848199905ac0de4631b3d02d6a655ad28ba5e5a4ca29a23358db712" }, "downloads": -1, "filename": "maxminddb-1.4.1.tar.gz", "has_sig": false, "md5_digest": "a472f6bb4b55e4c410412ff1389737ac", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 264596, "upload_time": "2018-06-22T16:17:03", "url": "https://files.pythonhosted.org/packages/83/35/6dc423e0ff354c326849d6d878d104b44be7eec491dcf26787ab3593cd81/maxminddb-1.4.1.tar.gz" } ], "1.5.0": [ { "comment_text": "", "digests": { "md5": "87254a451ccd333fcb2f7cb75cc0a13a", "sha256": "e76be1a842c37050392254e714df3a1f63c00de5128fa604c355ba2217cee8ac" }, "downloads": -1, "filename": "maxminddb-1.5.0.tar.gz", "has_sig": false, "md5_digest": "87254a451ccd333fcb2f7cb75cc0a13a", "packagetype": "sdist", "python_version": "source", "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*", "size": 272363, "upload_time": "2019-09-27T19:50:35", "url": "https://files.pythonhosted.org/packages/3d/59/e3fdde4911df8d1c8a2e69150f6459f88f1154c9250e317defc9662a2c36/maxminddb-1.5.0.tar.gz" } ], "1.5.1": [ { "comment_text": "", "digests": { "md5": "911bdc9bb7994bfe92f88aedd7e7d2c8", "sha256": "449a1713d37320d777d0db286286ab22890f0a176492ecf3ad8d9319108f2f79" }, "downloads": -1, "filename": "maxminddb-1.5.1.tar.gz", "has_sig": false, "md5_digest": "911bdc9bb7994bfe92f88aedd7e7d2c8", "packagetype": "sdist", "python_version": "source", "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*", "size": 272429, "upload_time": "2019-09-27T21:13:15", "url": "https://files.pythonhosted.org/packages/48/6e/6e91f3ea31d08b4142b451e1959dd8964e6d5edc955d5b180de9c5f7a920/maxminddb-1.5.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "911bdc9bb7994bfe92f88aedd7e7d2c8", "sha256": "449a1713d37320d777d0db286286ab22890f0a176492ecf3ad8d9319108f2f79" }, "downloads": -1, "filename": "maxminddb-1.5.1.tar.gz", "has_sig": false, "md5_digest": "911bdc9bb7994bfe92f88aedd7e7d2c8", "packagetype": "sdist", "python_version": "source", "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*", "size": 272429, "upload_time": "2019-09-27T21:13:15", "url": "https://files.pythonhosted.org/packages/48/6e/6e91f3ea31d08b4142b451e1959dd8964e6d5edc955d5b180de9c5f7a920/maxminddb-1.5.1.tar.gz" } ] }