File Coverage

blib/lib/PRANG/Cookbook.pm
Criterion Covered Total %
statement 6 6 100.0
branch n/a
condition n/a
subroutine 3 3 100.0
pod 0 1 0.0
total 9 10 90.0


line stmt bran cond sub pod time code
1              
2             package PRANG::Cookbook;
3             $PRANG::Cookbook::VERSION = '0.21';
4 2     2   236563 use Moose::Role;
  2         478410  
  2         11  
5 2     2   12211 use PRANG::Graph;
  2         9  
  2         10  
6              
7       25 0   sub xmlns { }
8              
9             with 'PRANG::Graph', 'PRANG::Cookbook::Node';
10              
11             1;
12              
13             =pod
14              
15             =head1 NAME
16              
17             PRANG::Cookbook - Examples of recipes which you can use with PRANG.
18              
19             =head1 DESCRIPTION
20              
21             The PRANG::Cookbook is a series of recipes showing various PRANG features. Most
22             recipes are small and self-explanatory but the general layout of each series
23             shows firstly a simple example with explanations followed by further
24             enhancements.
25              
26             Each component of PRANG has a man page describing it, and collectively
27             these form the PRANG manual. However, the cookbook is designed to
28             give quick examples to get up to speed with what you need to know to
29             effectively use PRANG.
30              
31             The manual pages for the cookbook do not contain the content; see the
32             actual source for the examples.
33              
34             =head1 RECIPES
35              
36             =head2 Basic PRANG
37              
38             This recipe series gives you a good overview of PRANG's capabilites starting
39             with simple XML elements and attributes.
40              
41             =over 4
42              
43             =item L<PRANG::Cookbook::Note>
44              
45             Shows a simple example of a note which requires some elements and adds
46             some optional elements later on. Also shows how to use attributes with
47             some basic validation.
48              
49             =back
50              
51             =head2 Intermediate PRANG
52              
53             This recipe series (ie, L<PRANG::Cookbook>) gives you a good overview
54             of some of advanced of PRANG's capabilites. Showing how to do lists of
55             nodes and then lists of any of a number of different nodes.
56              
57             =over 4
58              
59             =item L<PRANG::Cookbook::Library>
60              
61             shows a simple library which has one book in it, then any number of
62             books. Adds to this the fact that the library holds CDs too, so this
63             is made generic such that it holds items, where each item can be a
64             book or a CD.
65              
66             =back
67              
68             =head2 Advanced PRANG
69              
70             The CPAN releases L<XML::SRS> and L<XML::EPP> are implementations of
71             real-world XML standards using PRANG. The first versions of these
72             will be released shortly after the inaugral PRANG release.
73              
74             =head1 AUTHOR
75              
76             Andrew Chilton, E<lt>andy@catalyst dot net dot nzE<gt>
77              
78             Edited by Sam Vilain, L<samv@cpan.org>
79              
80             =head1 COPYRIGHT & LICENSE
81              
82             This software development is sponsored and directed by New Zealand Registry
83             Services, http://www.nzrs.net.nz/
84              
85             The work is being carried out by Catalyst IT, http://www.catalyst.net.nz/
86              
87             Copyright (c) 2009, NZ Registry Services. All Rights Reserved. This software
88             may be used under the terms of the Artistic License 2.0. Note that this
89             license is compatible with both the GNU GPL and Artistic licenses. A copy of
90             this license is supplied with the distribution in the file COPYING.txt.
91              
92             This license applies to all Cookbook files shipped with PRANG.
93              
94             =cut