Skip to content
/ model Public
forked from memio/model

[sub] Describe PHP code by building Memio objects

License

Notifications You must be signed in to change notification settings

sjokki/model

 
 

Repository files navigation

Memio's Models Travis CI SensioLabsInsight

Describe PHP code (classes/interfaces with their constants, properties, methods, method arguments and even PHPdoc) by constructing "Model" objects.

Note: This package is part of Memio, a highly opinionated PHP code generator. Have a look at the main repository.

Installation

Install it using Composer:

composer require memio/model:^1.0

Example

Let's say we want to describe the following method:

    /**
     * @param ValueObject $valueObject
     * @param int         $type
     * @param boolean     $option
     *
     * @api
     */
    public function doSomething(ValueObject $valueObject, $type = self::TYPE_ONE, $option = true);

In order to do so, we'd need to write the following:

<?php

require __DIR__.'/vendor/autoload.php';

use Memio\Model\Argument;
use Memio\Model\Method;
use Memio\Model\Phpdoc\ApiTag;
use Memio\Model\Phpdoc\MethodPhpdoc;
use Memio\Model\Phpdoc\ParameterTag;

$method = Method::make('doSomething')
    ->setPhpdoc(MethodPhpdoc::make()
        ->addParameterTag(new ParameterTag('Vendor\Project\ValueObject', 'valueObject'))
        ->addParameterTag(new ParameterTag('int', 'type'))
        ->addParameterTag(new ParameterTag('bool', 'option'))

        ->addApiTag(new ApiTag())
    )
    ->addArgument(new Argument('Vendor\Project\ValueObject', 'valueObject'))
    ->addArgument(Argument::make('int', 'type')
        ->setDefaultValue('self::TYPE_ONE')
    )
    ->addArgument(Argument::make('bool', 'option')
        ->setDefaultValue('true')
    )
;

Usually models aren't described manually like this, they would be built dynamically:

// Let's say we've received the following two parameters:
$methodName = 'doSomething';
$arguments = array(new \Vendor\Project\ValueObject(), ValueObject::TYPE_ONE, true);

$method = new Method($methodName);
$phpdoc = MethodPhpdoc::make()->setApiTag(new ApiTag());
$index = 1;
foreach ($arguments as $rawArgument) {
    $type = is_object($rawArgument) ? get_class($argument) : gettype($rawArgument);
    $name = 'argument'.$index++;
    $argument = new Argument($type, $name);

    $method->addArgument($argument);
    $phpdoc->addParameterTag(new ParameterTag($type, $name));
}
$method->setPhpdoc($phpdoc);

We can build dynamically the models using a configuration file, user input, existing source code... Possibilities are infinite!

Once built these models can be further tweaked, and converted to another format: an array, source code, etc... Again, the possibilities are infinite!

Have a look at the main respository to discover the full power of Medio.

Want to know more?

Memio uses phpspec, which means the tests also provide the documentation. Not convinced? Then clone this repository and run the following commands:

composer install
./vendor/bin/phpspec run -n -f pretty

You can see the current and past versions using one of the following:

And finally some meta documentation:

Roadmap

  • get rid of Type
  • extract Import (use statement) from FullyQualifiedName
  • get rid of FullyQualifiedName
  • support more PHPdoc stuff
  • support annotations

About

[sub] Describe PHP code by building Memio objects

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PHP 100.0%