add clock

Signed-off-by: Mattias Andrée <maandree@operamail.com>

1 files changed, 92 insertions, 0 deletions

diff --git a/src/plugins/clock.py b/src/plugins/clock.py
new file mode 100644
index 0000000..129269c
--- /dev/null
+++ b/src/plugins/clock.py
@@ -0,0 +1,92 @@
+# -*- python -*-
+'''
+xpybar – xmobar replacement written in python
+Copyright © 2014  Mattias Andrée (maandree@member.fsf.org)
+
+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 time
+
+from util import *
+
+
+class Clock:
+    '''
+    Date and time information retrieval
+    '''
+    
+    
+    SECONDS = 1
+    '''
+    :float  Synchronisation value for syncing to seconds
+    '''
+    
+    MINUTES = 60
+    '''
+    :float  Synchronisation value for syncing to minutes
+    '''
+    
+    
+    def __init__(self, format = '%Y-(%m)%b-%d %T, %a w%V, %Z', utc = False, sync_to = 1):
+        '''
+        Constructor
+        
+        @param  format:str     The format as in the `date` command
+        @param  utc:bool       Show time in UTC, otherwise local time
+        @param  sync_to:float  The time parameter to sync to, the number of seconds between the reads
+        '''
+        self.format = format
+        self.utc = utc
+        self.sync_to = sync_to
+        self.command = ['date'] + (['--utc'] if utc else []) + ['+' + format]
+    
+    
+    def read(self):
+        '''
+        Reads the clock
+        
+        @return  :str  The time and date in the format specified at construction
+        '''
+        return spawn_read(*(self.command))
+    
+    
+    def sync(self):
+        '''
+        Wait for the clock to reach the next synchronisation time point
+        '''
+        time.sleep(self.sync_to - (time.time() % self.sync_to))
+    
+    
+    def continuous_sync(self, function):
+        '''
+        Wait for the clock to reach the next synchronisation time point
+        and the call a function and start over, i.e. sync in a loop forever
+        
+        @param  function:()→void  The function to call
+        '''
+        while True:
+            time.sleep(self.sync_to - (time.time() % self.sync_to))
+            function()
+    
+    
+    @staticmethod
+    def posix_time():
+        '''
+        Returns the current POSIX time
+        
+        @return  :float  The current POSIX time
+        '''
+        return time.time()
+