Shard Detail

punch-card v0.8.2

A CLI for tracking your work time

Install & Use

Add the following code to your project's shard.yml under:

dependencies to use in production
- OR -
development_dependencies to use in development


punch-card:
  github: koffeinfrei/punch-card

Readme

Punch Card

GitHub tag (latest SemVer)   Build Status   License

I needed a simple tool to track my work time. This is exactly what I was looking for.
-- myself


This is a simple CLI to track your work time.


Usage

Adding entries

# Adding entries for today
$ punch-card start now
$ punch-card stop 12:00
$ punch-card 13:00-17:00

# Adding entries for an arbitrary day
$ punch-card start 09:00 12.12.2021
$ punch-card stop 12:00 12.12.2021
$ punch-card 13:00-17:00 12.12.2021

Showing entries

$ punch-card today
╭──────────────────╮
│ 📅  05.11.2021   │
╰──────────────────╯
╭──────────────────┬──────────────────┬──────────────────┬──────────────────╮
│ Entries          │ Total hours      │ Diff             │ Project          │
├──────────────────┼──────────────────┼──────────────────┼──────────────────┤
│ 08:30 - 11:45    │                  │                  │                  │
│ 12:45 - 18:15    │             8:45 │            +0:45 │                  │
╰──────────────────┴──────────────────┴──────────────────┴──────────────────╯

$ punch-card 05.11.2021
╭──────────────────╮
│ 📅  05.11.2021   │
╰──────────────────╯
╭──────────────────┬──────────────────┬──────────────────┬──────────────────╮
│ Entries          │ Total hours      │ Diff             │ Project          │
├──────────────────┼──────────────────┼──────────────────┼──────────────────┤
│ 08:30 - 11:45    │                  │                  │ Project A        │
│ 12:45 - 18:15    │             8:45 │            +0:45 │ Project B        │
╰──────────────────┴──────────────────┴──────────────────┴──────────────────╯

$ punch-card month
╭──────────────────╮
│ 📅  Nov 2021     │
╰──────────────────╯
╭──────────────────┬──────────────────┬──────────────────┬──────────────────╮
│ Day              │ Total hours      │ Diff             │ Projects         │
├──────────────────┼──────────────────┼──────────────────┼──────────────────┤
│ Mon  01.11.2021  │             8:00 │             0:00 │                  │
│ Tue  02.11.2021  │             8:00 │             0:00 │                  │
│ Wed  03.11.2021  │             7:30 │            -0:30 │                  │
│ Thu  04.11.2021  │             7:00 │            -1:00 │                  │
│ Fri  05.11.2021  │             8:45 │            +0:45 │                  │
╰──────────────────┴──────────────────┴──────────────────┴──────────────────╯
╭──────────────────┬──────────────────┬──────────────────╮
│ Total            │            39:15 │            -0:45 │
╰──────────────────┴──────────────────┴──────────────────╯

Installation

Install from snap

sudo snap install punch-card

Install from source

First you'll need to install Crystal.

$ git clone git@github.com:koffeinfrei/punch-card.git
$ cd punch-card
$ shards build --release
$ cp bin/punch-card <some directory in your $PATH>

Contributing

  1. Fork it (https://github.com/koffeinfrei/punch-card/fork)
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

Versioning

Semantic Versioning is used, obviously.

There's a script that bumps the version in all necessary files and creates a git tag.

# bump the major version, e.g. from 1.2.0 to 2.2.0
$ scripts/version bump:major

# bump the minor version, e.g. from 1.2.0 to 1.3.0
$ scripts/version bump:minor

# bump the patch version, e.g. from 1.2.0 to 1.2.1
$ scripts/version bump:patch

Made with ☕️ by Koffeinfrei