README.md

Memio's SpecGen

This extension for phpspec provides a powerful code generator:

• method generation:
  • it inserts method at the end of the class
  • it typehints arguments (uses interface when possible)
  • it names object arguments after their type (strips Interface suffix from names)
  • it names scalar arguments after a generic name (argument)
  • it adds number on names that could collide (e.g. $argument1, $argument2)
• constructor generation, same as method except:
  • it inserts constructor at the begining of the class
  • it inserts properties with initialization for each constructor arguments

Note: Currently it is not possible to provide custom templates to SpecGen (it is not compatible with phpspec templates).

Installation

First install it using Composer:

$ composer require --dev memio/spec-gen:^0.10

Then enable it in phpspec.yml:

extensions:
    Memio\SpecGen\MemioSpecGenExtension: ~

Version guide:

• using phpspec 5? Then use spec-gen v0.9
• using phpspec 4? Then use spec-gen v0.8
• using phpspec 3 and PHP 7? Then use spec-gen v0.7
• using phpspec 3 and PHP 5.6? Then use spec-gen v0.6
• using phpspec 2? Then use spec-gen v0.4

Full example

Let's write the following specification:

<?php

namespace spec\Vendor\Project;

use Vendor\Project\Service\Filesystem;
use Vendor\Project\File;
use PhpSpec\ObjectBehavior;

class TextEditorSpec extends ObjectBehavior
{
    const FILENAME = '/tmp/file.txt';
    const FORCE_FILE_CREATION = true;

    function let(Filesystem $filesystem)
    {
        $this->beConstructedWith($filesystem);
    }

    function it_creates_new_files(File $file, Filesystem $filesystem)
    {
        $filesystem->exists(self::FILENAME)->willReturn(false);
        $filesystem->create(self::FILENAME)->willReturn($file);

        $this->open(self::FILENAME, self::FORCE_FILE_CREATION)->shouldBe($file);
    }
}

Executing the specifications (phpspec run) will generate the following class:

<?php

namespace Vendor\Project;

use Vendor\Project\Service\Filesystem;

class TextEditor
{
    private $filesystem;

    public function __construct(Filesytem $filesystem)
    {
        $this->filesystem = $filesystem;
    }

    public function open(string $argument1, bool $argument2)
    {
    }
}

Now we can start naming those generic arguments and write the code.

Want to know more?

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:

• copyright and MIT license
• versioning and branching models
• contribution instructions

Roadmap

• constructor property promotion
• return type hints
• method body (mirror of test method body)
• better scalar argument naming (based on names used in test)