From d9f15faaf6a61380a51c99349932718a181513f4 Mon Sep 17 00:00:00 2001
From: Ultrabug <ultrabug@gentoo.org>
Date: Sat, 3 May 2014 19:36:39 +0200
Subject: rename examples folder to the modules and prepare for installation

---
 MANIFEST.in                    |   2 +-
 examples/dpms.py               |  44 -------------
 examples/empty_class.py        |  41 ------------
 examples/glpi.py               |  52 ----------------
 examples/i3bar_click_events.py | 127 --------------------------------------
 examples/netdata.py            | 132 ---------------------------------------
 examples/ns_checker.py         |  57 -----------------
 examples/pingdom.py            |  59 ------------------
 examples/pomodoro.py           | 123 ------------------------------------
 examples/sysdata.py            | 137 -----------------------------------------
 examples/weather_yahoo.py      | 106 -------------------------------
 examples/whoami.py             |  26 --------
 modules/__init__.py            |   0
 modules/dpms.py                |  44 +++++++++++++
 modules/empty_class.py         |  41 ++++++++++++
 modules/glpi.py                |  52 ++++++++++++++++
 modules/i3bar_click_events.py  | 127 ++++++++++++++++++++++++++++++++++++++
 modules/netdata.py             | 132 +++++++++++++++++++++++++++++++++++++++
 modules/ns_checker.py          |  57 +++++++++++++++++
 modules/pingdom.py             |  59 ++++++++++++++++++
 modules/pomodoro.py            | 123 ++++++++++++++++++++++++++++++++++++
 modules/sysdata.py             | 137 +++++++++++++++++++++++++++++++++++++++++
 modules/weather_yahoo.py       | 106 +++++++++++++++++++++++++++++++
 modules/whoami.py              |  26 ++++++++
 24 files changed, 905 insertions(+), 905 deletions(-)
 delete mode 100644 examples/dpms.py
 delete mode 100644 examples/empty_class.py
 delete mode 100644 examples/glpi.py
 delete mode 100644 examples/i3bar_click_events.py
 delete mode 100644 examples/netdata.py
 delete mode 100644 examples/ns_checker.py
 delete mode 100644 examples/pingdom.py
 delete mode 100644 examples/pomodoro.py
 delete mode 100644 examples/sysdata.py
 delete mode 100644 examples/weather_yahoo.py
 delete mode 100644 examples/whoami.py
 create mode 100644 modules/__init__.py
 create mode 100644 modules/dpms.py
 create mode 100644 modules/empty_class.py
 create mode 100644 modules/glpi.py
 create mode 100644 modules/i3bar_click_events.py
 create mode 100644 modules/netdata.py
 create mode 100644 modules/ns_checker.py
 create mode 100644 modules/pingdom.py
 create mode 100644 modules/pomodoro.py
 create mode 100644 modules/sysdata.py
 create mode 100644 modules/weather_yahoo.py
 create mode 100644 modules/whoami.py

diff --git a/MANIFEST.in b/MANIFEST.in
index 191f6ec..4bb9bbc 100644
--- a/MANIFEST.in
+++ b/MANIFEST.in
@@ -1,2 +1,2 @@
 include *.rst
