njuhel/php-swagger-to-md

<?php

/*
 * Copyright 2016 Nicolas JUHEL <swaggervalidator@nabbar.com>.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

namespace Swagger2md\SwaggerValidator\Object;

/**
 * Description of Swagger
 *
 * @author Nicolas JUHEL<swaggervalidator@nabbar.com>
 * @version 1.0.0
 */
class Swagger extends \SwaggerValidator\Object\Swagger
{

    /**
     *
     * @param \SwaggerValidator\Common\Context $context
     */
    public function markdown(\SwaggerValidator\Common\Context $context)
    {
        $method       = __FUNCTION__;
        $keyTags      = \SwaggerValidator\Common\FactorySwagger::KEY_TAGS;
        $generalItems = $this->getMethodGeneric($context, $method);
        $templateVars = array();
        $tags         = array();

        if (($this->has($keyTags))) {
            foreach ($this->$keyTags as $tag) {
                if (is_object($tag) && property_exists($tag, 'name')) {
                    $tags[$tag->name] = get_object_vars($tag);
                }
            }
        }

        if (isset($this->basePath)) {
            $context->setBasePath($this->basePath);
        }

        if (isset($this->host)) {
            $context->setHost($this->host);
        }

        if (isset($this->schemes)) {
            $tmp = $this->schemes;
            $context->setScheme(array_shift($tmp));
        }

        foreach ($this->keys() as $key) {
            if ($key === \SwaggerValidator\Common\FactorySwagger::KEY_PARAMETERS) {
                continue;
            }

            if ($key === \SwaggerValidator\Common\FactorySwagger::KEY_RESPONSES) {
                continue;
            }

            if (is_object($this->$key) && method_exists($this->$key, $method)) {
                $templateVars[$key] = $this->$key->$method($context->setDataPath($key), $generalItems);
            }
            elseif (!is_object($this->$key)) {
                $templateVars[$key] = $this->$key;
            }

            if (is_object($this->$key) && method_exists($this->$key, 'getSummary')) {
                $summary = $this->$key->getSummary($context->setDataPath($key));
            }

            if (is_object($this->$key) && method_exists($this->$key, 'getTags')) {
                $tags = $this->$key->getTags($context->setDataPath($key), $tags);
            }
        }

        $templateVars['Summary'] = \Swagger2md\Swagger2md::getInstance()->renderTemplate('GenericSummary', array('summary' => $summary));
        $templateVars['Index']   = \Swagger2md\Swagger2md::getInstance()->renderTemplate('GenericIndex', array('tags' => $tags, 'summary' => $summary));

        $tpl = explode('\\', trim(__CLASS__, "\\"));
        array_shift($tpl);
        array_shift($tpl);
        $tpl = implode('', array_map('ucfirst', $tpl));

        \Swagger2md\Swagger2md::printOutV('Rendering this template : ' . $tpl);
        return \Swagger2md\Swagger2md::getInstance()->renderTemplate($tpl, $templateVars);
    }

}