appier 1.34.2__py2.py3-none-any.whl → 1.34.3__py2.py3-none-any.whl

appier/base.py

@@ -94,7 +94,7 @@ NAME = "appier"
 """ The name to be used to describe the framework while working
 on its own environment, this is just a descriptive value """
 
-VERSION = "1.34.2"
+VERSION = "1.34.3"
 """ The version of the framework that is currently installed
 this value may be used for debugging/diagnostic purposes """
 
@@ -2328,7 +2328,7 @@ class App(
         thread.daemon = True
         thread.start()
 
-    def cron(self, job, cron):
+    def cron(self, job, cron, id=None, description=None):
         """
         Schedule the provided method for regular execution using
         the provided Cron like string.
@@ -2342,6 +2342,11 @@ class App(
         :type cron: String/SchedulerDate
         :param cron: The cron like string that is going to be used to
         define the execution time of the provided method.
+        :type id: String
+        :param id: The unique identifier for the task to be created.
+        :type description: String
+        :param description: The description for the task to be created
+        that describes the goal of the task.
         :rtype: SchedulerTask
         :return: The task that has been scheduled for execution at the
         provided time.
@@ -2350,7 +2355,7 @@ class App(
         if self._cron == None:
             self._cron = scheduler.CronScheduler(self)
             self._cron.start()
-        return self._cron.schedule(job, cron)
+        return self._cron.schedule(job, cron, id=id, description=description)
 
     def chunks(self, data, size=32768):
         for index in range(0, len(data), size):

appier/scheduler.py

@@ -29,6 +29,7 @@ __license__ = "Apache License, Version 2.0"
 """ The license for the module """
 
 import time
+import uuid
 import heapq
 import datetime
 import logging
@@ -143,7 +144,7 @@ class CronScheduler(Scheduler):
 
         self.timeout = max(0, timestamp - current_ts())
 
-    def schedule(self, job, cron, now=None):
+    def schedule(self, job, cron, id=None, description=None, now=None):
         """
         Schedules the provided job function for execution according
         to the provided cron string.
@@ -156,13 +157,18 @@ class CronScheduler(Scheduler):
         :param job: The function to be executed as the job.
         :type cron: String/SchedulerDate
         :param cron: The cron like string defining the schedule.
+        :type id: String
+        :param id: The unique identifier for the task to be created.
+        :type description: String
+        :param description: The description for the task to be created
+        that describes the goal of the task.
         :type now: datetime
         :param now: Optional time reference for the job scheduling.
         :rtype: SchedulerTask
         :return: The task object that was created for the job.
         """
 
-        task = SchedulerTask(job, cron)
+        task = SchedulerTask(job, cron, id=id, description=description)
         heapq.heappush(self._tasks, (task.next_timestamp(now=now), task))
         self.awake()
         return task
@@ -181,16 +187,18 @@ class CronScheduler(Scheduler):
 
 class SchedulerTask(object):
 
-    def __init__(self, job, cron):
+    def __init__(self, job, cron, id=None, description=None):
         self.job = job
         self.date = SchedulerDate.from_cron(cron)
+        self.id = str(uuid.uuid4()) if id == None else id
+        self.description = description
         self._enabled = True
 
     def __repr__(self):
-        return "<SchedulerTask: %s, %s>" % (self.job, self.date)
+        return "<SchedulerTask: [%s] %s, %s>" % (self.id[:-12], self.job, self.date)
 
     def __str__(self):
-        return "<SchedulerTask: %s, %s>" % (self.job, self.date)
+        return "<SchedulerTask: [%s] %s, %s>" % (self.id[:-12], self.job, self.date)
 
     def __eq__(self, other):
         if isinstance(other, self.__class__):
@@ -216,6 +224,10 @@ class SchedulerTask(object):
     def enabled(self):
         return self._enabled
 
+    @property
+    def cron(self):
+        return self.date.into_cron()
+
 
 class SchedulerDate(object):
 
@@ -229,10 +241,10 @@ class SchedulerDate(object):
         self.days_of_week = self._parse_field(days_of_week, 0, 6)
 
     def __repr__(self):
-        return "<SchedulerDate: %s>" % self.next_run()
+        return "<SchedulerDate: %s, %s>" % (self.into_cron(), self.next_run())
 
     def __str__(self):
-        return "<SchedulerDate: %s>" % self.next_run()
+        return "<SchedulerDate: %s, %s>" % (self.into_cron(), self.next_run())
 
     @classmethod
     def from_cron(cls, cron):
@@ -241,6 +253,17 @@ class SchedulerDate(object):
         values = (value.strip().split(",") for value in cron.split(" "))
         return cls(*values)
 
+    def into_cron(self):
+        return " ".join(
+            [
+                self._into_cron_field(self.minutes, 0, 59),
+                self._into_cron_field(self.hours, 0, 23),
+                self._into_cron_field(self.days_of_month, 1, 31),
+                self._into_cron_field(self.months, 1, 12),
+                self._into_cron_field(self.days_of_week, 0, 6),
+            ]
+        )
+
     def next_timestamp(self, now=None):
         date = self.next_run(now=now)
         return legacy.to_timestamp(date)
@@ -301,6 +324,11 @@ class SchedulerDate(object):
         else:
             return set((int(field),))
 
+    def _into_cron_field(self, field, min_value, max_value):
+        if field == set(range(min_value, max_value + 1)):
+            return "*"
+        return ",".join(str(v) for v in sorted(field))
+
 
 class Cron(object):
     pass

appier/scheduler.pyi

@@ -29,7 +29,12 @@ class CronScheduler(Scheduler):
     def __init__(self, owner: App | None, timeout: float = ..., daemon: bool = ...): ...
     def tick(self, now_ts: float | None = ...): ...
     def schedule(
-        self, job: JobFunction, cron: Cron, now: datetime | None = ...
+        self,
+        job: JobFunction,
+        cron: Cron,
+        id: str | None = ...,
+        description: str | None = ...,
+        now: datetime | None = ...,
     ) -> SchedulerTask: ...
     def next_run(self) -> datetime | None: ...
     def next_timestamp(self) -> float | None: ...
@@ -38,13 +43,21 @@ class SchedulerTask(object):
     job: JobFunction
     date: SchedulerDate
 
-    def __init__(self, job: JobFunction, cron: Cron): ...
+    def __init__(
+        self,
+        job: JobFunction,
+        cron: Cron,
+        id: str | None = ...,
+        description: str | None = ...,
+    ): ...
     def enable(self): ...
     def disable(self): ...
     def next_run(self, now: datetime | None = ...) -> datetime: ...
     def next_timestamp(self, now: datetime | None = ...) -> float: ...
     @property
     def enabled(self) -> bool: ...
+    @property
+    def cron(self) -> str: ...
 
 class SchedulerDate(object):
     minutes: set[int]
@@ -63,8 +76,12 @@ class SchedulerDate(object):
     ): ...
     @classmethod
     def from_cron(cls, cron: Cron) -> SchedulerDate: ...
+    def into_cron(self) -> str: ...
     def next_timestamp(self, now: datetime | None = None) -> float: ...
     def next_run(self, now: datetime | None = None) -> datetime: ...
     def _parse_field(
         self, field: CronField, min_value: int, max_value: int
     ) -> set[int]: ...
+    def _into_cron_field(
+        self, field: set[int], min_value: int, max_value: int
+    ) -> str: ...

appier/test/scheduler.py

@@ -164,6 +164,12 @@ class CronSchedulerTest(unittest.TestCase):
 
 class SchedulerDateTest(unittest.TestCase):
 
+    def test_repr(self):
+        date = appier.SchedulerDate.from_cron("11")
+        self.assertEqual(
+            repr(date), "<SchedulerDate: 11 * * * *, %s>" % str(date.next_run())
+        )
+
     def test_from_cron(self):
         date = appier.SchedulerDate.from_cron("11")
         self.assertEqual(date.minutes, set((11,)))
@@ -172,6 +178,25 @@ class SchedulerDateTest(unittest.TestCase):
         self.assertEqual(date.months, set(range(1, 13)))
         self.assertEqual(date.days_of_week, set(range(0, 7)))
 
+    def test_into_cron(self):
+        date = appier.SchedulerDate.from_cron("11")
+        self.assertEqual(date.into_cron(), "11 * * * *")
+
+        date = appier.SchedulerDate.from_cron("11 3")
+        self.assertEqual(date.into_cron(), "11 3 * * *")
+
+        date = appier.SchedulerDate.from_cron("11 3 10")
+        self.assertEqual(date.into_cron(), "11 3 10 * *")
+
+        date = appier.SchedulerDate.from_cron("11 3 10 5")
+        self.assertEqual(date.into_cron(), "11 3 10 5 *")
+
+        date = appier.SchedulerDate.from_cron("11 3 10 5 2")
+        self.assertEqual(date.into_cron(), "11 3 10 5 2")
+
+        date = appier.SchedulerDate.from_cron("* 3 10 5 2")
+        self.assertEqual(date.into_cron(), "* 3 10 5 2")
+
     def test_next_run(self):
         date = appier.SchedulerDate.from_cron("11")
 

{appier-1.34.2.dist-info → appier-1.34.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: appier
-Version: 1.34.2
+Version: 1.34.3
 Summary: Appier Framework
 Home-page: http://appier.hive.pt
 Author: Hive Solutions Lda.

{appier-1.34.2.dist-info → appier-1.34.3.dist-info}/RECORD

@@ -6,7 +6,7 @@ appier/async_neo.py,sha256=gQpyT1-nZE6Uynh5FEmFl5kfXkxChdUsgiKgwlaNw5E,5446
 appier/async_old.py,sha256=m3BFqHVPCRuIZ9L2sGYhCQPEwuCNKBO2y7SKM0dbtj8,9194
 appier/asynchronous.py,sha256=a1LQa3wbGMaXELhF7W71dRr1klPOj6x-ST9EInvPhtU,1757
 appier/asynchronous.pyi,sha256=5CpLkpKcUq09woMOVYwpl24Pli0A8Xu6nXoT20xDQ-o,104
-appier/base.py,sha256=ikeBH6C_rE-13iP4yUysgVrMLs3wnvtgenotUk8hotY,270322
+appier/base.py,sha256=Hjb9dtAp7Ux_3R4hClJNghjZjN7wXpfaoDYPMGbcjFA,270630
 appier/base.pyi,sha256=Uk9nLTDpI5Z51AatN1AtBuGJ7w5CtZpJHXywg1z_Rv4,2818
 appier/bus.py,sha256=AMC2UXlaf6rzhzlIyTHkzbfb6tdfPBiOii4lpl9AAwg,7670
 appier/bus.pyi,sha256=W6_MIBpvDq468wfT5XM2WpPuR3O49QiZMOSCdMsJWos,182
@@ -48,8 +48,8 @@ appier/preferences.pyi,sha256=uYVgvDq2f4KWlLRY-C8bi6xry_utFKDeToGHH5aptxc,197
 appier/queuing.py,sha256=6AJlRVdd5JunzChu8Q1U-9Biq4vQUHTuJFC8qs2wzCs,8097
 appier/redisdb.py,sha256=5inJMQqHVkfsGoqoRGYzewlgooDZD2uwOtlPXHX17V0,3504
 appier/request.py,sha256=vNiRdBZXgboMx_d3xkGHlJf3f7ifejgKyhYZ4Pr9GlE,31450
-appier/scheduler.py,sha256=8PcdJQqgbUOrkRfy-2-3N987lGpIUPO9fNYm9QtSjE0,9741
-appier/scheduler.pyi,sha256=JHqH-DSKFZL1uXJTpWFTVHykRT8QRGrVdYCi0nyhjrQ,2132
+appier/scheduler.py,sha256=7R1iTA6KSFKUwhjw-PWqhPPNKaaRi9qUTLwcyqO5tXk,10962
+appier/scheduler.pyi,sha256=y-PL_t6gm6f8wwhfrpfIP0P8pljBGTljy-zRMBP_Ihw,2530
 appier/serialize.py,sha256=LiR1ZbAiC_I3lhlQToPK_u2DC2r04Gl9OEQTayW4Rlg,6669
 appier/session.py,sha256=6rcwFdsu--7gFLr6mJJh3EFSZ_A3Oe8u7olAvTw2sUk,20380
 appier/session.pyi,sha256=JBYcT1wZ9mKBBk9iTw2GDJENB8PWFzxXjIr9oXKe85Q,239
@@ -84,7 +84,7 @@ appier/test/part.py,sha256=yHQxg2hdfojJMO2Fs0NLvYTX3uCJ6xwgsD4VaKV04ak,3352
 appier/test/preferences.py,sha256=QyqoBddOCAmhkcgUYAJ5RgypqrkGL6x6s6a0jsIwE9w,2890
 appier/test/queuing.py,sha256=Lq7gI5QkZfXPf_MUzmRd6LHHknf9EryF-MauWjDLJn0,5710
 appier/test/request.py,sha256=h3DdvhEMARpYTp7eRcJ3-qLQyG-a8PHqSnWY52BiOeU,8176
-appier/test/scheduler.py,sha256=VlbwpoYYI5hgqlpjcyVcMnSHnLGCCCeMi6kyPD7YxV4,7440
+appier/test/scheduler.py,sha256=j-0byKZZfD36EenJg8kVm55plZ5p1lTLz9GsOT0FDxE,8384
 appier/test/serialize.py,sha256=roX01n86AQfnPxzPVdIjdIUQWC_x0C_HE3hNgF37ci8,2120
 appier/test/session.py,sha256=KdiYLLB5autIEu1sHwOuYJXVd0y6RMPgg0ITBuRTMfA,4419
 appier/test/smtp.py,sha256=XJNa0ZTmabdrX8MfVMgcqBxabvBfHgIimvozdziP4_E,1826
@@ -92,8 +92,8 @@ appier/test/structures.py,sha256=MRjUFRlnJi-i7YGWW5y792JbJwicNvOIzVAS220tgeQ,836
 appier/test/typesf.py,sha256=KHumQFzx7wPZSCb8_mpIwobhIy2Fh_0XYviwPjXMbKI,9680
 appier/test/util.py,sha256=SSHuBAZQ0TcXLDYI0xUvmwId5nndDZb88s_5Y-Hqibw,46884
 appier/test/validation.py,sha256=riOCsGKob1P5jnbcB5qGZ45ApimNAVS0byg9v_uUdrk,4952
-appier-1.34.2.dist-info/LICENSE,sha256=Pd-b5cKP4n2tFDpdx27qJSIq0d1ok0oEcGTlbtL6QMU,11560
-appier-1.34.2.dist-info/METADATA,sha256=guRP0PiFO_o0wJ9zrw11k4D1LSE5XS12T_Ad6tI-0tY,1920
-appier-1.34.2.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
-appier-1.34.2.dist-info/top_level.txt,sha256=Z2e_Y1ya06a554WwQZkfNRiaaQxqsdaPtBzrck384Lo,7
-appier-1.34.2.dist-info/RECORD,,
+appier-1.34.3.dist-info/LICENSE,sha256=Pd-b5cKP4n2tFDpdx27qJSIq0d1ok0oEcGTlbtL6QMU,11560
+appier-1.34.3.dist-info/METADATA,sha256=6fMXpRxLPtO0Ur-t0Mqj2gNZBFPWJ4mRGMvCSPnI6Ug,1920
+appier-1.34.3.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
+appier-1.34.3.dist-info/top_level.txt,sha256=Z2e_Y1ya06a554WwQZkfNRiaaQxqsdaPtBzrck384Lo,7
+appier-1.34.3.dist-info/RECORD,,