docblox/docblox — Issue #370: 3rd-party plugins
Author: DavertMik
Created: 2012-02-12 11:23:22+00:00
State: open

I've created a plugin to DocBlox which generates agile documentation, based on [Codeception](http://codeception.com) unit tests.
It appends parsed test file into method documetnation. Like this:

```
If I execute \Service\Group::join("2",3)
I will see result is "int"
I will see in repository "Model\ULG",{"group":"2","user":3,"grouprole":"member"}

I am going to join group with user already joined
If I execute \Service\Group::join("1",3)
I will see exception thrown "\Service\Exception\PublicException","No need to join"

I am going to join group with 25 groups already reached
I have fake repository "Model\SmsSource",{"findFree":{}}
If I execute \Service\Group::join("2",2)
I will see exception thrown "\Service\Exception\PublicException","you have reached the maximum number of groups"
```

DocBlox has only local and bundled plugins. My plugin Is not somekind of 'local', I want to share it for all Codeception users. If I want to provide this plugin within Codeception distribution, users should have a way they can load this plugin without providing full path to PEAR.

There are 2 solutions I see:

* patch ``` DocBlox_Plugin->load``` to scan through all 'include_path' for plugins.
* add Codeception plugin into DocBlox distribution. Well, that would be really cool )

What do you think?