From 28b6495e553ed0c12874a2cbfa1065a724f8c8f4 Mon Sep 17 00:00:00 2001 From: soyuka Date: Tue, 30 Apr 2024 14:31:52 +0200 Subject: [PATCH] [TypeInfo] mark classes as experimental --- src/Symfony/Component/TypeInfo/CHANGELOG.md | 2 +- .../Component/TypeInfo/Exception/ExceptionInterface.php | 2 ++ .../TypeInfo/Exception/InvalidArgumentException.php | 2 ++ src/Symfony/Component/TypeInfo/Exception/LogicException.php | 2 ++ .../Component/TypeInfo/Exception/RuntimeException.php | 2 ++ .../Component/TypeInfo/Exception/UnsupportedException.php | 2 ++ src/Symfony/Component/TypeInfo/README.md | 5 +++++ src/Symfony/Component/TypeInfo/Type.php | 2 ++ src/Symfony/Component/TypeInfo/Type/BackedEnumType.php | 2 ++ src/Symfony/Component/TypeInfo/Type/BuiltinType.php | 2 ++ src/Symfony/Component/TypeInfo/Type/CollectionType.php | 2 ++ src/Symfony/Component/TypeInfo/Type/EnumType.php | 2 ++ src/Symfony/Component/TypeInfo/Type/GenericType.php | 2 ++ src/Symfony/Component/TypeInfo/Type/IntersectionType.php | 2 ++ src/Symfony/Component/TypeInfo/Type/ObjectType.php | 2 ++ src/Symfony/Component/TypeInfo/Type/TemplateType.php | 2 ++ src/Symfony/Component/TypeInfo/Type/UnionType.php | 2 ++ src/Symfony/Component/TypeInfo/TypeContext/TypeContext.php | 2 ++ .../Component/TypeInfo/TypeContext/TypeContextFactory.php | 2 ++ src/Symfony/Component/TypeInfo/TypeFactoryTrait.php | 2 ++ src/Symfony/Component/TypeInfo/TypeIdentifier.php | 2 ++ src/Symfony/Component/TypeInfo/TypeResolver/TypeResolver.php | 2 ++ .../TypeInfo/TypeResolver/TypeResolverInterface.php | 2 ++ 23 files changed, 48 insertions(+), 1 deletion(-) diff --git a/src/Symfony/Component/TypeInfo/CHANGELOG.md b/src/Symfony/Component/TypeInfo/CHANGELOG.md index 5f941ae21a99a..6eb821cdebc51 100644 --- a/src/Symfony/Component/TypeInfo/CHANGELOG.md +++ b/src/Symfony/Component/TypeInfo/CHANGELOG.md @@ -4,4 +4,4 @@ CHANGELOG 7.1 --- - * Add the component + * Add the component as experimental diff --git a/src/Symfony/Component/TypeInfo/Exception/ExceptionInterface.php b/src/Symfony/Component/TypeInfo/Exception/ExceptionInterface.php index fee0c3bd94978..6236d9e395073 100644 --- a/src/Symfony/Component/TypeInfo/Exception/ExceptionInterface.php +++ b/src/Symfony/Component/TypeInfo/Exception/ExceptionInterface.php @@ -14,6 +14,8 @@ /** * @author Mathias Arlaud * @author Baptiste Leduc + * + * @experimental */ interface ExceptionInterface extends \Throwable { diff --git a/src/Symfony/Component/TypeInfo/Exception/InvalidArgumentException.php b/src/Symfony/Component/TypeInfo/Exception/InvalidArgumentException.php index 8baae82917683..67d0f1a7ca1b4 100644 --- a/src/Symfony/Component/TypeInfo/Exception/InvalidArgumentException.php +++ b/src/Symfony/Component/TypeInfo/Exception/InvalidArgumentException.php @@ -14,6 +14,8 @@ /** * @author Mathias Arlaud * @author Baptiste Leduc + * + * @experimental */ class InvalidArgumentException extends \InvalidArgumentException implements ExceptionInterface { diff --git a/src/Symfony/Component/TypeInfo/Exception/LogicException.php b/src/Symfony/Component/TypeInfo/Exception/LogicException.php index 06be3c9eb1653..9adcaedb52e17 100644 --- a/src/Symfony/Component/TypeInfo/Exception/LogicException.php +++ b/src/Symfony/Component/TypeInfo/Exception/LogicException.php @@ -14,6 +14,8 @@ /** * @author Mathias Arlaud * @author Baptiste Leduc + * + * @experimental */ class LogicException extends \LogicException implements ExceptionInterface { diff --git a/src/Symfony/Component/TypeInfo/Exception/RuntimeException.php b/src/Symfony/Component/TypeInfo/Exception/RuntimeException.php index 143e18ef4ace0..e9cd623d54193 100644 --- a/src/Symfony/Component/TypeInfo/Exception/RuntimeException.php +++ b/src/Symfony/Component/TypeInfo/Exception/RuntimeException.php @@ -14,6 +14,8 @@ /** * @author Mathias Arlaud * @author Baptiste Leduc + * + * @experimental */ class RuntimeException extends \RuntimeException implements ExceptionInterface { diff --git a/src/Symfony/Component/TypeInfo/Exception/UnsupportedException.php b/src/Symfony/Component/TypeInfo/Exception/UnsupportedException.php index 1b7e1ee9396c1..29c76fbe79351 100644 --- a/src/Symfony/Component/TypeInfo/Exception/UnsupportedException.php +++ b/src/Symfony/Component/TypeInfo/Exception/UnsupportedException.php @@ -14,6 +14,8 @@ /** * @author Mathias Arlaud * @author Baptiste Leduc + * + * @experimental */ class UnsupportedException extends \LogicException implements ExceptionInterface { diff --git a/src/Symfony/Component/TypeInfo/README.md b/src/Symfony/Component/TypeInfo/README.md index 6643ed41dd325..de85ba7ffd154 100644 --- a/src/Symfony/Component/TypeInfo/README.md +++ b/src/Symfony/Component/TypeInfo/README.md @@ -3,6 +3,11 @@ TypeInfo Component The TypeInfo component extracts PHP types information. +**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/TypeInfo/Type.php b/src/Symfony/Component/TypeInfo/Type.php index 6cdb61d870891..dc5b7bd5586a0 100644 --- a/src/Symfony/Component/TypeInfo/Type.php +++ b/src/Symfony/Component/TypeInfo/Type.php @@ -17,6 +17,8 @@ /** * @author Mathias Arlaud * @author Baptiste Leduc + * + * @experimental */ abstract class Type implements \Stringable { diff --git a/src/Symfony/Component/TypeInfo/Type/BackedEnumType.php b/src/Symfony/Component/TypeInfo/Type/BackedEnumType.php index c83017cedf38c..32ec3b6c96dc7 100644 --- a/src/Symfony/Component/TypeInfo/Type/BackedEnumType.php +++ b/src/Symfony/Component/TypeInfo/Type/BackedEnumType.php @@ -21,6 +21,8 @@ * @template U of BuiltinType|BuiltinType * * @extends EnumType + * + * @experimental */ final class BackedEnumType extends EnumType { diff --git a/src/Symfony/Component/TypeInfo/Type/BuiltinType.php b/src/Symfony/Component/TypeInfo/Type/BuiltinType.php index 3ce7de790f3f2..91f16c12cbb2b 100644 --- a/src/Symfony/Component/TypeInfo/Type/BuiltinType.php +++ b/src/Symfony/Component/TypeInfo/Type/BuiltinType.php @@ -20,6 +20,8 @@ * @author Baptiste Leduc * * @template T of TypeIdentifier + * + * @experimental */ final class BuiltinType extends Type { diff --git a/src/Symfony/Component/TypeInfo/Type/CollectionType.php b/src/Symfony/Component/TypeInfo/Type/CollectionType.php index 950befcbb8ec4..7e1210ae3352f 100644 --- a/src/Symfony/Component/TypeInfo/Type/CollectionType.php +++ b/src/Symfony/Component/TypeInfo/Type/CollectionType.php @@ -24,6 +24,8 @@ * @author Baptiste Leduc * * @template T of BuiltinType|BuiltinType|ObjectType|GenericType + * + * @experimental */ final class CollectionType extends Type { diff --git a/src/Symfony/Component/TypeInfo/Type/EnumType.php b/src/Symfony/Component/TypeInfo/Type/EnumType.php index 95665921d1590..97d7dc221f5bb 100644 --- a/src/Symfony/Component/TypeInfo/Type/EnumType.php +++ b/src/Symfony/Component/TypeInfo/Type/EnumType.php @@ -18,6 +18,8 @@ * @template T of class-string<\UnitEnum> * * @extends ObjectType + * + * @experimental */ class EnumType extends ObjectType { diff --git a/src/Symfony/Component/TypeInfo/Type/GenericType.php b/src/Symfony/Component/TypeInfo/Type/GenericType.php index e71a54b20c8c1..dd1bd0b2b4795 100644 --- a/src/Symfony/Component/TypeInfo/Type/GenericType.php +++ b/src/Symfony/Component/TypeInfo/Type/GenericType.php @@ -23,6 +23,8 @@ * @author Baptiste Leduc * * @template T of BuiltinType|BuiltinType|ObjectType + * + * @experimental */ final class GenericType extends Type { diff --git a/src/Symfony/Component/TypeInfo/Type/IntersectionType.php b/src/Symfony/Component/TypeInfo/Type/IntersectionType.php index c829874eab81f..afe702df1e609 100644 --- a/src/Symfony/Component/TypeInfo/Type/IntersectionType.php +++ b/src/Symfony/Component/TypeInfo/Type/IntersectionType.php @@ -19,6 +19,8 @@ * @author Baptiste Leduc * * @template T of Type + * + * @experimental */ final class IntersectionType extends Type { diff --git a/src/Symfony/Component/TypeInfo/Type/ObjectType.php b/src/Symfony/Component/TypeInfo/Type/ObjectType.php index ebb36537b9db7..1b1311e2e27c6 100644 --- a/src/Symfony/Component/TypeInfo/Type/ObjectType.php +++ b/src/Symfony/Component/TypeInfo/Type/ObjectType.php @@ -19,6 +19,8 @@ * @author Baptiste Leduc * * @template T of class-string + * + * @experimental */ class ObjectType extends Type { diff --git a/src/Symfony/Component/TypeInfo/Type/TemplateType.php b/src/Symfony/Component/TypeInfo/Type/TemplateType.php index e9b5c0875df5b..8f2000533cc48 100644 --- a/src/Symfony/Component/TypeInfo/Type/TemplateType.php +++ b/src/Symfony/Component/TypeInfo/Type/TemplateType.php @@ -19,6 +19,8 @@ * * @author Mathias Arlaud * @author Baptiste Leduc + * + * @experimental */ final class TemplateType extends Type { diff --git a/src/Symfony/Component/TypeInfo/Type/UnionType.php b/src/Symfony/Component/TypeInfo/Type/UnionType.php index 380d66b2d7e88..33390647f4a54 100644 --- a/src/Symfony/Component/TypeInfo/Type/UnionType.php +++ b/src/Symfony/Component/TypeInfo/Type/UnionType.php @@ -19,6 +19,8 @@ * @author Baptiste Leduc * * @template T of Type + * + * @experimental */ final class UnionType extends Type { diff --git a/src/Symfony/Component/TypeInfo/TypeContext/TypeContext.php b/src/Symfony/Component/TypeInfo/TypeContext/TypeContext.php index 60638b95616e8..dba4d3fec215b 100644 --- a/src/Symfony/Component/TypeInfo/TypeContext/TypeContext.php +++ b/src/Symfony/Component/TypeInfo/TypeContext/TypeContext.php @@ -22,6 +22,8 @@ * * @author Mathias Arlaud * @author Baptiste Leduc + * + * @experimental */ final class TypeContext { diff --git a/src/Symfony/Component/TypeInfo/TypeContext/TypeContextFactory.php b/src/Symfony/Component/TypeInfo/TypeContext/TypeContextFactory.php index 8008cc724b7a8..006b748ba6fbd 100644 --- a/src/Symfony/Component/TypeInfo/TypeContext/TypeContextFactory.php +++ b/src/Symfony/Component/TypeInfo/TypeContext/TypeContextFactory.php @@ -27,6 +27,8 @@ * * @author Mathias Arlaud * @author Baptiste Leduc + * + * @experimental */ final class TypeContextFactory { diff --git a/src/Symfony/Component/TypeInfo/TypeFactoryTrait.php b/src/Symfony/Component/TypeInfo/TypeFactoryTrait.php index 374179c0f67a0..d87737d5945bb 100644 --- a/src/Symfony/Component/TypeInfo/TypeFactoryTrait.php +++ b/src/Symfony/Component/TypeInfo/TypeFactoryTrait.php @@ -26,6 +26,8 @@ * * @author Mathias Arlaud * @author Baptiste Leduc + * + * @experimental */ trait TypeFactoryTrait { diff --git a/src/Symfony/Component/TypeInfo/TypeIdentifier.php b/src/Symfony/Component/TypeInfo/TypeIdentifier.php index 8776ef661ba83..45bd5472ab41e 100644 --- a/src/Symfony/Component/TypeInfo/TypeIdentifier.php +++ b/src/Symfony/Component/TypeInfo/TypeIdentifier.php @@ -16,6 +16,8 @@ * * @author Mathias Arlaud * @author Baptiste Leduc + * + * @experimental */ enum TypeIdentifier: string { diff --git a/src/Symfony/Component/TypeInfo/TypeResolver/TypeResolver.php b/src/Symfony/Component/TypeInfo/TypeResolver/TypeResolver.php index 6181e1a94faa8..c2e89968f6663 100644 --- a/src/Symfony/Component/TypeInfo/TypeResolver/TypeResolver.php +++ b/src/Symfony/Component/TypeInfo/TypeResolver/TypeResolver.php @@ -23,6 +23,8 @@ * * @author Mathias Arlaud * @author Baptiste Leduc + * + * @experimental */ final readonly class TypeResolver implements TypeResolverInterface { diff --git a/src/Symfony/Component/TypeInfo/TypeResolver/TypeResolverInterface.php b/src/Symfony/Component/TypeInfo/TypeResolver/TypeResolverInterface.php index ce259a993ec07..edb1be642ce36 100644 --- a/src/Symfony/Component/TypeInfo/TypeResolver/TypeResolverInterface.php +++ b/src/Symfony/Component/TypeInfo/TypeResolver/TypeResolverInterface.php @@ -20,6 +20,8 @@ * * @author Mathias Arlaud * @author Baptiste Leduc + * + * @experimental */ interface TypeResolverInterface {