DocParser.php

<?php
/**
 * @copyright 2014 Integ S.A.
 * @license http://opensource.org/licenses/MIT The MIT License (MIT)
 * @author Javier Lorenzana <javier.lorenzana@gointegro.com>
 */

namespace GoIntegro\Raml;

// YAML.
use Symfony\Component\Yaml\Yaml;

class DocParser
{
 const ERROR_ROOT_SCHEMA_VALUE = "The root section \"schemas\" have an unsupported item.";

 /**
 * @var MapCollectionParser
 */
 private $mapCollectionParser;
 /**
 * @var DocExpander
 */
 private $docExpander;

 /**
 * @param MapCollectionParser $mapCollectionParser
 * @param DocExpander $docExpander
 */
 public function __construct(
 MapCollectionParser $mapCollectionParser,
 DocExpander $docExpander
 )
 {
 $this->mapCollectionParser = $mapCollectionParser;
 $this->docExpander = $docExpander;
 }

 /**
 * @param string $filePath
 * @return RamlDoc
 */
 public function parse($filePath)
 {
 $rawRaml = Yaml::parse($filePath);
 $ramlDoc = new RamlDoc($rawRaml, $filePath);

 foreach (RamlSpec::$rootLevelDeclarations as $key) {
 if (isset($rawRaml[$key])) {
 $ramlDoc->$key = $this->mapCollectionParser->parse(
 $rawRaml[$key], $ramlDoc
 );
 }
 }

 $this->docExpander->expand($ramlDoc);

 return $ramlDoc;
 }
}