feature #61500 [JsonPath][JsonStreamer][ObjectMapper] the components are no longer experimental (xabbuh)

fabpot · fabpot · commit f37691b2d37f · 2025-08-22T16:27:23.000+02:00
This PR was merged into the 7.4 branch. Discussion ---------- [JsonPath][JsonStreamer][ObjectMapper] the components are no longer experimental | Q | A | ------------- | --- | Branch? | 7.4 | Bug fix? | no | New feature? | yes | Deprecations? | no | Issues | | License | MIT Commits ------- 5ab5aa8 JsonPath, JsonStreamer and ObjectMapper are no longer experimental
diff --git a/src/Symfony/Component/JsonPath/CHANGELOG.md b/src/Symfony/Component/JsonPath/CHANGELOG.md
@@ -1,6 +1,11 @@
 CHANGELOG
 =========
 
+7.4
+---
+
+ * The component is not marked as `@experimental` anymore
+
 7.3
 ---
 
diff --git a/src/Symfony/Component/JsonPath/Exception/ExceptionInterface.php b/src/Symfony/Component/JsonPath/Exception/ExceptionInterface.php
@@ -13,8 +13,6 @@
 
 /**
  * @author Alexandre Daubois <alex.daubois@gmail.com>
- *
- * @experimental
  */
 interface ExceptionInterface extends \Throwable
 {
diff --git a/src/Symfony/Component/JsonPath/Exception/InvalidArgumentException.php b/src/Symfony/Component/JsonPath/Exception/InvalidArgumentException.php
@@ -13,8 +13,6 @@
 
 /**
  * @author Alexandre Daubois <alex.daubois@gmail.com>
- *
- * @experimental
  */
 class InvalidArgumentException extends \InvalidArgumentException implements ExceptionInterface
 {
diff --git a/src/Symfony/Component/JsonPath/Exception/InvalidJsonPathException.php b/src/Symfony/Component/JsonPath/Exception/InvalidJsonPathException.php
@@ -13,8 +13,6 @@
 
 /**
  * @author Alexandre Daubois <alex.daubois@gmail.com>
- *
- * @experimental
  */
 class InvalidJsonPathException extends \LogicException implements ExceptionInterface
 {
diff --git a/src/Symfony/Component/JsonPath/Exception/InvalidJsonStringInputException.php b/src/Symfony/Component/JsonPath/Exception/InvalidJsonStringInputException.php
@@ -15,8 +15,6 @@
  * Thrown when a string passed as an input is not a valid JSON string, e.g. in {@see JsonCrawler}.
  *
  * @author Alexandre Daubois <alex.daubois@gmail.com>
- *
- * @experimental
  */
 class InvalidJsonStringInputException extends InvalidArgumentException
 {
diff --git a/src/Symfony/Component/JsonPath/Exception/JsonCrawlerException.php b/src/Symfony/Component/JsonPath/Exception/JsonCrawlerException.php
@@ -13,8 +13,6 @@
 
 /**
  * @author Alexandre Daubois <alex.daubois@gmail.com>
- *
- * @experimental
  */
 class JsonCrawlerException extends \RuntimeException implements ExceptionInterface
 {
diff --git a/src/Symfony/Component/JsonPath/JsonCrawler.php b/src/Symfony/Component/JsonPath/JsonCrawler.php
@@ -26,8 +26,6 @@
  * @see https://datatracker.ietf.org/doc/html/rfc9535
  *
  * @author Alexandre Daubois <alex.daubois@gmail.com>
- *
- * @experimental
  */
 final class JsonCrawler implements JsonCrawlerInterface
 {
diff --git a/src/Symfony/Component/JsonPath/JsonCrawlerInterface.php b/src/Symfony/Component/JsonPath/JsonCrawlerInterface.php
@@ -16,8 +16,6 @@
 
 /**
  * @author Alexandre Daubois <alex.daubois@gmail.com>
- *
- * @experimental
  */
 interface JsonCrawlerInterface
 {
diff --git a/src/Symfony/Component/JsonPath/JsonPath.php b/src/Symfony/Component/JsonPath/JsonPath.php
@@ -15,8 +15,6 @@
  * @author Alexandre Daubois <alex.daubois@gmail.com>
  *
  * @immutable
- *
- * @experimental
  */
 final class JsonPath
 {
diff --git a/src/Symfony/Component/JsonPath/README.md b/src/Symfony/Component/JsonPath/README.md
@@ -3,11 +3,6 @@ JsonPath Component
 
 The JsonPath component eases JSON navigation using the JSONPath syntax as described in [RFC 9535](https://www.rfc-editor.org/rfc/rfc9535.html).
 
-**This Component is experimental**.
-[Experimental features](https://symfony.com/doc/current/contributing/code/experimental.html)
-are not covered by Symfony's
-[Backward Compatibility Promise](https://symfony.com/doc/current/contributing/code/bc.html).
-
 Getting Started
 ---------------
 
diff --git a/src/Symfony/Component/JsonPath/Test/JsonPathAssertionsTrait.php b/src/Symfony/Component/JsonPath/Test/JsonPathAssertionsTrait.php
@@ -17,8 +17,6 @@
 
 /**
  * @author Alexandre Daubois <alex.daubois@gmail.com>
- *
- * @experimental
  */
 trait JsonPathAssertionsTrait
 {
diff --git a/src/Symfony/Component/JsonPath/Test/JsonPathContains.php b/src/Symfony/Component/JsonPath/Test/JsonPathContains.php
@@ -17,8 +17,6 @@
 
 /**
  * @author Alexandre Daubois <alex.daubois@gmail.com>
- *
- * @experimental
  */
 class JsonPathContains extends Constraint
 {
diff --git a/src/Symfony/Component/JsonPath/Test/JsonPathCount.php b/src/Symfony/Component/JsonPath/Test/JsonPathCount.php
@@ -17,8 +17,6 @@
 
 /**
  * @author Alexandre Daubois <alex.daubois@gmail.com>
- *
- * @experimental
  */
 class JsonPathCount extends Constraint
 {
diff --git a/src/Symfony/Component/JsonPath/Test/JsonPathEquals.php b/src/Symfony/Component/JsonPath/Test/JsonPathEquals.php
@@ -17,8 +17,6 @@
 
 /**
  * @author Alexandre Daubois <alex.daubois@gmail.com>
- *
- * @experimental
  */
 class JsonPathEquals extends Constraint
 {
diff --git a/src/Symfony/Component/JsonPath/Test/JsonPathNotContains.php b/src/Symfony/Component/JsonPath/Test/JsonPathNotContains.php
@@ -17,8 +17,6 @@
 
 /**
  * @author Alexandre Daubois <alex.daubois@gmail.com>
- *
- * @experimental
  */
 class JsonPathNotContains extends Constraint
 {
diff --git a/src/Symfony/Component/JsonPath/Test/JsonPathNotEquals.php b/src/Symfony/Component/JsonPath/Test/JsonPathNotEquals.php
@@ -17,8 +17,6 @@
 
 /**
  * @author Alexandre Daubois <alex.daubois@gmail.com>
- *
- * @experimental
  */
 class JsonPathNotEquals extends Constraint
 {
diff --git a/src/Symfony/Component/JsonPath/Test/JsonPathNotSame.php b/src/Symfony/Component/JsonPath/Test/JsonPathNotSame.php
@@ -17,8 +17,6 @@
 
 /**
  * @author Alexandre Daubois <alex.daubois@gmail.com>
- *
- * @experimental
  */
 class JsonPathNotSame extends Constraint
 {
diff --git a/src/Symfony/Component/JsonPath/Test/JsonPathSame.php b/src/Symfony/Component/JsonPath/Test/JsonPathSame.php
@@ -17,8 +17,6 @@
 
 /**
  * @author Alexandre Daubois <alex.daubois@gmail.com>
- *
- * @experimental
  */
 class JsonPathSame extends Constraint
 {
diff --git a/src/Symfony/Component/JsonStreamer/Attribute/JsonStreamable.php b/src/Symfony/Component/JsonStreamer/Attribute/JsonStreamable.php
@@ -13,8 +13,6 @@
 
 /**
  * @author Mathias Arlaud <mathias.arlaud@gmail.com>
- *
- * @experimental
  */
 #[\Attribute(\Attribute::TARGET_CLASS)]
 final class JsonStreamable
diff --git a/src/Symfony/Component/JsonStreamer/Attribute/StreamedName.php b/src/Symfony/Component/JsonStreamer/Attribute/StreamedName.php
@@ -15,8 +15,6 @@
  * Defines the streamed property name.
  *
  * @author Mathias Arlaud <mathias.arlaud@gmail.com>
- *
- * @experimental
  */
 #[\Attribute(\Attribute::TARGET_PROPERTY)]
 final class StreamedName
diff --git a/src/Symfony/Component/JsonStreamer/Attribute/ValueTransformer.php b/src/Symfony/Component/JsonStreamer/Attribute/ValueTransformer.php
@@ -19,8 +19,6 @@
  * that will be used to transform the property data during stream reading/writing.
  *
  * @author Mathias Arlaud <mathias.arlaud@gmail.com>
- *
- * @experimental
  */
 #[\Attribute(\Attribute::TARGET_PROPERTY)]
 class ValueTransformer
diff --git a/src/Symfony/Component/JsonStreamer/CHANGELOG.md b/src/Symfony/Component/JsonStreamer/CHANGELOG.md
@@ -4,6 +4,7 @@ CHANGELOG
 7.4
 ---
 
+ * The component is not marked as `@experimental` anymore
  * Remove `nikic/php-parser` dependency
  * Add `_current_object` to the context passed to value transformers during write operations
  * Add `include_null_properties` option to encode the properties with `null` value
diff --git a/src/Symfony/Component/JsonStreamer/Exception/ExceptionInterface.php b/src/Symfony/Component/JsonStreamer/Exception/ExceptionInterface.php
@@ -13,8 +13,6 @@
 
 /**
  * @author Mathias Arlaud <mathias.arlaud@gmail.com>
- *
- * @experimental
  */
 interface ExceptionInterface extends \Throwable
 {
diff --git a/src/Symfony/Component/JsonStreamer/Exception/InvalidArgumentException.php b/src/Symfony/Component/JsonStreamer/Exception/InvalidArgumentException.php
@@ -13,8 +13,6 @@
 
 /**
  * @author Mathias Arlaud <mathias.arlaud@gmail.com>
- *
- * @experimental
  */
 class InvalidArgumentException extends \InvalidArgumentException implements ExceptionInterface
 {
diff --git a/src/Symfony/Component/JsonStreamer/Exception/InvalidStreamException.php b/src/Symfony/Component/JsonStreamer/Exception/InvalidStreamException.php
@@ -13,8 +13,6 @@
 
 /**
  * @author Mathias Arlaud <mathias.arlaud@gmail.com>
- *
- * @experimental
  */
 final class InvalidStreamException extends UnexpectedValueException
 {
diff --git a/src/Symfony/Component/JsonStreamer/Exception/LogicException.php b/src/Symfony/Component/JsonStreamer/Exception/LogicException.php
@@ -13,8 +13,6 @@
 
 /**
  * @author Mathias Arlaud <mathias.arlaud@gmail.com>
- *
- * @experimental
  */
 class LogicException extends \LogicException implements ExceptionInterface
 {
diff --git a/src/Symfony/Component/JsonStreamer/Exception/NotEncodableValueException.php b/src/Symfony/Component/JsonStreamer/Exception/NotEncodableValueException.php
@@ -13,8 +13,6 @@
 
 /**
  * @author Mathias Arlaud <mathias.arlaud@gmail.com>
- *
- * @experimental
  */
 class NotEncodableValueException extends UnexpectedValueException
 {
diff --git a/src/Symfony/Component/JsonStreamer/Exception/RuntimeException.php b/src/Symfony/Component/JsonStreamer/Exception/RuntimeException.php
@@ -13,8 +13,6 @@
 
 /**
  * @author Mathias Arlaud <mathias.arlaud@gmail.com>
- *
- * @experimental
  */
 class RuntimeException extends \RuntimeException implements ExceptionInterface
 {
diff --git a/src/Symfony/Component/JsonStreamer/Exception/UnexpectedValueException.php b/src/Symfony/Component/JsonStreamer/Exception/UnexpectedValueException.php
@@ -13,8 +13,6 @@
 
 /**
  * @author Mathias Arlaud <mathias.arlaud@gmail.com>
- *
- * @experimental
  */
 class UnexpectedValueException extends \UnexpectedValueException implements ExceptionInterface
 {
diff --git a/src/Symfony/Component/JsonStreamer/Exception/UnsupportedException.php b/src/Symfony/Component/JsonStreamer/Exception/UnsupportedException.php
@@ -13,8 +13,6 @@
 
 /**
  * @author Mathias Arlaud <mathias.arlaud@gmail.com>
- *
- * @experimental
  */
 class UnsupportedException extends InvalidArgumentException
 {
diff --git a/src/Symfony/Component/JsonStreamer/JsonStreamReader.php b/src/Symfony/Component/JsonStreamer/JsonStreamReader.php
@@ -32,8 +32,6 @@
  * @author Mathias Arlaud <mathias.arlaud@gmail.com>
  *
  * @implements StreamReaderInterface<array<string, mixed>>
- *
- * @experimental
  */
 final class JsonStreamReader implements StreamReaderInterface
 {
diff --git a/src/Symfony/Component/JsonStreamer/JsonStreamWriter.php b/src/Symfony/Component/JsonStreamer/JsonStreamWriter.php
@@ -33,8 +33,6 @@
  *     include_null_properties?: bool,
  *     ...<string, mixed>,
  * }>
- *
- * @experimental
  */
 final class JsonStreamWriter implements StreamWriterInterface
 {
diff --git a/src/Symfony/Component/JsonStreamer/Mapping/PropertyMetadata.php b/src/Symfony/Component/JsonStreamer/Mapping/PropertyMetadata.php
@@ -17,8 +17,6 @@
  * Holds stream reading/writing metadata about a given property.
  *
  * @author Mathias Arlaud <mathias.arlaud@gmail.com>
- *
- * @experimental
  */
 final class PropertyMetadata
 {
diff --git a/src/Symfony/Component/JsonStreamer/Mapping/PropertyMetadataLoaderInterface.php b/src/Symfony/Component/JsonStreamer/Mapping/PropertyMetadataLoaderInterface.php
@@ -18,8 +18,6 @@
  * an appropriate ObjectNode.
  *
  * @author Mathias Arlaud <mathias.arlaud@gmail.com>
- *
- * @experimental
  */
 interface PropertyMetadataLoaderInterface
 {
diff --git a/src/Symfony/Component/JsonStreamer/README.md b/src/Symfony/Component/JsonStreamer/README.md
@@ -3,11 +3,6 @@ JsonStreamer component
 
 Provides powerful methods to read/write data structures from/into JSON streams.
 
-**This Component is experimental**.
-[Experimental features](https://symfony.com/doc/current/contributing/code/experimental.html)
-are not covered by Symfony's
-[Backward Compatibility Promise](https://symfony.com/doc/current/contributing/code/bc.html).
-
 Resources
 ---------
 
diff --git a/src/Symfony/Component/JsonStreamer/Read/Splitter.php b/src/Symfony/Component/JsonStreamer/Read/Splitter.php
@@ -17,8 +17,6 @@
  * Splits collections to retrieve the offset and length of each element.
  *
  * @author Mathias Arlaud <mathias.arlaud@gmail.com>
- *
- * @experimental
  */
 final class Splitter
 {
diff --git a/src/Symfony/Component/JsonStreamer/StreamReaderInterface.php b/src/Symfony/Component/JsonStreamer/StreamReaderInterface.php
@@ -18,8 +18,6 @@
  *
  * @author Mathias Arlaud <mathias.arlaud@gmail.com>
  *
- * @experimental
- *
  * @template T of array<string, mixed>
  */
 interface StreamReaderInterface
diff --git a/src/Symfony/Component/JsonStreamer/StreamWriterInterface.php b/src/Symfony/Component/JsonStreamer/StreamWriterInterface.php
@@ -18,8 +18,6 @@
  *
  * @author Mathias Arlaud <mathias.arlaud@gmail.com>
  *
- * @experimental
- *
  * @template T of array<string, mixed>
  */
 interface StreamWriterInterface
diff --git a/src/Symfony/Component/JsonStreamer/ValueTransformer/DateTimeToStringValueTransformer.php b/src/Symfony/Component/JsonStreamer/ValueTransformer/DateTimeToStringValueTransformer.php
@@ -20,8 +20,6 @@
  * Transforms DateTimeInterface to string during stream writing.
  *
  * @author Mathias Arlaud <mathias.arlaud@gmail.com>
- *
- * @experimental
  */
 final class DateTimeToStringValueTransformer implements ValueTransformerInterface
 {
diff --git a/src/Symfony/Component/JsonStreamer/ValueTransformer/StringToDateTimeValueTransformer.php b/src/Symfony/Component/JsonStreamer/ValueTransformer/StringToDateTimeValueTransformer.php
@@ -20,8 +20,6 @@
  * Transforms string to DateTimeImmutable during stream reading.
  *
  * @author Mathias Arlaud <mathias.arlaud@gmail.com>
- *
- * @experimental
  */
 final class StringToDateTimeValueTransformer implements ValueTransformerInterface
 {
diff --git a/src/Symfony/Component/JsonStreamer/ValueTransformer/ValueTransformerInterface.php b/src/Symfony/Component/JsonStreamer/ValueTransformer/ValueTransformerInterface.php
@@ -17,8 +17,6 @@
  * Transforms a native value before stream writing and after stream reading.
  *
  * @author Mathias Arlaud <mathias.arlaud@gmail.com>
- *
- * @experimental
  */
 interface ValueTransformerInterface
 {
diff --git a/src/Symfony/Component/ObjectMapper/Attribute/Map.php b/src/Symfony/Component/ObjectMapper/Attribute/Map.php
@@ -14,8 +14,6 @@
 /**
  * Configures a class or a property to map to.
  *
- * @experimental
- *
  * @author Antoine Bluchet <soyuka@gmail.com>
  */
 #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_PROPERTY | \Attribute::IS_REPEATABLE)]
diff --git a/src/Symfony/Component/ObjectMapper/CHANGELOG.md b/src/Symfony/Component/ObjectMapper/CHANGELOG.md
@@ -4,6 +4,7 @@ CHANGELOG
 7.4
 ---
 
+ * The component is not marked as `@experimental` anymore
  * Add `ObjectMapperAwareInterface` to set the owning object mapper instance
 
 7.3
diff --git a/src/Symfony/Component/ObjectMapper/ConditionCallableInterface.php b/src/Symfony/Component/ObjectMapper/ConditionCallableInterface.php
diff --git a/src/Symfony/Component/ObjectMapper/Exception/ExceptionInterface.php b/src/Symfony/Component/ObjectMapper/Exception/ExceptionInterface.php
diff --git a/src/Symfony/Component/ObjectMapper/Exception/MappingException.php b/src/Symfony/Component/ObjectMapper/Exception/MappingException.php
diff --git a/src/Symfony/Component/ObjectMapper/Exception/MappingTransformException.php b/src/Symfony/Component/ObjectMapper/Exception/MappingTransformException.php
diff --git a/src/Symfony/Component/ObjectMapper/Exception/RuntimeException.php b/src/Symfony/Component/ObjectMapper/Exception/RuntimeException.php
diff --git a/src/Symfony/Component/ObjectMapper/Metadata/ObjectMapperMetadataFactoryInterface.php b/src/Symfony/Component/ObjectMapper/Metadata/ObjectMapperMetadataFactoryInterface.php
diff --git a/src/Symfony/Component/ObjectMapper/ObjectMapper.php b/src/Symfony/Component/ObjectMapper/ObjectMapper.php
diff --git a/src/Symfony/Component/ObjectMapper/ObjectMapperAwareInterface.php b/src/Symfony/Component/ObjectMapper/ObjectMapperAwareInterface.php
diff --git a/src/Symfony/Component/ObjectMapper/ObjectMapperInterface.php b/src/Symfony/Component/ObjectMapper/ObjectMapperInterface.php
diff --git a/src/Symfony/Component/ObjectMapper/README.md b/src/Symfony/Component/ObjectMapper/README.md
diff --git a/src/Symfony/Component/ObjectMapper/TransformCallableInterface.php b/src/Symfony/Component/ObjectMapper/TransformCallableInterface.php

Original file line number	Diff line number	Diff line change
`@@ -13,8 +13,6 @@`
`13`	`13`
`14`	`14`	`/**`
`15`	`15`	`* @author Alexandre Daubois <[email protected]>`
`16`		`- *`
`17`		`- * @experimental`
`18`	`16`	`*/`
`19`	`17`	`interface ExceptionInterface extends \Throwable`
`20`	`18`	`{`
Original file line number	Diff line number	Diff line change
`@@ -15,8 +15,6 @@`
`15`	`15`	`* Thrown when a string passed as an input is not a valid JSON string, e.g. in {@see JsonCrawler}.`
`16`	`16`	`*`
`17`	`17`	`* @author Alexandre Daubois <[email protected]>`
`18`		`- *`
`19`		`- * @experimental`
`20`	`18`	`*/`
`21`	`19`	`class InvalidJsonStringInputException extends InvalidArgumentException`
`22`	`20`	`{`
Original file line number	Diff line number	Diff line change
`@@ -26,8 +26,6 @@`
`26`	`26`	`* @see https://datatracker.ietf.org/doc/html/rfc9535`
`27`	`27`	`*`
`28`	`28`	`* @author Alexandre Daubois <[email protected]>`
`29`		`- *`
`30`		`- * @experimental`
`31`	`29`	`*/`
`32`	`30`	`final class JsonCrawler implements JsonCrawlerInterface`
`33`	`31`	`{`
Original file line number	Diff line number	Diff line change
`@@ -16,8 +16,6 @@`
`16`	`16`
`17`	`17`	`/**`
`18`	`18`	`* @author Alexandre Daubois <[email protected]>`
`19`		`- *`
`20`		`- * @experimental`
`21`	`19`	`*/`
`22`	`20`	`interface JsonCrawlerInterface`
`23`	`21`	`{`