XML::RelaxNG::Compact::PXB - create perl XML (RelaxNG Compact) data binding API
Version 0.15
The instance of this class is capable of generating the API tree of the perl objects based on XML (RelaxNG compact) schema described as perl data structures. If you have bunch of XML schemes ( and able to convert them into RelaxNG Compact ) and hate to waste your time by writing DOM tree walking code then this module may help you. Of course POD will be created automatically as well. Also, it will build the tests suit automatically as well and provide perltidy and perlcritic config files for you to assure the absence of problems in your API. The Perl::Critic test will be performed as part of the tests suit.
See XML::RelaxNG::Compact::DataModel for more details and examples.
### use XML::RelaxNG::Compact::PXB; # express your schema my $subelement = { 'attrs' => {value => 'scalar', type => 'scalar', port => 'scalar', xmlns => 'nsid2'}, elements => [], text => 'unless:value', }; my $model = = { 'attrs' => {id => 'scalar', type => 'scalar', xmlns => 'nsid'}, elements => [ [subelement => $subelement ] ], }; # define Namespace registry for your schemes my $nsreg = { 'nsid' => 'http://nsid/URI', 'nsid2' => 'http://nsid2/URI'}; # create API builder with your desired parameters # my $api_builder = XML::RelaxNG::Compact::PXB->new({ top_dir => "/topdir/", nsregistry => $nsreg, datatypes_root => "Datatypes, project_root => 'API, schema_version => "1.0", test_dir => "t", footer => POD::Credentials->new({author=> 'Author Name', license=> ' This stuff is for free !', copyright => 'Copyright (c) 2011, by me'}); #### this call will build everything - API,tests, helper modules #### where name parameter is the name of your root element - "nsid:mymodel" # # it will create versioned API under /topdir/API/Datatypes/v1_0/nsid/ for nsid namespace prefix # and /topdir/API/Datatypes/v1_0/nsid2/ for nsid2 namespace prefix # $api_builder->buildAPI({name => 'mymodel', element => $model}); #### this call will build only test suit #### $api_builder->buildTests({name => 'mymodel', element => $model}); #### #### this call will build only Helper modules under /topdir/API/Datatypes/v1_0/ - #### namespace prefix mapping, basic element operations #### $api_builder->buildHelpers(); ####
creates new object, accepts reference to hash as parameters container where keys are:
DEBUG - set it to something defined to provide extra logging
top_dir - full pathname to the api root dir, for example test files will be placed as top_dir/test_dir Default: current directory
current directory
nsregistry - reference to the hash with {ns_prefix => ns_URI} pairs, it will be built into the Element class Default: just XSD and XSI namespaces
datatypes_root - name of the generated datatypes directory Default: XMLTypes
project_root - name of the API project directory, all packages will have naming beginning with this one Default: API, with datatypes_root default value every package will have API::XMLTYpes:: pre-fix
schema_version - version identifier for your XML schema Default: 1.0
test_dir - name for the test suit files ( relative to the <top_dir>) Default: t
footer - container of the object - POD::Credentials, used for printing POD footer with SEE ALSO, AUTHOR, COPYRIGHT, LICENSE
Possible ways to call new():
### with defaults $api_builder = XML::RelaxNG::Compact::PXB->new(); ## passes hashref with explicit parameters, for the next example: ## api will be created at /root/XMLTypes/v1_0/ ## and tests files under - /root/t $api_builder = XML::RelaxNG::Compact::PXB->new({ top_dir => "/root/", datatypes_root => "XMLTypes", nsregistry => { 'nsid' => 'nsURI'}, project_root => 'API, schema_version => "1.0", test_dir => "t", footer => POD::Credentials->new({author=> 'Joe Doe'}), });
builds XML binding API recursively accepts hashref with keys:
name - scalar, name of the root element - undef by default
element - reference to the hash representing the RelaxNG Compact schema, empty hash ref by default
parent - optional scalar parameter, reference to the hash with definition of the parent element, its C<undef> for the root element
returns $self
shortcut to build Helper classes only, no arguments returns $self
prints accessors and mutators for the passed reference to array of names returns $self
shortcut to build test files only, no arguments returns $self
builds single class on the filesystem and corresponded test file accepts position bounded parameters:
name of the element
hashref with the element definition
hashref with parent definition if its not the root element
auxiliary method it builds test file for current class accepts: reference to array with elements, reference to array with attributes, class name name of the package element name returns: nothing
prints string into the file handler without new line
prints string into the file handler with new line added
Maxim Grigoriev (FNAL), maxim_at_fnal_dot_gov
You should have received a copy of the Fermitools license with this software. If not, see <http://fermitools.fnal.gov/about/terms.html>
Copyright(c) 2007-2011, Fermi Research Alliance (FRA)
To install XML::RelaxNG::Compact::PXB, copy and paste the appropriate command in to your terminal.
cpanm
cpanm XML::RelaxNG::Compact::PXB
CPAN shell
perl -MCPAN -e shell install XML::RelaxNG::Compact::PXB
For more information on module installation, please visit the detailed CPAN module installation guide.