NAME

TiddlyWeb::Resting - module for accessing TiddlyWeb HTTP API

SYNOPSIS

            

              
              
use TiddlyWeb::Resting;
my $Rester = TiddlyWeb::Resting->new(
  username => $opts{username},
  password => $opts{password},
  server   => $opts{server},
);
$Rester->workspace('wikiname');
$Rester->get_page('my_page');
}
            
          

DESCRIPTION

TiddlyWeb::Resting is a module designed to allow remote access to the TiddlyWeb API for use in Perl programs. It is a work in progress, adapting Socialtext::Resting. It maintains the terms, from Socialtext, of workspace and page, which are translated to recipe and tiddler.

METHODS

new

            

              
              
my $Rester = TiddlyWeb::Resting->new(
    username => $opts{username},
    password => $opts{password},
    server   => $opts{server},
);
or
my $Rester = TiddlyWeb::Resting->new(
    user_cookie => $opts{user_cookie},
    server      => $opts{server},
);
            
          

Creates a TiddlyWeb::Resting object for the specified server/user/password, or server/cookie combination.

accept

            

              
              
$Rester->accept($mime_type);
            
          

Sets the HTTP Accept header to ask the server for a specific representation in future requests.

Common representations:

text/plain

text/html

application/json

text/x-tiddlywiki

get_page

            

              
              
$Rester->workspace('wikiname');
$Rester->get_page('page_name');
            
          

Retrieves the content of the specified page. Note that the workspace method needs to be called first to specify which workspace to operate on.

put_page

            

              
              
$Rester->workspace('wikiname');
$Rester->put_page('page_name',$content);
            
          

Save the content as a page in the wiki. $content can either be a string, which is treated as wikitext, or a hash with the following keys:

text

A string which is the page's wiki content or a hash of content plus other stuff.

tags

A list of tags.

fields

A hash of arbitrary key value pairs.

get_pages

            

              
              
$Rester->workspace('wikiname');
$Rester->get_pages();
            
          

List all pages in the wiki.

get_revisions

            

              
              
$Rester->get_revisions($page)
            
          

List all the revisions of a page.

get_workspace

            

              
              
$Rester->get_workspace();
            
          

Return the metadata about a particular workspace.

get_workspaces

            

              
              
$Rester->get_workspaces();
            
          

List all workspaces on the server

response

            

              
              
my $resp = $Rester->response;
            
          

Return the HTTP::Response object from the last request.

AUTHORS / MAINTAINERS

Chris Dent <cdent@peermore.com>

Based on work by:

Luke Closs <luke.closs@socialtext.com>

Shawn Devlin <shawn.devlin@socialtext.com>

Jeremy Stashewsky <jeremy.stashewsky@socialtext.com>

CONTRIBUTORS

Chris Dent

Kirsten Jones

Michele Berg - get_revisions()

cpanm TiddlyWeb::Wikrad

perl -MCPAN -e shell
install TiddlyWeb::Wikrad