Dallgoot\Yaml

Complexity

Total Complexity

8

Size/Duplication

Total Lines	98
Duplicated Lines	0 %

Test Coverage

Coverage

100%

Importance

Changes

0

4 Methods

Rating	Name	Duplication	Size	Complexity
A	parse()	0	6	2
A	parseFile()	0	6	2
A	dumpFile()	0	6	2
A	dump()	0	6	2

<?php

namespace Dallgoot;

/**
 * Library that :
 * - reads YAML as PHP types
 * - writes PHP types as YAML content
 *
 * @author  Stéphane Rebai <stephane.rebai@gmail.com>
 * @license Apache 2.0
 * @link    https://github.com/dallgoot/yaml
 *
 * @see YamlObject
 * @see Compact
 * @see Tag
 */
final class Yaml
{
    const VERSION_SUPPORT = "1.2";
    /**
     * Parse the given Yaml string to either :
     * - a YamlObject
     * - an array of YamlObject
     *
     * @param string   $someYaml Some yaml
     * @param int|null $options  from Loader class, bitwise combination of
     *                           Loader::IGNORE_DIRECTIVES
     *                           Loader::IGNORE_COMMENTS
     *                           Loader::NO_PARSING_EXCEPTIONS
     *                           Loader::NO_OBJECT_FOR_DATE
     * @param int|null $debug    define the level of debugging (true = default)
     *
     * @return Yaml\YamlObject|array|null a Yaml document as YamlObject OR multiple documents as an array of YamlObject,
     *                               NULL if Error and option Loader::NO_PARSING_EXCEPTIONS is set.
     * @throws \Exception coming from Dallgoot\Yaml\Loader
     * @see    Dallgoot\Yaml\Loader
     *
     * @todo transpose Loader::NO_PARSING_EXCEPTIONS in this class
     */
    public static function parse(string $someYaml, $options = null, $debug = null)
    {
        try {
            return (new Yaml\Loader(null, $options, $debug))->parse($someYaml);
        } catch (\Throwable $e) {
            throw new \Exception(__CLASS__." Error while parsing YAML string", 1, $e);
        }
    }

    /**
     * Load the given file and parse its content (assumed YAML) to either :
     * - a YamlObject
     * - an array of YamlObject
     *
     * @param string   $fileName Some file path name
     * @param int|null $options  from Loader class, bitwise combination of
     *                           Loader::IGNORE_DIRECTIVES
     *                           Loader::IGNORE_COMMENTS
     *                           Loader::NO_PARSING_EXCEPTIONS
     *                           Loader::NO_OBJECT_FOR_DATE
     * @param int|null $debug    define the level of debugging (true = default)
     *
     * @return Yaml\YamlObject|array|null a Yaml document as YamlObject OR multiple documents as an array of YamlObject,
     *                               NULL if Error
     * @throws \Exception coming from Dallgoot\Yaml\Loader
     * @see    Dallgoot\Yaml\Loader
     */
    public static function parseFile(string $fileName, $options = null, $debug = null)
    {
        try {
            return (new Yaml\Loader($fileName, $options, (int) $debug))->parse();
        } catch (\Throwable $e) {
            throw new \Exception(__CLASS__." Error during parsing '$fileName'", 1, $e);
        }

    }

    /**
     * Returns the YAML representation corresponding to given PHP variable
     *
     * @param mixed    $somePhpVar Some php variable
     * @param int|null $options    enable/disable some options see Dumper
     *
     * @return string  ( the representation of $somePhpVar as a YAML content (single or multiple document accordingly) )
     * @throws \Exception on errors during building YAML string coming from Dumper class
     * @see    Dumper
     */
    public static function dump($somePhpVar, $options = null):string
    {
        try {
            return (new Yaml\Dumper($options))->toString($somePhpVar);
        } catch (\Throwable $e) {
            throw new \Exception(__CLASS__." Error dumping", 1, $e);
        }
    }


    /**
     * Builds the YAML representation corresponding to given PHP variable ($somePhpVar)
     * AND save it as file with the $fileName provided.
     *
     * @param string   $fileName   The file name
     * @param mixed    $somePhpVar Some php variable
     * @param int|null $options    Dumper::constants as options
     *
     * @return boolean  true if YAML built and saved , false if error during writing file
     * @throws \Exception on errors (from Dumper::toString) during building YAML string
     * @see    Dumper
     */
    public static function dumpFile(string $fileName, $somePhpVar, $options = null):bool
    {
        try {
            return (new Yaml\Dumper($options))->toFile($fileName, $somePhpVar);
        } catch (\Throwable $e) {
            throw new \Exception(__CLASS__." Error during dumping '$fileName'", 1, $e);
        }
    }
}