summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorRick van de Loo <rickvandeloo@gmail.com>2014-07-30 11:14:22 +0000
committerRick van de Loo <rickvandeloo@gmail.com>2014-08-05 20:46:39 +0000
commitd3f35c959a9048066c283ea62ca76e425741915d (patch)
treef74b71cd0b5170932bb0896388ebfc7b0ab86087
parente69607f6e703b90d69ac6013ddb424ee15606ebc (diff)
downloadgit-hours-d3f35c959a9048066c283ea62ca76e425741915d.zip
git-hours-d3f35c959a9048066c283ea62ca76e425741915d.tar.gz
git-hours-d3f35c959a9048066c283ea62ca76e425741915d.tar.bz2
rebased
-rw-r--r--README.md49
1 files changed, 42 insertions, 7 deletions
diff --git a/README.md b/README.md
index 1e5a7db..0ffedf1 100644
--- a/README.md
+++ b/README.md
@@ -60,16 +60,51 @@ The algorithm in [~30 lines of code](https://github.com/kimmobrunfeldt/git-hours
## Install
- npm install -g nodegit
- npm install -g git-hours
+ $ npm install -g nodegit
+ $ npm install -g git-hours
Nodegit library is a bit unstable and might crash randomly.
+## Quick setup with Vagrant
+
+[Vagrant](https://docs.vagrantup.com/v2/getting-started/) can be used to automatically
+set up a disposable Virtual Machine with the required environment and install the
+program.
+
+```
+$ git clone https://github.com/kimmobrunfeldt/git-hours
+$ cd git-hours
+$ vagrant up && vagrant ssh
+```
+
+And that's it, you can now test out git-hours. For example:
+
+```
+$ git clone https://github.com/twbs/bootstrap
+$ cd bootstrap
+$ git hours
+{
+ "total": {
+ "hours": 6417,
+ "commits": 9779
+ }
+}
+```
+
+Then when you are done playing around you can cleanly
+[remove](https://docs.vagrantup.com/v2/cli/destroy.html) the vm from your
+system by running:
+
+```
+$ exit
+$ vagrant destroy -f
+```
+
## Usage
In root of a git repository run:
- git hours
+ $ git hours
**Note: repository is not detected if you are not in the root of repository!**
@@ -116,8 +151,8 @@ Documentation for git-hours developers.
* Edit GitHub release notes
* Release to NPM
- git checkout x.x.x
- npm publish
+ $ git checkout x.x.x
+ $ npm publish
To see an example how to release minor/major, check https://github.com/geddski/grunt-release
@@ -126,10 +161,10 @@ To see an example how to release minor/major, check https://github.com/geddski/g
Tests can be run with command
- grunt test
+ $ grunt test
or
- npm test
+ $ npm test
You need to have *mocha* installed globally with `npm install -g mocha`.