# Punch-0.0.1

**URL:** <https://www.ruby-forum.com/t/punch-0-0-1/122368>\
**Category:** Ruby\
**Created:** [December 7, 2007, 12:10am UTC](https://www.ruby-forum.com/t/punch-0-0-1/122368 "2007-12-07T00:10:49Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![ara.t.howard](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/a/a8b319/32.png) [@ara.t.howard](https://www.ruby-forum.com/u/ara.t.howard)\
**Post date:** [December 7, 2007, 12:10am UTC](https://www.ruby-forum.com/t/punch-0-0-1/122368/1 "2007-12-07T00:10:49Z")

</div>

NAME  
punch

SYNOPSIS  
punch (in|out|log|clock|status|list|total|delete|dump) [options]+

URIS  
[http://codeforpeople.com/lib/ruby/punch](http://codeforpeople.com/lib/ruby/punch)  
[http://rubyforge.org/projects/codeforpeople/](http://rubyforge.org/projects/codeforpeople/)

INSTALL  
gem install punch

DESCRIPTION  
punch is a k.i.s.s. tool for tracking the hours spent on various  
projects.  
it supports logging hours under a project name, adding notes about  
work  
done during that period, and several very simple reporting tools that  
operate over a window of time.

run ‘punch help modename’ for more info.

PARAMETERS  
–help, -h

EXAMPLES  
. punch in projectname  
. punch log projectname “can has time tracking”  
. punch out projectname  
. punch total projectname --after 2007-12-03 --before 2007-12-07

a @ [http://codeforpeople.com/](http://codeforpeople.com/)

---

<div class="post-metadata">

**Author:** ![ara.t.howard](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/a/a8b319/32.png) [@ara.t.howard](https://www.ruby-forum.com/u/ara.t.howard)\
**Post date:** [December 7, 2007, 1:03am UTC](https://www.ruby-forum.com/t/punch-0-0-1/122368/2 "2007-12-07T01:03:26Z")

</div>

On Dec 6, 5:09 pm, “ara.t.howard” [removed\_email\_address@domain.invalid](mailto:removed_email_address@domain.invalid) wrote:

> ## INSTALL run ‘punch help modename’ for more info. a @[http://codeforpeople.com/](http://codeforpeople.com/)
> 
> it is not enough to be compassionate. you must act.  
> h.h. the 14th dalai lama

Very nice, Ara.

I was playing with an earlier version that someone linked me to, and  
the addition of the log is wonderful, as are other improvements. It  
was worth the small effort required to convert my old data (only a few  
punches).

---

<div class="post-metadata">

**Author:** ![ara.t.howard](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/a/a8b319/32.png) [@ara.t.howard](https://www.ruby-forum.com/u/ara.t.howard)\
**Post date:** [December 7, 2007, 1:21am UTC](https://www.ruby-forum.com/t/punch-0-0-1/122368/3 "2007-12-07T01:21:33Z")

</div>

On Dec 6, 2007, at 5:02 PM, Yossef M. wrote:

> Very nice, Ara.
> 
> I was playing with an earlier version that someone linked me to, and  
> the addition of the log is wonderful, as are other improvements. It  
> was worth the small effort required to convert my old data (only a few  
> punches).

glad to hear it. encoding a schema version into the yaml file so  
support migrations is on my TODO list - but right now i’m just trying  
to settle on what a minimal commandline time tracker should look  
like. any comments from a user’s perspective are great.

cheers.

a @ [http://codeforpeople.com/](http://codeforpeople.com/)

---

<div class="post-metadata">

**Author:** ![ara.t.howard](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/a/a8b319/32.png) [@ara.t.howard](https://www.ruby-forum.com/u/ara.t.howard)\
**Post date:** [December 7, 2007, 4:23am UTC](https://www.ruby-forum.com/t/punch-0-0-1/122368/4 "2007-12-07T04:23:58Z")

</div>

On Dec 6, 2007, at 7:12 PM, Yossef M. wrote:

> I accept a certain risk when I start using not-actually-released  
> software, especially when it turns out to be pre-0.0.1 .

😉

a @ [http://codeforpeople.com/](http://codeforpeople.com/)

---

<div class="post-metadata">

**Author:** ![ara.t.howard](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/a/a8b319/32.png) [@ara.t.howard](https://www.ruby-forum.com/u/ara.t.howard)\
**Post date:** [December 7, 2007, 3:18am UTC](https://www.ruby-forum.com/t/punch-0-0-1/122368/5 "2007-12-07T03:18:29Z")

</div>

> encoding a schema version into the yaml file so  
> support migrations is on my TODO list

I accept a certain risk when I start using not-actually-released  
software, especially when it turns out to be pre-0.0.1 .
