replace doctrine annotation by php attribute for PHPUnit

Author: WengerK

CHANGELOG.md

@@ -10,6 +10,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 - add required #\[RunTestsInSeparateProcesses] attribute on Kernel, Functional and FunctionalJavascript tests
+- replace doctrine annotation by php attribute for PHPUnit
 
 ## [6.0.6] - 2026-01-26
 ### Added

tests/src/Functional/BambooTwigCacheableTest.php

@@ -2,12 +2,17 @@
 
 namespace Drupal\Tests\bamboo_twig\Functional;
 
+use Drupal\bamboo_twig_cacheable\TwigExtension\BubbleMetadata;
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\Attributes\CoversMethod;
 use PHPUnit\Framework\Attributes\Group;
 use PHPUnit\Framework\Attributes\RunTestsInSeparateProcesses;
 
 /**
  * Tests Cacheable twig filters and functions.
  */
+#[CoversClass(BubbleMetadata::class)]
+#[CoversMethod(BubbleMetadata::class, 'attachCacheableMetadata')]
 #[Group('bamboo_twig')]
 #[Group('bamboo_twig_functional')]
 #[Group('bamboo_twig_cacheable')]
@@ -25,7 +30,7 @@ class BambooTwigCacheableTest extends BambooTwigTestBase {
   ];
 
   /**
-   * @covers Drupal\bamboo_twig_cacheable\TwigExtension\BubbleMetadata::attachCacheableMetadata
+   * Tests attachCacheableMetadata() propagates cache contexts to the response.
    */
   public function testCacheableContexts() {
     $this->drupalGet('/bamboo-twig-cacheable');
@@ -35,7 +40,7 @@ public function testCacheableContexts() {
   }
 
   /**
-   * @covers Drupal\bamboo_twig_cacheable\TwigExtension\BubbleMetadata::attachCacheableMetadata
+   * Tests attachCacheableMetadata() propagates cache tags to the response.
    */
   public function testCacheableTags() {
     $this->drupalGet('/bamboo-twig-cacheable');
@@ -45,7 +50,7 @@ public function testCacheableTags() {
   }
 
   /**
-   * @covers Drupal\bamboo_twig_cacheable\TwigExtension\BubbleMetadata::attachCacheableMetadata
+   * Tests attachCacheableMetadata() propagates max-age to the response.
    */
   public function testCacheableMaxAge() {
     $this->drupalGet('/bamboo-twig-cacheable');

tests/src/Functional/BambooTwigConfigTest.php

@@ -2,15 +2,22 @@
 
 namespace Drupal\Tests\bamboo_twig\Functional;
 
+use Drupal\bamboo_twig_config\TwigExtension\Config;
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\Attributes\CoversMethod;
+use PHPUnit\Framework\Attributes\Group;
 use PHPUnit\Framework\Attributes\RunTestsInSeparateProcesses;
 
 /**
  * Tests Config twig filters and functions.
- *
- * @group bamboo_twig
- * @group bamboo_twig_functional
- * @group bamboo_twig_config
  */
+#[CoversClass(Config::class)]
+#[CoversMethod(Config::class, 'getSettings')]
+#[CoversMethod(Config::class, 'getConfig')]
+#[CoversMethod(Config::class, 'getState')]
+#[Group('bamboo_twig')]
+#[Group('bamboo_twig_functional')]
+#[Group('bamboo_twig_config')]
 #[RunTestsInSeparateProcesses]
 class BambooTwigConfigTest extends BambooTwigTestBase {
 
@@ -42,7 +49,7 @@ public function setUp(): void {
   }
 
   /**
-   * @covers Drupal\bamboo_twig_config\TwigExtension\Config::getSettings
+   * Tests getSettings() exposes PHP settings values in templates.
    */
   public function testGetSettings() {
     $this->drupalGet('/bamboo-twig-config');
@@ -52,7 +59,7 @@ public function testGetSettings() {
   }
 
   /**
-   * @covers Drupal\bamboo_twig_config\TwigExtension\Config::getConfig
+   * Tests getConfig() exposes Drupal configuration values in templates.
    */
   public function testGetConfig() {
     $this->drupalGet('/bamboo-twig-config');
@@ -62,7 +69,7 @@ public function testGetConfig() {
   }
 
   /**
-   * @covers Drupal\bamboo_twig_config\TwigExtension\Config::getState
+   * Tests getState() exposes Drupal state values in templates.
    */
   public function testGetState() {
     $now = time();

tests/src/Functional/BambooTwigExtensionsI18nTest.php

@@ -4,16 +4,16 @@
 
 use Drupal\Component\Gettext\PoItem;
 use Drupal\language\Entity\ConfigurableLanguage;
+use PHPUnit\Framework\Attributes\Group;
 use PHPUnit\Framework\Attributes\RunTestsInSeparateProcesses;
 
 /**
  * Tests Extensions i18n of twig filters and functions.
- *
- * @group bamboo_twig
- * @group bamboo_twig_functional
- * @group bamboo_twig_extensions
- * @group bamboo_twig_extensions_i18n
  */
+#[Group('bamboo_twig')]
+#[Group('bamboo_twig_functional')]
+#[Group('bamboo_twig_extensions')]
+#[Group('bamboo_twig_extensions_i18n')]
 #[RunTestsInSeparateProcesses]
 class BambooTwigExtensionsI18nTest extends BambooTwigTestBase {
 

tests/src/Functional/BambooTwigExtensionsTest.php

@@ -2,15 +2,15 @@
 
 namespace Drupal\Tests\bamboo_twig\Functional;
 
+use PHPUnit\Framework\Attributes\Group;
 use PHPUnit\Framework\Attributes\RunTestsInSeparateProcesses;
 
 /**
  * Tests Extensions twig filters and functions.
- *
- * @group bamboo_twig
- * @group bamboo_twig_functional
- * @group bamboo_twig_extensions
  */
+#[Group('bamboo_twig')]
+#[Group('bamboo_twig_functional')]
+#[Group('bamboo_twig_extensions')]
 #[RunTestsInSeparateProcesses]
 class BambooTwigExtensionsTest extends BambooTwigTestBase {
 

tests/src/Functional/BambooTwigFileTest.php

@@ -2,15 +2,21 @@
 
 namespace Drupal\Tests\bamboo_twig\Functional;
 
+use Drupal\bamboo_twig_file\TwigExtension\File;
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\Attributes\CoversMethod;
+use PHPUnit\Framework\Attributes\Group;
 use PHPUnit\Framework\Attributes\RunTestsInSeparateProcesses;
 
 /**
  * Tests File twig filters and functions.
- *
- * @group bamboo_twig
- * @group bamboo_twig_functional
- * @group bamboo_twig_file
  */
+#[CoversClass(File::class)]
+#[CoversMethod(File::class, 'extensionGuesser')]
+#[CoversMethod(File::class, 'UrlAbsolute')]
+#[Group('bamboo_twig')]
+#[Group('bamboo_twig_functional')]
+#[Group('bamboo_twig_file')]
 #[RunTestsInSeparateProcesses]
 class BambooTwigFileTest extends BambooTwigTestBase {
 
@@ -25,7 +31,7 @@ class BambooTwigFileTest extends BambooTwigTestBase {
   ];
 
   /**
-   * @covers Drupal\bamboo_twig_file\TwigExtension\File::extensionGuesser
+   * Tests extensionGuesser() returns the correct extension for various files.
    */
   public function testExtensionGuesser() {
     $this->drupalGet('/bamboo-twig-file');
@@ -44,7 +50,7 @@ public function testExtensionGuesser() {
   }
 
   /**
-   * @covers Drupal\bamboo_twig_file\TwigExtension\File::UrlAbsolute
+   * Tests UrlAbsolute() returns relative and absolute file URLs.
    */
   public function testUrlAbsolute() {
     $this->drupalGet('/bamboo-twig-file');

tests/src/Functional/BambooTwigI18nTest.php

@@ -2,15 +2,25 @@
 
 namespace Drupal\Tests\bamboo_twig\Functional;
 
+use Drupal\bamboo_twig_i18n\TwigExtension\I18n;
+use Drupal\bamboo_twig_loader\TwigExtension\Loader;
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\Attributes\CoversMethod;
+use PHPUnit\Framework\Attributes\Group;
 use PHPUnit\Framework\Attributes\RunTestsInSeparateProcesses;
 
 /**
  * Tests I18n twig filters and functions.
- *
- * @group bamboo_twig
- * @group bamboo_twig_functional
- * @group bamboo_twig_i18n
  */
+#[CoversClass(I18n::class)]
+#[CoversClass(Loader::class)]
+#[CoversMethod(I18n::class, 'getCurrentLanguage')]
+#[CoversMethod(I18n::class, 'formatDate')]
+#[CoversMethod(I18n::class, 'getTranslation')]
+#[CoversMethod(Loader::class, 'loadEntity')]
+#[Group('bamboo_twig')]
+#[Group('bamboo_twig_functional')]
+#[Group('bamboo_twig_i18n')]
 #[RunTestsInSeparateProcesses]
 class BambooTwigI18nTest extends BambooTwigTestBase {
 
@@ -87,7 +97,7 @@ protected function setUpTranslations() {
   }
 
   /**
-   * @covers Drupal\bamboo_twig_i18n\TwigExtension\I18n::getCurrentLanguage
+   * Tests getCurrentLanguage() returns the active language code.
    */
   public function testCurrentLang() {
     $this->drupalGet('/bamboo-twig-i18n');
@@ -100,7 +110,7 @@ public function testCurrentLang() {
   }
 
   /**
-   * @covers Drupal\bamboo_twig_i18n\TwigExtension\I18n::formatDate
+   * Tests formatDate() formats dates with locale-aware translations.
    */
   public function testFormatDate() {
     $this->drupalGet('/bamboo-twig-i18n');
@@ -145,7 +155,7 @@ public function testFormatDate() {
   }
 
   /**
-   * @covers Drupal\bamboo_twig_i18n\TwigExtension\I18n::getTranslation
+   * Tests getTranslation() returns the entity in the requested language.
    */
   public function testGetTranslation() {
     $this->drupalGet('/bamboo-twig-i18n');
@@ -187,8 +197,7 @@ public function testGetTranslation() {
   }
 
   /**
-   * @covers Drupal\bamboo_twig_i18n\TwigExtension\I18n::getTranslation
-   * @covers Drupal\bamboo_twig_loader\TwigExtension\Loader::loadEntity
+   * Tests getTranslation() with loadEntity() on entity reference fields.
    */
   public function testGetTranslationReferencedField() {
     $this->drupalGet('/bamboo-twig-i18n');

tests/src/Functional/BambooTwigLoaderTest.php

@@ -2,18 +2,27 @@
 
 namespace Drupal\Tests\bamboo_twig\Functional;
 
+use Drupal\bamboo_twig_loader\TwigExtension\Loader;
 use Drupal\Core\StreamWrapper\PublicStream;
 use Drupal\file\FileInterface;
 use Drupal\Tests\taxonomy\Traits\TaxonomyTestTrait;
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\Attributes\CoversMethod;
+use PHPUnit\Framework\Attributes\Group;
 use PHPUnit\Framework\Attributes\RunTestsInSeparateProcesses;
 
 /**
  * Tests Loaders twig filters and functions.
- *
- * @group bamboo_twig
- * @group bamboo_twig_functional
- * @group bamboo_twig_loader
  */
+#[CoversClass(Loader::class)]
+#[CoversMethod(Loader::class, 'loadCurrentUser')]
+#[CoversMethod(Loader::class, 'loadEntity')]
+#[CoversMethod(Loader::class, 'loadEntityRevision')]
+#[CoversMethod(Loader::class, 'loadField')]
+#[CoversMethod(Loader::class, 'loadImage')]
+#[Group('bamboo_twig')]
+#[Group('bamboo_twig_functional')]
+#[Group('bamboo_twig_loader')]
 #[RunTestsInSeparateProcesses]
 class BambooTwigLoaderTest extends BambooTwigTestBase {
   use TaxonomyTestTrait;
@@ -98,7 +107,7 @@ public function setUp(): void {
   }
 
   /**
-   * @covers Drupal\bamboo_twig_loader\TwigExtension\Loader::loadCurrentUser
+   * Tests loadCurrentUser() loads the current user in templates.
    */
   public function testCurrentUser() {
     $this->drupalGet('/bamboo-twig-loader');
@@ -114,7 +123,7 @@ public function testCurrentUser() {
   }
 
   /**
-   * @covers Drupal\bamboo_twig_loader\TwigExtension\Loader::loadEntity
+   * Tests loadEntity() loads nodes, taxonomy terms, files, and users.
    */
   public function testEntity() {
     $this->drupalGet('/bamboo-twig-loader');
@@ -222,7 +231,7 @@ public function testEntity() {
   }
 
   /**
-   * @covers Drupal\bamboo_twig_loader\TwigExtension\Loader::loadEntityRevision
+   * Tests loadEntityRevision() loads specific revisions of entities.
    */
   public function testEntityRevision() {
     $this->drupalGet('/bamboo-twig-loader-revision');
@@ -252,8 +261,7 @@ public function testEntityRevision() {
   }
 
   /**
-   * @covers Drupal\bamboo_twig_loader\TwigExtension\Loader::loadEntity
-   * @covers Drupal\bamboo_twig_loader\TwigExtension\Loader::loadEntityRevision
+   * Tests loadEntity() and loadEntityRevision() load entities from route.
    */
   public function testEntityFromRoutes() {
     // Accessing unpublished revision page required to be authenticated.
@@ -287,7 +295,7 @@ public function testEntityFromRoutes() {
   }
 
   /**
-   * @covers Drupal\bamboo_twig_loader\TwigExtension\Loader::loadField
+   * Tests loadField() loads individual field values from entities.
    */
   public function testField() {
     $this->drupalGet('/bamboo-twig-loader');
@@ -391,7 +399,7 @@ public function testField() {
   }
 
   /**
-   * @covers Drupal\bamboo_twig_loader\TwigExtension\Loader::loadImage
+   * Tests loadImage() loads an image by URI and by module path.
    */
   public function testImage() {
     $this->drupalGet('/bamboo-twig-loader');

tests/src/Functional/BambooTwigPathTest.php

@@ -2,15 +2,20 @@
 
 namespace Drupal\Tests\bamboo_twig\Functional;
 
+use Drupal\bamboo_twig_path\TwigExtension\Path;
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\Attributes\CoversMethod;
+use PHPUnit\Framework\Attributes\Group;
 use PHPUnit\Framework\Attributes\RunTestsInSeparateProcesses;
 
 /**
  * Tests Path twig filters and functions.
- *
- * @group bamboo_twig
- * @group bamboo_twig_functional
- * @group bamboo_twig_path
  */
+#[CoversClass(Path::class)]
+#[CoversMethod(Path::class, 'getSystemPath')]
+#[Group('bamboo_twig')]
+#[Group('bamboo_twig_functional')]
+#[Group('bamboo_twig_path')]
 #[RunTestsInSeparateProcesses]
 class BambooTwigPathTest extends BambooTwigTestBase {
 
@@ -24,7 +29,7 @@ class BambooTwigPathTest extends BambooTwigTestBase {
   ];
 
   /**
-   * @covers Drupal\bamboo_twig_path\TwigExtension\Path::getSystemPath
+   * Tests getSystemPath() resolves theme, profile, and module paths.
    */
   public function testPathSystem() {
     $this->drupalGet('/bamboo-twig-path');