KO
|
EN
gitlite โ search
Search
#python
#php
#react
#nodejs
#android
#github
#javascript
#mongodb
#programming
#webdevelopment
#tecinforeni
#cli
toggl-cli
โ 61
Open GitHub โ
๐ Command Line App for Toggl Track
Download README (.md)
Explore Similar Repositories
rules_buf
:
Bazel rules for Buf.
MyBlog
:
MyBlogไธป่ฆๆฏๅบไบ SpringBoot + Vue ๅๅ็ซฏๅ็ฆปๅผๅ็ไธๆฌพๅจๆไธชไบบๅๅฎข็ณป็ป
CoreTweaks
:
A bunch of random bug fixes, optimizations and tweaks (1.7.10)
ansible-collection-acme
:
An Ansible collection for issuing certificates via the ACME protocol.
SternalBoard
:
Lightweight & animated scoreboard, packet-based designed for easy usage
// repository documentation
Was this content helpful?
โ 0
(0 ratings)
Select Rating:
โ
โ
โ
โ
โ
Submit Feedback
Recent Feedback
×
Download README
Do you want to download the
README.md
file for
toggl-cli
?
Download (.md)
# toggl-cli Unofficial CLI for [Toggl Track](https://toggl.com/track/) written in Rust, using the [v9 API](https://developers.track.toggl.com/docs/). ## Usage Building the binary. ```shell cargo build # or cargo build --release ``` Installing the binary. ### From [crates.io](https://crates.io/crates/toggl) ```shell cargo install toggl ``` ### From Arch Linux aur [](https://aur.archlinux.org/packages/toggl-cli/) [](https://aur.archlinux.org/packages/toggl-cli-bin/) toggl-cli is available on the [AUR](https://wiki.archlinux.org/index.php/Arch_User_Repository): - [toggl-cli](https://aur.archlinux.org/packages/toggl-cli/) (release package) - [toggl-cli-bin](https://aur.archlinux.org/packages/toggl-cli-bin/) (binary release package) You can install it using your [AUR helper](https://wiki.archlinux.org/index.php/AUR_helpers) of choice. Example: ```shell $ yay -Sy toggl-cli ``` ### From source ```shell cargo install --path . ``` > This places the release optimized binary at `~/.cargo/bin/toggl`. Make sure to add `~/.cargo/bin` to your `$PATH` so that you can run the binary from any directory. You can invoke the binary using the `toggl` command now. Alternatively you can also run the command directly using `cargo run` ```shell cargo run [command] # To list the last 3 time-entries cargo run list -n 3 ``` The first command you need to run is `auth` to set up your [Toggl API token](https://support.toggl.com/en/articles/3116844-where-is-my-api-token-located). ```shell cargo run auth [API_TOKEN] # or toggl auth [API_TOKEN] ``` The API token is stored securely in your Operating System's keychain using the [keyring](https://crates.io/crates/keyring) crate. > **Note**: On some linux environments the `keyring` store is not persistent > across reboots. We recommend exporting the api token as `TOGGL_API_TOKEN` > in your shell profile. The CLI will use this environment variable if it is > set. You don't need to run the `auth` command if you have the environment > variable set. ### Commands Run the `help` command to see a list of available commands. ```shell $ toggl help toggl 0.5.1 Toggl command line app. USAGE: toggl [FLAGS] [OPTIONS] [SUBCOMMAND] FLAGS: --fzf Use fzf instead of the default picker -h, --help Prints help information -V, --version Prints version information OPTIONS: -C <directory> Change directory before running the command --proxy <proxy> Use custom proxy SUBCOMMANDS: auth Authenticate with the Toggl API. Find your API token at https://track.toggl.com/profile#api- token config Manage auto-tracking configuration continue create-project Create a new project in your workspace create-tag Create a new tag in your workspace current delete Delete a time entry by ID delete-project Delete a project from your workspace by name delete-tag Delete a tag from your workspace by name edit Edit a time entry, opens it in $EDITOR when no edit flags are given help Prints this message or the help of the given subcommand(s) list logout Clear stored credentials rename-project Rename a project in your workspace rename-tag Rename a tag in your workspace running start Start a new time entry, call with no arguments to start in interactive mode stop ``` You can also run the `help` command on a specific subcommand. ```shell $ toggl help start toggl-start 0.5.1 Start a new time entry, call with no arguments to start in interactive mode USAGE: toggl start [FLAGS] [OPTIONS] [--] [description] FLAGS: -b, --billable -h, --help Prints help information -i, --interactive -V, --version Prints version information OPTIONS: -p, --project <project> Exact name of the project you want the time entry to be associated with -t, --tags <tags>... Space separated list of tags to associate with the time entry, e.g. 'tag1 tag2 tag3' --task <task> Exact name of the task you want the time entry to be associated with ARGS: <description> Description of the time entry ``` ## Testing To run the unit-tests ```shell cargo test ``` ## Linting Common lint tools ```shell cargo fmt # Formatting the code to a unified style. cargo clippy --fix # To automatically fix common mistakes. ``` The CI will also run the lint commands for all pull-requests. See [pull_request.yml](.github/workflows/pull_request.yml) for more details. ## Releasing To create a new release, first bump the package version. We have a handy script at [pkg/autodoc.rs](pkg/autodoc.rs). Running it with no arguments, bumps the current patch version, in `Cargo.toml` and `Cargo.lock` files. It also updates the help documentation in this README to match the current version of the command. Commit and push the updated changes and a new release will show up under the [releases](https://github.com/watercooler-labs/toggl-cli/releases) page. --- Built by the [Watercooler Studio](https://watercooler.studio/)
