NAME

       KiokuDB::Util - Utility functions for working with KiokuDB

VERSION

       version 0.57

SYNOPSIS

           use KiokuDB::Util qw(set weak_set);

           my $set = set(@objects); # create a transient set

           my $weak = weak_set(@objects); # to avoid circular refs

DESCRIPTION

       This module provides various helper functions for working with KiokuDB.

EXPORTS

       dsn_to_backend $dsn, %args
           Tries to parse $dsn, load the backend and invoke "new" on it.

           Used by "connect" in KiokuDB and the various command line interfaces.

       set
       weak_set
           Instantiate   a   Set::Object   or   Set::Object::Weak   from  the  arguments,  and  then  creates  a
           KiokuDB::Set::Transient with the result.

       import_yaml $kiokudb, @files_or_dirs
           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.

           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".

           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

AUTHOR

       Yuval Kogman <nothingmuch@woobling.org>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2014 by Yuval Kogman, Infinity Interactive.

       This  is  free  software;  you  can  redistribute  it and/or modify it under the same terms as the Perl 5
       programming language system itself.

perl v5.34.0                                       2022-05-23                                 KiokuDB::Util(3pm)