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.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2af54b57b35c2011de28d04c5065ceb767ece024484b4cf9c571c35bafa4253a |
|
MD5 | 7c8cd84c2f8f6e4a4b2b4e04eb6a0909 |
|
BLAKE2b-256 | c35f38bca67e803aed1396a8670da48cbac3f869f25378d7f6ca743338b5e3c5 |