2015-08-30 01:14:07 +00:00
|
|
|
usage: wakatime [-h] [--entity FILE] [--key KEY] [--write] [--plugin PLUGIN]
|
2015-08-12 17:28:01 +00:00
|
|
|
[--time time] [--lineno LINENO] [--cursorpos CURSORPOS]
|
2018-04-07 05:37:01 +00:00
|
|
|
[--entity-type ENTITY_TYPE] [--category CATEGORY]
|
|
|
|
[--proxy PROXY] [--no-ssl-verify] [--project PROJECT]
|
|
|
|
[--alternate-project ALTERNATE_PROJECT] [--language LANGUAGE]
|
|
|
|
[--hostname HOSTNAME] [--disable-offline] [--hide-filenames]
|
|
|
|
[--exclude EXCLUDE] [--include INCLUDE]
|
|
|
|
[--include-only-with-project-file] [--extra-heartbeats]
|
|
|
|
[--log-file LOG_FILE] [--api-url API_URL] [--timeout TIMEOUT]
|
|
|
|
[--config CONFIG] [--verbose] [--version]
|
2015-08-12 01:59:29 +00:00
|
|
|
|
|
|
|
Common interface for the WakaTime api.
|
|
|
|
|
|
|
|
optional arguments:
|
|
|
|
-h, --help show this help message and exit
|
2018-04-07 05:37:01 +00:00
|
|
|
--entity FILE Absolute path to file for the heartbeat. Can also be a
|
2018-04-07 18:03:36 +00:00
|
|
|
url, domain or app when --entity-type is not file.
|
2018-04-07 05:37:01 +00:00
|
|
|
--key KEY Your wakatime api key; uses api_key from
|
|
|
|
~/.wakatime.cfg by default.
|
|
|
|
--write When set, tells api this heartbeat was triggered from
|
|
|
|
writing to a file.
|
|
|
|
--plugin PLUGIN Optional text editor plugin name and version for User-
|
|
|
|
Agent header.
|
|
|
|
--time time Optional floating-point unix epoch timestamp. Uses
|
|
|
|
current time by default.
|
|
|
|
--lineno LINENO Optional line number. This is the current line being
|
|
|
|
edited.
|
2015-08-12 01:59:29 +00:00
|
|
|
--cursorpos CURSORPOS
|
2018-04-07 05:37:01 +00:00
|
|
|
Optional cursor position in the current file.
|
2016-04-28 21:57:15 +00:00
|
|
|
--entity-type ENTITY_TYPE
|
2018-04-07 05:37:01 +00:00
|
|
|
Entity type for this heartbeat. Can be "file",
|
2018-04-07 18:03:36 +00:00
|
|
|
"domain" or "app". Defaults to "file".
|
2018-04-07 05:37:01 +00:00
|
|
|
--category CATEGORY Category of this heartbeat activity. Can be "coding",
|
|
|
|
"building", "debugging", "running tests", "browsing",
|
2018-04-07 21:56:58 +00:00
|
|
|
"code reviewing", "designing" or "indexing". Defaults
|
|
|
|
to "coding".
|
2018-04-07 05:37:01 +00:00
|
|
|
--proxy PROXY Optional proxy configuration. Supports HTTPS and SOCKS
|
2016-05-21 11:09:55 +00:00
|
|
|
proxies. For example: https://user:pass@host:port or
|
2017-02-15 23:02:05 +00:00
|
|
|
socks5://user:pass@host:port or domain\user:pass
|
2018-04-07 05:37:01 +00:00
|
|
|
--no-ssl-verify Disables SSL certificate verification for HTTPS
|
2017-05-06 00:09:17 +00:00
|
|
|
requests. By default, SSL certificates are verified.
|
2018-04-07 05:37:01 +00:00
|
|
|
--project PROJECT Optional project name.
|
2015-08-12 01:59:29 +00:00
|
|
|
--alternate-project ALTERNATE_PROJECT
|
2018-04-07 05:37:01 +00:00
|
|
|
Optional alternate project name. Auto-discovered
|
|
|
|
project takes priority.
|
|
|
|
--language LANGUAGE Optional language name. If valid, takes priority over
|
|
|
|
auto-detected language.
|
|
|
|
--hostname HOSTNAME Hostname of current machine.
|
|
|
|
--disable-offline Disables offline time logging instead of queuing
|
|
|
|
logged time.
|
|
|
|
--hide-filenames Obfuscate filenames. Will not send file names to api.
|
|
|
|
--exclude EXCLUDE Filename patterns to exclude from logging. POSIX regex
|
|
|
|
syntax. Can be used more than once.
|
|
|
|
--include INCLUDE Filename patterns to log. When used in combination
|
2015-08-12 01:59:29 +00:00
|
|
|
with --exclude, files matching include will still be
|
2018-04-07 05:37:01 +00:00
|
|
|
logged. POSIX regex syntax. Can be used more than
|
|
|
|
once.
|
2018-01-05 07:24:19 +00:00
|
|
|
--include-only-with-project-file
|
2018-04-07 05:37:01 +00:00
|
|
|
Disables tracking folders unless they contain a
|
|
|
|
.wakatime-project file. Defaults to false.
|
|
|
|
--extra-heartbeats Reads extra heartbeats from STDIN as a JSON array
|
|
|
|
until EOF.
|
|
|
|
--log-file LOG_FILE Defaults to ~/.wakatime.log.
|
|
|
|
--api-url API_URL Heartbeats api url. For debugging with a local server.
|
|
|
|
--timeout TIMEOUT Number of seconds to wait when sending heartbeats to
|
|
|
|
api. Defaults to 60 seconds.
|
|
|
|
--config CONFIG Defaults to ~/.wakatime.cfg.
|
|
|
|
--verbose Turns on debug messages in log file.
|
2015-08-12 01:59:29 +00:00
|
|
|
--version show program's version number and exit
|