django-swingtime 1.4.0

描述

Swingtime是一个类似于Mac OS X中iCal或Google Calendar的简化版的Django应用。

Swingtime提供了一个models.Event模型，该模型作为包含一个或多个models.Occurrence对象的元数据容器，这些对象描述了特定的开始和结束时间。

Swingtime在datetime标准库包和dateutil包上都有很大的依赖，提供了对dateutil.rrule接口的直接支持，用于创建发生。

一个相当简单的例子

>>> from datetime import *
>>> from swingtime import models as swingtime
>>> et = swingtime.EventType.objects.create(abbr='work', label='Work Related Events')
>>> evt = swingtime.Event.objects.create(
...     title='New TPS Cover Sheet',
...     description='Kiss off, Lumbergh!',
...     event_type=et
... )
>>> evt.add_occurrences(datetime(2018,3,18,16), datetime(2018,3,18,16,15), count=5)
>>> for o in evt.occurrence_set.all():
...     print(o)
...
New TPS Cover Sheet: 2018-03-18T16:00:00
New TPS Cover Sheet: 2018-03-19T16:00:00
New TPS Cover Sheet: 2018-03-20T16:00:00
New TPS Cover Sheet: 2018-03-21T16:00:00
New TPS Cover Sheet: 2018-03-22T16:00:00

一个更详细的例子，使用方便的函数models.create_event

>>> # pay day is the last Friday of the month at 5pm
>>> evt = swingtime.create_event(
...     'Pay day',
...     ('pay', 'Payroll'), # alternate means to add EventType on the fly
...     freq=rrule.MONTHLY,
...     byweekday=rrule.FR(-1),
...     until=datetime(2013,8,1),
...     start_time=datetime(2013,4,1,17)
... )
>>> for o in evt.occurrence_set.all():
...     print(o)
...
Pay day: 2013-04-26T17:00:00
Pay day: 2013-05-31T17:00:00
Pay day: 2013-06-28T17:00:00
Pay day: 2013-07-26T17:00:00

演示

要查看演示，请点击此处。

要使用Docker运行本地演示，请按照以下步骤操作

$ docker build -t swingtime .
$ docker run -p 8000:80 -d swingtime:latest

并浏览到localhost:8000。

特性

• 通过dateutil添加复杂事件发生的支持

• 用于处理复杂输入的现成 forms.MultipleOccurrenceForm 表单

• 每日、每月和年度视图功能

• 基于网格的每日视图生成器，包含交替或顺序的 EventType CSS类处理

• 略优于平均水平的文档，一些测试案例和注释代码

• 内置的演示项目/应用程序

要求

• Python 3.8+

• Django >=3.2,<5.0

• python-dateutil.