Sebastian Raschka


I would be happy to hear your comments and suggestions.
Please feel free to drop me a note via twitter, email, or google+.


IPython magic function documentation - %watermark

I wrote this simple watermark IPython magic function to conveniently add date- and time-stamps to my IPython notebooks. Also, I often want to document various system information, e.g., for my Python benchmarks series.



Installation

The watermark line magic can be directly installed from my GitHub repository via


In [2]:
%install_ext https://raw.githubusercontent.com/rasbt/watermark/master/watermark.py


Installed watermark.py. To use it, type:
  %load_ext watermark



Loading the %watermark magic

To load the date magic, execute the following line in your IPython notebook or current IPython shell


In [2]:
%load_ext watermark



Usage

In order to display the optional watermark arguments, type


In [3]:
%watermark?
  %watermark [-a AUTHOR] [-d] [-e] [-n] [-t] [-z] [-u] [-c CUSTOM_TIME]
                 [-v] [-p PACKAGES] [-h] [-m] [-g] [-w]


IPython magic function to print date/time stamps 
and various system information.

watermark version 1.2.1

optional arguments:
  -a AUTHOR, --author AUTHOR
                        prints author name
  -d, --date            prints current date as MM/DD/YYYY
  -e, --eurodate        prints current date as DD/MM/YYYY
  -n, --datename        prints date with abbrv. day and month names
  -t, --time            prints current time
  -z, --timezone        appends the local time zone
  -u, --updated         appends a string "Last updated: "
  -c CUSTOM_TIME, --custom_time CUSTOM_TIME
                        prints a valid strftime() string
  -v, --python          prints Python and IPython version
  -p PACKAGES, --packages PACKAGES
                        prints versions of specified Python modules and
                        packages
  -h, --hostname        prints the host name
  -m, --machine         prints system and machine info
  -g, --githash         prints current Git commit hash
  -w, --watermark       prints the current version of watermark



Examples


In [4]:
%watermark


06/17/2015 15:04:35

CPython 3.4.3
IPython 3.1.0

compiler   : GCC 4.2.1 (Apple Inc. build 5577)
system     : Darwin
release    : 14.3.0
machine    : x86_64
processor  : i386
CPU cores  : 4
interpreter: 64bit



In [5]:
%watermark -d -t


06/17/2015 15:04:36 



In [6]:
%watermark -u -n -t -z


Last updated: Wed Jun 17 2015 15:04:36 EDT



In [7]:
%watermark -v


CPython 3.4.3
IPython 3.1.0



In [8]:
%watermark -m


compiler   : GCC 4.2.1 (Apple Inc. build 5577)
system     : Darwin
release    : 14.3.0
machine    : x86_64
processor  : i386
CPU cores  : 4
interpreter: 64bit



In [9]:
%watermark -v -m -p numpy,scipy -g


CPython 3.4.3
IPython 3.1.0

numpy 1.9.2
scipy 0.15.1

compiler   : GCC 4.2.1 (Apple Inc. build 5577)
system     : Darwin
release    : 14.3.0
machine    : x86_64
processor  : i386
CPU cores  : 4
interpreter: 64bit
Git hash   : fde9b4a1c1c0cd706a09a1c37e210755c59bffae



In [10]:
%watermark -a "John Doe" -d -v -m


John Doe 06/17/2015 

CPython 3.4.3
IPython 3.1.0

compiler   : GCC 4.2.1 (Apple Inc. build 5577)
system     : Darwin
release    : 14.3.0
machine    : x86_64
processor  : i386
CPU cores  : 4
interpreter: 64bit