add datetime utils

CHANGELOG.md

@@ -1,6 +1,11 @@
 # Change Log
 All notable changes to this project will be documented in this file.
 
+### 4.7.2 - 2017-10-22
+
+### Added
+- datetime utils
+
 ### 4.7.1 - 2017-10-22
 
 ### Added

README.md

@@ -134,7 +134,7 @@ Browse extra examples here:
 - you can browse the [html](docs/doxygen/html/index.html) (or if you prefer the [epydoc docs](docs/epydoc/html/index.html))
 - there is also the [pdf](docs/doxygen/pdf/api.pdf) version (for the epydoc pdfs go [here](docs/epydoc/pdf)
 - download the repository and open the [sphinx](docs/sphinx/_build/html/index.html) documentation
-- read online at the official [readthedocs](http://pyhal.readthedocs.io) web-page
+- read online at the official [readthedocs](http://pyhal.readthedocs.io) web-page or the [official Github pages](https://sirfoga.github.io/pyhal/).
 
 
 ## Questions and issues

hal/internet/gmail.py

@@ -16,6 +16,8 @@
 # limitations under the License.
 
 
+""" Use GMail APIs from python """
+
 import os
 from email.mime.text import MIMEText
 

hal/internet/google/gauthenticator.py

@@ -16,6 +16,8 @@
 # limitations under the License.
 
 
+""" Authenticate your Google APIs """
+
 import os
 
 import httplib2

hal/time/dates.py

@@ -0,0 +1,52 @@
+# !/usr/bin/python3
+# coding: utf-8
+
+# Copyright 2016-2018 Stefano Fogarollo
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+""" Datetime utils """
+
+import datetime
+from enum import Enum
+
+
+class Weekday(Enum):
+    """ Representing weekday by using ints (datetime standard) """
+
+    MONDAY = 0
+    TUESDAY = 1
+    WEDNESDAY = 2
+    THURSDAY = 3
+    FRIDAY = 4
+    SATURDAY = 5
+    SUNDAY = 6
+
+
+def get_next_weekday(weekday):
+    """
+    :param weekday: Weekday
+        Weekday to get
+    :return: datetime
+        Date of next monday, tuesday ...
+    """
+
+    now = datetime.datetime.now()
+    if now.weekday() == weekday:
+        return now + datetime.timedelta(days=7)
+
+    t = datetime.timedelta(
+        (7 + weekday - now.weekday()) % 7
+    )  # time delta to next instance
+    return now + t