timecalc 0.4.0

Calculate the total duration of a given set of intervals and durations
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63

![ci](https://github.com/Granddave/timecalc-rs/actions/workflows/ci.yml/badge.svg)
[![dependency status](https://deps.rs/repo/github/granddave/timecalc-rs/status.svg)](https://deps.rs/repo/github/granddave/timecalc-rs)
![Crates.io Version](https://img.shields.io/crates/v/timecalc)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

# Timecalc-rs

Timecalc-rs is a simple CLI tool that calculates the total time spent on a project given intervals and durations.

This is the Rust implementation of my [previous tool written in Python](https://github.com/Granddave/timecalc).

## How to use

```bash
$ timecalc --help
Calculate the total duration of a given set of intervals and durations.

Usage: timecalc [OPTIONS] [DURATION_ARGS]...

Arguments:
  [DURATION_ARGS]...  Intervals or durations to sum

                      Intervals are specified as `start-end`, e.g. `9-12:30`.
                      Durations are specified as `+duration` or `-duration`, e.g. `1h` or `-30m`.

                      Valid duration units are:
                        w for weeks
                        d for days
                        h for hours
                        m for minutes

Options:
  -s, --stdin    Read arguments from stdin
  -h, --help     Print help
  -V, --version  Print version

```

### Example

Let's say you worked on a project from 7:00 to 11:30, including a 15 minute break, and then worked another 4 hours after lunch.
You can calculate the total time spent on the project like this:

```bash
$ timecalc 7-11:30 -15m 4h
8h 15m
# or via stdin
$ echo 7-11:30 -15m 4h | timecalc -s
8h 15m
```

## Installation

The easiest way to install timecalc-rs is using `cargo`:

```bash
cargo install --git https://github.com/Granddave/timecalc-rs
```

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details