Django utility wrapping dateutil.rrule
Project description
django-recurrence
django-recurrence is a utility for working with recurring dates in Django. Documentation is available at https://django-recurrence.readthedocs.org/.
It provides:
- Recurrence/Rule objects using a subset of rfc2445 (wraps
dateutil.rrule
) for specifying recurring date/times; RecurrenceField
for storing recurring datetimes in the database;- JavaScript widget.
RecurrenceField
provides a Django model field which serializes
recurrence information for storage in the database.
For example - say you were storing information about a university course in your app. You could use a model like this:
import recurrence.fields
class Course(models.Model):
title = models.CharField(max_length=200)
start = models.TimeField()
end = models.TimeField()
recurrences = recurrence.fields.RecurrenceField()
You'll notice that I'm storing my own start and end time. The
recurrence field only deals with recurrences not with specific time
information. I have an event that starts at 2pm. Its recurrences
would be "every Friday". For this to work, you'll need to put the
recurrence
application into your INSTALLED_APPS
Running the tests
Our test coverage is currently fairly poor (we're working on it!), but you can run the tests by making sure you've got the test requirements installed:
pip install -r requirements_test.txt
Once you've done that, you can run the tests using:
make test
You can generate a coverage report by running:
make coverage
You can run tests on multiple versions of Python and Django by
installing tox (pip install tox
) and running:
tox
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django_recurrence-1.10.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | cf865ec07e60bc4203ce09d849b03e1e506a36c56337962d95cd558a7c59b707 |
|
MD5 | 40186ab2d73e7d991c88a97e9847e923 |
|
BLAKE2b-256 | cd84cfd259adfe95c4e5df55d90828e6ed3dd80512570520fb4814e48b258671 |