YAML::Any3pm

Usage

    use YAML::Any;
    $YAML::Indent = 3;
    my $yaml = Dump(@objects);

Status

WARNING: This module will soon be deprecated. The plan is that YAML.pm itself will act like an Any module.

Overview

There are several YAML implementations that support the Dump/Load API. This module selects the best one available and uses it.

Order

Currently, YAML::Any will choose the first one of these YAML implementations that is installed on your system:

Options

If you specify an option like:

    $YAML::Indent = 4;

And YAML::Any is using YAML::XS, it will use the proper variable: $YAML::XS::Indent.

Subroutines

Like all the YAML modules that YAML::Any uses, the following subroutines are exported by default:

and the following subroutines are exportable by request:

Methods

YAML::Any provides the following class methods.

"YAML::Any->order"

This method returns a list of the current possible implementations that YAML::Any will search for.

"YAML::Any->implementation"

This method returns the implementation the YAML::Any will use. This result is obtained by finding the first member of YAML::Any->order that is either already loaded in %INC or that can be loaded using "require". If no implementation is found, an error will be thrown.

Examples

    #!/usr/bin/perl
    use strict;
    use warnings;
    use YAML::Any qw(DumpFile);
    my $ds =
    {
        array => [5,6,100],
        string => "Hello",
    };
    DumpFile("hello.yml", $ds);

    ---
    array:
    - 5
    - 6
    - 100
    string: Hello

    #!/usr/bin/perl
    use strict;
    use warnings;
    use YAML::Any qw(LoadFile);
    my ($ds) = LoadFile("hello.yml");
    print "String == '", $ds->{string}, "'\n";

    $ perl load.pl
    String == 'Hello'
    $