From 46793540d3fda564a29ab26a7da8cd6406bfc4da Mon Sep 17 00:00:00 2001
From: Rodrigo Primo <rodrigosprimo@gmail.com>
Date: Thu, 4 Dec 2025 16:12:26 -0300
Subject: [PATCH 1/2] FormattingFunctionsHelper::is_formatting_function(): add
 tests

---
 .../IsFormattingFunctionUnitTest.php          | 63 +++++++++++++++++++
 1 file changed, 63 insertions(+)
 create mode 100644 WordPress/Tests/Helpers/FormattingFunctionsHelper/IsFormattingFunctionUnitTest.php

diff --git a/WordPress/Tests/Helpers/FormattingFunctionsHelper/IsFormattingFunctionUnitTest.php b/WordPress/Tests/Helpers/FormattingFunctionsHelper/IsFormattingFunctionUnitTest.php
new file mode 100644
index 0000000000..d1ea2a910a
--- /dev/null
+++ b/WordPress/Tests/Helpers/FormattingFunctionsHelper/IsFormattingFunctionUnitTest.php
@@ -0,0 +1,63 @@
+<?php
+/**
+ * WordPress Coding Standard.
+ *
+ * @package WPCS\WordPressCodingStandards
+ * @link    https://github.com/WordPress/WordPress-Coding-Standards
+ * @license https://opensource.org/licenses/MIT MIT
+ */
+
+namespace WordPressCS\WordPress\Tests\Helpers\FormattingFunctionsHelper;
+
+use PHPUnit\Framework\TestCase;
+use WordPressCS\WordPress\Helpers\FormattingFunctionsHelper;
+
+/**
+ * Tests for the `FormattingFunctionsHelper::is_formatting_function()` method.
+ *
+ * @since 3.4.0
+ *
+ * @covers \WordPressCS\WordPress\Helpers\FormattingFunctionsHelper::is_formatting_function()
+ */
+final class IsFormattingFunctionUnitTest extends TestCase {
+
+	/**
+	 * Test is_formatting_function().
+	 *
+	 * @dataProvider dataIsFormattingFunction
+	 *
+	 * @param string $functionName   The function name to test.
+	 * @param bool   $expectedResult The expected return value.
+	 *
+	 * @return void
+	 */
+	public function testIsFormattingFunction( $functionName, $expectedResult ) {
+		$this->assertSame(
+			$expectedResult,
+			FormattingFunctionsHelper::is_formatting_function( $functionName )
+		);
+	}
+
+	/**
+	 * Data provider.
+	 *
+	 * @return array<string, array<string, bool|string>>
+	 * @see testIsFormattingFunction()
+	 */
+	public static function dataIsFormattingFunction() {
+		return array(
+			'lowercase_name'            => array(
+				'functionName'   => 'sprintf',
+				'expectedResult' => true,
+			),
+			'mixedcase_name'            => array(
+				'functionName'   => 'iMpLoDe',
+				'expectedResult' => true,
+			),
+			'not_a_formatting_function' => array(
+				'functionName'   => 'printf',
+				'expectedResult' => false,
+			),
+		);
+	}
+}

From 93935e4e6e9e85378d30971507266cb022114b44 Mon Sep 17 00:00:00 2001
From: Rodrigo Primo <rodrigosprimo@gmail.com>
Date: Thu, 2 Apr 2026 09:38:08 +0000
Subject: [PATCH 2/2] Fix docblock tag issues

Remove trailing `()` from the `@covers` tag and reorder `@see` to come
before `@return`.
---
 .../IsFormattingFunctionUnitTest.php                         | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/WordPress/Tests/Helpers/FormattingFunctionsHelper/IsFormattingFunctionUnitTest.php b/WordPress/Tests/Helpers/FormattingFunctionsHelper/IsFormattingFunctionUnitTest.php
index d1ea2a910a..e567d0f7c3 100644
--- a/WordPress/Tests/Helpers/FormattingFunctionsHelper/IsFormattingFunctionUnitTest.php
+++ b/WordPress/Tests/Helpers/FormattingFunctionsHelper/IsFormattingFunctionUnitTest.php
@@ -17,7 +17,7 @@
  *
  * @since 3.4.0
  *
- * @covers \WordPressCS\WordPress\Helpers\FormattingFunctionsHelper::is_formatting_function()
+ * @covers \WordPressCS\WordPress\Helpers\FormattingFunctionsHelper::is_formatting_function
  */
 final class IsFormattingFunctionUnitTest extends TestCase {
 
@@ -41,8 +41,9 @@ public function testIsFormattingFunction( $functionName, $expectedResult ) {
 	/**
 	 * Data provider.
 	 *
-	 * @return array<string, array<string, bool|string>>
 	 * @see testIsFormattingFunction()
+	 *
+	 * @return array<string, array<string, bool|string>>
 	 */
 	public static function dataIsFormattingFunction() {
 		return array(