Package: did
What did you do last week, month, year?DescriptionComfortably gather status report data (e.g. list of committed
changes) for given week, month, quarter, year or selected date
range. By default all available stats for this week are reported.Based on the config,didexplores user’s activity for given
tools in provided time frame. For example checks all configured
git repositories for the list of commits or contacts Bugzilla to
search for bugs created, modified or closed.Some information (like git commits) is gathered from the local
file system, but usually individual plugins are contacting remote
API of the tool to query for the latest data. For tools which
provide a public API there is no need for authentication. Some
plugins support Kerberos, other need to create an authentication
token. See individual plugin documentation for details.SynopsisUsage is straightforward:did [this|last] [week|month|quarter|year] [opts]ExamplesGather all stats for current week:didShow me all stats for today, yesterday, last Friday:did today
did yesterday
did last fridayGather stats for the last month:did last monthSeedid--helpfor complete list of available stats.OptionsThe list of available options depends on which plugins are
configured. Here’s the list of general options which are not
related to any plugin:SelectAt least one email address needs to be provided on command line
unless defined in the config file. Use the complete email address
formatName Surname <email@example.org>to display full name
in the report output. For date valuestodayandyesterdaycan be used instead of the full date format.--email=EMAILSUser email address(es)--since=SINCEStart date in the YYYY-MM-DD format--until=UNTILEnd date in the YYYY-MM-DD formatFormatThe default output is plain text of maximum width 79 characters.
This can be adjusted using the--widthparameter. To disable
shortening altogether use--width=0. The default width value
can be saved in the config file as well. Use--format=wikito
enable simple MoinMoin wiki syntax or--format=markdownto
enable markdown syntax. For stats which support them,--briefand--verbosecan be used to specify a different level of
detail to be shown.–format {text,markdown,wiki}Output style, default: text--width=WIDTHMaximum width of the report output (default: 79)--briefShow brief summary only, do not list individual items--verboseInclude more details (like modified git directories)UtilsMultiple emails can be used to put together a team report or to
gather stats for all of your email aliases. For this use case--totaland--mergecan be used to append the overall
summary at the end or merge all results into a single report
respectively. Use--debugor set the environment variableDEBUGto 1 through 5 to set the desired level of debugging.--config=FILEUse alternate configuration file (default: ‘config’)--totalAppend total stats after listing individual users--mergeMerge stats of all users into a single report--debugTurn on debugging output, do not catch exceptionsSeedid--helpfor complete list of available options.InstallInstall directly from Fedora/Copr repository:yum install didOr use pip to install from Python Package Index:pip install didYou may want to install some or all extra requires:pip install did[plugin]
pip install did[all]To build and execute in a docker container, run:make run_dockerSee documentation for more details about installation options.ConfigThe config file~/.did/configis used to store both general
settings and configuration of individual reports:[general]
email = "Petr Šplíchal" <psplicha@redhat.com>
width = 79

[header]
type = header
highlights = Highlights
joy = Joy of the week ;-)

[tools]
type = git
did = /home/psss/git/did

[tests]
type = git
tests = /home/psss/git/tests/*

[trac]
type = trac
prefix = TT
url = https://some.trac.com/trac/project/rpc

[bz]
type = bugzilla
prefix = BZ
url = https://bugzilla.redhat.com/xmlrpc.cgi

[footer]
type = footer
next = Plans, thoughts, ideas...
status = Status: Green | Yellow | Orange | RedSee plugin documentation for more detailed description of options
available for particular plugin. You can also check python module
documentation directly, e.g.pydoc did.plugins.gitor use the
example config provided in the package and web documentation.LinksGit:https://github.com/psss/didDocs:https://did.readthedocs.ioIssues:https://github.com/psss/did/issuesReleases:https://github.com/psss/did/releasesCopr:https://copr.fedoraproject.org/coprs/psss/didPIP:https://pypi.org/project/didAuthorsPetr Šplíchal, Karel Šrot, Lukáš Zachar, Matěj Cepl, Ondřej Pták,
Chris Ward, Tomáš Hofman, Martin Mágr, Stanislav Kozina, Paul
Belanger, Eduard Trott, Martin Frodl, Randy Barlow, Alois Mahdal,
Evgeni Golov, Stanislav Ochotnický, Maroš Kopec, Robbie Harwood,
Christopher Sams, Thomas Heute, Giulio Fidente, Han Han, Qiao
Zhao, Henrique Ferreiro, Jakub Vávra, Luigi Toscano, Lukáš
Zapletal, Maryna Nalbandian, Dominika Hoďovská, Jakub Haruda,
Han Han, Štěpán Němec, Evgeny Fedin, Mikel Olasagasti Uranga,
Miloš Malík, Jeffrey Bastian, Côme Chilliet, Marcin Juszkiewicz,
Tomáš Kopeček, Konrad Kleine, Sandro Bonazzola and Morgan Weetman.CopyrightCopyright (c) 2015 Red Hat, Inc. All rights reserved.This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of
the License, or (at your option) any later version.Status