Merge pull request #457 from GromNaN/final

Make Executor and Purger classes final

UPGRADE.md

@@ -6,6 +6,11 @@ awareness about deprecated code.
 - Use of our low-overhead runtime deprecation API, details:
   https://github.com/doctrine/deprecations/
 
+# Upgrade to 1.8
+
+Executor and Purger classes are final, they cannot be extended.
+`AbstractExecutor` is internal. It cannot be extended or used as typehint.
+
 # Upgrade to 1.6
 
 ## BC BREAK: `CircularReferenceException` no longer extends `Doctrine\Common\CommonException`

docs/en/explanation/transactions-and-purging.rst

@@ -1,9 +1,8 @@
 Transactions and purging
 ========================
 
-This package exposes an ``AbstractExecutor`` class and 3 concrete
-implementations for ``doctrine/orm``, ``doctrine/mongodb-odm`` and
-``doctrine/phpcr-odm``.
+This package provides executors for ``doctrine/orm``, ``doctrine/mongodb-odm``
+and ``doctrine/phpcr-odm``.
 
 The executors purge the database, then load the fixtures. The ORM
 implementation wraps these two steps in a database transaction, which

src/Executor/AbstractExecutor.php

@@ -17,6 +17,8 @@
 
 /**
  * Abstract fixture executor.
+ *
+ * @internal since 1.8.0
  */
 abstract class AbstractExecutor
 {

src/Executor/MongoDBExecutor.php

@@ -11,6 +11,8 @@
 
 /**
  * Class responsible for executing data fixtures.
+ *
+ * @final since 1.8.0
  */
 class MongoDBExecutor extends AbstractExecutor
 {

src/Executor/ORMExecutor.php

@@ -8,6 +8,8 @@
 
 /**
  * Class responsible for executing data fixtures.
+ *
+ * @final since 1.8.0
  */
 class ORMExecutor extends AbstractExecutor
 {

src/Executor/PHPCRExecutor.php

@@ -11,6 +11,8 @@
 
 /**
  * Class responsible for executing data fixtures.
+ *
+ * @final since 1.8.0
  */
 class PHPCRExecutor extends AbstractExecutor
 {

src/Purger/MongoDBPurger.php

@@ -8,6 +8,8 @@
 
 /**
  * Class responsible for purging databases of data before reloading data fixtures.
+ *
+ * @final since 1.8.0
  */
 class MongoDBPurger implements PurgerInterface
 {

src/Purger/ORMPurger.php

@@ -19,6 +19,8 @@
 
 /**
  * Class responsible for purging databases of data before reloading data fixtures.
+ *
+ * @final since 1.8.0
  */
 class ORMPurger implements PurgerInterface, ORMPurgerInterface
 {

src/Purger/PHPCRPurger.php

@@ -10,6 +10,8 @@
 
 /**
  * Class responsible for purging databases of data before reloading data fixtures.
+ *
+ * @final since 1.8.0
  */
 class PHPCRPurger implements PurgerInterface
 {