<?php

/**
 * Class property documentation generator.
 *
 * @package    Kohana/Userguide
 * @category   Base
 * @author     Kohana Team
 * @copyright  (c) 2009 Kohana Team
 * @license    http://kohanaphp.com/license
 */
class Docs_Property extends Docs
{

    /**
     * @var  object  ReflectionProperty
     */
    public $property;

    /**
     * @var  string   modifiers: public, private, static, etc
     */
    public $modifiers = 'public';

    /**
     * @var  string  variable type, retrieved from the comment
     */
    public $type;

    /**
     * @var  string  value of the property
     */
    public $value;

    public function __construct( $class, $property )
    {
        $property = new ReflectionProperty( $class, $property );
        
        list ( $description, $tags ) = Docs::parse( $property->getDocComment() );
        
        $this->description = $description;
        
        if ( $modifiers = $property->getModifiers() )
        {
            $this->modifiers = '<small>' . implode( ' ', Reflection::getModifierNames( $modifiers ) ) . '</small> ';
        }
        
        if ( isset( $tags['var'] ) )
        {
            if ( preg_match( '/^(\S*)(?:\s*(.+?))?$/', $tags['var'][0], $matches ) )
            {
                $this->type = $matches[1];
                
                if ( isset( $matches[2] ) )
                {
                    $this->description = $matches[2];
                }
            }
        }
        
        $this->property = $property;
        
        if ( $property->isStatic() )
        {
            $this->value = Docs::debug( $property->getValue( $class ) );
        }
    }

} // End Kodoc_Property