-recursive-include examples *.py
+recursive-include modules *.py
diff --git a/examples/dpms.py b/examples/dpms.py
deleted file mode 100644
index 783c53c..0000000
--- a/examples/dpms.py
+++ /dev/null
@@ -1,44 +0,0 @@
-from os import system
-
-
-class Py3status:
-    """
-    This module allows activation and deactivation
-    of DPMS (Display Power Management Signaling)
-    by clicking on 'DPMS' in the status bar.
-
-    Written and contributed by @tasse:
-        Andre Doser <dosera AT tf.uni-freiburg.de>
-    """
-    def __init__(self):
-        """
-        Detect current state on start.
-        """
-        self.run = system('xset -q | grep -iq "DPMS is enabled"') == 0
-
-    def dpms(self, i3status_output_json, i3status_config):
-        """
-        Display a colorful state of DPMS.
-        """
-        result = {
-            'full_text': 'DPMS',
-            'name': 'dpms'
-        }
-        if self.run:
-            result['color'] = i3status_config['color_good']
-        else:
-            result['color'] = i3status_config['color_bad']
-        return (0, result)
-
-    def on_click(self, json, i3status_config, event):
-        """
-        Enable/Disable DPMS on left click.
-        """
-        if event['button'] == 1:
-            if self.run:
-                self.run = False
-                system("xset -dpms")
-            else:
-                self.run = True
-                system("xset +dpms")
-            system("killall -USR1 py3status")
diff --git a/examples/empty_class.py b/examples/empty_class.py
deleted file mode 100644
index 077269c..0000000
--- a/examples/empty_class.py
+++ /dev/null
@@ -1,41 +0,0 @@
-class Py3status:
-    """
-    Empty and basic py3status class.
-
-    NOTE: py3status will NOT execute:
-        - methods starting with '_'
-        - methods decorated by @property and @staticmethod
-
-    NOTE: reserved method names:
-        - 'kill' method for py3status exit notification
-        - 'on_click' method for click events from i3bar
-    """
-    def kill(self, i3status_output_json, i3status_config):
-        """
-        This method will be called upon py3status exit.
-        """
-        pass
-
-    def on_click(self, i3status_output_json, i3status_config, event):
-        """
-        This method will be called when a click event occurs on this module's
-        output on the i3bar.
-
-        Example 'event' json object:
-        {'y': 13, 'x': 1737, 'button': 1, 'name': 'empty', 'instance': 'first'}
-        """
-        pass
-
-    def empty(self, i3status_output_json, i3status_config):
-        """
-        This method will return an empty text message
-        so it will NOT be displayed on your i3bar.
-
-        If you want something displayed you should write something
-        in the 'full_text' key of your response.
-
-        See the i3bar protocol spec for more information:
-        http://i3wm.org/docs/i3bar-protocol.html
-        """
-        response = {'full_text': '', 'name': 'empty', 'instance': 'first'}
-        return (0, response)
diff --git a/examples/glpi.py b/examples/glpi.py
deleted file mode 100644
index 929749d..0000000
--- a/examples/glpi.py
+++ /dev/null
@@ -1,52 +0,0 @@
-# You need MySQL-python from http://pypi.python.org/pypi/MySQL-python
-import MySQLdb
-
-
-class Py3status:
-    """
-    This example class demonstrates how to display the current total number of
-    open tickets from GLPI in your i3bar.
-
-    It features thresholds to colorize the output and forces a low timeout to
-    limit the impact of a server connectivity problem on your i3bar freshness.
-
-    Note that we don't have to implement a cache layer as it is handled by
-    py3status automagically.
-    """
-    def count_glpi_open_tickets(self, json, i3status_config):
-        response = {'full_text': '', 'name': 'glpi_tickets'}
-
-        # user-defined variables
-        CRIT_THRESHOLD = 20
-        WARN_THRESHOLD = 15
-        MYSQL_DB = ''
-        MYSQL_HOST = ''
-        MYSQL_PASSWD = ''
-        MYSQL_USER = ''
-        POSITION = 0
-
-        mydb = MySQLdb.connect(
-            host=MYSQL_HOST,
-            user=MYSQL_USER,
-            passwd=MYSQL_PASSWD,
-            db=MYSQL_DB,
-            connect_timeout=5,
-            )
-        mycr = mydb.cursor()
-        mycr.execute('''select count(*)
-                        from glpi_tickets
-                        where closedate is NULL and solvedate is NULL;''')
-        row = mycr.fetchone()
-        if row:
-            open_tickets = int(row[0])
-            if i3status_config['colors']:
-                if open_tickets > CRIT_THRESHOLD:
-                    response.update({'color': i3status_config['color_bad']})
-                elif open_tickets > WARN_THRESHOLD:
-                    response.update(
-                        {'color': i3status_config['color_degraded']}
-                    )
-            response['full_text'] = '%s tickets' % open_tickets
-        mydb.close()
-
-        return (POSITION, response)
diff --git a/examples/i3bar_click_events.py b/examples/i3bar_click_events.py
deleted file mode 100644
index 792965c..0000000
--- a/examples/i3bar_click_events.py
+++ /dev/null
@@ -1,127 +0,0 @@
-from subprocess import Popen
-from time import time
-
-
-class Py3status:
-    """
-    This module allows you to take actions based on click events made on
-    the i3status modules. For example, thanks to this module you could
-    launch the wicd GUI when clicking on the ethernet or wireless module
-    of your i3status output !
-
-    IMPORTANT:
-        This module file name is reserved and should NOT be changed if you
-        want py3status to handle your i3status modules click events !
-
-        The behavior described above will only work if this file is named
-        'i3bar_click_events.py' !
-    """
-    def __init__(self):
-        """
-        This is where you setup your actions based on your i3status config.
-
-        Configuration:
-        --------------
-        self.actions = {
-            "<module name and instance>": {
-                <button number>: [<function to run>, <arg1>, <arg2>],
-            }
-        }
-
-        Variables:
-        ----------
-        <button number> is an integer from 1 to 3:
-            1 : left click
-            2 : middle click
-            3 : right click
-
-        <function to run> is a python function written in this module.
-            The 'external_command' function is provided for convenience if
-            you want to call an external program from this module.
-            You can of course write your own functions and have them executed
-            on a click event at will with possible arguments <arg1>, <arg2>...
-
-        <module name and instance> is a string made from the module
-        attribute 'name' and 'instance' using a space as separator:
-            For i3status modules, it's simply the name of the module as it
-            appears in the 'order' instruction of your i3status.conf.
-            Example:
-                in i3status.conf -> order += "wireless wlan0"
-                self.actions key -> "wireless wlan0"
-
-        Usage example:
-        --------------
-            - Open the wicd-gtk GUI when we LEFT click on the ethernet
-            module of i3status.
-            - Open emelfm2 to /home when we LEFT click on
-            the /home instance of disk_info
-            - Open emelfm2 to / when we LEFT click on
-            the / instance of disk_info
-
-            The related i3status.conf looks like:
-                order += "disk /home"
-                order += "disk /"
-                order += "ethernet eth0"
-
-            The resulting self.actions should be:
-                self.actions = {
-                    "ethernet eth0": {
-                        1: [external_command, 'wicd-gtk', '-n'],
-                    },
-                    "disk_info /home": {
-                        1: [external_command, 'emelfm2', '-1', '~'],
-                    },
-                    "disk_info /": {
-                        1: [external_command, 'emelfm2', '-1', '/'],
-                    },
-                }
-        """
-        # CONFIGURE ME PLEASE, LOVE YOU BIG TIME !
-        self.actions = {
-        }
-
-    def on_click(self, i3status_output_json, i3status_config, event):
-        """
-        If an action is configured for the given i3status module 'name' and
-        'instance' (if present), then we'll execute the given function with
-        its arguments (if present).
-
-        Usually you SHOULD NOT modify this part of the code.
-        """
-        button = event['button']
-        key_name = '{} {}'.format(
-            event['name'],
-            event.get('instance', '')
-        ).strip()
-        if key_name in self.actions and button in self.actions[key_name]:
-            # get the function to run
-            func = self.actions[key_name][button][0]
-            assert hasattr(func, '__call__'), \
-                'first element of the action list must be a function'
-
-            # run the function with the possibly given arguments
-            func(*self.actions[key_name][button][1:])
-
-    def i3bar_click_events(self, i3status_output_json, i3status_config):
-        """
-        Cached empty output, this module doesn't show anything.
-        """
-        response = {'full_text': '', 'name': 'i3bar_click_events'}
-        response['cached_until'] = time() + 3600
-        return (-1, response)
-
-
-def external_command(*cmd):
-    """
-    This convenience function lets you call an external program at will.
-
-    NOTE:
-        The stdout and stderr MUST be suppressed as shown here to avoid any
-        output from being caught by the i3bar (this would freeze it).
-        See issue #20 for more info.
-    """
-    Popen(
-        cmd,
-        stdout=open('/dev/null', 'w'),
-        stderr=open('/dev/null', 'w')
-    )
diff --git a/examples/netdata.py b/examples/netdata.py
deleted file mode 100644
index d923036..0000000
--- a/examples/netdata.py
+++ /dev/null
@@ -1,132 +0,0 @@
-# -*- coding: utf-8 -*-
-
-# netdata
-
-# Netdata is a module uses great Py3status (i3status wrapper) to
-# display network information (Linux systems) in i3bar.
-# For more information read:
-# i3wm homepage: http://i3wm.org
-# py3status homepage: https://github.com/ultrabug/py3status
-
-# Copyright (C) <2013> <Shahin Azad [ishahinism at Gmail]>
-
-# 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 3 of the License, or
-# (at your option) any later version.
-
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-
-# You should have received a copy of the GNU General Public License
-# along with this program.  If not, see <http://www.gnu.org/licenses/>.
-
-# ----------------------------------------------------------------- #
-# Notes:
-# 1. netdata will check 'eth0' interface by default. You can
-# change it by changing 'self.net_interface' variable in 'GetData'
-# class.
-# 2. Colors are depended on strict specification in traffic/netspeed methods.
-# You can change them by manipulating conditions.
-
-import subprocess
-from time import time
-
-# Method 'netSpeed' will use this variables to calculate downloaded
-# bytes in last second.  Initializing this variables globally is
-# necessary since we can't use __init__ method in Py3Status class.
-old_transmitted, old_received = 0, 0
-
-
-class GetData:
-    """Get system status
-
-    """
-    def __init__(self):
-        # You can change it to another interface.
-        # It'll be used for grabbing net interface data.
-        self.net_interface = 'eth0'
-
-    def execCMD(self, cmd, arg):
-        """Take a system command and its argument, then return the result.
-
-        Arguments:
-        - `cmd`: system command.
-        - `arg`: argument.
-        """
-        result = subprocess.check_output([cmd, arg])
-        return result
-
-    def netBytes(self):
-        """Execute 'cat /proc/net/dev', find the interface line (Default
-        'eth0') and grab received/transmitted bytes.
-
-        """
-        net_data = self.execCMD('cat', '/proc/net/dev').split()
-        interface_index = net_data.index(self.net_interface + ':')
-        received_bytes = int(net_data[interface_index + 1])
-        transmitted_bytes = int(net_data[interface_index + 9])
-
-        return received_bytes, transmitted_bytes
-
-
-class Py3status:
-    """
-    System status in i3bar
-    """
-    def netSpeed(self, json, i3status_config):
-        """Calculate network speed ('eth0' interface) and return it.  You can
-        change the interface using 'self.net_interface' variable in
-        'GetData' class.
-
-        """
-        data = GetData()
-        response = {'full_text': '', 'name': 'net_speed'}
-
-        global old_received
-        global old_transmitted
-
-        received_bytes, transmitted_bytes = data.netBytes()
-        dl_speed = (received_bytes - old_received) / 1024.
-        up_speed = (transmitted_bytes - old_transmitted) / 1024.
-
-        if dl_speed < 30:
-            response['color'] = i3status_config['color_bad']
-        elif dl_speed < 60:
-            response['color'] = i3status_config['color_degraded']
-        else:
-            response['color'] = i3status_config['color_good']
-
-        response['full_text'] = "LAN(Kb): {:5.1f}↓ {:5.1f}↑"\
-            .format(dl_speed, up_speed)
-        response['cached_until'] = time()
-
-        old_received, old_transmitted = received_bytes, transmitted_bytes
-        return (0, response)
-
-    def traffic(self, json, i3status_config):
-        """Calculate networks used traffic. Same as 'netSpeed' method you can
-        change the interface.
-
-        """
-        data = GetData()
-        response = {'full_text': '', 'name': 'traffic'}
-
-        received_bytes, transmitted_bytes = data.netBytes()
-        download = received_bytes / 1024 / 1024.
-        upload = transmitted_bytes / 1024 / 1024.
-        total = download + upload
-
-        if total < 400:
-            response['color'] = i3status_config['color_good']
-        elif total < 700:
-            response['color'] = i3status_config['color_degraded']
-        else:
-            response['color'] = i3status_config['color_bad']
-
-        response['full_text'] = "T(Mb): {:3.0f}↓ {:3.0f}↑ {:3.0f}↕"\
-            .format(download, upload, total)
-
-        return (1, response)
diff --git a/examples/ns_checker.py b/examples/ns_checker.py
deleted file mode 100644
index 4a332b1..0000000
--- a/examples/ns_checker.py
+++ /dev/null
@@ -1,57 +0,0 @@
-import dns.resolver
-import socket
-
-
-class Py3status:
-    """
-    This module launch a simple query on each nameservers for the specified domain.
-    Nameservers are dynamically retrieved. The FQDN is the only one mandatory parameter.
-    It's also possible to add additional nameservers by appending them in nameservers list.
-
-    The default resolver can be overwritten with my_resolver.nameservers parameter.
-
-    Written and contributed by @nawadanp
-    """
-    def __init__(self):
-        self.domain = 'google.com'
-        self.lifetime = 0.3
-        self.resolver = []
-        self.nameservers = []
-
-    def ns_checker(self, i3status_output_json, i3status_config):
-        response = {'full_text': '', 'name': 'ns_checker'}
-        position = 0
-        counter = 0
-        error = False
-        nameservers = []
-
-        my_resolver = dns.resolver.Resolver()
-        my_resolver.lifetime = self.lifetime
-        if self.resolver:
-            my_resolver.nameservers = self.resolver
-
-        my_ns = my_resolver.query(self.domain, 'NS')
-
-        # Insert each NS ip address in nameservers
-        for ns in my_ns:
-            nameservers.append(str(socket.gethostbyname(str(ns))))
-        for ns in self.nameservers:
-            nameservers.append(str(ns))
-
-        # Perform a simple DNS query, for each NS servers
-        for ns in nameservers:
-            my_resolver.nameservers = [ns]
-            counter += 1
-            try:
-                my_resolver.query(self.domain, 'A')
-            except:
-                error = True
-
-        if error:
-            response['full_text'] = str(counter) + ' NS NOK'
-            response['color'] = i3status_config['color_bad']
-        else:
-            response['full_text'] = str(counter) + ' NS OK'
-            response['color'] = i3status_config['color_good']
-
-        return (position, response)
diff --git a/examples/pingdom.py b/examples/pingdom.py
deleted file mode 100644
index cddf1a9..0000000
--- a/examples/pingdom.py
+++ /dev/null
@@ -1,59 +0,0 @@
-# -*- coding: utf-8 -*-
-
-import requests
-from time import time
-
-
-class Py3status:
-    """
-    Dynamically display the latest response time of the configured checks using
-    the Pingdom API.
-    We also verify the status of the checks and colorize if needed.
-    Pingdom API doc : https://www.pingdom.com/services/api-documentation-rest/
-
-    #NOTE: This module needs the 'requests' python module from pypi
-        https://pypi.python.org/pypi/requests
-    """
-    def pingdom_checks(self, json, i3status_config):
-        response = {'full_text': '', 'name': 'pingdom_checks'}
-
-        #NOTE: configure me !
-        APP_KEY = ''             # create an APP KEY on pingdom first
-        CACHE_TIMEOUT = 600      # recheck every 10 mins
-        CHECKS = []              # checks' names you want added to your bar
-        LATENCY_THRESHOLD = 500  # when to colorize the output
-        LOGIN = ''               # pingdom login
-        PASSWORD = ''            # pingdom password
-        TIMEOUT = 15
-        POSITION = 0
-
-        r = requests.get(
-            'https://api.pingdom.com/api/2.0/checks',
-            auth=(LOGIN, PASSWORD),
-            headers={'App-Key': APP_KEY},
-            timeout=TIMEOUT,
-        )
-        result = r.json()
-        if 'checks' in result:
-            for check in [
-                ck for ck in result['checks'] if ck['name'] in CHECKS
-            ]:
-                if check['status'] == 'up':
-                    response['full_text'] += '{}: {}ms, '.format(
-                        check['name'],
-                        check['lastresponsetime']
-                    )
-                    if check['lastresponsetime'] > LATENCY_THRESHOLD:
-                        response.update(
-                            {'color': i3status_config['color_degraded']}
-                        )
-                else:
-                    response['full_text'] += '{}: DOWN'.format(
-                        check['name'],
-                        check['lastresponsetime']
-                    )
-                    response.update({'color': i3status_config['color_bad']})
-            response['full_text'] = response['full_text'].strip(', ')
-            response['cached_until'] = time() + CACHE_TIMEOUT
-
-        return (POSITION, response)
diff --git a/examples/pomodoro.py b/examples/pomodoro.py
deleted file mode 100644
index 28b5ea1..0000000
--- a/examples/pomodoro.py
+++ /dev/null
@@ -1,123 +0,0 @@
-"""
-Pomodoro countdown on i3bar originally written by @Fandekasp (Adrien Lemaire)
-"""
-from subprocess import call
-from time import time
-
-MAX_BREAKS = 4
-POSITION = 0
-TIMER_POMODORO = 25 * 60
-TIMER_BREAK = 5 * 60
-TIMER_LONG_BREAK = 15 * 60
-
-
-class Py3status:
-    """
-    """
-    def __init__(self):
-        self.__setup('stop')
-        self.alert = False
-        self.run = False
-
-    def on_click(self, json, i3status_config, event):
-        """
-        Handles click events
-        """
-        if event['button'] == 1:
-            if self.status == 'stop':
-                self.status = 'start'
-            self.run = True
-
-        elif event['button'] == 2:
-            self.__setup('stop')
-            self.run = False
-
-        elif event['button'] == 3:
-            self.__setup('pause')
-            self.run = False
-
-    @property
-    def response(self):
-        """
-        Return the response full_text string
-        """
-        return {
-            'full_text': '{} ({})'.format(self.prefix, self.timer),
-            'name': 'pomodoro'
-        }
-
-    def __setup(self, status):
-        """
-        Setup a step
-        """
-        self.status = status
-        if status == 'stop':
-            self.prefix = 'Pomodoro'
-            self.status = 'stop'
-            self.timer = TIMER_POMODORO
-            self.breaks = 1
-
-        elif status == 'start':
-            self.prefix = 'Pomodoro'
-            self.timer = TIMER_POMODORO
-
-        elif status == 'pause':
-            self.prefix = 'Break #%d' % self.breaks
-            if self.breaks > MAX_BREAKS:
-                self.timer = TIMER_LONG_BREAK
-                self.breaks = 1
-            else:
-                self.breaks += 1
-                self.timer = TIMER_BREAK
-
-    def __decrement(self):
-        """
-        Countdown handler
-        """
-        self.timer -= 1
-        if self.timer < 0:
-            self.alert = True
-            self.run = False
-            self.__i3_nagbar()
-            if self.status == 'start':
-                self.__setup('pause')
-                self.status = 'pause'
-            elif self.status == 'pause':
-                self.__setup('start')
-                self.status = 'start'
-
-    def __i3_nagbar(self, level='warning'):
-        """
-        Make use of i3-nagbar to display warnings to the user.
-        """
-        msg = '{} time is up !'.format(self.prefix)
-        try:
-            call(
-                ['i3-nagbar', '-m', msg, '-t', level],
-                stdout=open('/dev/null', 'w'),
-                stderr=open('/dev/null', 'w')
-            )
-        except:
-            pass
-
-    def pomodoro(self, json, i3status_config):
-        """
-        Pomodoro response handling and countdown
-        """
-        if self.run:
-            self.__decrement()
-
-        response = self.response
-        if self.alert:
-            response['urgent'] = True
-            self.alert = False
-
-        if self.status == 'start':
-            response['color'] = i3status_config['color_good']
-        elif self.status == 'pause':
-            response['color'] = i3status_config['color_degraded']
-        else:
-            response['color'] = i3status_config['color_bad']
-
-        response['cached_until'] = time()
-        return (POSITION, response)
diff --git a/examples/sysdata.py b/examples/sysdata.py
deleted file mode 100644
index 14aefb3..0000000
--- a/examples/sysdata.py
+++ /dev/null
@@ -1,137 +0,0 @@
-# -*- coding: utf-8 -*-
-
-# sysdata
-
-# Sysdata is a module uses great Py3status (i3status wrapper) to
-# display system information (RAM usage) in i3bar (Linux systems).
-# For more information read:
-# i3wm homepage: http://i3wm.org
-# py3status homepage: https://github.com/ultrabug/py3status
-
-# Copyright (C) <2013> <Shahin Azad [ishahinism at Gmail]>
-
-# 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 3 of the License, or
-# (at your option) any later version.
-
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-
-# You should have received a copy of the GNU General Public License
-# along with this program.  If not, see <http://www.gnu.org/licenses/>.
-
-import subprocess
-from time import time
-
-
-class GetData:
-    """Get system status
-
-    """
-    def execCMD(self, cmd, arg):
-        """Take a system command and its argument, then return the result.
-
-        Arguments:
-        - `cmd`: system command.
-        - `arg`: argument.
-        """
-        result = subprocess.check_output([cmd, arg])
-        return result
-
-    def cpu(self):
-        """Get the cpu usage data from /proc/stat :
-        cpu  2255 34 2290 22625563 6290 127 456 0 0
-        - user: normal processes executing in user mode
-        - nice: niced processes executing in user mode
-        - system: processes executing in kernel mode
-        - idle: twiddling thumbs
-        - iowait: waiting for I/O to complete
-        - irq: servicing interrupts
-        - softirq: servicing softirqs
-        - steal: involuntary wait
-        - guest: running a normal guest
-        - guest_nice: running a niced guest
-        These numbers identify the amount of time the CPU has spent performing
-        different kinds of work.  Time units are in USER_HZ (typically hundredths of a
-        second)
-        """
-        with open('/proc/stat', 'r') as fd:
-            line = fd.readline()
-        cpu_data = line.split()
-        total_cpu_time = sum(map(int, cpu_data[1:]))
-        cpu_idle_time = int(cpu_data[4])
-
-        #return the cpu total&idle time
-        return total_cpu_time, cpu_idle_time
-
-    def memory(self):
-        """Execute 'free -m' command, grab the memory capacity and used size
-        then return; Memory size 'total_mem', Used_mem, and percentage
-        of used memory.
-
-        """
-        # Run 'free -m' command and make a list from output.
-        mem_data = self.execCMD('free', '-m').split()
-        total_mem = int(mem_data[7]) / 1024.
-        used_mem = int(mem_data[15]) / 1024.
-        # Caculate percentage
-        used_mem_percent = int(used_mem / (total_mem / 100))
-
-        # Results are in kilobyte.
-        return total_mem, used_mem, used_mem_percent
-
-
-class Py3status:
-    """
-    System status in i3bar
-    """
-    def __init__(self):
-        self.data = GetData()
-        self.cpu_total = 0
-        self.cpu_idle = 0
-
-    def cpuInfo(self, json, i3status_config):
-        """calculate the CPU status and return it.
-
-        """
-        response = {'full_text': '', 'name': 'cpu_usage'}
-        cpu_total, cpu_idle = self.data.cpu()
-        used_cpu_percent = 1 - float(cpu_idle-self.cpu_idle)/float(cpu_total-self.cpu_total)
-        self.cpu_total = cpu_total
-        self.cpu_idle = cpu_idle
-
-        if used_cpu_percent <= 40:
-            response['color'] = i3status_config['color_good']
-        elif used_cpu_percent <= 75:
-            response['color'] = i3status_config['color_degraded']
-        else:
-            response['color'] = i3status_config['color_bad']
-
-        response['full_text'] = "CPU: %.2f%%" % (used_cpu_percent*100)
-        #cache the status for 10 seconds
-        response['cached_until'] = time() + 10
-
-        return (0, response)
-
-    def ramInfo(self, json, i3status_config):
-        """calculate the memory (RAM) status and return it.
-
-        """
-        response = {'full_text': '', 'name': 'ram_info'}
-        total_mem, used_mem, used_mem_percent = self.data.memory()
-
-        if used_mem_percent <= 40:
-            response['color'] = i3status_config['color_good']
-        elif used_mem_percent <= 75:
-            response['color'] = i3status_config['color_degraded']
-        else:
-            response['color'] = i3status_config['color_bad']
-
-        response['full_text'] = "RAM: %.2f/%.2f GB (%d%%)" % \
-                                (used_mem, total_mem, used_mem_percent)
-        response['cached_until'] = time()
-
-        return (0, response)
diff --git a/examples/weather_yahoo.py b/examples/weather_yahoo.py
deleted file mode 100644
index 6b91b04..0000000
--- a/examples/weather_yahoo.py
+++ /dev/null
@@ -1,106 +0,0 @@
-# -*- coding: utf-8 -*-
-from time import time
-import requests
-
-
-class Py3status:
-    """
-    Display current day + 3 days weather forecast as icons on your i3bar
-    Based on Yahoo! Weather. forecast, thanks guys !
-    See: http://developer.yahoo.com/weather/
-    """
-    def __init__(self):
-        """
-        Basic configuration
-        Find your city code using:
-            http://answers.yahoo.com/question/index?qid=20091216132708AAf7o0g
-        The city_code in this example is for Paris, France
-        """
-        self.cache_timeout = 1800
-        self.city_code = 'FRXX0076'
-        self.request_timeout = 10
-
-    def _get_forecast(self):
-        """
-        Ask Yahoo! Weather. for a forecast
-        """
-        r = requests.get(
-            'http://query.yahooapis.com/v1/public/yql?q=select item from weather.forecast where location="%s"&format=json' % self.city_code,
-            timeout=self.request_timeout
-        )
-
-        result = r.json()
-        status = r.status_code
-        forecasts = []
-
-        if status == 200:
-            forecasts = result['query']['results']['channel']['item']['forecast']
-            # reset today
-            forecasts[0] = result['query']['results']['channel']['item']['condition']
-        else:
-            raise Exception('got status {}'.format(status))
-
-        # return current today + 3 days forecast
-        return forecasts[:4]
-
-    def _get_icon(self, forecast):
-        """
-        Return an unicode icon based on the forecast code and text
-        See: http://developer.yahoo.com/weather/#codes
-        """
-        icons = ['☀', '☁', '☂', '☃', '?']
-        code = int(forecast['code'])
-        text = forecast['text'].lower()
-
-        # sun
-        if 'sun' in text or code in [31, 32, 33, 34, 36]:
-            code = 0
-
-        # cloud / early rain
-        elif 'cloud' in text or code in [
-                19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30,
-                44
-                ]:
-            code = 1
-
-        # rain
-        elif 'rain' in text or code in [
-                0, 1, 2, 3, 4, 5, 6, 9,
-                11, 12,
-                37, 38, 39,
-                40, 45, 47
-                ]:
-            code = 2
-
-        # snow
-        elif 'snow' in text or code in [
-                7, 8,
-                10, 13, 14, 15, 16, 17, 18,
-                35,
-                41, 42, 43, 46
-                ]:
-            code = 3
-
-        # dunno
-        else:
-            code = -1
-
-        return icons[code]
-
-    def weather_yahoo(self, json, i3status_config):
-        """
-        This method gets executed by py3status
-        """
-        response = {
-            'cached_until': time() + self.cache_timeout,
-            'full_text': '',
-            'name': 'weather_yahoo'
-            }
-
-        forecasts = self._get_forecast()
-        for forecast in forecasts:
-            icon = self._get_icon(forecast)
-            response['full_text'] += '{} '.format(icon)
-        response['full_text'] = response['full_text'].strip()
-
-        return (0, response)
diff --git a/examples/whoami.py b/examples/whoami.py
deleted file mode 100644
index f930991..0000000
--- a/examples/whoami.py
+++ /dev/null
@@ -1,26 +0,0 @@
-from getpass import getuser
-from time import time
-
-
-class Py3status:
-    """
-    Simply output the currently logged in user in i3bar.
-
-    Inspired by i3 FAQ:
-        https://faq.i3wm.org/question/1618/add-user-name-to-status-bar/
-    """
-    def whoami(self, i3status_output_json, i3status_config):
-        """
-        We use the getpass module to get the current user.
-        """
-        # the current user doesnt change so much, cache it good
-        CACHE_TIMEOUT = 600
-
-        # here you can change the format of the output
-        # default is just to show the username
-        username = '{}'.format(getuser())
-
-        # set, cache and return the output
-        response = {'full_text': username, 'name': 'whoami'}
-        response['cached_until'] = time() + CACHE_TIMEOUT
-        return (0, response)
diff --git a/modules/__init__.py b/modules/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/modules/dpms.py b/modules/dpms.py
new file mode 100644
index 0000000..783c53c
--- /dev/null
+++ b/modules/dpms.py
@@ -0,0 +1,44 @@
+from os import system
+
+
+class Py3status:
+    """
+    This module allows activation and deactivation
+    of DPMS (Display Power Management Signaling)
+    by clicking on 'DPMS' in the status bar.
+
+    Written and contributed by @tasse:
+        Andre Doser <dosera AT tf.uni-freiburg.de>
+    """
+    def __init__(self):
+        """
+        Detect current state on start.
+        """
+        self.run = system('xset -q | grep -iq "DPMS is enabled"') == 0
+
+    def dpms(self, i3status_output_json, i3status_config):
+        """
+        Display a colorful state of DPMS.
+        """
+        result = {
+            'full_text': 'DPMS',
+            'name': 'dpms'
+        }
+        if self.run:
+            result['color'] = i3status_config['color_good']
+        else:
+            result['color'] = i3status_config['color_bad']
+        return (0, result)
+
+    def on_click(self, json, i3status_config, event):
+        """
+        Enable/Disable DPMS on left click.
+        """
+        if event['button'] == 1:
+            if self.run:
+                self.run = False
+                system("xset -dpms")
+            else:
+                self.run = True
+                system("xset +dpms")
+            system("killall -USR1 py3status")
diff --git a/modules/empty_class.py b/modules/empty_class.py
new file mode 100644
index 0000000..077269c
--- /dev/null
+++ b/modules/empty_class.py
@@ -0,0 +1,41 @@
+class Py3status:
+    """
+    Empty and basic py3status class.
+
+    NOTE: py3status will NOT execute:
+        - methods starting with '_'
+        - methods decorated by @property and @staticmethod
+
+    NOTE: reserved method names:
+        - 'kill' method for py3status exit notification
+        - 'on_click' method for click events from i3bar
+    """
+    def kill(self, i3status_output_json, i3status_config):
+        """
+        This method will be called upon py3status exit.
+        """
+        pass
+
+    def on_click(self, i3status_output_json, i3status_config, event):
+        """
+        This method will be called when a click event occurs on this module's
+        output on the i3bar.
+
+        Example 'event' json object:
+        {'y': 13, 'x': 1737, 'button': 1, 'name': 'empty', 'instance': 'first'}
+        """
+        pass
+
+    def empty(self, i3status_output_json, i3status_config):
+        """
+        This method will return an empty text message
+        so it will NOT be displayed on your i3bar.
+
+        If you want something displayed you should write something
+        in the 'full_text' key of your response.
+
+        See the i3bar protocol spec for more information:
+        http://i3wm.org/docs/i3bar-protocol.html
+        """
+        response = {'full_text': '', 'name': 'empty', 'instance': 'first'}
+        return (0, response)
diff --git a/modules/glpi.py b/modules/glpi.py
new file mode 100644
index 0000000..929749d
--- /dev/null
+++ b/modules/glpi.py
@@ -0,0 +1,52 @@
+# You need MySQL-python from http://pypi.python.org/pypi/MySQL-python
+import MySQLdb
+
+
+class Py3status:
+    """
+    This example class demonstrates how to display the current total number of
+    open tickets from GLPI in your i3bar.
+
+    It features thresholds to colorize the output and forces a low timeout to
+    limit the impact of a server connectivity problem on your i3bar freshness.
+
+    Note that we don't have to implement a cache layer as it is handled by
+    py3status automagically.
+    """
+    def count_glpi_open_tickets(self, json, i3status_config):
+        response = {'full_text': '', 'name': 'glpi_tickets'}
+
+        # user-defined variables
+        CRIT_THRESHOLD = 20
+        WARN_THRESHOLD = 15
+        MYSQL_DB = ''
+        MYSQL_HOST = ''
+        MYSQL_PASSWD = ''
+        MYSQL_USER = ''
+        POSITION = 0
+
+        mydb = MySQLdb.connect(
+            host=MYSQL_HOST,
+            user=MYSQL_USER,
+            passwd=MYSQL_PASSWD,
+            db=MYSQL_DB,
+            connect_timeout=5,
+            )
+        mycr = mydb.cursor()
+        mycr.execute('''select count(*)
+                        from glpi_tickets
+                        where closedate is NULL and solvedate is NULL;''')
+        row = mycr.fetchone()
+        if row:
+            open_tickets = int(row[0])
+            if i3status_config['colors']:
+                if open_tickets > CRIT_THRESHOLD:
+                    response.update({'color': i3status_config['color_bad']})
+                elif open_tickets > WARN_THRESHOLD:
+                    response.update(
+                        {'color': i3status_config['color_degraded']}
+                    )
+            response['full_text'] = '%s tickets' % open_tickets
+        mydb.close()
+
+        return (POSITION, response)
diff --git a/modules/i3bar_click_events.py b/modules/i3bar_click_events.py
new file mode 100644
index 0000000..792965c
--- /dev/null
+++ b/modules/i3bar_click_events.py
@@ -0,0 +1,127 @@
+from subprocess import Popen
+from time import time
+
+
+class Py3status:
+    """
+    This module allows you to take actions based on click events made on
+    the i3status modules. For example, thanks to this module you could
+    launch the wicd GUI when clicking on the ethernet or wireless module
+    of your i3status output !
+
+    IMPORTANT:
+        This module file name is reserved and should NOT be changed if you
+        want py3status to handle your i3status modules click events !
+
+        The behavior described above will only work if this file is named
+        'i3bar_click_events.py' !
+    """
+    def __init__(self):
+        """
+        This is where you setup your actions based on your i3status config.
+
+        Configuration:
+        --------------
+        self.actions = {
+            "<module name and instance>": {
+                <button number>: [<function to run>, <arg1>, <arg2>],
+            }
+        }
+
+        Variables:
+        ----------
+        <button number> is an integer from 1 to 3:
+            1 : left click
+            2 : middle click
+            3 : right click
+
+        <function to run> is a python function written in this module.
+            The 'external_command' function is provided for convenience if
+            you want to call an external program from this module.
+            You can of course write your own functions and have them executed
+            on a click event at will with possible arguments <arg1>, <arg2>...
+
+        <module name and instance> is a string made from the module
+        attribute 'name' and 'instance' using a space as separator:
+            For i3status modules, it's simply the name of the module as it
+            appears in the 'order' instruction of your i3status.conf.
+            Example:
+                in i3status.conf -> order += "wireless wlan0"
+                self.actions key -> "wireless wlan0"
+
+        Usage example:
+        --------------
+            - Open the wicd-gtk GUI when we LEFT click on the ethernet
+            module of i3status.
+            - Open emelfm2 to /home when we LEFT click on
+            the /home instance of disk_info
+            - Open emelfm2 to / when we LEFT click on
+            the / instance of disk_info
+
+            The related i3status.conf looks like:
+                order += "disk /home"
+                order += "disk /"
+                order += "ethernet eth0"
+
+            The resulting self.actions should be:
+                self.actions = {
+                    "ethernet eth0": {
+                        1: [external_command, 'wicd-gtk', '-n'],
+                    },
+                    "disk_info /home": {
+                        1: [external_command, 'emelfm2', '-1', '~'],
+                    },
+                    "disk_info /": {
+                        1: [external_command, 'emelfm2', '-1', '/'],
+                    },
+                }
+        """
+        # CONFIGURE ME PLEASE, LOVE YOU BIG TIME !
+        self.actions = {
+        }
+
+    def on_click(self, i3status_output_json, i3status_config, event):
+        """
+        If an action is configured for the given i3status module 'name' and
+        'instance' (if present), then we'll execute the given function with
+        its arguments (if present).
+
+        Usually you SHOULD NOT modify this part of the code.
+        """
+        button = event['button']
+        key_name = '{} {}'.format(
+            event['name'],
+            event.get('instance', '')
+        ).strip()
+        if key_name in self.actions and button in self.actions[key_name]:
+            # get the function to run
+            func = self.actions[key_name][button][0]
+            assert hasattr(func, '__call__'), \
+                'first element of the action list must be a function'
+
+            # run the function with the possibly given arguments
+            func(*self.actions[key_name][button][1:])
+
+    def i3bar_click_events(self, i3status_output_json, i3status_config):
+        """
+        Cached empty output, this module doesn't show anything.
+        """
+        response = {'full_text': '', 'name': 'i3bar_click_events'}
+        response['cached_until'] = time() + 3600
+        return (-1, response)
+
+
+def external_command(*cmd):
+    """
+    This convenience function lets you call an external program at will.
+
+    NOTE:
+        The stdout and stderr MUST be suppressed as shown here to avoid any
+        output from being caught by the i3bar (this would freeze it).
+        See issue #20 for more info.
+    """
+    Popen(
+        cmd,
+        stdout=open('/dev/null', 'w'),
+        stderr=open('/dev/null', 'w')
+    )
diff --git a/modules/netdata.py b/modules/netdata.py
new file mode 100644
index 0000000..d923036
--- /dev/null
+++ b/modules/netdata.py
@@ -0,0 +1,132 @@
+# -*- coding: utf-8 -*-
+
+# netdata
+
+# Netdata is a module uses great Py3status (i3status wrapper) to
+# display network information (Linux systems) in i3bar.
+# For more information read:
+# i3wm homepage: http://i3wm.org
+# py3status homepage: https://github.com/ultrabug/py3status
+
+# Copyright (C) <2013> <Shahin Azad [ishahinism at Gmail]>
+
+# 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 3 of the License, or
+# (at your option) any later version.
+
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+# ----------------------------------------------------------------- #
+# Notes:
+# 1. netdata will check 'eth0' interface by default. You can
+# change it by changing 'self.net_interface' variable in 'GetData'
+# class.
+# 2. Colors are depended on strict specification in traffic/netspeed methods.
+# You can change them by manipulating conditions.
+
+import subprocess
+from time import time
+
+# Method 'netSpeed' will use this variables to calculate downloaded
+# bytes in last second.  Initializing this variables globally is
+# necessary since we can't use __init__ method in Py3Status class.
+old_transmitted, old_received = 0, 0
+
+
+class GetData:
+    """Get system status
+
+    """
+    def __init__(self):
+        # You can change it to another interface.
+        # It'll be used for grabbing net interface data.
+        self.net_interface = 'eth0'
+
+    def execCMD(self, cmd, arg):
+        """Take a system command and its argument, then return the result.
+
+        Arguments:
+        - `cmd`: system command.
+        - `arg`: argument.
+        """
+        result = subprocess.check_output([cmd, arg])
+        return result
+
+    def netBytes(self):
+        """Execute 'cat /proc/net/dev', find the interface line (Default
+        'eth0') and grab received/transmitted bytes.
+
+        """
+        net_data = self.execCMD('cat', '/proc/net/dev').split()
+        interface_index = net_data.index(self.net_interface + ':')
+        received_bytes = int(net_data[interface_index + 1])
+        transmitted_bytes = int(net_data[interface_index + 9])
+
+        return received_bytes, transmitted_bytes
+
+
+class Py3status:
+    """
+    System status in i3bar
+    """
+    def netSpeed(self, json, i3status_config):
+        """Calculate network speed ('eth0' interface) and return it.  You can
+        change the interface using 'self.net_interface' variable in
+        'GetData' class.
+
+        """
+        data = GetData()
+        response = {'full_text': '', 'name': 'net_speed'}
+
+        global old_received
+        global old_transmitted
+
+        received_bytes, transmitted_bytes = data.netBytes()
+        dl_speed = (received_bytes - old_received) / 1024.
+        up_speed = (transmitted_bytes - old_transmitted) / 1024.
+
+        if dl_speed < 30:
+            response['color'] = i3status_config['color_bad']
+        elif dl_speed < 60:
+            response['color'] = i3status_config['color_degraded']
+        else:
+            response['color'] = i3status_config['color_good']
+
+        response['full_text'] = "LAN(Kb): {:5.1f}↓ {:5.1f}↑"\
+            .format(dl_speed, up_speed)
+        response['cached_until'] = time()
+
+        old_received, old_transmitted = received_bytes, transmitted_bytes
+        return (0, response)
+
+    def traffic(self, json, i3status_config):
+        """Calculate networks used traffic. Same as 'netSpeed' method you can
+        change the interface.
+
+        """
+        data = GetData()
+        response = {'full_text': '', 'name': 'traffic'}
+
+        received_bytes, transmitted_bytes = data.netBytes()
+        download = received_bytes / 1024 / 1024.
+        upload = transmitted_bytes / 1024 / 1024.
+        total = download + upload
+
+        if total < 400:
+            response['color'] = i3status_config['color_good']
+        elif total < 700:
+            response['color'] = i3status_config['color_degraded']
+        else:
+            response['color'] = i3status_config['color_bad']
+
+        response['full_text'] = "T(Mb): {:3.0f}↓ {:3.0f}↑ {:3.0f}↕"\
+            .format(download, upload, total)
+
+        return (1, response)
diff --git a/modules/ns_checker.py b/modules/ns_checker.py
new file mode 100644
index 0000000..4a332b1
--- /dev/null
+++ b/modules/ns_checker.py
@@ -0,0 +1,57 @@
+import dns.resolver
+import socket
+
+
+class Py3status:
+    """
+    This module launch a simple query on each nameservers for the specified domain.
+    Nameservers are dynamically retrieved. The FQDN is the only one mandatory parameter.
+    It's also possible to add additional nameservers by appending them in nameservers list.
+
+    The default resolver can be overwritten with my_resolver.nameservers parameter.
+
+    Written and contributed by @nawadanp
+    """
+    def __init__(self):
+        self.domain = 'google.com'
+        self.lifetime = 0.3
+        self.resolver = []
+        self.nameservers = []
+
+    def ns_checker(self, i3status_output_json, i3status_config):
+        response = {'full_text': '', 'name': 'ns_checker'}
+        position = 0
+        counter = 0
+        error = False
+        nameservers = []
+
+        my_resolver = dns.resolver.Resolver()
+        my_resolver.lifetime = self.lifetime
+        if self.resolver:
+            my_resolver.nameservers = self.resolver
+
+        my_ns = my_resolver.query(self.domain, 'NS')
+
+        # Insert each NS ip address in nameservers
+        for ns in my_ns:
+            nameservers.append(str(socket.gethostbyname(str(ns))))
+        for ns in self.nameservers:
+            nameservers.append(str(ns))
+
+        # Perform a simple DNS query, for each NS servers
+        for ns in nameservers:
+            my_resolver.nameservers = [ns]
+            counter += 1
+            try:
+                my_resolver.query(self.domain, 'A')
+            except:
+                error = True
+
+        if error:
+            response['full_text'] = str(counter) + ' NS NOK'
+            response['color'] = i3status_config['color_bad']
+        else:
+            response['full_text'] = str(counter) + ' NS OK'
+            response['color'] = i3status_config['color_good']
+
+        return (position, response)
diff --git a/modules/pingdom.py b/modules/pingdom.py
new file mode 100644
index 0000000..cddf1a9
--- /dev/null
+++ b/modules/pingdom.py
@@ -0,0 +1,59 @@
+# -*- coding: utf-8 -*-
+
+import requests
+from time import time
+
+
+class Py3status:
+    """
+    Dynamically display the latest response time of the configured checks using
+    the Pingdom API.
+    We also verify the status of the checks and colorize if needed.
+    Pingdom API doc : https://www.pingdom.com/services/api-documentation-rest/
+
+    #NOTE: This module needs the 'requests' python module from pypi
+        https://pypi.python.org/pypi/requests
+    """
+    def pingdom_checks(self, json, i3status_config):
+        response = {'full_text': '', 'name': 'pingdom_checks'}
+
+        #NOTE: configure me !
+        APP_KEY = ''             # create an APP KEY on pingdom first
+        CACHE_TIMEOUT = 600      # recheck every 10 mins
+        CHECKS = []              # checks' names you want added to your bar
+        LATENCY_THRESHOLD = 500  # when to colorize the output
+        LOGIN = ''               # pingdom login
+        PASSWORD = ''            # pingdom password
+        TIMEOUT = 15
+        POSITION = 0
+
+        r = requests.get(
+            'https://api.pingdom.com/api/2.0/checks',
+            auth=(LOGIN, PASSWORD),
+            headers={'App-Key': APP_KEY},
+            timeout=TIMEOUT,
+        )
+        result = r.json()
+        if 'checks' in result:
+            for check in [
+                ck for ck in result['checks'] if ck['name'] in CHECKS
+            ]:
+                if check['status'] == 'up':
+                    response['full_text'] += '{}: {}ms, '.format(
+                        check['name'],
+                        check['lastresponsetime']
+                    )
+                    if check['lastresponsetime'] > LATENCY_THRESHOLD:
+                        response.update(
+                            {'color': i3status_config['color_degraded']}
+                        )
+                else:
+                    response['full_text'] += '{}: DOWN'.format(
+                        check['name'],
+                        check['lastresponsetime']
+                    )
+                    response.update({'color': i3status_config['color_bad']})
+            response['full_text'] = response['full_text'].strip(', ')
+            response['cached_until'] = time() + CACHE_TIMEOUT
+
+        return (POSITION, response)
diff --git a/modules/pomodoro.py b/modules/pomodoro.py
new file mode 100644
index 0000000..28b5ea1
--- /dev/null
+++ b/modules/pomodoro.py
@@ -0,0 +1,123 @@
+"""
+Pomodoro countdown on i3bar originally written by @Fandekasp (Adrien Lemaire)
+"""
+from subprocess import call
+from time import time
+
+MAX_BREAKS = 4
+POSITION = 0
+TIMER_POMODORO = 25 * 60
+TIMER_BREAK = 5 * 60
+TIMER_LONG_BREAK = 15 * 60
+
+
+class Py3status:
+    """
+    """
+    def __init__(self):
+        self.__setup('stop')
+        self.alert = False
+        self.run = False
+
+    def on_click(self, json, i3status_config, event):
+        """
+        Handles click events
+        """
+        if event['button'] == 1:
+            if self.status == 'stop':
+                self.status = 'start'
+            self.run = True
+
+        elif event['button'] == 2:
+            self.__setup('stop')
+            self.run = False
+
+        elif event['button'] == 3:
+            self.__setup('pause')
+            self.run = False
+
+    @property
+    def response(self):
+        """
+        Return the response full_text string
+        """
+        return {
+            'full_text': '{} ({})'.format(self.prefix, self.timer),
+            'name': 'pomodoro'
+        }
+
+    def __setup(self, status):
+        """
+        Setup a step
+        """
+        self.status = status
+        if status == 'stop':
+            self.prefix = 'Pomodoro'
+            self.status = 'stop'
+            self.timer = TIMER_POMODORO
+            self.breaks = 1
+
+        elif status == 'start':
+            self.prefix = 'Pomodoro'
+            self.timer = TIMER_POMODORO
+
+        elif status == 'pause':
+            self.prefix = 'Break #%d' % self.breaks
+            if self.breaks > MAX_BREAKS:
+                self.timer = TIMER_LONG_BREAK
+                self.breaks = 1
+            else:
+                self.breaks += 1
+                self.timer = TIMER_BREAK
+
+    def __decrement(self):
+        """
+        Countdown handler
+        """
+        self.timer -= 1
+        if self.timer < 0:
+            self.alert = True
+            self.run = False
+            self.__i3_nagbar()
+            if self.status == 'start':
+                self.__setup('pause')
+                self.status = 'pause'
+            elif self.status == 'pause':
+                self.__setup('start')
+                self.status = 'start'
+
+    def __i3_nagbar(self, level='warning'):
+        """
+        Make use of i3-nagbar to display warnings to the user.
+        """
+        msg = '{} time is up !'.format(self.prefix)
+        try:
+            call(
+                ['i3-nagbar', '-m', msg, '-t', level],
+                stdout=open('/dev/null', 'w'),
+                stderr=open('/dev/null', 'w')
+            )
+        except:
+            pass
+
+    def pomodoro(self, json, i3status_config):
+        """
+        Pomodoro response handling and countdown
+        """
+        if self.run:
+            self.__decrement()
+
+        response = self.response
+        if self.alert:
+            response['urgent'] = True
+            self.alert = False
+
+        if self.status == 'start':
+            response['color'] = i3status_config['color_good']
+        elif self.status == 'pause':
+            response['color'] = i3status_config['color_degraded']
+        else:
+            response['color'] = i3status_config['color_bad']
+
+        response['cached_until'] = time()
+        return (POSITION, response)
diff --git a/modules/sysdata.py b/modules/sysdata.py
new file mode 100644
index 0000000..14aefb3
--- /dev/null
+++ b/modules/sysdata.py
@@ -0,0 +1,137 @@
+# -*- coding: utf-8 -*-
+
+# sysdata
+
+# Sysdata is a module uses great Py3status (i3status wrapper) to
+# display system information (RAM usage) in i3bar (Linux systems).
+# For more information read:
+# i3wm homepage: http://i3wm.org
+# py3status homepage: https://github.com/ultrabug/py3status
+
+# Copyright (C) <2013> <Shahin Azad [ishahinism at Gmail]>
+
+# 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 3 of the License, or
+# (at your option) any later version.
+
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+import subprocess
+from time import time
+
+
+class GetData:
+    """Get system status
+
+    """
+    def execCMD(self, cmd, arg):
+        """Take a system command and its argument, then return the result.
+
+        Arguments:
+        - `cmd`: system command.
+        - `arg`: argument.
+        """
+        result = subprocess.check_output([cmd, arg])
+        return result
+
+    def cpu(self):
+        """Get the cpu usage data from /proc/stat :
+        cpu  2255 34 2290 22625563 6290 127 456 0 0
+        - user: normal processes executing in user mode
+        - nice: niced processes executing in user mode
+        - system: processes executing in kernel mode
+        - idle: twiddling thumbs
+        - iowait: waiting for I/O to complete
+        - irq: servicing interrupts
+        - softirq: servicing softirqs
+        - steal: involuntary wait
+        - guest: running a normal guest
+        - guest_nice: running a niced guest
+        These numbers identify the amount of time the CPU has spent performing
+        different kinds of work.  Time units are in USER_HZ (typically hundredths of a
+        second)
+        """
+        with open('/proc/stat', 'r') as fd:
+            line = fd.readline()
+        cpu_data = line.split()
+        total_cpu_time = sum(map(int, cpu_data[1:]))
+        cpu_idle_time = int(cpu_data[4])
+
+        #return the cpu total&idle time
+        return total_cpu_time, cpu_idle_time
+
+    def memory(self):
+        """Execute 'free -m' command, grab the memory capacity and used size
+        then return; Memory size 'total_mem', Used_mem, and percentage
+        of used memory.
+
+        """
+        # Run 'free -m' command and make a list from output.
+        mem_data = self.execCMD('free', '-m').split()
+        total_mem = int(mem_data[7]) / 1024.
+        used_mem = int(mem_data[15]) / 1024.
+        # Caculate percentage
+        used_mem_percent = int(used_mem / (total_mem / 100))
+
+        # Results are in kilobyte.
+        return total_mem, used_mem, used_mem_percent
+
+
+class Py3status:
+    """
+    System status in i3bar
+    """
+    def __init__(self):
+        self.data = GetData()
+        self.cpu_total = 0
+        self.cpu_idle = 0
+
+    def cpuInfo(self, json, i3status_config):
+        """calculate the CPU status and return it.
+
+        """
+        response = {'full_text': '', 'name': 'cpu_usage'}
+        cpu_total, cpu_idle = self.data.cpu()
+        used_cpu_percent = 1 - float(cpu_idle-self.cpu_idle)/float(cpu_total-self.cpu_total)
+        self.cpu_total = cpu_total
+        self.cpu_idle = cpu_idle
+
+        if used_cpu_percent <= 40:
+            response['color'] = i3status_config['color_good']
+        elif used_cpu_percent <= 75:
+            response['color'] = i3status_config['color_degraded']
+        else:
+            response['color'] = i3status_config['color_bad']
+
+        response['full_text'] = "CPU: %.2f%%" % (used_cpu_percent*100)
+        #cache the status for 10 seconds
+        response['cached_until'] = time() + 10
+
+        return (0, response)
+
+    def ramInfo(self, json, i3status_config):
+        """calculate the memory (RAM) status and return it.
+
+        """
+        response = {'full_text': '', 'name': 'ram_info'}
+        total_mem, used_mem, used_mem_percent = self.data.memory()
+
+        if used_mem_percent <= 40:
+            response['color'] = i3status_config['color_good']
+        elif used_mem_percent <= 75:
+            response['color'] = i3status_config['color_degraded']
+        else:
+            response['color'] = i3status_config['color_bad']
+
+        response['full_text'] = "RAM: %.2f/%.2f GB (%d%%)" % \
+                                (used_mem, total_mem, used_mem_percent)
+        response['cached_until'] = time()
+
+        return (0, response)
diff --git a/modules/weather_yahoo.py b/modules/weather_yahoo.py
new file mode 100644
index 0000000..6b91b04
--- /dev/null
+++ b/modules/weather_yahoo.py
@@ -0,0 +1,106 @@
+# -*- coding: utf-8 -*-
+from time import time
+import requests
+
+
+class Py3status:
+    """
+    Display current day + 3 days weather forecast as icons on your i3bar
+    Based on Yahoo! Weather. forecast, thanks guys !
+    See: http://developer.yahoo.com/weather/
+    """
+    def __init__(self):
+        """
+        Basic configuration
+        Find your city code using:
+            http://answers.yahoo.com/question/index?qid=20091216132708AAf7o0g
+        The city_code in this example is for Paris, France
+        """
+        self.cache_timeout = 1800
+        self.city_code = 'FRXX0076'
+        self.request_timeout = 10
+
+    def _get_forecast(self):
+        """
+        Ask Yahoo! Weather. for a forecast
+        """
+        r = requests.get(
+            'http://query.yahooapis.com/v1/public/yql?q=select item from weather.forecast where location="%s"&format=json' % self.city_code,
+            timeout=self.request_timeout
+        )
+
+        result = r.json()
+        status = r.status_code
+        forecasts = []
+
+        if status == 200:
+            forecasts = result['query']['results']['channel']['item']['forecast']
+            # reset today
+            forecasts[0] = result['query']['results']['channel']['item']['condition']
+        else:
+            raise Exception('got status {}'.format(status))
+
+        # return current today + 3 days forecast
+        return forecasts[:4]
+
+    def _get_icon(self, forecast):
+        """
+        Return an unicode icon based on the forecast code and text
+        See: http://developer.yahoo.com/weather/#codes
+        """
+        icons = ['☀', '☁', '☂', '☃', '?']
+        code = int(forecast['code'])
+        text = forecast['text'].lower()
+
+        # sun
+        if 'sun' in text or code in [31, 32, 33, 34, 36]:
+            code = 0
+
+        # cloud / early rain
+        elif 'cloud' in text or code in [
+                19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30,
+                44
+                ]:
+            code = 1
+
+        # rain
+        elif 'rain' in text or code in [
+                0, 1, 2, 3, 4, 5, 6, 9,
+                11, 12,
+                37, 38, 39,
+                40, 45, 47
+                ]:
+            code = 2
+
+        # snow
+        elif 'snow' in text or code in [
+                7, 8,
+                10, 13, 14, 15, 16, 17, 18,
+                35,
+                41, 42, 43, 46
+                ]:
+            code = 3
+
+        # dunno
+        else:
+            code = -1
+
+        return icons[code]
+
+    def weather_yahoo(self, json, i3status_config):
+        """
+        This method gets executed by py3status
+        """
+        response = {
+            'cached_until': time() + self.cache_timeout,
+            'full_text': '',
+            'name': 'weather_yahoo'
+            }
+
+        forecasts = self._get_forecast()
+        for forecast in forecasts:
+            icon = self._get_icon(forecast)
+            response['full_text'] += '{} '.format(icon)
+        response['full_text'] = response['full_text'].strip()
+
+        return (0, response)
diff --git a/modules/whoami.py b/modules/whoami.py
new file mode 100644
index 0000000..f930991
--- /dev/null
+++ b/modules/whoami.py
@@ -0,0 +1,26 @@
+from getpass import getuser
+from time import time
+
+
+class Py3status:
+    """
+    Simply output the currently logged in user in i3bar.
+
+    Inspired by i3 FAQ:
+        https://faq.i3wm.org/question/1618/add-user-name-to-status-bar/
+    """
+    def whoami(self, i3status_output_json, i3status_config):
+        """
+        We use the getpass module to get the current user.
+        """
+        # the current user doesnt change so much, cache it good
+        CACHE_TIMEOUT = 600
+
+        # here you can change the format of the output
+        # default is just to show the username
+        username = '{}'.format(getuser())
+
+        # set, cache and return the output
+        response = {'full_text': username, 'name': 'whoami'}
+        response['cached_until'] = time() + CACHE_TIMEOUT
+        return (0, response)
-- 
cgit v1.3