Created logger bundle

composer.json

@@ -39,8 +39,10 @@
         "psr-4": {
             "RunOpenCode\\Component\\Bitmask\\": "src/RunOpenCode/Component/Bitmask/src/",
             "RunOpenCode\\Component\\Dataset\\": "src/RunOpenCode/Component/Dataset/src/",
+            "RunOpenCode\\Component\\Logger\\": "src/RunOpenCode/Component/Logger/src/",
             "RunOpenCode\\Component\\Metadata\\": "src/RunOpenCode/Component/Metadata/src/",
             "RunOpenCode\\Component\\Query\\": "src/RunOpenCode/Component/Query/src/",
+            "RunOpenCode\\Bundle\\LoggerBundle\\": "src/RunOpenCode/Bundle/LoggerBundle/src/",
             "RunOpenCode\\Bundle\\QueryBundle\\": "src/RunOpenCode/Bundle/QueryBundle/src/",
             "RunOpenCode\\Bundle\\MetadataBundle\\": "src/RunOpenCode/Bundle/MetadataBundle/src/",
             "Monorepo\\": "monorepo/"
@@ -54,8 +56,10 @@
         "psr-4": {
             "RunOpenCode\\Component\\Bitmask\\Tests\\": "src/RunOpenCode/Component/Bitmask/tests/",
             "RunOpenCode\\Component\\Dataset\\Tests\\": "src/RunOpenCode/Component/Dataset/tests/",
+            "RunOpenCode\\Component\\Logger\\Tests\\": "src/RunOpenCode/Component/Logger/tests/",
             "RunOpenCode\\Component\\Metadata\\Tests\\": "src/RunOpenCode/Component/Metadata/tests/",
             "RunOpenCode\\Component\\Query\\Tests\\": "src/RunOpenCode/Component/Query/tests/",
+            "RunOpenCode\\Bundle\\LoggerBundle\\Tests\\": "src/RunOpenCode/Bundle/LoggerBundle/tests/",
             "RunOpenCode\\Bundle\\QueryBundle\\Tests\\": "src/RunOpenCode/Bundle/QueryBundle/tests/",
             "RunOpenCode\\Bundle\\MetadataBundle\\Tests\\": "src/RunOpenCode/Bundle/MetadataBundle/tests/"
         }

docker/php/Dockerfile

@@ -87,10 +87,7 @@ ENV PHP_EXTENSION_DIR=/usr/local/lib/php/extensions/no-debug-non-zts-20240924
 #####################################################################################
 
 RUN composer global config --no-plugins allow-plugins.infection/extension-installer true && \
-    composer global require infection/infection && \
-    composer global require maglnet/composer-require-checker && \
-    composer global require icanhazstring/composer-unused && \
-    composer global require phpmetrics/phpmetrics && \
+    composer global require infection/infection maglnet/composer-require-checker icanhazstring/composer-unused phpmetrics/phpmetrics && \
     export PATH=~/.config/composer/vendor/bin:$PATH
 
 #####################################################################################

docs/source/bundles/index.rst

@@ -14,5 +14,6 @@ Table of Contents
    :maxdepth: 2
    :titlesonly:
 
+   logger-bundle/index
    metadata-bundle/index
 

docs/source/bundles/logger-bundle/index.rst

@@ -0,0 +1,177 @@
+=============
+Logger Bundle
+=============
+
+The Logger Bundle provides seamless integration of the Logger component with 
+the Symfony framework. This bundle automatically configures the Logger as a 
+service and provides configuration options for customizing its behavior.
+
+The Logger component is a decorator for PSR-3 logger implementations that adds
+convenience methods for exception logging and context enrichment. See the
+:doc:`../../components/logger/index` for details about the Logger component
+itself.
+
+Installation
+------------
+
+To use the Logger component in a Symfony application, install the bundle:
+
+.. code-block:: console
+
+    composer require runopencode/logger-bundle
+
+The bundle will be automatically registered in your ``config/bundles.php`` if
+you're using Symfony Flex.
+
+Configuration
+-------------
+
+The bundle provides several configuration options that can be set in your
+``config/packages/runopencode_logger.yaml`` file:
+
+.. code-block:: yaml
+
+    runopencode_logger:
+        debug: '%kernel.debug%'
+        default_log_level: 'error'
+
+Configuration options
+~~~~~~~~~~~~~~~~~~~~~
+
+* ``debug`` (boolean, default: ``false``): Enable debug mode. When enabled, the
+  ``exception()`` method will throw exceptions after logging them. This is
+  useful during development. Typically set to ``%kernel.debug%`` to match
+  Symfony's debug mode.
+
+* ``default_log_level`` (string, default: ``'critical'``): The default log level
+  used for exception logging when no level is explicitly specified. Valid values
+  are: ``emergency``, ``alert``, ``critical``, ``error``, ``warning``,
+  ``notice``, ``info``, ``debug``.
+
+Using the Logger service
+-------------------------
+
+Once the bundle is installed and configured, the Logger service is automatically
+available for dependency injection. Inject it using the interface:
+
+.. code-block:: php
+   :linenos:
+
+   <?php
+
+   declare(strict_types=1);
+
+   namespace App\Service;
+
+   use RunOpenCode\Component\Logger\Contract\LoggerInterface;
+
+   final readonly class UserService
+   {
+       public function __construct(private LoggerInterface $logger)
+       {
+           // noop.
+       }
+
+       public function registerUser(array $userData): User
+       {
+           try {
+               $user = $this->repository->create($userData);
+               $this->mailer->sendWelcomeEmail($user);
+
+               return $user;
+           } catch (\Throwable $exception) {
+               $this->logger->exception(
+                   $exception,
+                   'User registration failed',
+                   ['email' => $userData['email'] ?? 'unknown']
+               );
+               // ...
+           }
+       }
+   }
+
+The Logger is automatically configured with Symfony's default logger (the
+``logger`` service).
+
+Automatic context provider registration
+----------------------------------------
+
+One of the most powerful features of the bundle is automatic registration of
+context providers. Any service that implements ``LoggerContextInterface`` is
+automatically detected and injected into the Logger.
+
+Creating a context provider
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Simply create a service that implements the interface:
+
+.. code-block:: php
+   :linenos:
+
+   <?php
+
+   declare(strict_types=1);
+
+   namespace App\Logger\Context;
+
+   use RunOpenCode\Component\Logger\Contract\LoggerContextInterface;
+   use Symfony\Component\HttpFoundation\RequestStack;
+
+   final readonly class RequestContextProvider implements LoggerContextInterface
+   {
+       public function __construct(private RequestStack $requestStack)
+       {
+           // noop.
+       }
+
+       public function get(array $current): array
+       {
+           $request = $this->requestStack->getCurrentRequest();
+
+           if (null === $request) {
+               return [];
+           }
+
+           return [
+               'request_id' => $request->headers->get('X-Request-ID') ?? uniqid(),
+               'request_uri' => $request->getRequestUri(),
+               'request_method' => $request->getMethod(),
+               'user_agent' => $request->headers->get('User-Agent'),
+           ];
+       }
+   }
+
+If you have services autoconfiguration enabled (which is the default in Symfony),
+this service will be automatically registered and tagged with
+``runopencode.logger.context_provider``. No additional configuration is needed!
+
+Manual registration
+~~~~~~~~~~~~~~~~~~~
+
+If you're not using autoconfiguration or want to explicitly register a context
+provider, you can do so in your services configuration:
+
+.. code-block:: yaml
+
+    services:
+        App\Logger\Context\RequestContextProvider:
+            tags:
+                - { name: 'runopencode.logger.context_provider' }
+
+Best practices
+--------------
+
+1. **Use the interface**: Always inject ``LoggerInterface`` from the Logger
+   component, not the concrete ``Logger`` class or PSR-3's ``LoggerInterface``.
+
+2. **Configure per environment**: Use different configuration files for dev,
+   test, and prod environments to adjust debug mode and log levels.
+
+3. **Create focused context providers**: Each context provider should have a
+   single responsibility (e.g., one for request data, one for user data, etc.).
+
+4. **Keep providers lightweight**: Context providers are called on every log
+   entry, so avoid expensive operations.
+
+See the :doc:`../../components/logger/context-providers` documentation for more 
+information about creating and using context providers.

