KiokuDB::Util - Utility functions for working with KiokuDB
use KiokuDB::Util qw(set weak_set); my $set = set(@objects); # create a transient set my $weak = weak_set(@objects); # to avoid circular refs
This module provides various helper functions for working with KiokuDB.
Tries to parse $dsn, load the backend and invoke new on it.
$dsn
new
Used by "connect" in KiokuDB and the various command line interfaces.
Instantiate a Set::Object or Set::Object::Weak from the arguments, and then creates a KiokuDB::Set::Transient with the result.
Loads YAML files with MooseX::YAML (if given a directory it will be searched recursively for files with a .yml extension are) into the specified KiokuDB directory in a single transaction.
.yml
The YAML files can contain multiple documents, with each document treated as an object. If the YAML file contains a single non blessed array or hash then that structure will be dereferenced as part of the arguments to insert.
insert
Here is an example of an array of objects, and a custom tag alias to ease authoring of the YAML file:
%YAML 1.1 %TAG ! !MyFoo:: --- - !User id: foo real_name: Foo Bar email: foo@myfoo.com password: '{cleartext}test123'
You can use a hash to specify custom IDs:
%YAML 1.1 --- the_id: !Some::Class attr: moose
To install KiokuDB, copy and paste the appropriate command in to your terminal.
cpanm
cpanm KiokuDB
CPAN shell
perl -MCPAN -e shell install KiokuDB
For more information on module installation, please visit the detailed CPAN module installation guide.