This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Common interface to the WakaTime api.

Project Description

Command line interface to WakaTime used by all WakaTime text editor plugins.

Go to http://wakatime.com/editors to install the plugin for your text editor or IDE.

Installation

Note: You shouldn’t need to directly use this package unless you are building your own plugin or your text editor’s plugin asks you to install the WakaTime CLI manually.

Each plugin installs the WakaTime CLI for you, except for the Emacs WakaTime plugin.

Install the plugin for your IDE/editor:

https://wakatime.com/editors

Each plugin either comes pre-bundled with WakaTime CLI, or downloads the latest version from GitHub for you.

Usage

If you are building a plugin using the WakaTime API then follow the Creating a Plugin guide.

For command line options, run wakatime --help.

Some more usage information is available in the FAQ.

Configuring

Options can be passed via command line, or set in the $WAKATIME_HOME/.wakatime.cfg config file. Command line arguments take precedence over config file settings. The $WAKATIME_HOME/.wakatime.cfg file is in INI format. An example config file with all available options:

[settings]
debug = false
api_key = your-api-key
hidefilenames = false
exclude =
    ^COMMIT_EDITMSG$
    ^TAG_EDITMSG$
    ^/var/(?!www/).*
    ^/etc/
include =
    .*
offline = true
proxy = https://user:pass@localhost:8080
no_ssl_verify = false
timeout = 30
hostname = machinename
[projectmap]
    projects/foo = new project name
    ^/home/user/projects/bar(\d+)/ = project{0}

For commonly used configuration options, see examples in the FAQ.

Troubleshooting

Read How to debug the plugins.

Make sure to set debug=true in your ~/.wakatime.cfg file.

Common log file location in your User $WAKATIME_HOME directory:

~/.wakatime.log

Each plugin also has it’s own log file:

  • Atom writes errors to the developer console (View -> Developer -> Toggle Developer Tools)
  • Brackets errors go to the developer console (Debug -> Show Developer Tools)
  • Cloud9 logs to the browser console (View -> Developer -> JavaScript Console)
  • Coda logs to /var/log/system.log so use sudo tail -f /var/log/system.log in Terminal to watch Coda 2 logs
  • Eclipse logs can be found in the Eclipse Error Log (Window -> Show View -> Error Log)
  • Emacs messages go to the messages buffer window
  • Jetbrains IDEs (IntelliJ IDEA, PyCharm, RubyMine, PhpStorm, AppCode, AndroidStudio, WebStorm) log to idea.log (locating IDE log files)
  • Komodo logs are written to pystderr.log (Help -> Troubleshooting -> View Log File)
  • Netbeans logs to it’s own log file (View -> IDE Log)
  • Notepad++ errors go to AppData\Roaming\Notepad++\plugins\config\WakaTime.log (this file is only created when an error occurs)
  • Sublime Text logs to the Sublime Console (View -> Show Console)
  • TextMate logs to stderr so run TextMate from Terminal to see any errors (enable logging)
  • Vim errors get displayed in the status line or inline (use :redraw! to clear inline errors)
  • Visual Studio logs to the Output window, but uncaught exceptions go to ActivityLog.xml (more info…)
  • Vscode logs to the developer console (Help -> Toggle Developer Tools)
  • Xcode type sudo tail -f /var/log/system.log in a Terminal to view Xcode errors

Useful API Endpoints:

Useful Resources:

Contributing

Before contributing a pull request, make sure tests pass:

virtualenv venv
. venv/bin/activate
pip install tox
tox

The above will run tests on all Python versions available on your machine. To just run tests on a single Python version:

virtualenv venv
. venv/bin/activate
pip install -r dev-requirements.txt
nosetests

Many thanks to all contributors!

Release History

Release History

This version
History Node

8.0.3

History Node

8.0.2

History Node

8.0.1

History Node

8.0.0

History Node

7.0.4

History Node

7.0.3

History Node

7.0.2

History Node

7.0.1

History Node

7.0.0

History Node

6.3.0

History Node

6.2.3

History Node

6.2.2

History Node

6.2.1

History Node

6.2.0

History Node

6.1.0

History Node

6.0.9

History Node

6.0.8

History Node

6.0.7

History Node

6.0.6

History Node

6.0.5

History Node

6.0.4

History Node

6.0.3

History Node

6.0.2

History Node

6.0.1

History Node

6.0.0

History Node

5.0.1

History Node

5.0.0

History Node

4.1.13

History Node

4.1.12

History Node

4.1.11

History Node

4.1.10

History Node

4.1.9

History Node

4.1.8

History Node

4.1.7

History Node

4.1.6

History Node

4.1.5

History Node

4.1.4

History Node

4.1.3

History Node

4.1.2

History Node

4.1.1

History Node

4.1.0

History Node

4.0.16

History Node

4.0.15

History Node

4.0.14

History Node

4.0.13

History Node

4.0.12

History Node

4.0.11

History Node

4.0.10

History Node

4.0.9

History Node

4.0.8

History Node

4.0.7

History Node

4.0.6

History Node

4.0.5

History Node

4.0.4

History Node

4.0.3

History Node

4.0.2

History Node

4.0.1

History Node

4.0.0

History Node

3.0.4

History Node

3.0.3

History Node

3.0.1

History Node

3.0.0

History Node

2.1.11

History Node

2.1.10

History Node

2.1.9

History Node

2.1.7

History Node

2.1.6

History Node

2.1.5

History Node

2.1.4

History Node

2.1.3

History Node

2.1.1

History Node

2.1.0

History Node

2.0.8

History Node

2.0.1

History Node

2.0.0

History Node

1.0.1

History Node

0.1.1

History Node

0.0.1

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
wakatime-8.0.3.tar.gz (1.4 MB) Copy SHA256 Checksum SHA256 Source Jun 8, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting