Add expiremental annotation where needed, add final to class that sho…

…uld not be extended

src/Symfony/Component/AutoMapper/AutoMapper.php

@@ -40,6 +40,8 @@
 /**
  * Maps a source data structure (object or array) to a target one.
  *
+ * @expiremental
+ *
  * @author Joel Wurtz <jwurtz@jolicode.com>
  */
 final class AutoMapper implements AutoMapperInterface, AutoMapperRegistryInterface, MapperGeneratorMetadataRegistryInterface

src/Symfony/Component/AutoMapper/AutoMapperInterface.php

@@ -14,6 +14,8 @@
 /**
  * An auto mapper has the role of mapping a source to a target.
  *
+ * @expiremental
+ *
  * @author Joel Wurtz <jwurtz@jolicode.com>
  */
 interface AutoMapperInterface

src/Symfony/Component/AutoMapper/AutoMapperNormalizer.php

@@ -18,6 +18,8 @@
 /**
  * Bridge for symfony/serializer.
  *
+ * @expiremental
+ *
  * @author Joel Wurtz <jwurtz@jolicode.com>
  */
 class AutoMapperNormalizer implements NormalizerInterface, DenormalizerInterface

src/Symfony/Component/AutoMapper/Exception/CircularReferenceException.php

@@ -11,6 +11,11 @@
 
 namespace Symfony\Component\AutoMapper\Exception;
 
+/**
+ * @expiremental
+ *
+ * @author Joel Wurtz <jwurtz@jolicode.com>
+ */
 class CircularReferenceException extends \RuntimeException
 {
 }

src/Symfony/Component/AutoMapper/Exception/CompileException.php

@@ -11,6 +11,11 @@
 
 namespace Symfony\Component\AutoMapper\Exception;
 
+/**
+ * @expiremental
+ *
+ * @author Joel Wurtz <jwurtz@jolicode.com>
+ */
 class CompileException extends \RuntimeException
 {
 }

src/Symfony/Component/AutoMapper/Exception/InvalidMappingException.php

@@ -11,6 +11,11 @@
 
 namespace Symfony\Component\AutoMapper\Exception;
 
+/**
+ * @expiremental
+ *
+ * @author Joel Wurtz <jwurtz@jolicode.com>
+ */
 class InvalidMappingException extends \RuntimeException
 {
 }

src/Symfony/Component/AutoMapper/Exception/NoMappingFoundException.php

@@ -11,6 +11,11 @@
 
 namespace Symfony\Component\AutoMapper\Exception;
 
+/**
+ * @expiremental
+ *
+ * @author Joel Wurtz <jwurtz@jolicode.com>
+ */
 class NoMappingFoundException extends \RuntimeException
 {
 }

src/Symfony/Component/AutoMapper/Extractor/FromSourceMappingExtractor.php

@@ -24,6 +24,8 @@
  *
  * Can use a NameConverter to use specific properties name in the target
  *
+ * @expiremental
+ *
  * @author Joel Wurtz <jwurtz@jolicode.com>
  */
 final class FromSourceMappingExtractor extends MappingExtractor

src/Symfony/Component/AutoMapper/Extractor/FromTargetMappingExtractor.php

@@ -24,6 +24,8 @@
  *
  * Can use a NameConverter to use specific properties name in the source
  *
+ * @expiremental
+ *
  * @author Joel Wurtz <jwurtz@jolicode.com>
  */
 final class FromTargetMappingExtractor extends MappingExtractor

src/Symfony/Component/AutoMapper/Extractor/PropertyMapping.php

@@ -16,6 +16,8 @@
 /**
  * Property mapping.
  *
+ * @expiremental
+ *
  * @author Joel Wurtz <jwurtz@jolicode.com>
  */
 final class PropertyMapping

src/Symfony/Component/AutoMapper/Extractor/SourceTargetMappingExtractor.php

@@ -16,6 +16,8 @@
 /**
  * Extracts mapping between two objects, only gives properties that have the same name.
  *
+ * @expiremental
+ *
  * @author Joel Wurtz <jwurtz@jolicode.com>
  */
 class SourceTargetMappingExtractor extends MappingExtractor

src/Symfony/Component/AutoMapper/Generator/Generator.php

@@ -30,8 +30,12 @@
 
 /**
  * Generate code for a mapping class.
+ *
+ * @expiremental
+ *
+ * @author Joel Wurtz <jwurtz@jolicode.com>
  */
-class Generator
+final class Generator
 {
     private $parser;
 

src/Symfony/Component/AutoMapper/Loader/EvalLoader.php

@@ -1,9 +1,12 @@
 <?php
-/**
- * Created by IntelliJ IDEA.
- * User: joelwurtz
- * Date: 2/14/19
- * Time: 2:07 PM.
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <fabien@symfony.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
  */
 
 namespace Symfony\Component\AutoMapper\Loader;
@@ -13,9 +16,13 @@
 use Symfony\Component\AutoMapper\MapperGeneratorMetadataInterface;
 
 /**
- * Uses a generator and eval to requiring mapping of a class.
+ * Use eval to load mappers
+ *
+ * @expiremental
+ *
+ * @author Joel Wurtz <jwurtz@jolicode.com>
  */
-class EvalLoader implements ClassLoaderInterface
+final class EvalLoader implements ClassLoaderInterface
 {
     private $generator;
 

src/Symfony/Component/AutoMapper/Loader/FileLoader.php

@@ -15,7 +15,14 @@
 use Symfony\Component\AutoMapper\Generator\Generator;
 use Symfony\Component\AutoMapper\MapperGeneratorMetadataInterface;
 
-class FileLoader implements ClassLoaderInterface
+/**
+ * Use file system to load mapper, and persist them using a registry
+ *
+ * @expiremental
+ *
+ * @author Joel Wurtz <jwurtz@jolicode.com>
+ */
+final class FileLoader implements ClassLoaderInterface
 {
     private $generator;
 

src/Symfony/Component/AutoMapper/MapperGeneratorMetadataFactory.php

@@ -18,6 +18,8 @@
 /**
  * Metadata factory, used to autoregistering new mapping without creating them.
  *
+ * @expiremental
+ *
  * @author Joel Wurtz <jwurtz@jolicode.com>
  */
 final class MapperGeneratorMetadataFactory

src/Symfony/Component/AutoMapper/MapperMetadata.php

@@ -20,6 +20,8 @@
 /**
  * Mapper metadata.
  *
+ * @expiremental
+ *
  * @author Joel Wurtz <jwurtz@jolicode.com>
  */
 class MapperMetadata implements MapperGeneratorMetadataInterface

src/Symfony/Component/AutoMapper/Transformer/ArrayTransformer.php

@@ -19,9 +19,11 @@
 /**
  * Transformer array decorator.
  *
+ * @expiremental
+ *
  * @author Joel Wurtz <jwurtz@jolicode.com>
  */
-class ArrayTransformer implements TransformerInterface
+final class ArrayTransformer implements TransformerInterface
 {
     private $itemTransformer;
 

src/Symfony/Component/AutoMapper/Transformer/ArrayTransformerFactory.php

@@ -17,9 +17,11 @@
 /**
  * Create a decorated transformer to handle array type.
  *
+ * @expiremental
+ *
  * @author Joel Wurtz <jwurtz@jolicode.com>
  */
-class ArrayTransformerFactory extends AbstractUniqueTypeTransformerFactory
+final class ArrayTransformerFactory extends AbstractUniqueTypeTransformerFactory
 {
     private $chainTransformerFactory;
 

src/Symfony/Component/AutoMapper/Transformer/BuiltinTransformer.php

@@ -22,9 +22,11 @@
 /**
  * Built in transformer to handle PHP scalar types.
  *
+ * @expiremental
+ *
  * @author Joel Wurtz <jwurtz@jolicode.com>
  */
-class BuiltinTransformer implements TransformerInterface
+final class BuiltinTransformer implements TransformerInterface
 {
     private const CAST_MAPPING = [
         Type::BUILTIN_TYPE_BOOL => [

src/Symfony/Component/AutoMapper/Transformer/BuiltinTransformerFactory.php

@@ -15,9 +15,11 @@
 use Symfony\Component\PropertyInfo\Type;
 
 /**
+ * @expiremental
+ *
  * @author Joel Wurtz <jwurtz@jolicode.com>
  */
-class BuiltinTransformerFactory implements TransformerFactoryInterface
+final class BuiltinTransformerFactory implements TransformerFactoryInterface
 {
     private const BUILTIN = [
         Type::BUILTIN_TYPE_BOOL,

src/Symfony/Component/AutoMapper/Transformer/CallbackTransformer.php

@@ -20,9 +20,11 @@
 /**
  * Handle custom callback transformation.
  *
+ * @expiremental
+ *
  * @author Joel Wurtz <jwurtz@jolicode.com>
  */
-class CallbackTransformer implements TransformerInterface
+final class CallbackTransformer implements TransformerInterface
 {
     private $callbackName;
 

src/Symfony/Component/AutoMapper/Transformer/ChainTransformerFactory.php

@@ -14,9 +14,11 @@
 use Symfony\Component\AutoMapper\MapperMetadataInterface;
 
 /**
+ * @expiremental
+ *
  * @author Joel Wurtz <jwurtz@jolicode.com>
  */
-class ChainTransformerFactory implements TransformerFactoryInterface
+final class ChainTransformerFactory implements TransformerFactoryInterface
 {
     /** @var TransformerFactoryInterface[] */
     private $factories = [];

src/Symfony/Component/AutoMapper/Transformer/CopyTransformer.php

@@ -18,9 +18,11 @@
 /**
  * Does not do any transformation, output = input.
  *
+ * @expiremental
+ *
  * @author Joel Wurtz <jwurtz@jolicode.com>
  */
-class CopyTransformer implements TransformerInterface
+final class CopyTransformer implements TransformerInterface
 {
     /**
      * {@inheritdoc}

src/Symfony/Component/AutoMapper/Transformer/DateTimeToStringTansformer.php

@@ -20,9 +20,11 @@
 /**
  * Transform a \DateTimeInterface object to a string.
  *
+ * @expiremental
+ *
  * @author Joel Wurtz <jwurtz@jolicode.com>
  */
-class DateTimeToStringTansformer implements TransformerInterface
+final class DateTimeToStringTansformer implements TransformerInterface
 {
     private $format;
 

src/Symfony/Component/AutoMapper/Transformer/DateTimeTransformerFactory.php

@@ -15,9 +15,11 @@
 use Symfony\Component\PropertyInfo\Type;
 
 /**
+ * @expiremental
+ *
  * @author Joel Wurtz <jwurtz@jolicode.com>
  */
-class DateTimeTransformerFactory extends AbstractUniqueTypeTransformerFactory
+final class DateTimeTransformerFactory extends AbstractUniqueTypeTransformerFactory
 {
     /**
      * {@inheritdoc}

src/Symfony/Component/AutoMapper/Transformer/MultipleTransformer.php

@@ -25,9 +25,11 @@
  * Decorate transformers with condition to handle property with multiples source types
  * It will always use the first target type possible for transformation
  *
+ * @expiremental
+ *
  * @author Joel Wurtz <jwurtz@jolicode.com>
  */
-class MultipleTransformer implements TransformerInterface
+final class MultipleTransformer implements TransformerInterface
 {
     private const CONDITION_MAPPING = [
         Type::BUILTIN_TYPE_BOOL => 'is_bool',

src/Symfony/Component/AutoMapper/Transformer/MultipleTransformerFactory.php

@@ -14,9 +14,11 @@
 use Symfony\Component\AutoMapper\MapperMetadataInterface;
 
 /**
+ * @expiremental
+ *
  * @author Joel Wurtz <jwurtz@jolicode.com>
  */
-class MultipleTransformerFactory implements TransformerFactoryInterface
+final class MultipleTransformerFactory implements TransformerFactoryInterface
 {
     private $chainTransformerFactory;
 

src/Symfony/Component/AutoMapper/Transformer/NullableTransformer.php

@@ -20,9 +20,11 @@
 /**
  * Tansformer decorator to handle null values.
  *
+ * @expiremental
+ *
  * @author Joel Wurtz <jwurtz@jolicode.com>
  */
-class NullableTransformer implements TransformerInterface
+final class NullableTransformer implements TransformerInterface
 {
     private $itemTransformer;
     private $isTargetNullable;

src/Symfony/Component/AutoMapper/Transformer/NullableTransformerFactory.php

@@ -15,9 +15,11 @@
 use Symfony\Component\PropertyInfo\Type;
 
 /**
+ * @expiremental
+ *
  * @author Joel Wurtz <jwurtz@jolicode.com>
  */
-class NullableTransformerFactory implements TransformerFactoryInterface
+final class NullableTransformerFactory implements TransformerFactoryInterface
 {
     private $chainTransformerFactory;