Take me over?
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 invokenew
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.