Close API by mark classes as final

UPGRADE-4.x.md

@@ -1,6 +1,14 @@
 UPGRADE 4.x
 ===========
 
+UPGRADE FROM 4.x to 4.x
+=======================
+
+### Mark classes as final
+
+A lot of classes were marked as final with the phpdoc annotation, make sure you avoid
+extending them because on next major they will become final.
+
 UPGRADE FROM 4.13 to 4.14
 =========================
 

src/Admin/Document/UserAdmin.php

@@ -15,6 +15,9 @@
 
 use Sonata\UserBundle\Admin\Model\UserAdmin as BaseUserAdmin;
 
+/**
+ * @final since sonata-project/user-bundle 4.x
+ */
 class UserAdmin extends BaseUserAdmin
 {
 }

src/Admin/Entity/UserAdmin.php

@@ -15,6 +15,9 @@
 
 use Sonata\UserBundle\Admin\Model\UserAdmin as BaseUserAdmin;
 
+/**
+ * @final since sonata-project/user-bundle 4.x
+ */
 class UserAdmin extends BaseUserAdmin
 {
 }

src/DependencyInjection/Compiler/GlobalVariablesCompilerPass.php

@@ -18,7 +18,7 @@
 use Symfony\Component\DependencyInjection\Reference;
 
 /**
- * GlobalVariablesCompilerPass.
+ * @final since sonata-project/user-bundle 4.x
  *
  * @author Thomas Rabaix <thomas.rabaix@sonata-project.org>
  */

src/DependencyInjection/Configuration.php

@@ -22,6 +22,8 @@
 use Symfony\Component\Config\Definition\ConfigurationInterface;
 
 /**
+ * @final since sonata-project/user-bundle 4.x
+ *
  * This is the class that validates and merges configuration from your app/config files.
  *
  * To learn more see {@link http://symfony.com/doc/current/cookbook/bundles/extension.html#cookbook-bundles-extension-config-class}

src/DependencyInjection/SonataUserExtension.php

@@ -30,6 +30,8 @@
 use Symfony\Component\HttpKernel\DependencyInjection\Extension;
 
 /**
+ * @final since sonata-project/user-bundle 4.x
+ *
  * @author Thomas Rabaix <thomas.rabaix@sonata-project.org>
  */
 class SonataUserExtension extends Extension implements PrependExtensionInterface

src/Document/GroupManager.php

@@ -18,6 +18,8 @@
 use Sonata\UserBundle\Model\GroupManagerInterface;
 
 /**
+ * @final since sonata-project/user-bundle 4.x
+ *
  * @author Hugo Briand <briand@ekino.com>
  */
 class GroupManager extends BaseGroupManager implements GroupManagerInterface

src/Document/UserManager.php

@@ -18,6 +18,8 @@
 use Sonata\UserBundle\Model\UserManagerInterface;
 
 /**
+ * @final since sonata-project/user-bundle 4.x
+ *
  * @author Hugo Briand <briand@ekino.com>
  */
 class UserManager extends BaseUserManager implements UserManagerInterface

src/Entity/GroupManager.php

@@ -19,6 +19,8 @@
 use Sonata\UserBundle\Model\GroupManagerInterface;
 
 /**
+ * @final since sonata-project/user-bundle 4.x
+ *
  * @author Hugo Briand <briand@ekino.com>
  */
 class GroupManager extends BaseGroupManager implements GroupManagerInterface

src/Entity/UserManager.php

@@ -21,6 +21,8 @@
 use Sonata\UserBundle\Model\UserManagerInterface;
 
 /**
+ * @final since sonata-project/user-bundle 4.x
+ *
  * @author Hugo Briand <briand@ekino.com>
  */
 class UserManager extends BaseUserManager implements UserManagerInterface, ManagerInterface

src/Form/Transformer/RestoreRolesTransformer.php

@@ -16,6 +16,9 @@
 use Sonata\UserBundle\Security\EditableRolesBuilder;
 use Symfony\Component\Form\DataTransformerInterface;
 
+/**
+ * @final since sonata-project/user-bundle 4.x
+ */
 class RestoreRolesTransformer implements DataTransformerInterface
 {
     /**

src/Form/Type/SecurityRolesType.php

@@ -25,6 +25,9 @@
 use Symfony\Component\OptionsResolver\Options;
 use Symfony\Component\OptionsResolver\OptionsResolver;
 
+/**
+ * @final since sonata-project/user-bundle 4.x
+ */
 class SecurityRolesType extends AbstractType
 {
     /**

src/Security/Authorization/Voter/UserAclVoter.php

@@ -17,6 +17,9 @@
 use Symfony\Component\Security\Acl\Voter\AclVoter;
 use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
 
+/**
+ * @final since sonata-project/user-bundle 4.x
+ */
 class UserAclVoter extends AclVoter
 {
     public function supportsClass($class)

src/Security/EditableRolesBuilder.php

@@ -18,6 +18,9 @@
 use Symfony\Component\Security\Core\Authorization\AuthorizationCheckerInterface;
 use Symfony\Component\Translation\TranslatorInterface;
 
+/**
+ * @final since sonata-project/user-bundle 4.x
+ */
 class EditableRolesBuilder
 {
     /**

src/SonataUserBundle.php

@@ -19,6 +19,9 @@
 use Symfony\Component\DependencyInjection\ContainerBuilder;
 use Symfony\Component\HttpKernel\Bundle\Bundle;
 
+/**
+ * @final since sonata-project/user-bundle 4.x
+ */
 class SonataUserBundle extends Bundle
 {
     public function build(ContainerBuilder $container): void

src/Twig/GlobalVariables.php

@@ -17,6 +17,8 @@
 use Symfony\Component\DependencyInjection\ContainerInterface;
 
 /**
+ * @final since sonata-project/user-bundle 4.x
+ *
  * @author Thomas Rabaix <thomas.rabaix@sonata-project.org>
  */
 class GlobalVariables

tests/Admin/Document/UserAdmin.php

@@ -13,7 +13,7 @@
 
 namespace Sonata\UserBundle\Tests\Admin\Document;
 
-use Sonata\UserBundle\Admin\Document\UserAdmin as BaseUserAdmin;
+use Sonata\UserBundle\Admin\Model\UserAdmin as BaseUserAdmin;
 
 /**
  * @author Anton Dyshkant <vyshkant@gmail.com>

tests/Admin/Entity/UserAdmin.php

@@ -13,7 +13,7 @@
 
 namespace Sonata\UserBundle\Tests\Admin\Entity;
 
-use Sonata\UserBundle\Admin\Entity\UserAdmin as BaseUserAdmin;
+use Sonata\UserBundle\Admin\Model\UserAdmin as BaseUserAdmin;
 
 /**
  * @author Anton Dyshkant <vyshkant@gmail.com>