update manpage, update parameter descriptions
Signed-off-by: Nico Schottelius <nico@bento.schottelius.org>
This commit is contained in:
parent
2f2f774e8d
commit
e6e1ffbbf8
2 changed files with 62 additions and 20 deletions
28
bin/ctt
28
bin/ctt
|
@ -37,10 +37,10 @@ def parse_argv(argv, version):
|
|||
parser = {}
|
||||
parser['loglevel'] = argparse.ArgumentParser(add_help=False)
|
||||
parser['loglevel'].add_argument('-d', '--debug',
|
||||
help='Set log level to debug', action='store_true',
|
||||
help='set log level to debug', action='store_true',
|
||||
default=False)
|
||||
parser['loglevel'].add_argument('-v', '--verbose',
|
||||
help='Set log level to info, be more verbose',
|
||||
help='set log level to info, be more verbose',
|
||||
action='store_true', default=False)
|
||||
|
||||
parser['main'] = argparse.ArgumentParser(description='ctt ' + version,
|
||||
|
@ -55,27 +55,27 @@ def parse_argv(argv, version):
|
|||
parser['track'] = parser['sub'].add_parser('track',
|
||||
parents=[parser['loglevel']])
|
||||
parser['track'].set_defaults(func=Tracker.commandline)
|
||||
parser['track'].add_argument("-s", "--start", help="Start datetime (format: %s)" % ctt.DATETIMEFORMAT_PLAIN,
|
||||
nargs=1)
|
||||
parser['track'].add_argument("-e", "--end", help="End datetime (format: %s)" % ctt.DATETIMEFORMAT_PLAIN,
|
||||
nargs=1)
|
||||
parser['track'].add_argument("-n", "--no-comment", help="Disable comment prompting after tracking",
|
||||
parser['track'].add_argument("--sd", "--start", help="start date (default: first of this month, format: %s)" % ctt.DATEFORMAT_PLAIN,
|
||||
nargs=1, dest="start")
|
||||
parser['track'].add_argument("--ed", "--end", help="end date (default: last of this month, format: %s)" % ctt.DATEFORMAT_PLAIN,
|
||||
nargs=1, default=None, dest="end")
|
||||
parser['track'].add_argument("-n", "--no-comment", help="disable comment prompting after tracking",
|
||||
action='store_false', dest="comment")
|
||||
parser['track'].add_argument("project", help="Project to track time for", nargs=1)
|
||||
parser['track'].add_argument("project", help="project to track time for", nargs=1)
|
||||
|
||||
parser['report'] = parser['sub'].add_parser('report',
|
||||
parents=[parser['loglevel']])
|
||||
parser['report'].set_defaults(func=Report.commandline)
|
||||
parser['report'].add_argument("project", help="Project to report time for", nargs=1)
|
||||
parser['report'].add_argument("--sd", "--start", help="Start date (default: first of last month, format: %s)" % ctt.DATEFORMAT_PLAIN,
|
||||
parser['report'].add_argument("project", help="project to report time for", nargs=1)
|
||||
parser['report'].add_argument("--sd", "--start", help="start date (default: first of this month, format: %s)" % ctt.DATEFORMAT_PLAIN,
|
||||
nargs=1, dest="start")
|
||||
parser['report'].add_argument("--ed", "--end", help="End date (default: last of last month, format: %s)" % ctt.DATEFORMAT_PLAIN,
|
||||
parser['report'].add_argument("--ed", "--end", help="end date (default: last of this month, format: %s)" % ctt.DATEFORMAT_PLAIN,
|
||||
nargs=1, default=None, dest="end")
|
||||
|
||||
parser['report'].add_argument("-e", "--regexp", help="Regular expression to match",
|
||||
parser['report'].add_argument("-e", "--regexp", help="regular expression to match",
|
||||
default=None)
|
||||
parser['report'].add_argument("-i", "--ignore-case", help="Ignore case distinctions", action="store_true")
|
||||
parser['report'].add_argument("-f", "--format", help="Output format (default: %s)" % ctt.REPORTFORMAT,
|
||||
parser['report'].add_argument("-i", "--ignore-case", help="ignore case distinctions", action="store_true")
|
||||
parser['report'].add_argument("-f", "--format", help="output format (default: %s)" % ctt.REPORTFORMAT,
|
||||
default=ctt.REPORTFORMAT, dest="output_format")
|
||||
|
||||
#parser['track'].add_argument("-t", "--tag", help="Add tags",
|
||||
|
|
54
ctt.text
54
ctt.text
|
@ -29,6 +29,8 @@ in a cconfig database.
|
|||
|
||||
GENERAL OPTIONS
|
||||
---------------
|
||||
The following parameters are available to all subcommands:
|
||||
|
||||
-h, --help::
|
||||
show this help message and exit
|
||||
-d, --debug::
|
||||
|
@ -40,25 +42,47 @@ GENERAL OPTIONS
|
|||
TRACK
|
||||
-----
|
||||
Tracking is started by using the **track** subcommand.
|
||||
It requires a project name to track time for.
|
||||
It requires the project name to track time for.
|
||||
|
||||
Without any options it stays in the foreground and waits until
|
||||
enter is pressed and then prompts for a comment.
|
||||
|
||||
Available parameters:
|
||||
|
||||
-s START, --start START::
|
||||
start datetime (format: Y-m-d-HM)
|
||||
-e END, --end END::
|
||||
end datetime (format: Y-m-d-HM)
|
||||
--sd START, --start START::
|
||||
start date (default: first of this month, format: Y-m-d)
|
||||
--ed END, --end END::
|
||||
end date (default: last of this month, format: Y-m-d)
|
||||
-n, --no-comment::
|
||||
disable comment prompting after tracking
|
||||
|
||||
|
||||
REPORT
|
||||
------
|
||||
Reporting is handled by the **report** subcommand.
|
||||
It requires the project name to report time for.
|
||||
It supports to filter entries using regular expressions
|
||||
and also allows to use a custom output format.
|
||||
|
||||
Available parameters:
|
||||
|
||||
--sd START, --start START::
|
||||
start date (default: first of this month, format: Y-m-d)
|
||||
--ed END, --end END::
|
||||
end date (default: last of this month, format: Y-m-d)
|
||||
-e REGEXP, --regexp REGEXP::
|
||||
regular expression to match
|
||||
-i, --ignore-case::
|
||||
ignore case distinctions
|
||||
-f OUTPUT_FORMAT, --format OUTPUT_FORMAT::
|
||||
output format (default: {0} ({1}): {2})
|
||||
|
||||
|
||||
LISTPROJECTS
|
||||
------------
|
||||
The **listprojects** subcommand is used to list used projects.
|
||||
It does not expect any parameters.
|
||||
|
||||
|
||||
EXAMPLES
|
||||
--------
|
||||
|
@ -79,6 +103,23 @@ Comment: Started early today
|
|||
# Track without prompting for a comment
|
||||
% ctt track -n test
|
||||
|
||||
# List available projects
|
||||
% ctt listprojects
|
||||
[...]
|
||||
|
||||
# List all entries of this month for project test
|
||||
% ctt report test
|
||||
[...]
|
||||
|
||||
# List all entries from January
|
||||
% ctt report --sd 2013-01-01 --ed 2013-01-31 test
|
||||
|
||||
# List all entries from January matching either rails ruby or cdist
|
||||
% ctt report --sd 2013-01-29 --ed 2013-04-29 -e "(rails|ruby|cdist)" test
|
||||
|
||||
# The same, but case insensitive
|
||||
% ctt report --sd 2013-01-29 --ed 2013-04-29 -e "(rails|ruby|cdist)" -i test
|
||||
|
||||
--------------------------------------------------------------------------------
|
||||
|
||||
BUGS
|
||||
|
@ -89,7 +130,8 @@ If it does, raise a bug.
|
|||
SEE ALSO
|
||||
---------
|
||||
|
||||
- cconfig: http://www.nico.schottelius.org/docs/cconfig/
|
||||
- cconfig homepage: http://www.nico.schottelius.org/docs/cconfig/
|
||||
- ctt homepage: http://www.nico.schottelius.org/software/ctt/
|
||||
|
||||
|
||||
COPYING
|
||||
|
|
Loading…
Reference in a new issue