{ "info": { "author": "Lars Yencken", "author_email": "lars@yencken.org", "bugtrack_url": null, "classifiers": [], "description": "doko (\u3069\u3053)\n===========\n\n.. image:: https://badge.fury.io/py/doko.png\n :target: http://badge.fury.io/py/doko\n\n.. image:: https://travis-ci.org/larsyencken/doko.png?branch=master\n :target: https://travis-ci.org/larsyencken/doko\n\n.. image:: https://pypip.in/d/doko/badge.png\n :target: https://crate.io/packages/doko\n\nA simple command-line utility (and Python module) to determine your current location.\n\nDoko is a clone of Victor Jalencas's `whereami `_ utility, but unlike whereami it supports multiple strategies for finding your location.\n\nKudos to `Richo Healey `_ for ideas and patches.\n\nInstalling\n----------\n\nWith GeoIP\n~~~~~~~~~~\n\nUsing GeoIP is the default. To install just GeoIP support, run::\n\n $ pip install doko\n\nThen you'll need to download a MaxMind `free GeoIP2 database `_, unzip it and set the ``GEOIP2_FILE`` environment variable to point to it.\n\nWith Core Location\n~~~~~~~~~~~~~~~~~~\n\nHowever, on OS X 10.6 (Snow Leopard) or later, you can also use the much more accurate Core Location framework::\n\n $ pip install doko[corelocation]\n\nThe corelocation dependencies take much longer to install, so go make a coffee. In fact, make several coffees.\n\nOnce you've installed the corelocation-enabled doko package, you'll need to enable Core Location in System Preferences, in the \"Security\" or \"Security & Privacy\" section. Furthermore, you must be using Wifi for it to work.\n\nHacking\n-------\n\nFor hacking on OSX, you will likely want to install ``requires-corelocation.txt`` as well as ``requires.txt``.\n\nRun the tests with ``make test``.\n\nUsing on the command-line\n-------------------------\n\nJust run the ``doko`` command::\n\n $ doko\n 35.674,139.701\n\nThis will give its best guess as to your location, depending on the strategies that are available. Use the ``--show`` option to open the location in Google Maps.\n\nMore fine-grained control over strategies used and the precision returned is available. See ``doko --help``.\n\nUsing as a module\n-----------------\n\n::\n\n > import doko\n > doko.location('geoip') # on any platform\n Location(latitude=35.674, longitude=139.701, source='geoip')\n > doko.location('corelocation') # on OS X, using Core Location\n Location(latitude=35.674851, longitude=139.701419, source='corelocation')\n > doko.Location.set_precision(2)\n > doko.location()\n Location(latitude=35.67, longitude=139.70, source='corelocation')\n\nLandmarks\n---------\n\nYou can use the ``doko-landmark`` command to store known landmarks, which you can then specify to doko using the ``DOKO_LANDMARK`` environment variable. This is useful if you're somewhere you go often without GPS::\n\n $ doko-landmark --add ueno-park 35.713965 139.77411\n $ doko-landmark --list\n ueno-park [35.713965, 139.77411]\n $ doko # will give its best guess\n 35.674851,139.70141\n $ DOKO_LANDMARK=ueno-park doko # will use the landmark\n 35.713965,139.77411\n\nChangelog\n---------\n\n0.4.0\n~~~~~\n\n- Migrate to ``geoip2`` database instead of web service\n- Give instructions for downloading and installing db to ``GEOIP2_FILE``\n- Run tests and lint using ``make``\n\n0.3.1\n~~~~~\n\n- Make ``setup.py`` dependencies more flexible.\n\n0.3.0\n~~~~~\n\n- Add a means for storing and using known landmarks\n- Add a cache strategy enabled by ``--cache`` option\n- Include location source in Location tuple\n- Add ``--show-strategy`` option on the command-line\n\n0.2.0\n~~~~~\n\n- Make doko multiplatform, by making Core Location optional\n- Honour timeouts for GeoIP lookups\n- Provide control over precision to support privacy\n\n0.1.0\n~~~~~\n\n- Fetch latitude and longitude using Core Location\n- Provide backup method via GeoBytes page\n\n\n.. image:: https://d2weczhvl823v0.cloudfront.net/larsyencken/doko/trend.png\n :alt: Bitdeli badge\n :target: https://bitdeli.com/free", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://github.com/larsyencken/doko/", "keywords": null, "license": "ISC", "maintainer": null, "maintainer_email": null, "name": "doko", "package_url": "https://pypi.org/project/doko/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/doko/", "project_urls": { "Download": "UNKNOWN", "Homepage": "http://github.com/larsyencken/doko/" }, "release_url": "https://pypi.org/project/doko/0.4.0/", "requires_dist": null, "requires_python": null, "summary": "Detect your current location.", "version": "0.4.0" }, "last_serial": 1059387, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "3aa1f08be455f22c2e426d278e7769d2", "sha256": "7277b44a71ce54b7802a67ef39f4f19da4f0cf26a2f8f4c51ef732acc2b28876" }, "downloads": -1, "filename": "doko-0.1.0.tar.gz", "has_sig": true, "md5_digest": "3aa1f08be455f22c2e426d278e7769d2", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3315, "upload_time": "2012-12-23T12:16:40", "url": "https://files.pythonhosted.org/packages/f0/eb/ef0d9f38175c8aa8bf12fb47bab18da1ef868e2cabdeb76a0d0b28923e6c/doko-0.1.0.tar.gz" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "fed24d2fe78343dc70bbcc9a71678d7f", "sha256": "378684164fe8d6cb95b81de0f4a78bdd9f49683107a259d25546a7a1043cc3a6" }, "downloads": -1, "filename": "doko-0.2.0.tar.gz", "has_sig": true, "md5_digest": "fed24d2fe78343dc70bbcc9a71678d7f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4252, "upload_time": "2012-12-24T21:14:46", "url": "https://files.pythonhosted.org/packages/b5/75/6d25630ac791b9dfd783874e703e2242481193f0dc1bccda93ed6bfa8974/doko-0.2.0.tar.gz" } ], "0.3.0": [ { "comment_text": "", "digests": { "md5": "c245cd7c1db28a76fed2f38f18a381a1", "sha256": "b6c8f3b9ead4ef4cd69bbb7fc594f6598f0789f36dc83950837a64381a41d0f3" }, "downloads": -1, "filename": "doko-0.3.0.tar.gz", "has_sig": true, "md5_digest": "c245cd7c1db28a76fed2f38f18a381a1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6120, "upload_time": "2013-01-02T11:48:23", "url": "https://files.pythonhosted.org/packages/61/64/2bfdb60b5191bdc9ce73ad0efcc9196a68147e2a50ec1e5dcfb2dd083434/doko-0.3.0.tar.gz" } ], "0.3.1": [ { "comment_text": "", "digests": { "md5": "c56e3e10c1f76aa436c725393088c04d", "sha256": "ebefe3390c99241db2480afb97ee94636d98a9d34261b0b054c6ef2c24748926" }, "downloads": -1, "filename": "doko-0.3.1.tar.gz", "has_sig": true, "md5_digest": "c56e3e10c1f76aa436c725393088c04d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6728, "upload_time": "2013-01-28T23:22:38", "url": "https://files.pythonhosted.org/packages/5a/10/6e33e13ac4f7409d6fc5db6fdd9fc844530ecbb0b6ae5141501385fe439a/doko-0.3.1.tar.gz" } ], "0.4.0": [ { "comment_text": "", "digests": { "md5": "e679d2337f60ef32110045da6f59cf35", "sha256": "c8a3c7dcf0f34fe52bf8c3ea8d8ffdeed35e4766d5cd4b69a6ac53b68fe305e9" }, "downloads": -1, "filename": "doko-0.4.0-py2-none-any.whl", "has_sig": true, "md5_digest": "e679d2337f60ef32110045da6f59cf35", "packagetype": "bdist_wheel", "python_version": "2.7", "requires_python": null, "size": 9793, "upload_time": "2014-04-13T20:36:28", "url": "https://files.pythonhosted.org/packages/e4/6b/2a11c9dfb43e0893300bf4ea16b6509eb0780cd554f0ef3ef3d169bcc9fe/doko-0.4.0-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "803557dad714392911a718b2545903ce", "sha256": "7b766905c617a254c17fa5522845aa5a9446f1bff1d8fb219097938d0ad2589f" }, "downloads": -1, "filename": "doko-0.4.0.tar.gz", "has_sig": true, "md5_digest": "803557dad714392911a718b2545903ce", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7906, "upload_time": "2014-04-13T20:36:22", "url": "https://files.pythonhosted.org/packages/76/75/21b277337b288c7a9eabdab4e70a6ea37dfa36acf86f8c1600bd5bca3ce1/doko-0.4.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "e679d2337f60ef32110045da6f59cf35", "sha256": "c8a3c7dcf0f34fe52bf8c3ea8d8ffdeed35e4766d5cd4b69a6ac53b68fe305e9" }, "downloads": -1, "filename": "doko-0.4.0-py2-none-any.whl", "has_sig": true, "md5_digest": "e679d2337f60ef32110045da6f59cf35", "packagetype": "bdist_wheel", "python_version": "2.7", "requires_python": null, "size": 9793, "upload_time": "2014-04-13T20:36:28", "url": "https://files.pythonhosted.org/packages/e4/6b/2a11c9dfb43e0893300bf4ea16b6509eb0780cd554f0ef3ef3d169bcc9fe/doko-0.4.0-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "803557dad714392911a718b2545903ce", "sha256": "7b766905c617a254c17fa5522845aa5a9446f1bff1d8fb219097938d0ad2589f" }, "downloads": -1, "filename": "doko-0.4.0.tar.gz", "has_sig": true, "md5_digest": "803557dad714392911a718b2545903ce", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7906, "upload_time": "2014-04-13T20:36:22", "url": "https://files.pythonhosted.org/packages/76/75/21b277337b288c7a9eabdab4e70a6ea37dfa36acf86f8c1600bd5bca3ce1/doko-0.4.0.tar.gz" } ] }