v3.3

Changes

• Require cleverage/process-bundle ^5.4.
• Please follow UPGRADE.md v3.3
• #66 The configuration key of the bundle (its extension alias) is cleverage_doctrine_process, instead of clever_age_doctrine_process (no option could be configured there). Configuring a key under cleverage_doctrine_process is deprecated: the bundle has no configuration and the keys were ignored without notice (new internal Configuration, empty; notice when the container is compiled). They will be rejected in 4.0. Require symfony/deprecation-contracts, used directly. Update documentation, add tests.
• #64 The bundle throws exceptions implementing ProcessExceptionInterface of the process bundle instead of raw SPL exceptions (as cleverage/process-bundle#317): new Exception\UnexpectedValueException and Exception\RuntimeException, extending the SPL exceptions thrown before (same messages, the existing catch keep working). Add tests.
• #62 Composer: require PHP ^8.2 instead of >=8.2 (PHP 9 is no longer accepted before being tested), remove the authorization of the symfony/flex plugin, which is not required (the CI installs it globally), as cleverage/process-bundle#319.
• #58 DoctrineReaderTask (order_by option): pass the \SortDirection enum to QueryBuilder::addOrderBy() when doctrine/orm accepts it (3.7 or later, where a string direction is deprecated), the string otherwise (same query). Require psr/log ^2 || ^3: process-bundle does not work with psr/log 1. The tests fail on deprecations and boot a kernel with process-bundle and DoctrineBundle.
• #57 Define the public API (Symfony BC promise, as cleverage/process-bundle#279): the concrete tasks (DatabaseReaderTask, DatabaseUpdaterTask, DoctrineReaderTask, DoctrineWriterTask, DoctrineBatchWriterTask, DoctrineCleanerTask, DoctrineDetacherTask, DoctrineRefresherTask, DoctrineRemoverTask, ClearEntityManagerTask) and CleverAgeDoctrineProcessBundle are marked @final since 3.3, they will be final in 4.0: extending them triggers a deprecation with the Symfony DebugClassLoader. AbstractDoctrineTask and AbstractDoctrineQueryTask stay open. CleverAgeDoctrineProcessExtension is marked @internal.
• #56 CleverAgeDoctrineProcessExtension::findServices() loads the service definition files with a glob pattern instead of a Finder (same files, as cleverage/process-bundle#271), symfony/finder is no longer required. Add tests.
• #54 CleverAgeDoctrineProcessExtension extends Symfony\Component\DependencyInjection\Extension\Extension instead of Symfony\Component\HttpKernel\DependencyInjection\Extension (internal since Symfony 7.1, to be deprecated in 8.1), as the other bundles. Same behaviour: the removed addAnnotatedClassesToCompile() / getAnnotatedClassesToCompile() methods (deprecated since Symfony 7.1, removed in 8.0) were not used.
• #52 Require symfony/polyfill-php83, symfony/polyfill-php84 and symfony/polyfill-php85 (cleverage/process-bundle#299): the functions of PHP 8.3 to 8.5 can be used while supporting PHP 8.2. Rector targets PHP 8.2 (withPhpVersion(), withPhpSets() read from composer.json) and applies the rules using a newer function when its polyfill is required; no rule nor manual replacement applies to the current code.
• #48 Give a code to the tasks (cleverage/process-bundle#91): doctrine_database_reader, doctrine_database_updater, doctrine_clear_entity_manager, doctrine_batch_writer, doctrine_cleaner, doctrine_detacher, doctrine_reader, doctrine_refresher, doctrine_remover and doctrine_writer (task: doctrine_reader, with cleverage/process-bundle 5.4 or later, referencing them by service being deprecated there). The tasks have their class name as service id; fetching them directly from the service container is deprecated (container.private), they will be private in 4.0. The former ids cleverage_doctrine_process.task.* are deprecated aliases, removed in 4.0. Update documentation, add tests.
• #46 Add a .gitattributes: the development files (.docker/, .github/, tests/, quality tools and PHPUnit configurations, Makefile) are no longer part of the archive installed by Composer (dist).
• #43 Clean up composer.json: doctrine/doctrine-migrations-bundle, not used by the bundle, is now only suggested (applications relying on the bundle to install it must require it, as symfony/orm-pack does); require doctrine/dbal, doctrine/persistence and psr/log, used directly.

Fixes

• #42 Fix DatabaseReaderTask, DatabaseUpdaterTask and DoctrineReaderTask: inject the logger service instead of monolog.logger, so that they log on the cleverage_process_task channel of their monolog.logger tag (they logged on the app channel, without the process context, and their logs were missing from the process execution logs of the UI). Add tests.