Skip to main content

A scheduling app for Django

Project description

Build Status Coverage Status Documentation Project on PyPI

Django agenda is a django app that allow you to create and book times in a schedule. Our goal is to handle all the nasty details for you; like timezones, schedule changes, and whether or not a specific segment is actually available to be booked.

Features

  • Create recurring availabilities. We should support everything that RFC 2445 does.

  • Subclass AbstractBooking to create bookings. Bookings will reserve time slots, and flag them as busy.

  • Uses dynamic foreign keys, so you can relate your availabilities & bookings to anything (a user, an office space, a classroom)

Installation

First, install via pip (on Windows, replace pip3 with pip)

pip3 install django-agenda

Then, edit your settings.py, adding this line to INSTALLED_APPS

'django_agenda',

For further instructions, see the documentation.

Changes

0.7.2

  • Properly fix inability to rename TimeSlot class (#2)

  • Add support for Django 3.1

0.7.1

  • Remove support for Django 1.10

  • Fix error in documentation (#2), and make the booking_csl in TimeSlotMeta dynamic

0.7.0

  • Deprecated _get_padding and related methods in favor of methods without leading underscores

  • Added some basic documentation

0.6.5

  • Don‘t validate already allocated slots

0.6.4

  • Fix long description rendering problems on pypi

0.6.3

  • Add django_agenda.version, drop pbr

0.6.2

  • add a related name for the bookings relation

0.6.1

  • Bug fix for case where foreign key wasn’t called schedule

0.6.0

A major rewrite & simplification. This version works very differently from 0.5, don’t expect to migrate easily.

  • Time slots are now primarily for marking busy state, and availability occurrences are for free times.

  • You have to create your own models, subclassing the abstract models in django_agenda.models. The good thing about this is that this allows us to use real foreign keys instead of generic ones.

  • To that end, you’ll have to migrate the data into your models. Django Agenda won’t delete any of it’s own models, but you’ll have to migrate the data into the new models that you make.

  • Booking validation is now done in AbstractBooking.clean instead of AbstractBooking.save. Make sure you call full_clean!

  • You can use django_agenda.models.get_free_times to find all the free time spans in a particular space of time.

0.5.4

  • Add the ability to overlap busy slots

0.5.3

  • Add ability to overlap bookings

0.5.2

  • Add support for django 2

0.5.1

  • Fix bug if the start/end time weren’t in the same zone as the availability

0.5.0

  • Fix handling of daylight savings

0.4.0–0.4.9

  • Small improvements to the regen method

  • Fix problem where _padding_changed would crash with big changes

  • Improve error messaging

  • Fix issue where slots were being skipped during regeneration

  • Update config so it works more naturally

  • Fix issue where _padding_changed would alter same slot multiple times

  • Add a method to handle non-static padding values

  • Fix problem with app config, and gitlab ci

  • Fix bug making overlapping slots when a booking spanned existing slots

  • Add support for disallowing duplicate bookings

  • Fix instruction formatting in readme

  • Rewrite scheduling logic

  • Add a reasonable number of tests

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-agenda-0.7.2.tar.gz (22.3 kB view details)

Uploaded Source

Built Distribution

django_agenda-0.7.2-py3-none-any.whl (31.3 kB view details)

Uploaded Python 3

File details

Details for the file django-agenda-0.7.2.tar.gz.

File metadata

  • Download URL: django-agenda-0.7.2.tar.gz
  • Upload date:
  • Size: 22.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: Python-urllib/3.8

File hashes

Hashes for django-agenda-0.7.2.tar.gz
Algorithm Hash digest
SHA256 e5bb825590355e99da73deaa27c7ecf160e50d132cc5cc12e2acfe3ecc3fb5d3
MD5 bc93a3158437c1f219e3140f142c80e2
BLAKE2b-256 a138120a73acdbddae86ffb444fca20b6f45b4fb3685e91f3a8ee8ebb4ff9531

See more details on using hashes here.

File details

Details for the file django_agenda-0.7.2-py3-none-any.whl.

File metadata

File hashes

Hashes for django_agenda-0.7.2-py3-none-any.whl
Algorithm Hash digest
SHA256 162c0c328453ca58adc037fe160526f3095424f53a9aadec0324cbb23a3ee1ec
MD5 c01ceab11707f2fff34a409142f2dfe5
BLAKE2b-256 474b3f0003000a44cf90c4ea8bd71acc852114c29c2c9330601959199e65d3c0

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page