Add ability to use container as a factory

[xepozz]

Q	A
Is bugfix?	/❌
New feature?	✔️
Breaks BC?	❌
Fixed issues	#350

[what-the-diff]

PR Summary

• Enhancements to the Container class in src

  • Introduced a new constant called META_AFTER_BUILT
  • A new property afterBuiltHooks has been added; it'll presumably be used to perform certain actions after the container is fully constructed.
  • Two new methods, callHookAfterBuilt and setAfterBuiltHook, have been added. These methods are useful for setting up and invoking the newly introduced after-build hooks.

• Addition of a new AfterBuiltHook class in src/Hook

  • A new class called AfterBuiltHook has been introduced in file AfterBuiltHook.php. It contains a static method unsetInstance that returns a closure. This likely facilitates the ability to work with hooks after a build.

• Unit Testing for AfterBuiltHook class

  • A new unit test file tests/Unit/Hook/AfterBuiltHookTest.php has been added. It offers a test case for the AfterBuiltHook class, essentially checking if different objects are returned from the container after a build. This ensures the new functionality of the after-build hook is working as intended.

[vjik]

Are there any other cases for this hook?

[xepozz]

Not now

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 100.00%. Comparing base (aeb0856) to head (9ddc47e).

Additional details and impacted files

@@             Coverage Diff             @@
##              master      #354   +/-   ##
===========================================
  Coverage     100.00%   100.00%           
- Complexity       161       166    +5     
===========================================
  Files             11        12    +1     
  Lines            466       479   +13     
===========================================
+ Hits             466       479   +13     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[vjik]

If we know only one case for new hook (use container as factory for defined classes), I suggest don't add hook now. For this case more convient and clear will be use specific meta tag singleton with boolean value (true as default).

'singleton' => false

It is better than:

'afterBuilt' => AfterBuiltHook::unsetInstance(),