= Extension Development =

Tahoe has a programmatic API which enables building custom applications on top of the storage infrastructure.  This RESTful interface uses HTTP, so extensions can be implemented as separate processes across a network.

 * The [/trac/tahoe/browser/docs/webapi.txt webapi.txt] document shows how to control a Tahoe node programmatically.

== Extension Projects ==

None known yet...

== Extension Implementation Issues ==

=== HTTP methods ===

The api relies on four HTTP methods defined as per the standard {{{GET, POST, PUT, and DELETE}}}, which map intuitively to storage operations.

Although these are standard HTTP methods, some clients do not offer good support for them.
 * The following clients are known to support all methods:
   * [http://curl.haxx.se/ curl] is an open source client which supports arbitrary methods with the '-X' option.
 * The following clients do not seem to support either {{{PUT}}} and {{{DELETE}}}:
   * ...
 * We have not yet determined if the following have support for arbitrary methods:
   * Common web browsers.
   * Python 2.5's stdlib:
     * {{{httplib}}}
     * {{{urllib}}}

=== Race Conditions ===

Race conditions commonly exist in programs which use traditional directory structure interfaces.  The webapi.txt document describes how to avoid many of these situations by relying on file URI's, instead of their vdrive names.