"""
A module providing a class the time of day

This is better than the ctime module because it hides and protects its attributes.

Authors: Steve Marschner (srm2), Lillian Lee (ljl2), and Walker White (wmw2)
Date:    October 1, 2017 (Python 3 Version)
"""


class Time(object):
    """
    A class to represent the times of day.
    
    INSTANCE ATTRIBUTES:
        _hour: hour of day    [int in 0..23]
        _min:  minute of hour [int in 0..59]"""
    
    # GETTERS AND SETTERS
    def getHour(self):
        """
        Returns: the hour of the day.
        """
        return self._hour
    
    def setHour(self,value):
        """
        Sets the hour of the day to be the given value.
        
        Parameter value: hour of day
        Precondition: value is an int in 0..23
        """
        assert type(value) == int, repr(value)+' is not an int'
        assert 0 <= value and value < 24, repr(value)+' is out of range 0..23'
        self._hour = value
    
    def getHour(self):
        """
        Returns: the hour of the day.
        """
        return self._hour
    
    def getMinute(self):
        """
        Returns: the minute of hour.
        """
        return self._min
    
    def setMinute(self,value):
        """
        Sets the minute of hour to be the given value.
        
        Parameter value: minute of hour
        Precondition: value is an int in 0..59
        """
        assert type(value) == int, repr(value)+' is not an int'
        assert 0 <= value and value < 60, repr(value)+' is out of range 0..59'
        self._min = value
    
    # SPECIAL METHODS
    def __init__(self, hour, min):
        """
        Initializer: Creates the time hour:min. 
        
        Parameter hour: hour of day
        Precondition: hour is an int in 0.23
        
        Parameter min: minute of hour
        Precondition: min is an int in 0..59
        """
        # NO ASSERTS NEEDED. WHY?
        self.setHour(hour)
        self.setMinute(min)
    
    def __str__(self):
        """
        Returns: the time as a string in [H]H:MM 24-hour format.
        """
        return str(self._hour) + (':0' if self._min < 10 else ':') + str(self._min)
    
    # BASIC METHODS
    def increment(self, hours, mins):
        """
        Moves this object <hours> hours and <mins> minutes into the future.
        
        Parameter hours: number of hours to move
        Precondition: hours is an int >= 0
        
        Parameter mins: number of minutes to move
        Precondition: mins an int in 0..59
        """
        assert type(hours) == int, repr(hours)+' is not an int'
        assert 0 <= hours, repr(hours)+' is not >= 0'
        assert type(mins) == int, repr(mins)+' is not an int'
        assert 0 <= mins and mins < 60, repr(mins)+' is out of range 0..59'
        
        # It is okay to access hidden attributes INSIDE of class
        self._hour = self._hour + hours
        self._min  = self._min + mins
        self._hour = self._hour + self._min // 60
        self._min  = self._min % 60
        self._hour = self._hour % 24
    
    def isPM(self):
        """
        Returns: True if this time is noon or later; False otherwise.
        """
        return self._hour >= 12


def demo_time():
    """
    Shows off time in action
    """
    t = Time(23,58)
    print(t)
    t.increment(0,3)
    print(t)
    t.increment(11,0)
    print(t, t.isPM())
    t.increment(1, 59)
    print(t, t.isPM())


if __name__ == '__main__':
    demo_time()