From 01d5043106dbc8d5b0a63024d0c2a81b1ee63bb9 Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Mon, 3 Mar 2014 14:08:00 +0100 Subject: add clock MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- src/plugins/clock.py | 92 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 92 insertions(+) create mode 100644 src/plugins/clock.py (limited to 'src') 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 . +''' + +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() + -- cgit v1.2.3-70-g09d2