GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  FAQ::OMATIC::API (3)

.ds Aq ’

NAME

FAQ::OMatic::API - a Perl API to manipulate FAQ-O-Matics

CONTENTS

SYNOPSIS



 use FAQ::OMatic::API;
 my $fom_api = new FAQ::OMatic::API();



DESCRIPTION

FAQ::OMatic::API is a class that makes HTTP requests to a FAQ-O-Matic. It provides a way to manipulate a FAQ-O-Matic from Perl code. Operations are performed by making HTTP requests on the FAQ-O-Matic server; this ensures that any operation is performed in exactly the same environment as it would be if it were requested by a human using a web browser.

Setup

The following methods are used to set up an API object.
$fom_api = new FAQ::OMatic::API([$url, [$id, $pass]]); Constructs a new FAQ::OMatic::API object that points at the FAQ whose CGI is at $url. Requests will be authenticated on behalf of FAQ user $id using password $pass.
$fom_api->setURL($url); Sets the URL of the target FAQ’s CGI. This is where requests will be sent.
$fom_api->setAuth($id, $pass); Sets the ID and password that will be used to authenticate requests.
$fom_api->setAuth(’query’); Passing in ’query’ will cause the script to query the terminal for the id and password at runtime.

Queries

The following methods retrieve information about a FAQ-O-Matic.
$fom_api->getCategories() Returns a list of the categories (by file name) in the FAQ.
$item = $fom_api->getItem($filename) Returns a local FAQ::OMatic::Item object created by retrieving $filename from the FAQ. You can perform operations on the result such as:



 print $item->getTitle();

 $parentItem = $item->getParent();

 print $item->displayHTML({render=>text});



my ($rc, $result) = $fom_api->fuzzyMatch([’Parent Category’,’child cat’])


 my ($rc, $result) = $fom_api->fuzzyMatch([Parent Category,child cat])
 die $result if (not $rc);
 my $item = $fom_api->getItem($result->[0]);



fuzzyMatch() attempts to figure out which category the last string in its array argument represents. The category name is matched fuzzily against existing categories. If a unique match is found, it is returned (as an array ref [$filename, $parent, $title]). If the match is ambiguous, the previous array element is matched against the parents of the set of fuzzy matches. This is performed recursively until the child category is disambiguated.

Fuzzy matching means that
(a) You don’t have to get the parent category names right if they’re not needed to disambiguate the child category.
(b) Category names are matched without respect to case, spacing, or punctuation: only alphanumerics matter. Also, the name you supply only has to appear somewhere inside the one you want to match. (Exact matches are preferred; this allows you to match categories whose names are prefixes of other category names.)

Operations

The following methods perform operations on a FAQ-O-Matic.
$fom_api->newAnswer($parent, $title, $text) A new answer is created as a child of item $parent. The new answer has title $title and a single text part containing $text.

REQUIRES

LWP and its hierarchy of helper classes.
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 FAQ::OMATIC::API (3) 2002-02-11

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.