&labelColor=31373e)
-
+
&labelColor=31373e)
-
+
Development Branch
+## PHPUnit testing infrastructure – Development Branch
-⚠️ **This is the `develop` branch**
+⚠️ **This is the `development` branch**
- Unstable
- APIs may change without notice
- Not intended for production use
+### Related
+
+- Milestone: **Development v1**
+- Target Release: **v0.0.0**
+- Repository: FireHub Core Standard
+
+### Pull request
+
+
+
+### Milestone
+
+
+
+ 
Branch Purpose
-The `develop` branch is the **primary integration branch** for all ongoing development.
+This branch introduces the PHPUnit testing infrastructure and initial Core test coverage for the FireHub ecosystem.
+
+It establishes the foundational testing layer required to validate Core behavior across:
-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
+- Core Standard
+- Core Professional
+- Core Enterprise
+- Runtime Foundation (consumers only)
-All **release branches** are created **from `develop`**.
+This includes PHPUnit configuration, bootstrap alignment, and first executable test cases for Core contracts.
-## Stability Guarantee
+## Architectural Goal
-❌ No backward compatibility guarantee
-❌ APIs may change without notice
-❌ Behavior may be incomplete or inconsistent
-❌ Breaking changes are expected
+Introduce a standardized testing layer for Core validation that:
-This branch is intended **only for contributors and advanced testers**.
+- Ensures Core contracts behave deterministically
+- Provides automated verification of architectural rules
+- Enables CI-level validation of Core stability
+- Establishes testing as a first-class governance layer in FireHub
-## Composer Usage (Not Recommended)
+## Core Concept
-For internal testing only:
+A FireHub testing layer is:
-```json
-{
- "require": {
- "the-firehub-project/core-standard": "dev-develop"
- }
-}
-```
-⚠️ Never use dev-develop in production.
+> A deterministic validation system that ensures Core contracts and architectural rules behave as specified, independent of runtime implementation details.
## Authors and Contributors
@@ -102,4 +137,4 @@ Architecture guidelines, design principles, and ecosystem documentation are avai
This software is licensed under the Apache-2.0 License.
-For more details, read the full license [here](./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 64e7613..d8b699e 100644
--- a/composer.json
+++ b/composer.json
@@ -10,9 +10,21 @@
},
"require-dev": {
"phpstan/phpstan": "^2.0",
- "the-firehub-project/phpstan-rules": "dev-develop"
+ "the-firehub-project/phpstan-rules": "dev-develop",
+
+ "the-firehub-project/testing": "dev-develop"
},
"minimum-stability": "stable",
+ "autoload": {
+ "psr-4": {
+ "FireHub\\Core\\": "src"
+ }
+ },
+ "autoload-dev": {
+ "psr-4": {
+ "FireHub\\Tests\\Core\\": "tests/"
+ }
+ },
"authors": [
{
"name": "Danijel Galić",
diff --git a/phpstan.neon b/phpstan.neon
index 6161413..d0e5c9b 100644
--- a/phpstan.neon
+++ b/phpstan.neon
@@ -1,5 +1,5 @@
includes:
- - vendor/the-firehub-project/phpstan-rules/src/config/base.neon
+ - vendor/the-firehub-project/phpstan-rules/src/Config/base.neon
parameters:
paths:
diff --git a/phpunit.xml b/phpunit.xml
new file mode 100644
index 0000000..27667c4
--- /dev/null
+++ b/phpunit.xml
@@ -0,0 +1,16 @@
+
+* The Value Object to compare against. *
* * @return bool True if the VOs are equal, false otherwise. + *@uses \FireHub\Core\Type\ValueObject::value() To compare the VO values. + * + * @since 1.0.0 + * + * @uses \FireHub\Core\Type\ValueObject::sameAs() To compare the VO types. */ final public function equals (self $other):bool { @@ -66,13 +66,13 @@ final public function equals (self $other):bool { * ### Checks strict identity equality of a Value Object type * * Ensures both objects are of the same concrete class without comparing values. - * @since 1.0.0 - * * @param \FireHub\Core\Type\ValueObject* The Value Object to compare against. *
* * @return bool True if the objects are of the same type, false otherwise. + *@since 1.0.0 + * */ final public function sameAs (self $other):bool { diff --git a/tests/Stubs/Type/DummyIntVO.php b/tests/Stubs/Type/DummyIntVO.php new file mode 100644 index 0000000..28537cb --- /dev/null +++ b/tests/Stubs/Type/DummyIntVO.php @@ -0,0 +1,55 @@ + + * @copyright 2026-present The FireHub Project - All rights reserved + * @license https://opensource.org/license/Apache-2-0 Apache License, Version 2.0 + * + * @php-version >=8.2 + * @package Core\Tests + */ + +namespace FireHub\Tests\Core\Stubs\Type; + +use FireHub\Core\Type\ValueObject; +use InvalidArgumentException; + +/** + * ### Dummy int Value Object + * @since 1.0.0 + */ +readonly class DummyIntVO extends ValueObject { + + /** + * ### Constructor + * @since 1.0.0 + * + * @param int $value + * + * @return void + */ + public function __construct ( + private int $value = 1 + ) { + + $this->guard( + fn() => $this->value > 0, + fn() => new InvalidArgumentException('Value must be positive.') + ); + + } + + /** + * @inheritDoc + * + * @since 1.0.0 + */ + public function value ():int { + + return $this->value; + + } + +} \ No newline at end of file diff --git a/tests/Stubs/Type/DummyStringVO.php b/tests/Stubs/Type/DummyStringVO.php new file mode 100644 index 0000000..a4e9be0 --- /dev/null +++ b/tests/Stubs/Type/DummyStringVO.php @@ -0,0 +1,55 @@ + + * @copyright 2026-present The FireHub Project - All rights reserved + * @license https://opensource.org/license/Apache-2-0 Apache License, Version 2.0 + * + * @php-version >=8.2 + * @package Core\Tests + */ + +namespace FireHub\Tests\Core\Stubs\Type; + +use FireHub\Core\Type\ValueObject; +use InvalidArgumentException; + +/** + * ### Dummy string Value Object + * @since 1.0.0 + */ +readonly class DummyStringVO extends ValueObject { + + /** + * ### Constructor + * @since 1.0.0 + * + * @param string $value + * + * @return void + */ + public function __construct ( + private string $value = 'default' + ) { + + $this->guard( + fn() => $this->value !== '', + fn() => new InvalidArgumentException('Value cannot be empty.') + ); + + } + + /** + * @inheritDoc + * + * @since 1.0.0 + */ + public function value ():string { + + return $this->value; + + } + +} \ No newline at end of file diff --git a/tests/Unit/Type/ValueObjectTest.php b/tests/Unit/Type/ValueObjectTest.php new file mode 100644 index 0000000..a4682a1 --- /dev/null +++ b/tests/Unit/Type/ValueObjectTest.php @@ -0,0 +1,74 @@ + + * @copyright 2026-present The FireHub Project - All rights reserved + * @license https://opensource.org/license/Apache-2-0 Apache License, Version 2.0 + * + * @php-version >=7.0 + * @package Core\Tests + */ + +namespace FireHub\Tests\Core\Unit\Type; + +use FireHub\Testing\FireHubTestCase; +use FireHub\Core\Type\ValueObject; +use FireHub\Tests\Core\Stubs\Type\ { + DummyIntVO, DummyStringVO +}; +use PHPUnit\Framework\Attributes\ { + CoversClass, Group, Small, TestWith +}; + +/** + * ### Test Base Value Object + * @since 1.0.0 + */ +#[Small] +#[Group('type')] +#[CoversClass(ValueObject::class)] +final class ValueObjectTest extends FireHubTestCase { + + /** + * @since 1.0.0 + * + * @param string $a + * @param string $b + * @param bool $expected + * + * @return void + */ + #[TestWith(['x', 'x', true])] + #[TestWith(['x', 'y', false])] + public function testEquals (string $a, string $b, bool $expected):void { + + $a = new DummyStringVO($a); + $b = new DummyStringVO($b); + + $this::assertEquals($expected, $a->equals($b)); + + } + + /** + * @since 1.0.0 + * + * @param string $a + * @param string $b + * @param bool $expected + * + * @return void + */ + #[TestWith([DummyStringVO::class, DummyStringVO::class, true])] + #[TestWith([DummyStringVO::class, DummyIntVO::class, false])] + public function testSameAs (string $a, string $b, bool $expected):void { + + $a = new $a; + $b = new $b; + + $this::assertEquals($expected, $a->sameAs($b)); + + } + +} \ No newline at end of file
