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; RecurrenceFieldfor 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
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.3-py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 9053b44b78b7fbfe3530673edfdd6d2f562105f8a192bc6a4b906a3df4f95f59 |
|
| MD5 | 466169bba9fd766492ed130dd70c5498 |
|
| BLAKE2b-256 | ad0aecb4a5ec001a552c7b0b6f51546300ed6146bd635d3f95880111fed73049 |
