Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/844196/man-hour
:clock3: Bullshit job buster
https://github.com/844196/man-hour
Last synced: 27 days ago
JSON representation
:clock3: Bullshit job buster
- Host: GitHub
- URL: https://github.com/844196/man-hour
- Owner: 844196
- License: mit
- Created: 2023-12-31T09:12:15.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2024-06-20T18:55:54.000Z (5 months ago)
- Last Synced: 2024-09-10T19:14:24.081Z (about 2 months ago)
- Language: TypeScript
- Homepage:
- Size: 354 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# man-hour [](https://www.npmjs.com/package/@efumaxay/man-hour)
## :package: Installation
```sh
npm i -g @efumaxay/man-hour
```
## :ok_hand: Usage
```sh
man-hour '2023-11-30T15:23:33+09:00' '2023-12-04T11:34:29+09:00' \
--work-start='10:00+09:00' \
--work-end='19:00+09:00' \
--work-period='05:00+09:00' \
--break-start='13:00+09:00' \
--break-end='14:00+09:00' \
--timezone='Asia/Tokyo' \
--locale='ja-JP'
```
```json
[
{
"interval": "2023/11/30木曜日 15:23:33～19:00:00",
"hours": 4,
"isoInterval": "2023-11-30T06:23:33Z/2023-11-30T10:00:00Z",
"isoDuration": "P0Y0M0DT3H36M27S"
},
{
"interval": "2023/12/1金曜日 10:00:00～13:00:00",
"hours": 3,
"isoInterval": "2023-12-01T01:00:00Z/2023-12-01T04:00:00Z",
"isoDuration": "P0Y0M0DT3H0M0S"
},
{
"interval": "2023/12/1金曜日 14:00:00～19:00:00",
"hours": 5,
"isoInterval": "2023-12-01T05:00:00Z/2023-12-01T10:00:00Z",
"isoDuration": "P0Y0M0DT5H0M0S"
},
{
"interval": "2023/12/4月曜日 10:00:00～11:34:29",
"hours": 2,
"isoInterval": "2023-12-04T01:00:00Z/2023-12-04T02:34:29Z",
"isoDuration": "P0Y0M0DT1H34M29S"
}
]
```
## :gear: Configurations
You can also set options in saved configuration files.
### Global config
Default: `${XDG_CONFIG_HOME:-${HOME}/.config}/man-hour/config.{json,yml,yaml}`
```yaml
# yaml-language-server: $schema=https://raw.githubusercontent.com/844196/man-hour/v1/json-schema/manhourrc.json
---
timezone: Asia/Tokyo
locale: ja-JP
```
You can override global config filepath:
```sh
MAN_HOUR_GLOBAL_CONFIG=/path/to/config.global
```
### Config
Default: `${PWD}/.manhourrc.{json,yml,yaml}`
```yaml
# yaml-language-server: $schema=https://raw.githubusercontent.com/844196/man-hour/v1/json-schema/manhourrc.json
---
step: 0.1
workStart: 10:00+09:00
workEnd: 19:00+09:00
workPeriod: 05:00+09:00
breakStart: 13:00+09:00
breakEnd: 14:00+09:00
```
You can override config filepath:
```sh
MAN_HOUR_CONFIG=/path/to/config
```
## :bulb: Tips
### Sum
```sh
man-hour --step 0.1 '2023-11-30T15:23:33+09:00' '2023-12-04T11:34:29+09:00' \
| jq '[.[].hours] | add * 10 | floor / 10'
```
```json
13.3
```
### Markdown table (with [wfxr/csview](https://github.com/wfxr/csview))
```sh
man-hour --step 0.1 '2023-11-30T15:23:33+09:00' '2023-12-04T11:34:29+09:00' \
| jq -r '["Interval", "Hours"], (.[] | [.interval, .hours]) | @csv' \
| csview --style markdown
```
```markdown
| Interval | Hours |
| ----------------------------------- | ----- |
| 2023/11/30木曜日 15:23:33～19:00:00 | 3.7 |
| 2023/12/1金曜日 10:00:00～13:00:00 | 3 |
| 2023/12/1金曜日 14:00:00～19:00:00 | 5 |
| 2023/12/4月曜日 10:00:00～11:34:29 | 1.6 |
```
| Interval | Hours |
| ----------------------------------- | ----- |
| 2023/11/30木曜日 15:23:33～19:00:00 | 3.7 |
| 2023/12/1金曜日 10:00:00～13:00:00 | 3 |
| 2023/12/1金曜日 14:00:00～19:00:00 | 5 |
| 2023/12/4月曜日 10:00:00～11:34:29 | 1.6 |
### Integrating with Github Actions
TBD