From: Joe Nahmias <jello@debian.org>
Date: Sun, 31 Aug 2025 10:44:40 -0400
Subject: convert doc-comments metadata annotations to PHP attributes

 - data providers
 - coverage

Provides future compatibility with PHPUnit 12
---

diff --git a/tests/Base32HexTest.php b/tests/Base32HexTest.php
index b97762f..7f4d1cd 100644
--- a/tests/Base32HexTest.php
+++ b/tests/Base32HexTest.php
@@ -6,10 +6,9 @@ namespace Base32\Tests;
 
 use Base32\Base32Hex;
 use PHPUnit\Framework\TestCase;
+use PHPUnit\Framework\Attributes\DataProvider;
 
-/**
- * @coversDefaultClass \Base32\Base32Hex
- */
+#[CoversClass(Base32\Base32Hex)]
 class Base32HexTest extends TestCase
 {
     /**
@@ -63,29 +62,23 @@ class Base32HexTest extends TestCase
         return Base32Test::BASE_CLEAR_STRINGS;
     }
 
-    /**
-     * @dataProvider decodeDataProvider
-     * @covers ::decode
-     */
+    #[CoversMethod(Base32::decode)]
+    #[DataProvider('decodeDataProvider')]
     public function testDecode(string $clear, string $base32): void
     {
         $this->assertEquals($clear, Base32Hex::decode($base32));
     }
 
-    /**
-     * @dataProvider encodeDataProvider
-     * @covers ::encode
-     */
+    #[CoversMethod(Base32::encode)]
+    #[DataProvider('encodeDataProvider')]
     public function testEncode(string $clear, string $base32): void
     {
         $this->assertEquals($base32, Base32Hex::encode($clear));
     }
 
-    /**
-     * @dataProvider backAndForthDataProvider
-     * @covers ::encode
-     * @covers ::decode
-     */
+    #[CoversMethod(Base32::decode)]
+    #[CoversMethod(Base32::encode)]
+    #[DataProvider('backAndForthDataProvider')]
     public function testEncodeAndDecode(string $clear): void
     {
         // Encoding then decoding again, to ensure that the back and forth works as intended
diff --git a/tests/Base32Test.php b/tests/Base32Test.php
index ac1de5c..0537a01 100644
--- a/tests/Base32Test.php
+++ b/tests/Base32Test.php
@@ -6,10 +6,9 @@ namespace Base32\Tests;
 
 use Base32\Base32;
 use PHPUnit\Framework\TestCase;
+use PHPUnit\Framework\Attributes\DataProvider;
 
-/**
- * @coversDefaultClass \Base32\Base32
- */
+#[CoversClass(Base32\Base32Hex)]
 class Base32Test extends TestCase
 {
     /**
@@ -81,29 +80,23 @@ class Base32Test extends TestCase
         return self::BASE_CLEAR_STRINGS;
     }
 
-    /**
-     * @dataProvider decodeDataProvider
-     * @covers ::decode
-     */
+    #[CoversMethod(Base32::decode)]
+    #[DataProvider('decodeDataProvider')]
     public function testDecode(string $clear, string $base32): void
     {
         $this->assertEquals($clear, Base32::decode($base32));
     }
 
-    /**
-     * @dataProvider encodeDataProvider
-     * @covers ::encode
-     */
+    #[CoversMethod(Base32::encode)]
+    #[DataProvider('encodeDataProvider')]
     public function testEncode(string $clear, string $base32): void
     {
         $this->assertEquals($base32, Base32::encode($clear));
     }
 
-    /**
-     * @dataProvider backAndForthDataProvider
-     * @covers ::encode
-     * @covers ::decode
-     */
+    #[CoversMethod(Base32::decode)]
+    #[CoversMethod(Base32::encode)]
+    #[DataProvider('backAndForthDataProvider')]
     public function testEncodeAndDecode(string $clear): void
     {
         // Encoding then decoding again, to ensure that the back and forth works as intended