punchcard

A simple CLI for tracking time.

Getting started

Create a configuration file in $HOME/.punchcard.yaml:

# ~/.punchcard.yaml
# configuration for punchcard
storage:
  data: ~/punchcard/data.yaml

# round timestamps to this duration
# for details on the format see https://golang.org/pkg/time/#ParseDuration
roundTimestampsTo: 15m

Run the commands for instructions and/or examples:

punchcard help

punchcard examples

Developer documentation

Some short information on how to keep this going. (Because I tend to forget these things.)

Contributing

1. Create an issue.
2. Fork the repository.
3. Run tests (all should be OK): go test ./...
4. Write tests.
5. Run tests (some should fail).
6. Implement fix / feature.
7. Run tests (all should be OK again).
8. Commit, push and send a pull request, referencing the issue from step 1.

Releasing a new version

I use standard-version to generate the CHANGELOG.

1. Run standard-version --dry-run. Note the next version number.
2. Increase the version number in cmd/root.go and git add cmd/root.go.
3. Run standard-version --commit-all.
4. Run git push --follow-tags origin master.

LICENSE

GPLv3 (or later). See file LICENSE for the full license text.