Data::Object::Data
Data-Object Data Class
package Command; use Data::Object::Data; =help fetches results from the api =cut my $data = Data::Object::Data->new; my $help = $data->content('help'); # fetches results ... my $token = $data->content('token'); # token: the access token ... my $secret = $data->content('secret'); # secret: the secret for ... my $flag = $data->contents('flag'); # [,...] __DATA__ =flag secret secret: the secret for the account =flag token token: the access token for the account =cut
Data::Object::Data provides methods for parsing and extracting pod-like data sections from any file or package. The pod-like syntax allows for using these sections anywhere in the source code and Perl properly ignoring them.
This package implements the following methods.
content(Str $arg1) : Str
The content method returns the pod-like section where the name matches the given string.
=pod help Example content =cut # given $data $data->content('help'); # Example content
contents(Str $arg1) : ArrayRef
The contents method returns all pod-like sections that start with the given string, e.g. pod matches =pod foo. This method returns an arrayref of data for the matched sections.
pod
=pod foo
=pod help Example content =cut # given $data $data->contents('pod'); # [,...]
data(Str $arg1) : ArrayRef
The data method returns the contents from the DATA and END sections of a package.
DATA
END
# given $data $data->data($class); # ...
file(Str $arg1) : ArrayRef
The file method returns the contents of a file which contains pod-like sections for a given filename.
# given $data $data->file($args); # ...
from_data(Str $arg1) : Str
The from_data method returns content for the given class to be passed to the constructor.
# given $data $data->from_data($class); # ...
from_file(Str $arg1) : Str
The from_data method returns content for the given file to be passed to the constructor.
# given $data $data->from_file($file); # ...
item(Str $arg1) : HashRef
The item method returns metadata for the pod-like section that matches the given string.
=pod help Example content =cut # given $data $data->item('help'); # {,...}
list(Str $arg1) : ArrayRef
The list method returns metadata for each pod-like section that matches the given string.
=pod help Example content =cut # given $data $data->list('pod'); # [,...]
parser(Str $arg1) : ArrayRef
The parser method extracts pod-like sections from a given string and returns an arrayref of metadata.
# given $data $data->parser($string); # [,...]
pluck(Str $arg1, Str $arg2) : HashRef
The pluck method splices and returns metadata for the pod-like section that matches the given list or item by name.
=pod help Example content =cut # given $data $data->pluck('item', 'help'); # {,...}
To install Data::Object, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Data::Object
CPAN shell
perl -MCPAN -e shell install Data::Object
For more information on module installation, please visit the detailed CPAN module installation guide.