{ "info": { "author": "Randall Degges", "author_email": "r@rdegges.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Environment :: Console", "Intended Audience :: Developers", "License :: Public Domain", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7", "Programming Language :: Python :: Implementation :: CPython", "Programming Language :: Python :: Implementation :: PyPy", "Topic :: Internet", "Topic :: Software Development", "Topic :: Software Development :: Libraries", "Topic :: Software Development :: Libraries :: Python Modules", "Topic :: Utilities" ], "description": "python-simple-geoip\n===================\n\nThe simplest possible way to get IP geolocation information in Python.\n\n.. image:: https://raw.githubusercontent.com/whois-api-llc/python-simple-geoip/master/images/geoip.png\n\n.. image:: https://img.shields.io/pypi/v/simple-geoip.svg\n :alt: python-simple-geoip Release\n :target: https://pypi.python.org/pypi/simple-geoip\n\n.. image:: https://img.shields.io/travis/whois-api-llc/python-simple-geoip.svg\n :alt: python-simple-geoip Build\n :target: https://travis-ci.org/whois-api-llc/python-simple-geoip\n\n\nMeta\n----\n\n- Author: Randall Degges\n- Email: r@rdegges.com\n- Twitter: https://twitter.com/rdegges\n- Site: http://www.rdegges.com\n- Status: production ready\n\n\nPrerequisites\n-------------\n\nTo use this library, you'll need to create a free GeoIPify account:\nhttps://geoipify.whoisxmlapi.com/\n\nIf you haven't done this yet, please do so now.\n\n\nInstallation\n------------\n\nTo install ``simple-geoip`` using `pypi `_, simply run:\n\n.. code-block:: console\n\n $ pip install simple-geoip\n\nIn the root of your project directory.\n\n\nUsage\n-----\n\nOnce you have `simple-geoip` installed, you can use it to easily find the\nphysical location of a given IP address.\n\nThis library gives you access to all sorts of geographical location data that\nyou can use in your application in any number of ways.\n\n.. code-block:: python\n\n from simple_geoip import GeoIP\n\n geoip = GeoIP(\"your-api-key\");\n\n try:\n data = geoip.lookup(\"8.8.8.8\")\n except ConnectionError:\n # If you get here, it means you were unable to reach the geoipify\n # service, most likely because of a network error on your end.\n except ServiceError:\n # If you get here, it means geoipify is having issues, so the request\n # couldn't be completed :(\n except:\n # Something else happened (non-geoipify) related. Maybe you hit CTRL-C\n # while the program was running, the kernel is killing your process, or\n # something else all together.\n\n print(data)\n\nHere's the sort of data you might get back when performing a geoip lookup\nrequest:\n\n.. code-block:: json\n\n {\n \"ip\": \"8.8.8.8\",\n \"location\": {\n \"country\": \"US\",\n \"region\": \"California\",\n \"city\": \"Mountain View\",\n \"lat\": 37.40599,\n \"lng\": -122.078514,\n \"postalCode\": \"94043\",\n \"timezone\": \"-08:00\"\n }\n }\n\nBy default, this library handles retrying failed HTTP requests for you. For\ninstance: if the GeoIPify API service is currently down or having issues,\nyour request will be retried up to three consecutive times before failing.\n\n\nChangelog\n---------\n\nAll library changes in descending order.\n\n\nVersion 0.1.0\n*************\n\n**Released April 26, 2018.**\n\n- First release!\n\n\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/whois-api-llc/python-simple-geoip", "keywords": "python api client ip address public geoip service geolocation", "license": "UNLICENSE", "maintainer": "", "maintainer_email": "", "name": "simple-geoip", "package_url": "https://pypi.org/project/simple-geoip/", "platform": "", "project_url": "https://pypi.org/project/simple-geoip/", "project_urls": { "Homepage": "https://github.com/whois-api-llc/python-simple-geoip" }, "release_url": "https://pypi.org/project/simple-geoip/0.1.0/", "requires_dist": [ "backoff (>=1.0.7)", "requests (>=2.7.0)" ], "requires_python": "", "summary": "The simplest possible way to get IP geolocation information.", "version": "0.1.0" }, "last_serial": 3809341, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "be9eb1416f80ac188e04695f1d14fe89", "sha256": "a6507bd14cfbc8bf9f771fea21a535dd6402e9e25cf12f82e53c4e654417ea9a" }, "downloads": -1, "filename": "simple_geoip-0.1.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "be9eb1416f80ac188e04695f1d14fe89", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 5498, "upload_time": "2018-04-26T07:07:01", "url": "https://files.pythonhosted.org/packages/8b/da/7952f8d4cf57add80d6dea0ae2c2870fa6a9fea2089c5c7ff3d1febd8567/simple_geoip-0.1.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "4ff46844a0d1e668af70b33fdf57810d", "sha256": "af94afc7f0329a31ab00c86e4e1c72fa38a7438285964b846bdd1b01d18d7467" }, "downloads": -1, "filename": "simple-geoip-0.1.0.tar.gz", "has_sig": false, "md5_digest": "4ff46844a0d1e668af70b33fdf57810d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5051, "upload_time": "2018-04-26T07:07:02", "url": "https://files.pythonhosted.org/packages/7c/e8/60855c0a74f7f880bb4e727f56543d560ddc108f1cf3c79c594a06c185de/simple-geoip-0.1.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "be9eb1416f80ac188e04695f1d14fe89", "sha256": "a6507bd14cfbc8bf9f771fea21a535dd6402e9e25cf12f82e53c4e654417ea9a" }, "downloads": -1, "filename": "simple_geoip-0.1.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "be9eb1416f80ac188e04695f1d14fe89", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 5498, "upload_time": "2018-04-26T07:07:01", "url": "https://files.pythonhosted.org/packages/8b/da/7952f8d4cf57add80d6dea0ae2c2870fa6a9fea2089c5c7ff3d1febd8567/simple_geoip-0.1.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "4ff46844a0d1e668af70b33fdf57810d", "sha256": "af94afc7f0329a31ab00c86e4e1c72fa38a7438285964b846bdd1b01d18d7467" }, "downloads": -1, "filename": "simple-geoip-0.1.0.tar.gz", "has_sig": false, "md5_digest": "4ff46844a0d1e668af70b33fdf57810d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5051, "upload_time": "2018-04-26T07:07:02", "url": "https://files.pythonhosted.org/packages/7c/e8/60855c0a74f7f880bb4e727f56543d560ddc108f1cf3c79c594a06c185de/simple-geoip-0.1.0.tar.gz" } ] }