README

📦 About

Mono is a library of immutable value objects that wrap primitive types like string, int, bool, and array.

Instead of passing around loose values, you use small, self-contained wrappers like:

Lowercased, Trimmed, TruncatedRight (strings)
Yes, IsEmail, ThrowsIf (logic)
Mapped, SequenceOf (collections)

Each class encapsulates one behavior and can be composed with others to form robust, intention-revealing objects.

🧠 Philosophy

❌ No null, static, or shared state in the public API
✅ One object = one responsibility
✅ Final classes, immutability by default
✅ Composition over inheritance
✅ Behavior and data live together

Inspired by Elegant Objects and cactoos.

✨ Example

use Mono\Text\Lowercased;
use Mono\Text\TruncatedRight;
use Mono\Text\Trimmed;

$text = new TruncatedRight(
    new Lowercased(
        new Trimmed("  Hello, world!  ")
    ),
    5
);

echo $text->toString(); // "hello"

Each wrapper adds one behavior:

Trimmed removes whitespace
TruncatedRight shortens the string

All wrappers implement the same interface and can be freely composed.

🧱 Modules

Text — Trimmed, Uppercased, Lowercased, TruncatedRight, HtmlSanitized, LengthOf, Preview, TextOf
Logic — Yes, No, ThrowsIf, IsEmpty, IsEmail, IsUuid, LogicEnvelope
Iterable — Sequence, SequenceOf, Mapped, Filtered
Number — (coming soon) Positive, NonZero, Rounded, etc.

🧪 Quality & CI

Every push and pull request is checked via GitHub Actions:

✅ Static analysis with PHPStan (level 9) and Psalm (level 8)
✅ Type coverage report via Shepherd
✅ Code style check with PHP-CS-Fixer (only changed files)
✅ Unit tests with PHPUnit
✅ Code coverage via Codecov
✅ Mutation testing with Infection
✅ Composer validation, platform checks, security audit
✅ Automatic refactoring via Rector

📥 Installation

composer require haspadar/mono

Requires PHP 8.4

📄 License

MIT

haspadar / mono

Maintainers

Details