minor: make "in-memory" classes experimental (#895)

Author: nikophil

docs/index.rst

@@ -2133,6 +2133,11 @@ applications or with `hexagonal architecture <https://en.wikipedia.org/wiki/Hexa
 repositories in the domain are usually interfaces for which main implementations are a Doctrine one. You can tell Foundry to
 use the "in-memory" version of these repositories.
 
+.. versionadded:: 2.5
+
+    The "in-memory" behavior is experimental. Experimental features are not
+    covered by the backward compatibility promise.
+
 First, you need to create an "in-memory" version of your repository. This repository must implement the
 ``Zenstruck\Foundry\InMemory\InMemoryRepository`` interface. You can use the trait
 ``Zenstruck\Foundry\InMemory\InMemoryRepositoryTrait`` to help you with this:
@@ -2160,7 +2165,7 @@ First, you need to create an "in-memory" version of your repository. This reposi
     }
 
 Then, the "in-memory" repository should be used in Symfony's container, as the main repository implementation. For this
-purpose, you can either use a new environment ``test-in-memory``, or declare use ``InMeMemoryKernel``.
+purpose, you can either use a new environment ``test-in-memory``, or use a ``InMeMemoryKernel``.
 
 In your tests, use the ``#[AsInMemoryTest]`` attribute, which will disable persistence of the factories, and register an
 "after instantiate" hook, which will store the objects in their respective "in memory" repositories:
@@ -2185,6 +2190,13 @@ In your tests, use the ``#[AsInMemoryTest]`` attribute, which will disable persi
             $address = AddressFactory::createOne();
 
             self::assertSame([$address], $this->addressRepository->_all());
+
+            // The following assertion is also true, `YourFactory::repository()` returns a special "in-memory" repository
+            // no request to the database will be made.
+            self::assertSame(1, AddressFactory::repository()->count(1));
+
+            // You can even use `YourFactory::repository()->assert()`
+            AddressFactory::repository()->assert()->count(1);
         }
     }
 

src/InMemory/AsInMemoryTest.php

@@ -15,6 +15,7 @@
 
 /**
  * @author Nicolas PHILIPPE <[email protected]>
+ * @experimental
  */
 #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_METHOD)]
 final class AsInMemoryTest

src/InMemory/GenericInMemoryRepository.php

@@ -17,6 +17,7 @@
  * @template T of object
  * @implements InMemoryRepository<T>
  * @author Nicolas PHILIPPE <[email protected]>
+ * @experimental
  *
  * This class will be used when a specific "in-memory" repository does not exist for a given class.
  */

src/InMemory/InMemoryRepository.php

@@ -17,6 +17,7 @@
  * @author Nicolas PHILIPPE <[email protected]>
  *
  * @template T of object
+ * @experimental
  */
 interface InMemoryRepository
 {

src/InMemory/InMemoryRepositoryTrait.php

@@ -16,6 +16,7 @@
 /**
  * @template T of object
  * @phpstan-require-implements InMemoryRepository
+ * @experimental
  *
  * @author Nicolas PHILIPPE <[email protected]>
  */