Enhancement: Implement WithOptionalStrategy

[localheinz]

This PR

• implements a WithOptionalStrategy

💁‍♂️ The fixture factory currently uses a DefaultStrategy for resolving field definitions.

This strategy involves random behavior, and

• FieldDefinition::optionalClosure() might be resolved to null a concrete value
• FieldDefinition::optionalReference() might be resolved to null or a concrete reference
• FieldDefinition::optionalSequence() might be resolved to null or a concrete value
• FieldDefinition::optionalValue() might be resolved to null or a concrete value
• FieldDefinition::references() might be resolved to an empty array or an array of references

You might have a scenario where you have entity definitions that use optional field definitions, but would like to create an entity where these optional field definitions are resolved to concrete values or references. In this case you can use a fixture factory with the WithOptionalStrategy.

This strategy still involves random behavior, but

• FieldDefinition::optionalClosure() will be resolved to a concrete value
• FieldDefinition::optionalReference() will be resolved to a concrete value
• FieldDefinition::optionalSequence() will be resolved to a concrete value
• FieldDefinition::optionalValue() will be resolved to a concrete value
• FieldDefinition::references() will be resolved to a non-empty array

[codecov]

Codecov Report

Merging #365 into main will increase coverage by 0.60%.
The diff coverage is 100.00%.

@@             Coverage Diff              @@
##               main     #365      +/-   ##
============================================
+ Coverage     98.41%   99.01%   +0.60%     
- Complexity       98      107       +9     
============================================
  Files            21       24       +3     
  Lines           252      304      +52     
============================================
+ Hits            248      301      +53     
+ Misses            4        3       -1     

Impacted Files	Coverage Δ	Complexity Δ
src/FieldDefinition/Reference.php	100.00% <ø> (ø)	2.00 <0.00> (ø)
src/Count.php	100.00% <100.00%> (ø)	8.00 <8.00> (?)
src/Exception/InvalidCount.php	100.00% <100.00%> (ø)	1.00 <1.00> (?)
src/Exception/InvalidDefinition.php	100.00% <100.00%> (ø)	3.00 <3.00> (+2.00)
src/Exception/InvalidMaximum.php	100.00% <100.00%> (ø)	1.00 <1.00> (?)
src/Exception/InvalidMinimum.php	100.00% <100.00%> (ø)	1.00 <1.00> (?)
src/FieldDefinition.php	100.00% <100.00%> (ø)	9.00 <1.00> (-2.00)
src/FieldDefinition/References.php	100.00% <100.00%> (ø)	2.00 <1.00> (ø)
src/FixtureFactory.php	97.88% <100.00%> (-0.35%)	46.00 <20.00> (+4.00)	⬇️
src/Strategy/DefaultStrategy.php	100.00% <100.00%> (ø)	4.00 <4.00> (?)
... and 6 more

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 0751c29...8c6b6b0. Read the comment docs.