Skip to content

🚀 Maatify Common v1.0.2 — Introducing TapHelper for Cleaner Initialization

Choose a tag to compare

View all tags
@Maatify Maatify released this 10 Nov 05:31
· 31 commits to main since this release
v1.0.2
37a244a

🚀 Maatify Common v1.0.2 — Introducing TapHelper for Cleaner Initialization

Release Date: 2025-11-10
Author: [Mohamed Abdulalim (megyptm)](mailto:mohamed@maatify.dev)
License: MIT
Organization: [Maatify.dev](https://www.maatify.dev)

✨ Overview

This version introduces the new TapHelper utility — a lightweight, functional-style helper designed to simplify object initialization and improve code fluency across all Maatify libraries.

It lets you execute a callback on an object or value and return that same instance unchanged, making adapter or service setup much cleaner.

“Cleaner initialization • Consistent patterns • Zero boilerplate.”

🧩 What’s New

  • Added: Maatify\Common\Helpers\TapHelper
    → Provides a static tap() method to execute a callback on a value and return it unchanged.
    → Promotes fluent, functional initialization patterns across the ecosystem.
  • Added Tests: tests/Helpers/TapHelperTest.php
    → Covers object identity, callback execution, and scalar/array support.
  • Updated Docs: README.md
    → New Helper Utilities section with usage examples and architectural notes.
    → Linked reference from the Core Modules section.

🧱 Architectural Impact

  • Enables fluent adapter and service initialization using one line.
  • Improves developer ergonomics and readability throughout Maatify projects.
  • Keeps consistency with helpers such as PathHelper, EnumHelper, and TimeHelper.
  • Fully backward-compatible with v1.0.1 (no breaking changes).

🧾 Changelog Summary

v1.0.2 — 2025-11-10
• Added TapHelper utility under Maatify\Common\Helpers
• Added full unit tests for TapHelper
• Updated README with Helper Utilities section
• Improved developer experience for adapter initialization

📦 Upgrade Guide

No action required.
Simply update via Composer:

composer update maatify/common

All features are non-breaking and immediately available after autoload refresh.

© 2025 Maatify.dev — Engineered by [Mohamed Abdulalim](https://www.maatify.dev)
Distributed under the MIT License

Assets 2
Loading