Calligraphy

Calligraphy is a Web Distributed Authoring and Versioning (WebDAV) solution for Rails that:

Provides a framework for handling WebDAV requests (e.g. PROPFIND, PROPPATCH)
Allows you to extend WedDAV functionality to any type of resource
Passes all of the Litmus tests (using Calligraphy::FileResource and digest authentication)

Getting Started

Add the following line to your Gemfile:

gem 'calligraphy'

Then, run bundle install

Next, run the generator:

rails generate calligraphy:install

The generator will install an initializer which describes Calligraphy's configuration options.

Finally, set up a calligraphy_resource route in config/routes.rb with a resource_class.

# config/routes.rb
calligraphy_resource :webdav, resource_class: Calligraphy::FileResource

The above will create a route, /webdav that will be able to handle the following HTTP request methods:

OPTIONS
GET
PUT
DELETE
COPY
MOVE
MKCOL
PROPFIND
PROPPATCH
LOCK
UNLOCK

The routes will also use the Calligraphy::FileResource, enabling Rails to carry out WebDAV actions on files. Additionally, when using the FileResource class the resource root path (the location you'd like to serve files from) with the resource_root_path key:

# config/routes.rb
calligraphy_resource :webdav, resource_class: Calligraphy::FileResource, resource_root_path: '/home/webdav'

This will serve local files from /home/webdav on the server through the /webdav endpoint.

Extensibility

The Calligraphy::Resource class exposes all the methods used in the various Calligraphy::WebDavRequest classes. To create a custom resource, simply inherit from Calligraphy::Resource and redefine the public methods you'd like to customize.

For example, to create a CalendarResource:

module Calligraphy
  class CalendarResource < Resource

    def propfind(nodes)
      # custom implementation of propfind for CalendarResource
    end

    ...
  end
end

eanlain/calligraphy

Calligraphy

Getting Started

Extensibility

License