NAME
App::JobLog::Command::summary - show what you did during a particular period
VERSION
version 1.042
SYNOPSIS
houghton@NorthernSpy:~$ job summary --help
job <command>
job summary [-cdiMmnTtVW] [long options...] [<date or date range>]
Use 'job help summary' to see full details.
-d STR --date STR provide the time expression as
an option instead of an argument
-n --notes show notes instead of events
-t STR... --tag STR... filter events/notes to include
only those with given tags;
multiple tags may be specified
-T STR... --exclude-tag STR... filter events/notes to exclude
those with given tags; multiple
tags may be specified
-m STR... --match STR... filter events/notes to include
only those one of whose
descriptions matches the given
regex; multiple regexes may be
specified
-M STR... --no-match STR... filter events/notes to include
only those one of whose
descriptions do not match the
given regex; multiple regexes
may be specified
-i STR --time STR consider only those portions of
events/notes that overlap the
given time range
--ma --mall --merge-all glom all events/notes into one
synopsis
--madj --merge-adjacent merge contiguous events
--mast --merge-adjacent-same-tags merge contiguous,
identically-tagged events/notes
(default)
--mst --merge-same-tags merge all identically tagged
events/notes
--msd --merge-same-day merge all events/notes in a
given day
--msdst --merge-same-day-same-tags merge all events/notes in a
given day
--nm --no-merge keep all events/notes separate
-V --no-vacation do not display vacation hours
--no-date do not display a date before
each distinct day
--no-time do not display event or note
start times and event end times
--no-duration do not display event durations
--no-tags do not display tags
--no-description do not display event/note
descriptions
--no-totals do not display the footer
containing total hours worked,
etc.
-c INT --columns INT limit the width of the report to
the specified number of columns;
by default the width of the
terminal is automatically
detected and, if that fails, a
width of 76 is used
-W --no-wrap do not wrap the text to fit
columns
--help this usage screen
houghton@NorthernSpy:~$ job s this week
Sunday, 6 March, 2011
7:36 - 7:37 pm 0.01 bar, foo something to add; and still more
Monday, 7 March
8:01 am - ongoing 1.05 bar, foo something to add; and still more
TOTAL HOURS 1.07
bar 1.07
foo 1.07
houghton@NorthernSpy:~$ job s --notes this week
Monday, 6 February
1:32 - 1:33 pm giving this thing a test run; maybe the second note will be faster
2:08 - 4:31 pm foo testing out note tagging; another note that should have the same tag; taking a note
4:32 - 4:33 pm money taking a note about money; taking another note that will be tagged with money
4:33 pm taking a note without any tags
houghton@NorthernSpy:~$ job s this month
Tuesday, 1 March, 2011
8:00 - 9:23 am 1.39 widgets adding handling of simplified pdf docs
Friday, 4 March
1:48 - 2:55 pm 1.11 widgets trying to get Eclipse working properly again
3:50 - 5:30 pm 1.66 widgets figuring out why some files are really, really slow
Sunday, 6 March
7:36 - 7:37 pm 0.01 bar, foo something to add; and still more
Monday, 7 March
8:01 am - ongoing 1.05 bar, foo something to add; and still more
TOTAL HOURS 5.23
bar 1.07
foo 1.07
widgets 4.16
houghton@NorthernSpy:~$ job s 2011/3/1
Tuesday, 1 March, 2011
8:00 - 9:23 am 1.39 widgets adding handling of simplified pdf docs
TOTAL HOURS 1.39
widgets 1.39
houghton@NorthernSpy:~$ job s Friday through today
Friday, 4 March, 2011
1:48 - 2:55 pm 1.11 widgets trying to get Eclipse working properly again
3:50 - 5:30 pm 1.66 widgets figuring out why some files are really, really slow
Sunday, 6 March
7:36 - 7:37 pm 0.01 bar, foo something to add; and still more
Monday, 7 March
8:01 am - ongoing 1.06 bar, foo something to add; and still more
TOTAL HOURS 3.84
bar 1.07
foo 1.07
widgets 2.77
houghton@NorthernSpy:~$ job s --merge-same-tags Friday through today
2.77 widgets trying to get Eclipse working properly again; figuring out why some files are really, really slow
1.07 bar, foo something to add; and still more
TOTAL HOURS 3.85
bar 1.07
foo 1.07
widgets 2.77DESCRIPTION
App::JobLog::Command::summary is the command that extracts pretty reports from the log. Its options are all concerned with filtering events and formatting the report. The report must be either a report of tasks or a report of notes.
SEE ALSO
App::JobLog::Command::today, App::JobLog::Command::last, App::JobLog::Command::parse, App::JobLog::Command::tags, App::JobLog::TimeGrammar
AUTHOR
David F. Houghton <dfhoughton@gmail.com>
COPYRIGHT AND LICENSE
This software is copyright (c) 2011 by David F. Houghton.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.