nayleen/finder

Yet another class finder implementation.

1.0 2024-01-08 23:56 UTC

Requires

• php: >=8.1
• roave/better-reflection: ^6

Requires (Dev)

• nayleen/codestandard: dev-latest
• nayleen/development-dependencies: ^3.3
• roave/security-advisories: dev-latest

MIT

README

Yet another class finder implementation.

Installation

composer require nayleen/finder

Usage

The finder comes with two different sets of classes: Engines and Expectations.

Engines

Currently supported Engine implementations:

• BetterReflectionEngine (can find built-in and load classes from strings)

Engines provide iterators over class strings which can then be filtered using Expectations.

Expectations

Expectations filter the class strings according to certain criteria. They're chainable, composable and negatable. You can (and should) write your own Expectations depending on your requirements in class filtering.

Building blocks (located in Nayleen\Finder\Expectation sub-namespaces):

• Combinator\Composed - chains two expectation (like boolean ANDs)
• Combinator\Not - negates a wrapped expectation

Concrete implementations:

• Any
• CallableExpectation - wraps a callable with signature: callable(class-string): bool
• ExtendsClass
• HasAttribute
• ImplementsInterface
• IsInstantiable