aboutsummaryrefslogtreecommitdiffstats
path: root/src/plugins/tzclock.py
blob: e0c866356ee40ada8d260daa9cbd6c3940d9762a (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
# -*- python -*-
'''
xpybar – xmobar replacement written in python
Copyright © 2014, 2015  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/>.
'''

from datetime import datetime
from pytz import timezone as tz
import time


class TZClock:
    '''
    Date and time information retrieval with timezone support
    '''
    
    
    SECONDS = 1
    '''
    :float  Synchronisation value for syncing to seconds
    '''
    
    MINUTES = 60
    '''
    :float  Synchronisation value for syncing to minutes
    '''
    
    
    def __init__(self, timezone, format = '%Y-(%m)%b-%d %T, %a w%V, %Z', sync_to = 1):
        '''
        Constructor
        
        @param  timezone:str   The timezone
        @param  format:str     The format as in the `date` command
        @param  sync_to:float  The time parameter to sync to, the number of seconds between the reads
        '''
        self.utc = tz('UTC')
        self.timezone = tz(timezone)
        self.format = format
        self.sync_to = sync_to
    
    
    def read(self):
        '''
        Reads the clock
        
        @return  :str  The time and date in the format specified at construction
        '''
        return self.from_posix_time(TZClock.posix_time())
    
    
    def from_posix_time(self, time):
        '''
        Converts POSIX time into human readable time with the selected timezone
        
        @param   time:float  The POSIX time
        @return  :str        The time and date in the format specified at construction
        '''
        return datetime.fromtimestamp(time, tz = self.utc).astimezone(self.timezone).strftime(self.format)
    
    
    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()