NAME

Shodo - Auto-generate documents from HTTP::Request and HTTP::Response

SYNOPSIS

use HTTP::Request::Common;
use HTTP::Response;
use Shodo;

my $shodo = Shodo->new();
my $suzuri = $shodo->new_suzuri('An endpoint method.');

my $req = POST '/entry', [ id => 1, message => 'Hello Shodo' ];
$suzuri->request($req);
my $res = HTTP::Response->new(200);
$res->content('{ "message" : "success" }');
$suzuri->response($res);

print $suzuri->document(); # print document as Markdown format

DESCRIPTION

Shodo generates Web API documents as Markdown format automatically and validates parameters using HTTP::Request/Response.

THIS IS A DEVELOPMENT RELEASE. API MAY CHANGE WITHOUT NOTICE.

Methods

new

my $shodo = Shodo->new(
    document_root => 'doc'
);

Create and return new Shodo object. "document_root" is optional parameter for your document root directory.

template

$shodo->template($tmpl);

Set custom template.

document_root

$shodo->document_root('doc');

Set document root directory.

new_suzuri

my $suzuri = $shodo->new_suzuri('This is description.');

Create and return new Shodo::Suzuri object with the description.

stock

$shodo->stock($suzuri->doc());

Stock text of documents for writing later. The parameter document is anything ok, but Markdown based is recommended.

write

$shodo->write('output.md');

Write the documentation in stocks to the file and make the stock empty.

SEE ALSO

Test::Shodo::JSONRPC

"autodoc": https://github.com/r7kamura/autodoc

Test::JsonAPI::Autodoc

What is Shodo?: http://en.wikipedia.org/wiki/Shodo

THANKS

Songmu for naming as "Shodo". It's pretty.

Moznion for making Test::JsonAPI::Autodoc.

Hachioji.pm for advising.

LICENSE

Copyright (C) Yusuke Wada.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

AUTHOR

Yusuke Wada yusuke@kamawada.com