docs/source/components/dataset/index.rst

@@ -7,6 +7,22 @@ collections in a functional(ish), declarative way. In some aspects, it is also
 inspired by `ReactiveX`_, but with a much simpler approach and far fewer 
 features.
 
+Table of Contents
+-----------------
+
+.. toctree::
+   :maxdepth: 1
+
+   installation
+   concepts
+   stream/index
+   operators/index
+   reducers/index
+   collectors/index
+
+Introduction
+------------
+
 If your problem can be described as:
 
    I have a data stream from some source (file, database query result, etc.), 
@@ -43,19 +59,6 @@ Features
   and reduce (aggregate) values simultaneously without interrupting the data 
   stream.
 
-Table of Contents
------------------
-
-.. toctree::
-   :maxdepth: 1
-
-   installation
-   concepts
-   stream/index
-   operators/index
-   reducers/index
-   collectors/index
-
 
 Quick example
 -------------

docs/source/components/dataset/operators/list/index.rst

@@ -2,66 +2,56 @@
 Available operators
 ===================
 
+Transformation operators
+------------------------
+
 .. toctree::
    :maxdepth: 1
-   :hidden:
 
    buffer_count
    buffer_while
-   distinct
-   filter
-   finalize
    flatten
-   if_empty
    left_join
    map
    merge
-   overflow
    reverse
-   skip
    sort
-   take
-   take_until
-   tap
-
-Transformation operators
-------------------------
-
-* ``bufferCount()`` 
-* ``bufferWhile()``
-* ``flatten()``
-* ``map()``
-* ``merge()``
-* ``reverse()``
-* ``sort()``
 
 Filtering operators
 -------------------
 
-* ``distinct()``
-* ``filter()``
-* ``skip()``
-* ``take()``
-* ``takeUntil()``
+.. toctree::
+   :maxdepth: 1
+
+   distinct
+   filter
+   skip
+   take
+   takeUntil
 
 Asserting operators
 -------------------
 
-* ``ifEmpty()``
-* ``overflow()``
+.. toctree::
+   :maxdepth: 1
+
+   if_empty
+   overflow
 
 Error handling operators
 ------------------------
 
-* ``finalize()``
-
-Aggregate operators
--------------------
-
-* ``reduce()``
+.. toctree::
+   :maxdepth: 1
+
+   finalize
 
 Utility operators
 -----------------
 
-* ``tap()``
+.. toctree::
+   :maxdepth: 1
+
+   tap
+