Developers Wiki

Chandler encompasses three major Apache 2.0 licensed software projects:

Chandler 1 and Chandler 2 are cross-platform desktop applications written in wxPython. Chandler Server is a Javascript web application plus a Java server providing storage and HTTP APIs for manipulating Chandler data. These three projects share:

• a common data model focused on items as the central unit of information, each of which can have different "stamps" (sets of related attributes) added or subtracted (for example, an Event stamp adds date details to simple note items)
• an interchange format associated with that data model, called EIM (Extensible Information Model) which allows Chandler data to be exchanged between different Chandler projects. When saved to a file, this data typically has a .chex extension (CHandler EXchange)

Chandler 1 is the code base for the 1.0 desktop product. Chandler 2 is the future of desktop development. It's still "under construction", interested volunteers are encouraged to help out. For more details, see this short history.

On Wikis

The Chandler wiki is a historical record of Chandler's development. As such, much is out of date. This became even more true in 2009 when most desktop development shifted focus to Chandler 2. There's a lot of good stuff in the wiki, but be careful and don't assume information in a wiki page is up to date.

If you need clarification, try the mailing lists, or chat with us on IRC.

What to Hack On

As of March 2009, all development on Chandler is volunteer. On the desktop, most volunteer effort is focused on Chandler 2. If you're using Chandler 1 and would like to fix a bug, go for it! Otherwise, focus your efforts on Chandler 2 and Chandler Server.

Chandler 2

At the moment, there's limited UI and no persistence, but Chandler 1 .chex files can be imported and exported. It's ready for hacking on, but not for end users, so there are currently no packaged installers for any platform.

For the authoritative documentation, see http://chandler2.osafoundation.org/

• SVN: http://svn.osafoundation.org/chandler2/trunk/
• Installation
• Documentation
• Bugtracker - not set up yet

Chandler 1

Chandler 1 was written in Python, building on Twisted for networking services, Berkeley DB for storage and wxPython for the GUI framework.

• SVN: http://svn.osafoundation.org/chandler/trunk/
• Installation
• Documentation
• Bugtracker

Chandler Server (aka Cosmo)

• Download Server | Source Code | FAQ
• Install | Configure
• Release Process

Development Tools

• Current Tinderbox Continuous Build Status
• Windmill - UI Test Framework
• Server Protocol Tests | Acceptance Tests | Test Specifications

Reference Material

• Architecture
• Administrator Documentation
• Generated Cosmo Site Documentation
• Security Model
• JavaScript Source Code Style Guide

Client Access to Chandler Server data

• User Service Document
• Feed Service : AtomPub-based Content Access Protocol
• WebDAV | WebDAV tickets | CalDAV | CardDAV
• Morse Code : Specialized HTTP-based Content Synchronization Protocol
• CMP : HTTP-based Server Management Protocol
• Webcal : Read-only HTTP-based icalendar protocol

Quality Assurance

• ChandlerServerTestSpecifications - Test specifications for various Chandler Server releases.
• Setting up Cosmo builds on qacosmo/qasharing

Server Backend Automation

• Cosmo Automated Tests
  • CosmoProtocolTests
• Cosmo Stress Tests
  • CosmoStressTests
• Miscellaneous Tools/Utilities
  • Simple timezone conversion utility(Olsen Convert) .
• Apple's CalDAV Test suite
  • AppleCalDAVTests
• Mikeal's Automated Test Coverage
  • MikealRogersAutomatedTestCoverage

Server Frontend Automation

• WindmillTests
• Windmill UI Testing Framework
• CosmoDotSevenWindmillTestingCoverage
• NeededWindmillTests

Related Projects

A list of projects hosted by OSAF, maintained by OSAF staff members, in part funded by OSAF, or in some other way directly related to OSAF:

• Feedback Server: Server component of the desktop feedback mechanism
• M2Crypto: Crypto and SSL toolkit for Python
• parsedatetime : Python library for parsing human-readable date/time text
• PyEgads : Python wrapper for EGADS, a cryptographically strong pseudo-random number generator and entropy daemon.
• PyICU : Python extension wrapping ICU's C++ API
• PyLucene : GCJ-compiled version of Java Lucene integrated with Python.
• setuptools : For packaging Python projects as "Eggs"
• vobject : Python package for parsing and generating vCard and vCalendar files
• subzilla : Utility for posting subversion patches to Bugzilla, and applying patches from Bugzilla to a subversion tree
• Windmill UI Testing Framework
• wxPython in Chandler
• Zanshin: Python library for collaboration over HTTP, WebDAV and CalDAV

A more complete list of contributions made to other projects.