Metadata-Version: 2.0
Name: icemac.recurrence
Version: 1.6
Summary: Compute recurrences of events
Home-page: https://github.com/icemac/icemac.recurrence
Author: Michael Howitz
Author-email: icemac@gmx.net
License: MIT
Download-URL: https://pypi.org/project/icemac.recurrence
Keywords: calendar event recurring recurrence datetime
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Provides-Extra: test
Requires-Dist: gocept.month (>=2)
Requires-Dist: grokcore.component (>=2.6)
Requires-Dist: setuptools
Requires-Dist: zope.cachedescriptors
Requires-Dist: zope.component
Requires-Dist: zope.globalrequest
Requires-Dist: zope.i18nmessageid
Requires-Dist: zope.interface
Provides-Extra: test
Requires-Dist: zope.configuration; extra == 'test'

This package provides helper functions to compute recurrences of events in a
environment using the Zope Component Architecture (ZCA).

Copyright (c) 2013-2018 Michael Howitz

This package is licensed under the MIT License, see LICENSE.txt inside the
package.

.. image::
  https://travis-ci.com/icemac/icemac.recurrence.svg?branch=master
  :target: https://travis-ci.com/icemac/icemac.recurrence

.. image::
  https://coveralls.io/repos/github/icemac/icemac.recurrence/badge.svg
  :target: https://coveralls.io/github/icemac/icemac.recurrence

.. image:: https://img.shields.io/pypi/v/icemac.recurrence.svg
        :target: https://pypi.org/project/icemac.recurrence/
        :alt: Current version on PyPI

.. image:: https://img.shields.io/pypi/pyversions/icemac.recurrence.svg
        :target: https://pypi.org/project/icemac.recurrence/
        :alt: Supported Python versions

.. image:: https://img.shields.io/pypi/implementation/icemac.recurrence.svg
        :target: https://pypi.org/project/icemac.recurrence/
        :alt: Supported Python implementations


.. contents::

=====
Usage
=====

* Register the package at the ZCA via ZCML::

  <include package="icemac.recurrence" />

* Compute recurrences. The example computes the 2nd Tuesday each month.::

      >>> from icemac.recurrence import get_recurrences
      >>> get_recurrences(
      ...     datetime=datetime(2015, 10, 13, 11, 15),
      ...     period='nth weekday of month',
      ...     interval_start=datetime(2015, 1, 1),
      ...     interval_end=datetime(2015, 12, 31))
      [datetime(2015, 10, 13, 11, 15),
       datetime(2015, 11, 10, 11, 15),
       datetime(2015, 12, 8, 11, 15)]

* Supported recurrence periods:

  * ``daily``
  * ``weekly``
  * ``biweekly``
  * ``nth weekday of month``
  * ``nth weekday every other month``
  * ``nth weekday from end of month``
  * ``nth weekday from end of other month``
  * ``yearly``

=========
 Hacking
=========

Source code
===========

Get the source code::

   $ git clone https://github.com/icemac/icemac.recurrence

or fork me on: https://github.com/icemac/icemac.recurrence

Running the tests
=================

You have to install tox_ onto your machine.

To run the tests yourself call::

  $ tox

.. _tox : https://pypi.org/project/tox/


===========
 Changelog
===========

1.6 (2018-08-10)
================

- Add support for Python 3.6 and 3.7, PyPy and PyPy3.

- The tests are now run using `tox`.


1.5 (2018-08-03)
================

- Change license from ZPL to MIT.


1.4.2 (2018-03-16)
==================

- Fix the computation of monthly recurrences not to return a date before the
  given `interval_start` date.


1.4.1.post1 (2017-12-26)
========================

- Also release as wheel.


1.4.1 (2017-04-11)
==================

- Fix a corner case in the computation of monthly recurrences: If the
  beginning of the interval for which recurrences should be computed was
  outside DST but the recurrence date was inside DST - it was incorrectly
  returned with a time zone object which did not have DST switched on.


1.4 (2017-04-08)
================

- No longer exclude tests from coverage report.


1.3.1 (2017-02-04)
==================

- Fix computation of biweekly recurrences: Previously the first recurrence with
  a matching weekday in the interval was used as the first result for the
  interval. This is only correct in half of the cases. Now the computation of
  the first recurrence in the interval takes into account that it has to be an
  even number of weeks after the recurrence start date and it handles DST
  differences correctly.


1.3 (2017-01-07)
================

- Add Manifest and clean up coverage configuration.


1.2 (2016-04-16)
================

- Fix handling for dates with a timezone which has a daylight saving time
  (DST): The local time of the recurrence does not change when switching DST
  though the UTC representation of the time will now change.


1.1 (2016-03-01)
================

- Shorten the import path of ``get_recurrences()`` from
  ``icemac.recurrence.recurrence`` to just ``icemac.recurrence``.

- Refactor tests to use ``py.test`` fixtures.

- Fix an off by one month error in the periods `nth weekday every other month`
  and `nth weekday from end of other month`.

- Bring the test coverage to 100 % even in branch coverage.


1.0.1 (2015-10-22)
==================

- Fix broken 1.0.0 release.


1.0.0 (2015-10-13)
==================

* Extract package from `icemac.ab.calendar` for reuse in other projects.


