[Messenger] marked the component as experimental for 4.2

fabpot · fabpot · commit 7a258b0b5101 · 2018-10-31T06:40:28.000+01:00
diff --git a/Command/ConsumeMessagesCommand.php b/Command/ConsumeMessagesCommand.php
@@ -27,6 +27,8 @@
 
 /**
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class ConsumeMessagesCommand extends Command
 {
diff --git a/Command/DebugCommand.php b/Command/DebugCommand.php
@@ -22,6 +22,8 @@
  * A console command to debug Messenger information.
  *
  * @author Roland Franssen <franssen.roland@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class DebugCommand extends Command
 {
diff --git a/DataCollector/MessengerDataCollector.php b/DataCollector/MessengerDataCollector.php
@@ -20,6 +20,8 @@
 
 /**
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class MessengerDataCollector extends DataCollector implements LateDataCollectorInterface
 {
diff --git a/DependencyInjection/MessengerPass.php b/DependencyInjection/MessengerPass.php
@@ -29,6 +29,8 @@
 
 /**
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class MessengerPass implements CompilerPassInterface
 {
diff --git a/Envelope.php b/Envelope.php
@@ -17,6 +17,8 @@
  * A message wrapped in an envelope with stamps (configurations, markers, ...).
  *
  * @author Maxime Steinhausser <maxime.steinhausser@gmail.com>
+ *
+ * @experimental in 4.2
  */
 final class Envelope
 {
diff --git a/Exception/ExceptionInterface.php b/Exception/ExceptionInterface.php
@@ -15,6 +15,8 @@
  * Base Message component's exception.
  *
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 interface ExceptionInterface extends \Throwable
 {
diff --git a/Exception/InvalidArgumentException.php b/Exception/InvalidArgumentException.php
@@ -13,6 +13,8 @@
 
 /**
  * @author Yonel Ceruto <yonelceruto@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class InvalidArgumentException extends \InvalidArgumentException implements ExceptionInterface
 {
diff --git a/Exception/LogicException.php b/Exception/LogicException.php
@@ -13,6 +13,8 @@
 
 /**
  * @author Roland Franssen <franssen.roland@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class LogicException extends \LogicException implements ExceptionInterface
 {
diff --git a/Exception/NoHandlerForMessageException.php b/Exception/NoHandlerForMessageException.php
@@ -13,6 +13,8 @@
 
 /**
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class NoHandlerForMessageException extends \LogicException implements ExceptionInterface
 {
diff --git a/Exception/RuntimeException.php b/Exception/RuntimeException.php
@@ -13,6 +13,8 @@
 
 /**
  * @author Fabien Potencier <fabien@symfony.com>
+ *
+ * @experimental in 4.2
  */
 class RuntimeException extends \RuntimeException implements ExceptionInterface
 {
diff --git a/Exception/ValidationFailedException.php b/Exception/ValidationFailedException.php
@@ -15,6 +15,8 @@
 
 /**
  * @author Tobias Nyholm <tobias.nyholm@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class ValidationFailedException extends \RuntimeException implements ExceptionInterface
 {
diff --git a/Handler/ChainHandler.php b/Handler/ChainHandler.php
@@ -17,6 +17,8 @@
  * Represents a collection of message handlers.
  *
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class ChainHandler
 {
diff --git a/Handler/Locator/AbstractHandlerLocator.php b/Handler/Locator/AbstractHandlerLocator.php
@@ -18,6 +18,8 @@
  * @author Samuel Roze <samuel.roze@gmail.com>
  *
  * @internal
+ *
+ * @experimental in 4.2
  */
 abstract class AbstractHandlerLocator implements HandlerLocatorInterface
 {
diff --git a/Handler/Locator/ContainerHandlerLocator.php b/Handler/Locator/ContainerHandlerLocator.php
@@ -16,6 +16,8 @@
 /**
  * @author Miha Vrhovnik <miha.vrhovnik@gmail.com>
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class ContainerHandlerLocator extends AbstractHandlerLocator
 {
diff --git a/Handler/Locator/HandlerLocator.php b/Handler/Locator/HandlerLocator.php
@@ -13,6 +13,8 @@
 
 /**
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class HandlerLocator extends AbstractHandlerLocator
 {
diff --git a/Handler/Locator/HandlerLocatorInterface.php b/Handler/Locator/HandlerLocatorInterface.php
@@ -15,6 +15,8 @@
 
 /**
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 interface HandlerLocatorInterface
 {
diff --git a/Handler/MessageHandlerInterface.php b/Handler/MessageHandlerInterface.php
@@ -15,6 +15,8 @@
  * Marker interface for message handlers.
  *
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 interface MessageHandlerInterface
 {
diff --git a/Handler/MessageSubscriberInterface.php b/Handler/MessageSubscriberInterface.php
@@ -15,6 +15,8 @@
  * Handlers can implement this interface to handle multiple messages.
  *
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 interface MessageSubscriberInterface extends MessageHandlerInterface
 {
diff --git a/MessageBus.php b/MessageBus.php
@@ -18,6 +18,8 @@
  * @author Samuel Roze <samuel.roze@gmail.com>
  * @author Matthias Noback <matthiasnoback@gmail.com>
  * @author Nicolas Grekas <p@tchwork.com>
+ *
+ * @experimental in 4.2
  */
 class MessageBus implements MessageBusInterface
 {
diff --git a/MessageBusInterface.php b/MessageBusInterface.php
@@ -13,6 +13,8 @@
 
 /**
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 interface MessageBusInterface
 {
diff --git a/Middleware/ActivationMiddleware.php b/Middleware/ActivationMiddleware.php
@@ -17,6 +17,8 @@
  * Execute the inner middleware according to an activation strategy.
  *
  * @author Maxime Steinhausser <maxime.steinhausser@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class ActivationMiddleware implements MiddlewareInterface
 {
diff --git a/Middleware/HandleMessageMiddleware.php b/Middleware/HandleMessageMiddleware.php
@@ -17,6 +17,8 @@
 
 /**
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class HandleMessageMiddleware implements MiddlewareInterface
 {
diff --git a/Middleware/LoggingMiddleware.php b/Middleware/LoggingMiddleware.php
@@ -16,6 +16,8 @@
 
 /**
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class LoggingMiddleware implements MiddlewareInterface
 {
diff --git a/Middleware/MiddlewareInterface.php b/Middleware/MiddlewareInterface.php
@@ -15,6 +15,8 @@
 
 /**
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 interface MiddlewareInterface
 {
diff --git a/Middleware/SendMessageMiddleware.php b/Middleware/SendMessageMiddleware.php
@@ -19,6 +19,8 @@
 /**
  * @author Samuel Roze <samuel.roze@gmail.com>
  * @author Tobias Schultze <http://tobion.de>
+ *
+ * @experimental in 4.2
  */
 class SendMessageMiddleware implements MiddlewareInterface
 {
diff --git a/Middleware/StackInterface.php b/Middleware/StackInterface.php
@@ -13,6 +13,8 @@
 
 /**
  * @author Nicolas Grekas <p@tchwork.com>
+ *
+ * @experimental in 4.2
  */
 interface StackInterface
 {
diff --git a/Middleware/StackMiddleware.php b/Middleware/StackMiddleware.php
@@ -15,6 +15,8 @@
 
 /**
  * @author Nicolas Grekas <p@tchwork.com>
+ *
+ * @experimental in 4.2
  */
 class StackMiddleware implements MiddlewareInterface, StackInterface
 {
diff --git a/Middleware/TraceableMiddleware.php b/Middleware/TraceableMiddleware.php
@@ -18,6 +18,8 @@
  * Collects some data about a middleware.
  *
  * @author Maxime Steinhausser <maxime.steinhausser@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class TraceableMiddleware implements MiddlewareInterface
 {
diff --git a/Middleware/ValidationMiddleware.php b/Middleware/ValidationMiddleware.php
@@ -18,6 +18,8 @@
 
 /**
  * @author Tobias Nyholm <tobias.nyholm@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class ValidationMiddleware implements MiddlewareInterface
 {
diff --git a/README.md b/README.md
@@ -4,6 +4,10 @@ Messenger Component
 The Messenger component helps application send and receive messages to/from other applications or via
 message queues.
 
+**This Component is experimental**. [Experimental
+features](https://symfony.com/doc/current/contributing/code/experimental.html)
+are not covered by Symfony's BC-break policy.
+
 Resources
 ---------
 
diff --git a/Stamp/ReceivedStamp.php b/Stamp/ReceivedStamp.php
@@ -22,6 +22,8 @@
  * @see SendMessageMiddleware
  *
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 final class ReceivedStamp implements StampInterface
 {
diff --git a/Stamp/SerializerStamp.php b/Stamp/SerializerStamp.php
@@ -13,6 +13,8 @@
 
 /**
  * @author Maxime Steinhausser <maxime.steinhausser@gmail.com>
+ *
+ * @experimental in 4.2
  */
 final class SerializerStamp implements StampInterface
 {
diff --git a/Stamp/StampInterface.php b/Stamp/StampInterface.php
@@ -17,6 +17,8 @@
  * Stamps must be serializable value objects for transport.
  *
  * @author Maxime Steinhausser <maxime.steinhausser@gmail.com>
+ *
+ * @experimental in 4.2
  */
 interface StampInterface
 {
diff --git a/Stamp/ValidationStamp.php b/Stamp/ValidationStamp.php
@@ -15,6 +15,8 @@
 
 /**
  * @author Maxime Steinhausser <maxime.steinhausser@gmail.com>
+ *
+ * @experimental in 4.2
  */
 final class ValidationStamp implements StampInterface
 {
diff --git a/Test/Middleware/MiddlewareTestCase.php b/Test/Middleware/MiddlewareTestCase.php
@@ -18,6 +18,8 @@
 
 /**
  * @author Nicolas Grekas <p@tchwork.com>
+ *
+ * @experimental in 4.2
  */
 abstract class MiddlewareTestCase extends TestCase
 {
diff --git a/TraceableMessageBus.php b/TraceableMessageBus.php
@@ -13,6 +13,8 @@
 
 /**
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class TraceableMessageBus implements MessageBusInterface
 {
diff --git a/Transport/AmqpExt/AmqpFactory.php b/Transport/AmqpExt/AmqpFactory.php
@@ -11,6 +11,9 @@
 
 namespace Symfony\Component\Messenger\Transport\AmqpExt;
 
+/**
+ * @experimental in 4.2
+ */
 class AmqpFactory
 {
     public function createConnection(array $credentials): \AMQPConnection
diff --git a/Transport/AmqpExt/AmqpReceiver.php b/Transport/AmqpExt/AmqpReceiver.php
@@ -20,6 +20,8 @@
  * Symfony Messenger receiver to get messages from AMQP brokers using PHP's AMQP extension.
  *
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class AmqpReceiver implements ReceiverInterface
 {
diff --git a/Transport/AmqpExt/AmqpSender.php b/Transport/AmqpExt/AmqpSender.php
@@ -20,6 +20,8 @@
  * Symfony Messenger sender to send messages to AMQP brokers using PHP's AMQP extension.
  *
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class AmqpSender implements SenderInterface
 {
diff --git a/Transport/AmqpExt/AmqpTransport.php b/Transport/AmqpExt/AmqpTransport.php
@@ -18,6 +18,8 @@
 
 /**
  * @author Nicolas Grekas <p@tchwork.com>
+ *
+ * @experimental in 4.2
  */
 class AmqpTransport implements TransportInterface
 {
diff --git a/Transport/AmqpExt/AmqpTransportFactory.php b/Transport/AmqpExt/AmqpTransportFactory.php
@@ -18,6 +18,8 @@
 
 /**
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class AmqpTransportFactory implements TransportFactoryInterface
 {
diff --git a/Transport/AmqpExt/Connection.php b/Transport/AmqpExt/Connection.php
@@ -19,6 +19,8 @@
  * @author Samuel Roze <samuel.roze@gmail.com>
  *
  * @final
+ *
+ * @experimental in 4.2
  */
 class Connection
 {
diff --git a/Transport/AmqpExt/Exception/RejectMessageExceptionInterface.php b/Transport/AmqpExt/Exception/RejectMessageExceptionInterface.php
@@ -19,6 +19,8 @@
  * be rejected. Otherwise, it will be re-queued.
  *
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 interface RejectMessageExceptionInterface extends \Throwable
 {
diff --git a/Transport/Receiver/ReceiverInterface.php b/Transport/Receiver/ReceiverInterface.php
@@ -13,6 +13,8 @@
 
 /**
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 interface ReceiverInterface
 {
diff --git a/Transport/Receiver/StopWhenMemoryUsageIsExceededReceiver.php b/Transport/Receiver/StopWhenMemoryUsageIsExceededReceiver.php
diff --git a/Transport/Receiver/StopWhenMessageCountIsExceededReceiver.php b/Transport/Receiver/StopWhenMessageCountIsExceededReceiver.php
diff --git a/Transport/Receiver/StopWhenTimeLimitIsReachedReceiver.php b/Transport/Receiver/StopWhenTimeLimitIsReachedReceiver.php
diff --git a/Transport/Sender/ChainSender.php b/Transport/Sender/ChainSender.php
diff --git a/Transport/Sender/Locator/AbstractSenderLocator.php b/Transport/Sender/Locator/AbstractSenderLocator.php
diff --git a/Transport/Sender/Locator/ContainerSenderLocator.php b/Transport/Sender/Locator/ContainerSenderLocator.php
diff --git a/Transport/Sender/Locator/SenderLocator.php b/Transport/Sender/Locator/SenderLocator.php
diff --git a/Transport/Sender/Locator/SenderLocatorInterface.php b/Transport/Sender/Locator/SenderLocatorInterface.php
diff --git a/Transport/Sender/SenderInterface.php b/Transport/Sender/SenderInterface.php
diff --git a/Transport/Serialization/Serializer.php b/Transport/Serialization/Serializer.php
diff --git a/Transport/Serialization/SerializerInterface.php b/Transport/Serialization/SerializerInterface.php
diff --git a/Transport/TransportFactory.php b/Transport/TransportFactory.php
diff --git a/Transport/TransportFactoryInterface.php b/Transport/TransportFactoryInterface.php
diff --git a/Transport/TransportInterface.php b/Transport/TransportInterface.php
diff --git a/Worker.php b/Worker.php

Original file line number	Diff line number	Diff line change
`@@ -27,6 +27,8 @@`
`27`	`27`
`28`	`28`	`/**`
`29`	`29`	`* @author Samuel Roze <samuel.roze@gmail.com>`
	`30`	`+ *`
	`31`	`+ * @experimental in 4.2`
`30`	`32`	`*/`
`31`	`33`	`class ConsumeMessagesCommand extends Command`
`32`	`34`	`{`
Original file line number	Diff line number	Diff line change
`@@ -22,6 +22,8 @@`
`22`	`22`	`* A console command to debug Messenger information.`
`23`	`23`	`*`
`24`	`24`	`* @author Roland Franssen <franssen.roland@gmail.com>`
	`25`	`+ *`
	`26`	`+ * @experimental in 4.2`
`25`	`27`	`*/`
`26`	`28`	`class DebugCommand extends Command`
`27`	`29`	`{`
Original file line number	Diff line number	Diff line change
`@@ -20,6 +20,8 @@`
`20`	`20`
`21`	`21`	`/**`
`22`	`22`	`* @author Samuel Roze <samuel.roze@gmail.com>`
	`23`	`+ *`
	`24`	`+ * @experimental in 4.2`
`23`	`25`	`*/`
`24`	`26`	`class MessengerDataCollector extends DataCollector implements LateDataCollectorInterface`
`25`	`27`	`{`
Original file line number	Diff line number	Diff line change
`@@ -29,6 +29,8 @@`
`29`	`29`
`30`	`30`	`/**`
`31`	`31`	`* @author Samuel Roze <samuel.roze@gmail.com>`
	`32`	`+ *`
	`33`	`+ * @experimental in 4.2`
`32`	`34`	`*/`
`33`	`35`	`class MessengerPass implements CompilerPassInterface`
`34`	`36`	`{`
Original file line number	Diff line number	Diff line change
`@@ -17,6 +17,8 @@`
`17`	`17`	`* A message wrapped in an envelope with stamps (configurations, markers, ...).`
`18`	`18`	`*`
`19`	`19`	`* @author Maxime Steinhausser <maxime.steinhausser@gmail.com>`
	`20`	`+ *`
	`21`	`+ * @experimental in 4.2`
`20`	`22`	`*/`
`21`	`23`	`final class Envelope`
`22`	`24`	`{`
Original file line number	Diff line number	Diff line change
`@@ -15,6 +15,8 @@`
`15`	`15`	`* Base Message component's exception.`
`16`	`16`	`*`
`17`	`17`	`* @author Samuel Roze <samuel.roze@gmail.com>`
	`18`	`+ *`
	`19`	`+ * @experimental in 4.2`
`18`	`20`	`*/`
`19`	`21`	`interface ExceptionInterface extends \Throwable`
`20`	`22`	`{`
Original file line number	Diff line number	Diff line change
`@@ -13,6 +13,8 @@`
`13`	`13`
`14`	`14`	`/**`
`15`	`15`	`* @author Yonel Ceruto <yonelceruto@gmail.com>`
	`16`	`+ *`
	`17`	`+ * @experimental in 4.2`
`16`	`18`	`*/`
`17`	`19`	`class InvalidArgumentException extends \InvalidArgumentException implements ExceptionInterface`
`18`	`20`	`{`