memio / model
Memio's models, used to describe the code to generate
Installs: 304 771
Dependents: 8
Suggesters: 0
Security: 0
Stars: 5
Watchers: 2
Forks: 7
Open Issues: 0
Requires
- php: ^7.2 || ^8.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ^2.16
- phpspec/phpspec: ^6.1 || ^7.0
README
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:^3.0
Example
Let's say we want to describe the following method:
/** * @api */ public function doSomething(ValueObject $valueObject, int $type = self::TYPE_ONE, bool $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 = (new Method('doSomething')) ->setPhpdoc((new MethodPhpdoc()) ->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((new Argument('int', 'type')) ->setDefaultValue('self::TYPE_ONE') ) ->addArgument((new Argument('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 = [new \Vendor\Project\ValueObject(), ValueObject::TYPE_ONE, true]; $method = new Method($methodName); $phpdoc = (new MethodPhpdoc())->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 endless!
Once built these models can be further tweaked, and converted to another format: an array, source code, etc... Again, the possibilities are endless!
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:
- the
git tag
command - the releases page on Github
- the file listing the changes between versions
And finally some meta documentation:
Roadmap
- get rid of
Type
- extract
Import
(use statement) fromFullyQualifiedName
- get rid of
FullyQualifiedName
- support more PHPdoc stuff
- support annotations