croniter 0.3.13

croniter provides iteration for datetime object with cron like format

Introduction

Contents

• Introduction

• Travis badge

• Usage

• Develop this package

• Make a new release

• Contributors

• Changelog

  • 0.3.13 (2016-11-01)

  • 0.3.12 (2016-03-10)

  • 0.3.11 (2016-01-13)

  • 0.3.10 (2015-11-29)

  • 0.3.9 (2015-11-19)

  • 0.3.8 (2015-06-23)

  • 0.3.7 (2015-06-01)

  • 0.3.6 (2015-05-29)

  • 0.3.5 (2014-08-01)

  • 0.3.4 (2014-01-30)

  • 0.3.3 (2012-09-29)

croniter provides iteration for the datetime object with a cron like format.

                      _ _
  ___ _ __ ___  _ __ (_) |_ ___ _ __
 / __| '__/ _ \| '_ \| | __/ _ \ '__|
| (__| | | (_) | | | | | ||  __/ |
 \___|_|  \___/|_| |_|_|\__\___|_|

Website: https://github.com/kiorky/croniter

Travis badge

Usage

A simple example:

>>> from croniter import croniter
>>> from datetime import datetime
>>> base = datetime(2010, 1, 25, 4, 46)
>>> iter = croniter('*/5 * * * *', base)  # every 5 minites
>>> print iter.get_next(datetime)   # 2010-01-25 04:50:00
>>> print iter.get_next(datetime)   # 2010-01-25 04:55:00
>>> print iter.get_next(datetime)   # 2010-01-25 05:00:00
>>>
>>> iter = croniter('2 4 * * mon,fri', base)  # 04:02 on every Monday and Friday
>>> print iter.get_next(datetime)   # 2010-01-26 04:02:00
>>> print iter.get_next(datetime)   # 2010-01-30 04:02:00
>>> print iter.get_next(datetime)   # 2010-02-02 04:02:00

All you need to know is how to use the constructor and the get_next method, the signature of these methods are listed below:

>>> def __init__(self, cron_format, start_time=time.time())

croniter iterates along with ‘cron_format’ from ‘start_time’. cron_format is ‘min hour day month day_of_week’, you can refer to http://en.wikipedia.org/wiki/Cron for more details.:

>>> def get_next(self, ret_type=float)

get_next calculates the next value according to the cron expression and returns an object of type ‘ret_type’. ret_type should be a ‘float’ or a ‘datetime’ object.

Supported added for get_prev method. (>= 0.2.0):

>>> base = datetime(2010, 8, 25)
>>> itr = croniter('0 0 1 * *', base)
>>> print itr.get_prev(datetime)  # 2010-08-01 00:00:00
>>> print itr.get_prev(datetime)  # 2010-07-01 00:00:00
>>> print itr.get_prev(datetime)  # 2010-06-01 00:00:00

Develop this package

git clone https://github.com/kiorky/croniter.git
cd croniter
virtualenv --no-site-packages venv
. venv/bin/activate
pip install --upgrade -r requirements/test.txt
py.test src

Make a new release

We use zest.fullreleaser, a great release infrastructure.

Do and follow these instructions

. venv/bin/activate
pip install --upgrade -r requirements/release.txt
fullrelease

Contributors

Thanks to all who have contributed to this project! If you have contributed and your name is not listed below please let me know.

• mrmachine

• Hinnack

• shazow

• kiorky

• jlsandell

• mag009

• djmitche

• GreatCombinator

• chris-baynes

• ipartola

• yuzawa-san

Changelog

0.3.13 (2016-11-01)

• Real fix for #34 [kiorky@github]

• Modernize test infra [kiorky@github]

• Release as a universal wheel [adamchainz@github]

• Raise ValueError on negative numbers [josegonzalez@github]

• Compare types using “issubclass” instead of exact match [darkk@github]

• Implement step cron with a variable base [josegonzalez@github]

0.3.12 (2016-03-10)

• support setting ret_type in __init__ [Brent Tubbs <[e-mail]>]

0.3.11 (2016-01-13)

• Bug fix: The get_prev API crashed when last day of month token was used. Some essential logic was missing. [Iddo Aviram <[e-mail]>]

0.3.10 (2015-11-29)

• The fuctionality of ‘l’ as day of month was broken, since the month variable was not properly updated [Iddo Aviram <[e-mail]>]

0.3.9 (2015-11-19)

• Don’t use datetime functions python 2.6 doesn’t support [petervtzand]

0.3.8 (2015-06-23)

• Truncate microseconds by setting to 0 [Corey Wright]

0.3.7 (2015-06-01)

• converting sun in range sun-thu transforms to int 0 which is recognized as empty string; the solution was to convert sun to string “0”

0.3.6 (2015-05-29)

• Fix default behavior when no start_time given Default value for start_time parameter is calculated at module init time rather than call time.

• Fix timezone support and stop depending on the system time zone

0.3.5 (2014-08-01)

• support for ‘l’ (last day of month)

0.3.4 (2014-01-30)

• Python 3 compat

• QA Relase

0.3.3 (2012-09-29)

• proper packaging