spatie/better-types

Improved abstraction for dealing with union and named types.

Fund package maintenance!
spatie

Installs: 1 422 021

Dependents: 2

Suggesters: 0

Security: 0

Stars: 65

Watchers: 4

Forks: 4

Open Issues: 0

0.2.0 2024-03-08 11:36 UTC

This package is auto-updated.

Last update: 2024-12-08 13:10:57 UTC


README

Check whether a reflection type or method accepts a given input

Latest Version on Packagist GitHub Tests Action Status GitHub Code Style Action Status Total Downloads

Support us

We invest a lot of resources into creating best in class open source packages. You can support us by buying one of our paid products.

We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on our contact page. We publish all received postcards on our virtual postcard wall.

Installation

You can install the package via composer:

composer require spatie/better-types

Usage

Using the Type class directly:

function (FooInterface $foo) {}

$reflectionType = …

$type = new Type($reflectionType);

$type->accepts(new Foo()); // true
$type->accepts('invalid string'); // false

Using the Method class:

function (?FooInterface $foo, ?BarInterface $bar) {}

$reflectionMethod = …

$method = new Method($reflectionMethod);

$method->accepts(new Foo(), new Bar()); // true
$method->accepts(bar: new Bar() foo: new Foo()); // true
$method->accepts(null, new Bar()); // true
$method->accepts(null, null); // true

$method->accepts('string', 1); // false
$method->accepts(new Foo()); // false, you can't omit values

Using Handlers to determine which methods accept a given set of input:

class Foo
{
    public function acceptsString(string $a) {}
    
    public function acceptsStringToo(string $a) {}
    
    public function acceptsInt(int $a) {}
}

$reflectionClass = …

$handlers = new Handlers($reflectionClass);

$handlers->accepts('string')->all(); // ['acceptsString', 'acceptsStringToo']
$handlers->accepts(1)->first(); // 'acceptsInt'

Using the Attributes class to find and instantiate attributes with a fluent API:

Attributes::new(AttributesTestClass::class)
    ->instanceOf(AttributesTestAttribute::class)
    ->first();

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

License

The MIT License (MIT). Please see License File for more information.