doko 0.4.0

Installing

$ pip install doko

$ pip install doko[corelocation]

Hacking

For hacking on OSX, you will likely want to install requires-corelocation.txt as well as requires.txt.

Run the tests with make test.

Using on the command-line

Just run the doko command:

$ doko
35.674,139.701

This 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.

More fine-grained control over strategies used and the precision returned is available. See doko --help.

Using as a module

> import doko
> doko.location('geoip')  # on any platform
Location(latitude=35.674, longitude=139.701, source='geoip')
> doko.location('corelocation')  # on OS X, using Core Location
Location(latitude=35.674851, longitude=139.701419, source='corelocation')
> doko.Location.set_precision(2)
> doko.location()
Location(latitude=35.67, longitude=139.70, source='corelocation')

Landmarks

You 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:

$ doko-landmark --add ueno-park 35.713965 139.77411
$ doko-landmark --list
ueno-park [35.713965, 139.77411]
$ doko  # will give its best guess
35.674851,139.70141
$ DOKO_LANDMARK=ueno-park doko  # will use the landmark
35.713965,139.77411

Changelog

0.1.0

• Fetch latitude and longitude using Core Location

• Provide backup method via GeoBytes page