From 151fd4846fa9928c8940b9736fe2433afba663c3 Mon Sep 17 00:00:00 2001
From: VasilevNStas <ctac@outlook.com>
Date: Mon, 10 Aug 2026 17:07:34 +0300
Subject: [PATCH] feat(#553): add test-word lint

---
 .../org/eolang/lints/tests/test-word.xsl      | 38 +++++++++++++++++++
 .../org/eolang/motives/tests/test-word.md     | 26 +++++++++++++
 .../test-word/allows-clean-test-names.yaml    | 16 ++++++++
 .../allows-test-word-in-regular-object.yaml   | 14 +++++++
 .../catches-test-in-nested-object.yaml        | 17 +++++++++
 .../catches-test-in-test-object.yaml          | 17 +++++++++
 .../catches-test-word-in-helper.yaml          | 17 +++++++++
 7 files changed, 145 insertions(+)
 create mode 100644 src/main/resources/org/eolang/lints/tests/test-word.xsl
 create mode 100644 src/main/resources/org/eolang/motives/tests/test-word.md
 create mode 100644 src/test/resources/org/eolang/lints/packs/single/test-word/allows-clean-test-names.yaml
 create mode 100644 src/test/resources/org/eolang/lints/packs/single/test-word/allows-test-word-in-regular-object.yaml
 create mode 100644 src/test/resources/org/eolang/lints/packs/single/test-word/catches-test-in-nested-object.yaml
 create mode 100644 src/test/resources/org/eolang/lints/packs/single/test-word/catches-test-in-test-object.yaml
 create mode 100644 src/test/resources/org/eolang/lints/packs/single/test-word/catches-test-word-in-helper.yaml

diff --git a/src/main/resources/org/eolang/lints/tests/test-word.xsl b/src/main/resources/org/eolang/lints/tests/test-word.xsl
new file mode 100644
index 000000000..80dd521d1
--- /dev/null
+++ b/src/main/resources/org/eolang/lints/tests/test-word.xsl
@@ -0,0 +1,38 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+* SPDX-FileCopyrightText: Copyright (c) 2016-2026 Objectionary.com
+* SPDX-License-Identifier: MIT
+-->
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:eo="https://www.eolang.org" id="test-word" version="2.0">
+  <xsl:import href="/org/eolang/funcs/lineno.xsl"/>
+  <xsl:import href="/org/eolang/funcs/escape.xsl"/>
+  <xsl:import href="/org/eolang/funcs/test-name.xsl"/>
+  <xsl:import href="/org/eolang/funcs/defect-context.xsl"/>
+  <xsl:output encoding="UTF-8" method="xml"/>
+  <xsl:template match="/">
+    <defects>
+      <xsl:variable name="top" select="/object/o[1]"/>
+      <xsl:for-each select="//o[@name and not(@name='φ') and matches(@name, 'test', 'i') and not(generate-id() = generate-id($top))]">
+        <xsl:if test="eo:test-name(@name) or ancestor::o[eo:test-name(@name)] or matches($top/@name, '-tests$')">
+          <xsl:element name="defect">
+            <xsl:variable name="line" select="eo:lineno(@line)"/>
+            <xsl:attribute name="line">
+              <xsl:value-of select="$line"/>
+            </xsl:attribute>
+            <xsl:if test="$line = '0'">
+              <xsl:attribute name="context">
+                <xsl:value-of select="eo:defect-context(.)"/>
+              </xsl:attribute>
+            </xsl:if>
+            <xsl:attribute name="severity">
+              <xsl:text>warning</xsl:text>
+            </xsl:attribute>
+            <xsl:text>The name of the object </xsl:text>
+            <xsl:value-of select="eo:escape(@name)"/>
+            <xsl:text> must not contain the word 'test'</xsl:text>
+          </xsl:element>
+        </xsl:if>
+      </xsl:for-each>
+    </defects>
+  </xsl:template>
+</xsl:stylesheet>
diff --git a/src/main/resources/org/eolang/motives/tests/test-word.md b/src/main/resources/org/eolang/motives/tests/test-word.md
new file mode 100644
index 000000000..b32615a0c
--- /dev/null
+++ b/src/main/resources/org/eolang/motives/tests/test-word.md
@@ -0,0 +1,26 @@
+# Test word
+
+Names of objects in test files must not contain the word 'test'. If an object
+is a unit test, or a helper inside a unit test, or lives in a file whose top
+object name ends with `-tests`, its name should describe the behavior it
+verifies instead of repeating the word 'test'.
+
+Incorrect:
+
+```eo
+# Tests for foo.
+[] > foo-tests
+  # Test.
+  [] +> can-test-add
+    42 > @
+```
+
+Correct:
+
+```eo
+# Tests for foo.
+[] > foo-tests
+  # Test.
+  [] +> can-add-two-and-two
+    42 > @
+```
diff --git a/src/test/resources/org/eolang/lints/packs/single/test-word/allows-clean-test-names.yaml b/src/test/resources/org/eolang/lints/packs/single/test-word/allows-clean-test-names.yaml
new file mode 100644
index 000000000..f49e87597
--- /dev/null
+++ b/src/test/resources/org/eolang/lints/packs/single/test-word/allows-clean-test-names.yaml
@@ -0,0 +1,16 @@
+# SPDX-FileCopyrightText: Copyright (c) 2016-2026 Objectionary.com
+# SPDX-License-Identifier: MIT
+---
+sheets:
+  - /org/eolang/lints/tests/test-word.xsl
+asserts:
+  - /defects[count(defect[@severity='warning'])=0]
+ignore-schema: true
+document: |
+  <object author="tests">
+    <o line="1" name="foo-tests" pos="0">
+      <o line="3" name="+can-add" pos="2">
+        <o base="Q.number" line="4" name="φ" pos="4"/>
+      </o>
+    </o>
+  </object>
diff --git a/src/test/resources/org/eolang/lints/packs/single/test-word/allows-test-word-in-regular-object.yaml b/src/test/resources/org/eolang/lints/packs/single/test-word/allows-test-word-in-regular-object.yaml
new file mode 100644
index 000000000..66a182bc1
--- /dev/null
+++ b/src/test/resources/org/eolang/lints/packs/single/test-word/allows-test-word-in-regular-object.yaml
@@ -0,0 +1,14 @@
+# SPDX-FileCopyrightText: Copyright (c) 2016-2026 Objectionary.com
+# SPDX-License-Identifier: MIT
+---
+sheets:
+  - /org/eolang/lints/tests/test-word.xsl
+asserts:
+  - /defects[count(defect[@severity='warning'])=0]
+ignore-schema: true
+document: |
+  <object author="tests">
+    <o line="1" name="app" pos="0">
+      <o base="Q.org.testing" line="3" name="testing-helper" pos="2"/>
+    </o>
+  </object>
diff --git a/src/test/resources/org/eolang/lints/packs/single/test-word/catches-test-in-nested-object.yaml b/src/test/resources/org/eolang/lints/packs/single/test-word/catches-test-in-nested-object.yaml
new file mode 100644
index 000000000..320ad5127
--- /dev/null
+++ b/src/test/resources/org/eolang/lints/packs/single/test-word/catches-test-in-nested-object.yaml
@@ -0,0 +1,17 @@
+# SPDX-FileCopyrightText: Copyright (c) 2016-2026 Objectionary.com
+# SPDX-License-Identifier: MIT
+---
+sheets:
+  - /org/eolang/lints/tests/test-word.xsl
+asserts:
+  - /defects[count(defect[@severity='warning'])=1]
+  - /defects/defect[@line='5']
+ignore-schema: true
+document: |
+  <object author="tests">
+    <o line="1" name="foo-tests" pos="0">
+      <o line="3" name="+can-setup" pos="2">
+        <o base="Q.number" line="5" name="tests-helper" pos="4"/>
+      </o>
+    </o>
+  </object>
diff --git a/src/test/resources/org/eolang/lints/packs/single/test-word/catches-test-in-test-object.yaml b/src/test/resources/org/eolang/lints/packs/single/test-word/catches-test-in-test-object.yaml
new file mode 100644
index 000000000..30947499e
--- /dev/null
+++ b/src/test/resources/org/eolang/lints/packs/single/test-word/catches-test-in-test-object.yaml
@@ -0,0 +1,17 @@
+# SPDX-FileCopyrightText: Copyright (c) 2016-2026 Objectionary.com
+# SPDX-License-Identifier: MIT
+---
+sheets:
+  - /org/eolang/lints/tests/test-word.xsl
+asserts:
+  - /defects[count(defect[@severity='warning'])=1]
+  - /defects/defect[@line='3']
+ignore-schema: true
+document: |
+  <object author="tests">
+    <o line="1" name="foo-tests" pos="0">
+      <o line="3" name="+can-test-add" pos="2">
+        <o base="Q.number" line="4" name="φ" pos="4"/>
+      </o>
+    </o>
+  </object>
diff --git a/src/test/resources/org/eolang/lints/packs/single/test-word/catches-test-word-in-helper.yaml b/src/test/resources/org/eolang/lints/packs/single/test-word/catches-test-word-in-helper.yaml
new file mode 100644
index 000000000..e3c84dc46
--- /dev/null
+++ b/src/test/resources/org/eolang/lints/packs/single/test-word/catches-test-word-in-helper.yaml
@@ -0,0 +1,17 @@
+# SPDX-FileCopyrightText: Copyright (c) 2016-2026 Objectionary.com
+# SPDX-License-Identifier: MIT
+---
+sheets:
+  - /org/eolang/lints/tests/test-word.xsl
+asserts:
+  - /defects[count(defect[@severity='warning'])=1]
+  - /defects/defect[@line='5']
+ignore-schema: true
+document: |
+  <object author="tests">
+    <o line="1" name="foo-tests" pos="0">
+      <o line="3" name="can-run" pos="2">
+        <o base="Q.number" line="5" name="tests-helper" pos="4"/>
+      </o>
+    </o>
+  </object>