jeroen / generic-decorator
Builder for generic and type safe decorators
Installs: 6 942
Dependents: 0
Suggesters: 0
Security: 0
Stars: 1
Watchers: 5
Forks: 0
Open Issues: 1
Requires
- php: >=7.0
- phpunit/phpunit-mock-objects: ~3.2 || ~4.0
Requires (Dev)
- mediawiki/mediawiki-codesniffer: ~0.6.0
- squizlabs/php_codesniffer: ~2.5
This package is auto-updated.
Last update: 2024-10-16 23:04:06 UTC
README
A builder for generic and type safe PHP decorators.
Usage
This library provides the DecoratorBuilder
class, which follows the
Builder pattern, and
thus is similar in use as PHPUnit's MockBuilder interface.
You construct a new builder by calling DecoratorBuilder::newBuilder
and
passing in the object you want to decorate. Then you can call withBefore
and withAfter
, to define the decorated behaviour. Finally you call
newDecorator
and get the decorated instance.
public function __construct() { $this->repository = new DoctrineKittenRepository( /* ... */ ); $this->stopWatch = new Stopwatch(); } public function newProfilingKittenRepository(): KittenRepository { return DecoratorBuilder::newBuilder( $this->repository ) ->withBefore( function() { $this->stopWatch->start( 'KittenRepository' ); } ) ->withAfter( function() { $this->stopWatch->stop( 'KittenRepository' ); } ) ->newDecorator(); }
The callable provided to withBefore
and withAfter
receives all
arguments the decorated method receives.
->withBefore( function() { $this->logger->alert( 'KittenRepository', [ 'arguments' => func_get_args() ] ); } )
Missing features / roadmap
- Allow decorating generated decorators (this will fatal error at present)
- Support try-catch, ie for logging decorators
- Provide a way to get the name of the calling method (anyone knows how to do that without crazy debug_backtrace hacks?)
- Test presence of private and protected methods
- Test final class
- Test exceptions
- Test internal calls to public methods
Release notes
0.1.2 (2017-02-06)
- Made installable with PHPUnit Mock Objects 4.x
0.1.1 (2016-08-16)
- Decorating classes with required constructor parameters now works
0.1.0 (2016-07-29)
- Initial release