Project

waddup

0.0
Repository is archived
No commit activity in last 3 years
No release in over 3 years
Waddup retraces your activities from arbitrary sources such as version control, issue tracking software and mail clients - and displays them in a neat chronological overview
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

Runtime

~> 0.10.2
~> 4.1.5
 Project Readme

Waddup

Gem Version Build Status Maintainability Test Coverage

Waddup is a Ruby gem that retraces your activities from arbitrary sources - such as version control, issue tracking software and mail clients - and displays them in a neat chronological overview.

Perfect for those who have lost track of what they have worked on.

Supported Ruby versions: 2.2 or higher

Licensed under the MIT license.

Waddup

Installation

Waddup is available from RubyGems and can be installed through the command-line.

Fire up your favourite terminal and run:

gem install waddup

Installing on OSX and using the default system Ruby? Run:

sudo gem install waddup

Usage

Once installed, use the command waddup or its alias sup as follows:

waddup with git and mail since last week through yesterday 23:00

Waddup is fairly liberal in what it accepts. The keywords described below may be mixed or omitted as desired.

Sources

At present, Waddup ships with three sources:

  • Git git
  • Apple Mail mail
  • Apple Calendar ical

To specify one or multiple sources, use the with-keyword forming a regular sentence with the listed aliases:

waddup with git
waddup with git, mail and ical

When the with-keyword is omitted it will default to all usable sources.

Start date

To specify a start date, use either from or since as a keyword:

waddup from october 29, 2013 9:00 AM
waddup since last friday

Defaults to right now if a start date is omitted. This default is likely to change in the future.

Dates/times are liberally parsed using Chronic. A grasp of crazy inputs one can use:

  • yesterday
  • last night
  • last winter
  • 3rd wednesday in november
  • may seventh '97 at three in the morning

End date

To specify an end date, use one of to, until, uptil, upto or through:

waddup upto one week ago
waddup through yesterday

Defaults to right now if an end date is omitted.

Formats

At present, Waddup supports two formats: visual (see screenshot) and JSON.

Use the --format flag to indicate the desired output format:

waddup since yesterday --format json