o ;i @s>ddlmZGdddZGdddeZGdddeZdS) )api_pb2c@seZdZdZddZdS)SchedulezDSchedules represent a time frame to repeatedly run a Modal function.cCs ||_dS)N) proto_message)selfrrB/home/ubuntu/.local/lib/python3.10/site-packages/modal/schedule.py__init__s zSchedule.__init__N)__name__ __module__ __qualname____doc__rrrrrrs rcs2eZdZdZ d dededdffdd ZZS) CronaCron jobs are a type of schedule, specified using the [Unix cron tab](https://crontab.guru/) syntax. The alternative schedule type is the [`modal.Period`](https://modal.com/docs/reference/modal.Period). **Usage** ```python import modal app = modal.App() @app.function(schedule=modal.Cron("* * * * *")) def f(): print("This function will run every minute") ``` We can specify different schedules with cron strings, for example: ```python modal.Cron("5 4 * * *") # run at 4:05am UTC every night modal.Cron("0 9 * * 4") # runs every Thursday at 9am UTC ``` We can also optionally specify a timezone, for example: ```python # Run daily at 6am New York time, regardless of whether daylight saving # is in effect (i.e. at 11am UTC in the winter, and 10am UTC in the summer): modal.Cron("0 6 * * *", timezone="America/New_York") ``` If no timezone is specified, the default is UTC. UTC cron_stringtimezonereturnNcs(tjj||d}ttj|ddS)zEConstruct a schedule that runs according to a cron expression string.)rr)cronN)rrr superr)rrrr __class__rrr0sz Cron.__init__)r)r r r r strr __classcell__rrrrr s&r csTeZdZdZdddddddddededededed ed ed d ffd dZZS)PeriodaCreate a schedule that runs every given time interval. **Usage** ```python import modal app = modal.App() @app.function(schedule=modal.Period(days=1)) def f(): print("This function will run every day") modal.Period(hours=4) # runs every 4 hours modal.Period(minutes=15) # runs every 15 minutes modal.Period(seconds=math.pi) # runs every 3.141592653589793 seconds ``` Only `seconds` can be a float. All other arguments are integers. Note that `days=1` will trigger the function the same time every day. This does not have the same behavior as `seconds=84000` since days have different lengths due to daylight savings and leap seconds. Similarly, using `months=1` will trigger the function on the same day each month. This behaves similar to the [dateutil](https://dateutil.readthedocs.io/en/latest/relativedelta.html) package. ryearsmonthsweeksdayshoursminutessecondsrrrrrrr rNc s2tjj|||||||d}ttj|ddS)Nr)period)rrrrr) rrrrrrrr r!rrrrXs  zPeriod.__init__)r r r r intfloatrrrrrrr:s4   rN) modal_protorrr rrrrrs .