clockwork 0.1.4__tar.gz → 0.2.0__tar.gz

{clockwork-0.1.4 → clockwork-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: clockwork
-Version: 0.1.4
+Version: 0.2.0
 Summary: Toolkit for time-related operations including scheduling, logging, date manipulation, and more.
 Home-page: https://github.com/zteinck/clockwork
 License: MIT

clockwork-0.2.0/clockwork/__init__.py

@@ -0,0 +1,4 @@
+from .core import *
+
+__version__ = '0.2.0'
+__author__ = 'Zachary Einck <zacharyeinck@gmail.com>'

{clockwork-0.1.4 → clockwork-0.2.0}/clockwork/_base.py

@@ -325,7 +325,7 @@ class DateBase(object):
         components = ['%Y-%m-%d']
         if self.dt.hour + self.dt.second + self.dt.microsecond > 0:
             components.append('%I:%M:%S.%f %p')
-        return self.str(' '.join(components))
+        return self.__class__.__name__ + '(%s)' % self.str(' '.join(components))
 
     def __int__(self):
         return self.timestamp

{clockwork-0.1.4 → clockwork-0.2.0}/clockwork/core.py

@@ -12,7 +12,7 @@ from ._month_end import MonthEnd
 #| Functions                                                               |
 #╰-------------------------------------------------------------------------╯
 
-def Date(arg=None, normalize=False, week_offset=0):
+def Date(arg=None, normalize=False, format=None, week_offset=0):
     '''
     Description
     ------------
@@ -35,6 +35,8 @@ def Date(arg=None, normalize=False, week_offset=0):
             • DateBase object or DateBase polymorphism
     normalize : bool
         if True, only the year, month, and day are retained (hours, minutes, seconds, microseconds are set to zero)
+    format : str
+        if 'arg' is a string, this format is used to parse it (e.g. '%Y%m%d %H%S').
     week_offset : int
         by default, if a day of the week is supplied (e.g. 'Monday') then the date returned will be that day of the week
         for the current week. This argument is used to override this behavior by shifting the week backwards or forwards
@@ -70,6 +72,12 @@ def Date(arg=None, normalize=False, week_offset=0):
         return out
 
 
+    if format is not None:
+        if not isinstance(arg, str):
+            raise TypeError(f"When 'format' argument is not None, 'arg' must be a string, not {type(arg)}.")
+        arg = DateBase.to_datetime(arg, format=format)
+        return Date(arg, normalize=normalize)
+
     if arg is None:
         dt = datetime.datetime.now()
     elif hasattr(arg, 'to_pydatetime'): # pandas

{clockwork-0.1.4 → clockwork-0.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "clockwork"
-version = "0.1.4"
+version = "0.2.0"
 description = "Toolkit for time-related operations including scheduling, logging, date manipulation, and more."
 authors = ["Zachary Einck <zacharyeinck@gmail.com>"]
 license = "MIT"

clockwork-0.1.4/clockwork/__init__.py

@@ -1,4 +0,0 @@
-from .core import *
-
-__version__ = '0.1.4'
-__author__ = 'Zachary Einck <zacharyeinck@gmail.com>'