public
Description: Keep track of your time on FreshBooks
Homepage: http://b.logi.cx/2008/1/31/laying-down-fresh-tracks
Clone URL: git://github.com/flogic/freshtrack.git
Search Repo:
commit  8dc895a27758d2ffa87179544df0ff0e33a26bbe
tree    60c4d9ad30d2ffea1ad20ce2cc8b9918bf52484b
parent  eeb56d6bdcf826721efdf54ad7c5de8c26322de4
name age message
folder .gitignore Wed Feb 27 10:49:49 -0800 2008 .gitignore time for pkg [ymendel]
folder History.txt Wed Feb 27 11:31:58 -0800 2008 Changing version, adding history. [ymendel]
folder License.txt Tue Jan 29 18:14:30 -0800 2008 Filling in my name a few times, setting up rspe... [ymendel]
folder Manifest.txt Wed Jan 30 18:26:05 -0800 2008 Added binary to manifest. [ymendel]
folder README.txt Wed Feb 27 11:31:58 -0800 2008 Changing version, adding history. [ymendel]
folder Rakefile Tue Jan 29 18:03:44 -0800 2008 Initial newgem framework. [ymendel]
folder bin/ Wed Jan 30 18:41:03 -0800 2008 Changes to binary, including actually initializ... [ymendel]
folder config/ Wed Feb 27 13:27:26 -0800 2008 Modified gemspec to require the 2.1 API version... [ymendel]
folder lib/ Wed Feb 27 11:31:58 -0800 2008 Changing version, adding history. [ymendel]
folder log/ Tue Jan 29 18:03:44 -0800 2008 Initial newgem framework. [ymendel]
folder script/ Tue Jan 29 18:03:44 -0800 2008 Initial newgem framework. [ymendel]
folder setup.rb Tue Jan 29 18:03:44 -0800 2008 Initial newgem framework. [ymendel]
folder spec/ Wed Feb 27 11:20:01 -0800 2008 Modified FreshBooks::TimeEntry to work with the... [ymendel]
folder tasks/ Tue Jan 29 18:03:44 -0800 2008 Initial newgem framework. [ymendel]
README.txt
Freshtrack is used to automatically create time entries in FreshBooks.

It presently depends on punch, the gem by Ara T. Howard, and any arguments given to 
freshtrack are passed along to punch as if freshtrack were an alias for 'punch list'.

For example

  freshtrack proj --after 2008-01-16 --before 2008-02-01

would get time data for the second half of January 2008 by using the command

  punch list proj --after 2008-01-16 --before 2008-02-01


Freshtrack requires a configuration file, ~/.freshtrack.yml, that looks something like

  --- 
  company: Company Name
  token: API Token
  project_task_mapping:
    project_name:
      :project: FreshBooks Project Name
      :task: FreshBooks Task Name

The 'Company Name' is the XXX in 'XXX.freshbooks.com'. The 'project_name' is the XXX in 'punch list XXX'


NOTE: As of this writing, punch (0.0.1) specifically requires attributes version 5.0.0 even though 5.0.1 is out.
Because of the way gems work, punch will not work if both are installed. Make sure the specific installed version 
of attributes is 5.0.0.