poljakowski/ctt: ctt - time tracking for geeks - ctt

ctt - time tracking for geeks

Go to file

Nico Schottelius 58a8924811 change disk format and add conversion utility Signed-off-by: Nico Schottelius <nico@brief.schottelius.org>		2012-08-28 14:03:58 +02:00
bin	can specifiy start and end datetimes for tracking	2012-08-27 18:37:03 +02:00
lib/ctt	change disk format and add conversion utility	2012-08-28 14:03:58 +02:00
tools	change disk format and add conversion utility	2012-08-28 14:03:58 +02:00
.gitignore	ignore python cache	2012-08-24 17:21:15 +02:00
README	reporting tracked time works	2012-08-27 17:37:56 +02:00

README

ctt - starts time tracking
    press ctrl-c to stop time tracking

ctt -t|--track
ctt --start "date"
ctt --start "date" --stop "otherdate"


Save to ~/.ctt/times/<project>/

Dateformat:
    YYYY-MM-DD

Report:
    
ctt(1)
======
Nico Schottelius <nico-ctt--@--schottelius.org>


NAME
----
ctt - time tracking for geeks


SYNOPSIS
--------
ctt [-h] [-V]

ctt track [-h] [-d] [-v] [-s START] [-e END] project

ctt report [-h] [-d] [-v] [-s START] [-e END] project


TIME TRACKING
-------------
If you start ctt with a project name, ctt will begin right away to
track the time, until you stop it using Ctrl-C:

--------------------------------------------------------------------------------
ctt track myreport
--------------------------------------------------------------------------------

-h, --help::
   Show the help screen

-V, --version::
   Show version and exit


BANNER
-------
Displays the ctt banner.


CONFIG
------
Configure a system

-h, --help::
    Show the help screen

-c CDIST_HOME, --ctt-home CDIST_HOME::
    Instead of using the parent of the bin directory as ctt home,
    use the specified directory

-d, --debug::
    Enable debug output

-i MANIFEST, --initial-manifest MANIFEST::
    Path to a ctt manifest or - to read from stdin

-p, --parallel::
    Operate on multiple hosts in parallel

-s, --sequential::
    Operate on multiple hosts sequentially

--remote-copy REMOTE_COPY:
    Command to use for remote copy (should behave like scp)

--remote-exec REMOTE_EXEC:
    Command to use for remote execution (should behave like ssh)


EXAMPLES
--------

--------------------------------------------------------------------------------
# Configure ikq05.ethz.ch with debug enabled
ctt config -d ikq05.ethz.ch

# Configure hosts in parallel and use a different home directory
ctt config -c ~/p/ctt-nutzung \
    -p ikq02.ethz.ch ikq03.ethz.ch ikq04.ethz.ch

# Use custom remote exec / copy commands
ctt config --remote-exec /path/to/my/remote/exec \
    --remote-copy /path/to/my/remote/copy \
    -p ikq02.ethz.ch ikq03.ethz.ch ikq04.ethz.ch

# Display banner
ctt banner

# Show help
ctt --help

# Show Version
ctt --version
--------------------------------------------------------------------------------


ENVIRONMENT
-----------
TMPDIR, TEMP, TMP::
   Setup the base directory for the temporary directory.
   See http://docs.python.org/py3k/library/tempfile.html for
   more information. This is rather useful, if the standard
   directory used does not allow executables.


EXIT STATUS
-----------
The following exit values shall be returned:

0::
    Successful completion
1::
    One or more host configurations failed


SEE ALSO
--------
- ctt(7)
- ctt-reference(7)


COPYING
-------
Copyright \(C) 2011-2012 Nico Schottelius. Free use of this software is
granted under the terms of the GNU General Public License version 3 (GPLv3).