alcaeus/fluent-facade

Library to create fluent interfaces for classes that don't use them

Maintainers

Details

github.com/alcaeus/fluent-facade

Source

Issues

Installs: 5

Dependents: 0

Suggesters: 0

Security: 0

Stars: 1

Watchers: 3

Forks: 0

Open Issues: 0

0.1.0 2018-10-27 07:29 UTC

Requires

  • php: ^7.2

Requires (Dev)

MIT 858bafb22db62425dc698f27fb81908e146ca300

  • Andreas Braun <git.woop@alcaeus.org>

This package is auto-updated.

Last update: 2024-12-06 10:57:45 UTC

README

🏡 Library to create fluent interfaces for classes that don't support them

Installation

To install using composer, run

$ composer require alcaeus/fluent-facade

Usage

To wrap an object that does not provide a fluent interface, use the static ClassWrapper::wrap helper, then use the class as if it provided a fluent interface:

use Alcaeus\Fluent\ClassWrapper;

ClassWrapper::wrap($object)
    ->doSomething()
    ->doSomethingElse();

Getters and other return values

Any non-object return value from a method is ignored and discarded. If a method returns an object, this object is automatically wrapped and returned, allowing nested calls. You can end this nesting by calling the end() method:

use Alcaeus\Fluent\ClassWrapper;

ClassWrapper::wrap($object)
    ->doSomething()
    ->getNestedObject()
        ->doSomethingElse()
    ->end()
    ->getOtherNestedObject()
        ->doYetAnotherThing();

Note that it's not possible to call end() on the root object that was wrapped.

Public properties

If your class contains public properties that contain objects, you can access them and get a wrapped instance of the original object. Properties that contain non-object values will cause an exception to be thrown.

use Alcaeus\Fluent\ClassWrapper;

ClassWrapper::wrap($object)
    ->doSomething()
    ->nestedObject
        ->doSomethingElse()
    ->end()
    ->otherNestedObject
        ->doYetAnotherThing();