https://github.com/bullshitsoftware/youtimetrack
CLI tools for YouTrack time management
https://github.com/bullshitsoftware/youtimetrack
cli it-galley timetracking youtrack
Last synced: 30 days ago
JSON representation
CLI tools for YouTrack time management
- Host: GitHub
- URL: https://github.com/bullshitsoftware/youtimetrack
- Owner: bullshitsoftware
- License: wtfpl
- Created: 2022-07-01T15:39:30.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-11-12T19:02:35.000Z (about 1 year ago)
- Last Synced: 2024-11-12T19:35:45.481Z (about 1 year ago)
- Topics: cli, it-galley, timetracking, youtrack
- Language: Go
- Homepage:
- Size: 48.8 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# YouTimeTrack
[](https://github.com/bullshitsoftware/youtimetrack/actions/workflows/ci.yml)
[](http://www.wtfpl.net/about/)
[](https://coveralls.io/github/bullshitsoftware/youtimetrack?branch=master)
[](https://goreportcard.com/report/github.com/bullshitsoftware/youtimetrack)
[](https://github.com/bullshitsoftware/youtimetrack)
[](https://github.com/bullshitsoftware/youtimetrack/releases/latest)
CLI tools to help you manage your timetracks at YouTrack.
Main features:
- Check timetracks against your calendar settings, which include custom
- Working day duration
- Half-holiday duration
- Weekends
- Half-holiday
- Public holidays
- Vacation
- And even extra working days!
- Show details about your timetracks
- Add/delete timetracks
- Written in Rust
## Install
Download suitable release from [here](https://github.com/bullshitsoftware/youtimetrack/releases) and place needed
binaries somewhere in your system.
## Usage
### Configuration
Initialize application config file with `yttconf` command or place
[sample config](https://github.com/bullshitsoftware/youtimetrack/blob/master/internal/app/config_stub.json) to
`$HOME/.config/ytt/config.json`.
```
❯ bin/yttconf
Created /home/user/.config/ytt/config.json edit it with your favorite text editor
```
Adjust it to your needs.
### Check your summary stats
Usage
```
❯ bin/yttsum --help
Usage of bin/yttsum:
-end value
end date (2006-01-02), default to current month end
-start value
start date (2006-01-02), default to current month start
```
Example
```
❯ bin/yttsum
50h / 48h / 168h (worked / today / month)
```
### Check details
Usage
```
❯ bin/yttdet --help
Usage of bin/yttdet:
-end value
end date (2006-01-02), default to current month end
-start value
start date (2006-01-02), default to current month start
```
Example
```
❯ bin/yttdet --start 2022-07-08
2022-07-08 1h XY-777 Do somethig good
116-74718 Did something good
```
### Log time
Usage
```
❯ bin/yttadd --help
Usage of bin/yttadd type issue duration comment:
- type, work type prefix (e.g., develop)
- issue, issue number (e.g., XY-123)
- duration, spent time in YouTrack format (e.g., 1h 30m)
- comment, work item description (e.g., did something cool)
```
Example
```
❯ bin/yttadd deve XY-777 "1h 30m" "did something"
Time tracked
```
### Delete time
Usage
```
❯ bin/yttdel --help
Usage of bin/yttdel issue item_id:
- issue, issue number (e.g., XY-123)
- item_id, work item id (e.g., 110-12312)
```
Example
```
❯ bin/yttdel XY-777 116-74718
Item deleted
```