Skip to main content

Dateable calendaring API

Project description

Kalends: Python calendaring API


Kalends is a Python module using the Component Architecture technologies of interfaces and adapters to separate the storage and display of calendar events. The purpose is to provide a generic Python API so that any calendar UI can display calendars coming from any calendar source. Thus, one can create new UIs without reimplementing the underlying calendar functionality, and one can likewise implement specialized calendar functionality while reusing the existing UI.

For example, if you have a groupware system with a good calendaring UI but need to use an external server for your calendars, you should not need to rewrite the user interface.

A secondary goal is also to provide an API for calendaring to help people around some of the obstacles you will sooner or later arrive at, like how to handle recurring events, searching, and more, by providing them with an API that can handle the issues.

The two main concepts of this API are event providers, which are the sources of events, and event users, which take the Events and display them, export them, etc. More information on how to use Kalends to make an EventProvider is in doc/PROVIDING.txt, and more information on how to use Kalends to get events from an EventProvider is in doc/USING.txt.


Although the creation of Kalends was prompted by the desire to have one set of advanced Kalendaring views available for all calendars in Plone, and although the Component Architecture was created by Zope Corporation, Kalends is in no way specific to Plone, Zope or even web applications. It’s a Python module, installable for any Python version (2.3 or later) on any system that can install the Component Architecture, which is pretty much any Python system with a C compiler.

Kalends requires: - Python 2.3 or later (last version tested: 2.4.3) - zope.interface 3.2 or later (last version tested: 3.2.2)

Known implementations

Currently the Dateable ( module set is using Kalends. It contains chronos, a set of views for Zope that implements a Kalends UI, and Plone4ArtistCalendar, a Plone product that makes Plone folders into event providers.

dateable.kalends Changes

1.0 (2013-05-21)

  • Updated the metadata.

dateable.kalends 0.5 (2009-05-03)

  • No changes.

dateable.kalends 0.4 (2008-10-04)

  • Version update to keep track with dateable.chronos.

dateable.kalends 0.3 (2008-07-09)

  • Added IEvent marker interface.

Project details

Download files

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

Files for dateable.kalends, version 1.0
Filename, size File type Python version Upload date Hashes
Filename, size (10.0 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page