81 lines
4.8 KiB
Text
81 lines
4.8 KiB
Text
usage: wakatime [-h] [--entity FILE] [--key KEY] [--write] [--plugin PLUGIN]
|
|
[--time time] [--lineno LINENO] [--cursorpos CURSORPOS]
|
|
[--entity-type ENTITY_TYPE] [--category CATEGORY]
|
|
[--proxy PROXY] [--no-ssl-verify] [--project PROJECT]
|
|
[--alternate-project ALTERNATE_PROJECT] [--language LANGUAGE]
|
|
[--local-file FILE] [--hostname HOSTNAME] [--disable-offline]
|
|
[--hide-file-names] [--hide-project-names] [--exclude EXCLUDE]
|
|
[--exclude-unknown-project] [--include INCLUDE]
|
|
[--include-only-with-project-file] [--extra-heartbeats]
|
|
[--log-file LOG_FILE] [--api-url API_URL] [--timeout TIMEOUT]
|
|
[--config CONFIG] [--verbose] [--version]
|
|
|
|
Common interface for the WakaTime api.
|
|
|
|
optional arguments:
|
|
-h, --help show this help message and exit
|
|
--entity FILE Absolute path to file for the heartbeat. Can also be a
|
|
url, domain or app when --entity-type is not file.
|
|
--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.
|
|
--cursorpos CURSORPOS
|
|
Optional cursor position in the current file.
|
|
--entity-type ENTITY_TYPE
|
|
Entity type for this heartbeat. Can be "file",
|
|
"domain" or "app". Defaults to "file".
|
|
--category CATEGORY Category of this heartbeat activity. Can be "coding",
|
|
"building", "indexing", "debugging", "running tests",
|
|
"manual testing", "browsing", "code reviewing" or
|
|
"designing". Defaults to "coding".
|
|
--proxy PROXY Optional proxy configuration. Supports HTTPS and SOCKS
|
|
proxies. For example: https://user:pass@host:port or
|
|
socks5://user:pass@host:port or domain\user:pass
|
|
--no-ssl-verify Disables SSL certificate verification for HTTPS
|
|
requests. By default, SSL certificates are verified.
|
|
--project PROJECT Optional project name.
|
|
--alternate-project ALTERNATE_PROJECT
|
|
Optional alternate project name. Auto-discovered
|
|
project takes priority.
|
|
--language LANGUAGE Optional language name. If valid, takes priority over
|
|
auto-detected language.
|
|
--local-file FILE Absolute path to local file for the heartbeat. When
|
|
--entity is a remote file, this local file will be
|
|
used for stats and just the value of --entity sent
|
|
with heartbeat.
|
|
--hostname HOSTNAME Hostname of current machine.
|
|
--disable-offline Disables offline time logging instead of queuing
|
|
logged time.
|
|
--hide-file-names Obfuscate filenames. Will not send file names to api.
|
|
--hide-project-names Obfuscate project names. When a project folder is
|
|
detected instead of using the folder name as the
|
|
project, a .wakatime-project file is created with a
|
|
random project name.
|
|
--exclude EXCLUDE Filename patterns to exclude from logging. POSIX regex
|
|
syntax. Can be used more than once.
|
|
--exclude-unknown-project
|
|
When set, any activity where the project cannot be
|
|
detected will be ignored.
|
|
--include INCLUDE Filename patterns to log. When used in combination
|
|
with --exclude, files matching include will still be
|
|
logged. POSIX regex syntax. Can be used more than
|
|
once.
|
|
--include-only-with-project-file
|
|
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.
|
|
--version show program's version number and exit
|