@codecovevienna/gittt-cli
Tracking time with CLI into a git repository
Last updated 2 months ago by eiabea .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @codecovevienna/gittt-cli 
SYNC missed versions from official npm registry.

Build Status codecov

gittt-cli

This project aims to track the time spent on a specific git project and stores it locally and separate git repository.

Features

  • Use a own git repository as a time tracking server
  • Add time records to the past
  • Edit committed time records
  • Git-like syntax
  • Timer
  • Publish recorded amount of spent time to third party applications (e.g. Jira)

Using the .gittt.yml

  1. Create a directory in your workspace which represents the project
mkdir new_project
  1. Navigate into the project directory
cd new_project
  1. Create a .gittt.yml file in a new directory or an existing project directory with the following content
name: new_project
  1. Initialize the new gittt project
gittt init

Migrate projects from .git/config to .gittt.yml

  1. Create a .gittt.yml file in a new directory or an existing project directory with the following content
name: name_of_the_project_to_book_resources_to
  1. Navigate to the projects directory in your gittt config directory in your home directory
cd ~/.gittt-cli/projects
  1. Move the projects file from the project to migrate into the root projects directory
mv github_com/project_to_migrate.json .
  1. Open up the json file and remove the meta data object and fix the name
2,6d1
<     "meta": {
<         "host": "github.com",
<         "port": null,
<         "raw": "git@github.com:eiabea/tempea-api.git"
<     },
>     "name": "name_of_the_project_to_book_resources_to",
  1. Save the file and you are good to go

Bash completion

cp bash/gittt-completion.bash /etc/bash_completion.d/gittt-completion.bash
source /etc/bash_completion.d/gittt-completion.bash

How to

  1. Install binary on your system (tba.)
  2. Create an empty private git repository on your favorite git provider (e.g. github or GitLab) or on your private git server
  3. Initialize the gittt working directory by executing
$ gittt init
  1. Change into a local git repository of any awesome project you are currently working on
$ cd my-awesome-project
  1. Commit the spent hours with the following command
$ gittt commit -m "Spent a great time with this code" -a 3
  1. After committing more hours or editing already committed hours the data can be pushed to your time tracking repository by executing
$ gittt push

CSV Import to projects

Use the CSV importer option to import a csv file to your project.

The CSV file has to include a header with at least the columns MESSAGE,END,AMOUNT,TYPE (any other columns will be ignored)

Hint: The TYPE row is mandatory and currently only takes Time as a valid input.

MESSAGE,END,AMOUNT,TYPE
Added Production Build,1570298400000,0.5,Time

Import data to your current project (aka. The git directory you are currently at) with

$ gittt import [path_to_your_file].csv

Releases

The binary releases can be found under the Releases Tab

Contribute

Every help is appreciated, take a look at the Contributing file

Current Tags

  • 1.7.4                                ...           latest (2 months ago)

25 Versions

  • 1.7.4                                ...           2 months ago
  • 1.7.3                                ...           2 months ago
  • 1.7.2                                ...           2 months ago
  • 1.7.0                                ...           3 months ago
  • 1.6.4                                ...           3 months ago
  • 1.6.3                                ...           3 months ago
  • 1.6.0                                ...           4 months ago
  • 1.5.0                                ...           4 months ago
  • 1.4.2                                ...           4 months ago
  • 1.4.1                                ...           4 months ago
  • 1.3.5                                ...           6 months ago
  • 1.3.4                                ...           6 months ago
  • 1.3.2                                ...           6 months ago
  • 1.3.1                                ...           6 months ago
  • 1.3.0                                ...           6 months ago
  • 1.2.2                                ...           6 months ago
  • 1.2.1                                ...           6 months ago
  • 1.1.2                                ...           7 months ago
  • 1.0.5                                ...           a year ago
  • 1.0.4                                ...           a year ago
  • 1.0.3                                ...           a year ago
  • 1.0.2                                ...           a year ago
  • 1.0.1                                ...           a year ago
  • 1.0.0-yR3h                                ...           a year ago
  • 1.0.0-Htb1                                ...           a year ago
Maintainers (1)
Downloads
Today 0
This Week 25
This Month 25
Last Day 0
Last Week 0
Last Month 25
Dependencies (27)
Dev Dependencies (12)
Dependents (0)
None

Copyright 2014 - 2016 © taobao.org |