Skip to content

crodjer/atg

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

60 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Around the Globe

A small timezone utility

image

image

Features

  • Get the timezone for a random address.
  • Current time anywhere.
  • Guesses about what people may be doing.
  • Helps you schedule meetings by providing you spans of convenient times.

Installation

This is a Python package, which can be simply installed through pip:

and to install it globally, run:

Usage

Get all the information about the time at Mountain View:

If you want to avoid querying the timezone to Google's maps api everytime, you can directly use the timezone in further requests:

By default, atg calculates time slots based to avoid sleep periods. You can use --dnd to customize this. For example, to avoid disturbing at work/sleep:

You can also specify who the time slots should be convenient to. By default it will consider both. You can use -c/--convenient-for flags to customize this behaviour. If you want the convenient timings for the remote location:

Help

You can always refer to the command usage through atg -h.

Developing and Testing

atg uses the pytz, tzlocal and enum34 (for backwards compatibility) as dependencies.

To set things up for development, create and activate a virtualenv and run

Tests

Run tests via:

Bugs

Probably lots. Please send us reports on the Github issue tracker. Patches are welcome too.

About

Around the globe: a small timezone utility

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages