diff --git a/README.md b/README.md index 8326abf..0d16351 100644 --- a/README.md +++ b/README.md @@ -23,19 +23,19 @@

- + GitHub last commit (branch) - + GitHub activity (branch) - + GitHub commit difference between two branches

@@ -55,47 +55,81 @@ This layer is designed to ensure that FireHub architectural rules are continuous --- -## FireHub Icon Development Branch +## FireHub Icon Testcase Base – Development Branch -⚠️ **This is the `develop` branch** +⚠️ **This is the `development` branch** - Unstable - APIs may change without notice - Not intended for production use +### Related + +- Target Release: **v0.0.0** +- Repository: FireHub Testing Toolkit + +### Pull request + +

+ + GitHub pull request title + + GitHub pull request author + + GitHub pull request created + + GitHub pull request comments +

+ ## FireHub Icon Branch Purpose -The `develop` branch is the **primary integration branch** for all ongoing development. +This branch introduces the **base testing abstraction (`FireHubTestCase`)** for the FireHub ecosystem. + +It establishes a unified foundation for all test suites across: + +- Core Standard +- Core Professional +- Core Enterprise +- Runtime Foundation (consumers only) +- Future FireHub testing extensions + +The goal is to remove direct coupling to `PHPUnit\Framework\TestCase` in application-level tests and introduce a **shared FireHub testing entry point**. + +## FireHub Icon Architectural Goal -It serves as the staging area where: -- Feature branches are merged -- Bug fixes are integrated -- Experimental work is stabilized -- Code is prepared for upcoming releases +Introduce a **standardized testing root layer** that: -All **release branches** are created **from `develop`**. +- Provides a single inheritance point for all FireHub tests +- Decouples ecosystem tests from direct PHPUnit dependency usage +- Enables future extension of testing behavior (assertions, bootstrapping, validation rules) +- Serves as the foundation for a structured testing hierarchy (CoreTestCase, IntegrationTestCase, ArchitectureTestCase) -## Stability Guarantee +This ensures testing evolves as a **governed architectural layer**, not a collection of isolated test implementations. -❌ No backward compatibility guarantee -❌ APIs may change without notice -❌ Behavior may be incomplete or inconsistent -❌ Breaking changes are expected +## FireHub Icon Core Concept -This branch is intended **only for contributors and advanced testers**. +A FireHub test case is: -## FireHub Icon Composer Usage (Not Recommended) +> A standardized, extensible abstraction over PHPUnit that acts as the root entry point for all FireHub testing logic. -For internal testing only: +It is designed to: -```json -{ - "require": { - "the-firehub-project/testing": "dev-develop" - } -} -``` -⚠️ Never use dev-develop in production. +- unify test structure across repositories +- enable architectural enforcement through tests +- provide a stable base for future testing capabilities +- ensure consistency in how FireHub systems are validated ## FireHub Icon Authors and Contributors @@ -110,6 +144,6 @@ Architecture guidelines, design principles, and ecosystem documentation are avai ## FireHub Icon License -This software is licensed under the MIT License. +This software is licensed under the Apache-2.0 License. For more details, read the full license [here](./LICENSE). \ No newline at end of file diff --git a/composer.json b/composer.json index 5fde2f9..ba91723 100644 --- a/composer.json +++ b/composer.json @@ -10,6 +10,11 @@ "phpunit/phpunit": "^13.0" }, "minimum-stability": "stable", + "autoload": { + "psr-4": { + "FireHub\\Testing\\": "src" + } + }, "authors": [ { "name": "Danijel Galić", diff --git a/src/FireHubTestCase.php b/src/FireHubTestCase.php new file mode 100644 index 0000000..f82c6db --- /dev/null +++ b/src/FireHubTestCase.php @@ -0,0 +1,30 @@ + + * @copyright 2026-present The FireHub Project - All rights reserved + * @license https://opensource.org/license/MIT MIT License + * + * @php-version >=7.0 + * @package Testing + */ + +namespace FireHub\Testing; + +use PHPUnit\Framework\TestCase; + +/** + * ### FireHub Test Case + * + * Base testing abstraction for the FireHub ecosystem built on top of PHPUnit. + * + * This class provides a unified foundation for all FireHub test suites and ensures consistent structure, + * extensibility, and future support for shared testing utilities across Core, Runtime, and ecosystem packages. + * + * It is not intended to contain business logic but to serve as the root entry point for all FireHub-specific testing + * behavior. + * @since 1.0.0 + */ +abstract class FireHubTestCase extends TestCase {} \ No newline at end of file