The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

Rest::HtmlVis - Rest API visualizer in HTML

VERSION

Version 0.01

SYNOPSIS

Transform perl hash to html. Each key in perl hash is transormed to the piece of html, js and css those are include in main html.

Example:

        use Rest::HtmlVis;

        my $htmlvis = Rest::HtmlVis->new({
                events => Rest::HtmlVis::Events
        });

        $htmlvis->html({

                events => [
                ],

                links => {
                        rel => 'root',
                        href => /,
                        name => Root resource
                }

                form => {
                        GET => {
                                from => {
                                        type => 'time',
                                        default => time(),
                                }
                        },
                        POST => {
                                DATA => {
                                        type => "text"
                                        temperature => 25
                                },

                        }
                }
        });

HtmlVis has default blocks that are show everytime:

These blocks can be rewrite when the base or content key is set in constructor params.

SUBROUTINES/METHODS

new( params )

Create new htmlvis object. You have to specify params for keys that should be transformed.

params

Define keys in input hash and library that manage this key.

Example:

        { events => Rest::HtmlVis::Events }   

Specific param is 'param.local' that defines if third party javascript and css is download from internet or from local repository. If you want to use local repository it is important to serve static content from static directory. Example:

        mount '/static' => Plack::App::File->new(root => "/path_to_static_directory/static/")->to_app;

html( hash_struct )

Convert input hash struct to html. Return html string.

TUTORIAL

http://psgirestapi.dovrtel.cz/

AUTHOR

Vaclav Dovrtel, <vaclav.dovrtel at gmail.com>

BUGS

Please report any bugs or feature requests to github repository.

ACKNOWLEDGEMENTS

Inspired by https://github.com/towhans/hochschober

REPOSITORY

https://github.com/vasekd/Rest-HtmlVis

LICENSE AND COPYRIGHT

Copyright 2015 Vaclav Dovrtel.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.