https://github.com/decodelabs/fluidity

Tools for creating fluent interfaces in PHP
https://github.com/decodelabs/fluidity

fluid-interface php

Last synced: 1 day ago
JSON representation

Tools for creating fluent interfaces in PHP

• Host: GitHub
• URL: https://github.com/decodelabs/fluidity
• Owner: decodelabs
• License: mit
• Created: 2020-10-06T09:38:35.000Z (over 4 years ago)
• Default Branch: develop
• Last Pushed: 2024-09-04T21:06:12.000Z (4 months ago)
• Last Synced: 2024-12-14T06:15:34.457Z (27 days ago)
• Topics: fluid-interface, php
• Language: PHP
• Homepage:
• Size: 50.8 KB
• Stars: 4
• Watchers: 4
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Fluidity

[![PHP from Packagist](https://img.shields.io/packagist/php-v/decodelabs/fluidity?style=flat)](https://packagist.org/packages/decodelabs/fluidity)

[![Latest Version](https://img.shields.io/packagist/v/decodelabs/fluidity.svg?style=flat)](https://packagist.org/packages/decodelabs/fluidity)

[![Total Downloads](https://img.shields.io/packagist/dt/decodelabs/fluidity.svg?style=flat)](https://packagist.org/packages/decodelabs/fluidity)

[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/decodelabs/fluidity/integrate.yml?branch=develop)](https://github.com/decodelabs/fluidity/actions/workflows/integrate.yml)

[![PHPStan](https://img.shields.io/badge/PHPStan-enabled-44CC11.svg?longCache=true&style=flat)](https://github.com/phpstan/phpstan)

[![License](https://img.shields.io/packagist/l/decodelabs/fluidity?style=flat)](https://packagist.org/packages/decodelabs/fluidity)

### Tools for creating fluent interfaces.

Fluidity provides a set of middleware interfaces that aid in the development of libraries that themselves aim to provide fluid interfaces.

_Get news and updates on the [DecodeLabs blog](https://blog.decodelabs.com)._

---

## Installation

Install via Composer:

```bash

composer require decodelabs/fluidity

```

## Usage

### Method chaining

```php

namespace DecodeLabs\Fluidity;

interface Then

{

    public function then(callable $callback): Then;

    public function thenEach(iterable $values, callable $callback): Then;

    public function thenIf(?bool $truth, callable $yes, callable $no=null): Then;

    public function thenUnless(?bool $truth, callable $no, callable $yes=null): Then;

}

```

Create fluent object interfaces with basic generic logic structure support.

```php

use DecodeLabs\Fluidity\Then;

use DecodeLabs\Fluidity\ThenTrait;

$test = new class() implements Then {

    use ThenTrait;

    public function doThing(int $value=null) {}

};

$truth = true;

$test

    ->then(function($test) {

        $test->doThing();

    })

    ->thenEach([1, 2, 3], function($test, $value) {

        // Called three times

        $test->doThing($value);

    })

    ->thenIf($truth, function($test) {

        // This gets called if($truth)

    }, function($test) {

        // This get called otherwise

    })

    ->thenUnless($truth, function($test) {

        // This gets called if(!$truth)

    }, function($test) {

        // This get called otherwise

    });

```

## Licensing

Fluidity is licensed under the MIT License. See [LICENSE](./LICENSE) for the full license text.