lintro 0.9.0__tar.gz → 0.11.0__tar.gz

{lintro-0.9.0/lintro.egg-info → lintro-0.11.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lintro
-Version: 0.9.0
+Version: 0.11.0
 Summary: A unified CLI tool for code formatting, linting, and quality assurance
 Author-email: TurboCoder13 <turbocoder13@gmail.com>
 License: MIT License

{lintro-0.9.0 → lintro-0.11.0}/docs/tool-analysis/ruff-analysis.md

@@ -209,8 +209,10 @@ Lintro preserves all Ruff rule categories:
 | **Pyflakes**              | F      | Logical errors and undefined names |
 | **pycodestyle**           | E, W   | PEP 8 style violations             |
 | **isort**                 | I      | Import sorting issues              |
+| **pep8-naming**           | N      | Naming conventions (PEP 8)         |
 | **pydocstyle**            | D      | Docstring style violations         |
 | **pyupgrade**             | UP     | Python upgrade suggestions         |
+| **flake8-annotations**    | ANN    | Type annotation requirements       |
 | **flake8-bugbear**        | B      | Bug detection and complexity       |
 | **flake8-comprehensions** | C4     | Comprehension improvements         |
 | **flake8-simplify**       | SIM    | Code simplification suggestions    |

{lintro-0.9.0 → lintro-0.11.0}/lintro/__init__.py

@@ -1,3 +1,3 @@
 """Lintro - A unified CLI core for code formatting, linting, and quality assurance."""
 
-__version__ = "0.9.0"
+__version__ = "0.11.0"

{lintro-0.9.0 → lintro-0.11.0/lintro.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lintro
-Version: 0.9.0
+Version: 0.11.0
 Summary: A unified CLI tool for code formatting, linting, and quality assurance
 Author-email: TurboCoder13 <turbocoder13@gmail.com>
 License: MIT License

{lintro-0.9.0 → lintro-0.11.0}/lintro.egg-info/SOURCES.txt

@@ -125,8 +125,10 @@ test_samples/actionlint_violations.yml
 test_samples/bandit_violations.py
 test_samples/darglint_violations.py
 test_samples/prettier_violations.js
+test_samples/ruff_annotations_violations.py
 test_samples/ruff_black_e501_wrappable.py
 test_samples/ruff_clean.py
+test_samples/ruff_naming_violations.py
 test_samples/ruff_violations.py
 test_samples/yaml_violations.yml
 tests/__init__.py
@@ -145,8 +147,10 @@ tests/integration/test_bandit_integration.py
 tests/integration/test_darglint_integration.py
 tests/integration/test_hadolint_integration.py
 tests/integration/test_prettier_integration.py
+tests/integration/test_ruff_annotations.py
 tests/integration/test_ruff_black_policy.py
 tests/integration/test_ruff_integration.py
+tests/integration/test_ruff_naming.py
 tests/integration/test_yamllint_integration.py
 tests/scripts/__init__.py
 tests/scripts/test_ci_post_pr_comment.py

{lintro-0.9.0 → lintro-0.11.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "lintro"
-version = "0.9.0"
+version = "0.11.0"
 description = "A unified CLI tool for code formatting, linting, and quality assurance"
 keywords = [ "linting", "formatting", "code-quality", "cli", "python", "javascript", "yaml", "docker",]
 classifiers = [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "Operating System :: OS Independent", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.13", "Topic :: Software Development :: Quality Assurance", "Topic :: Software Development :: Libraries :: Python Modules", "Topic :: Utilities",]
@@ -65,8 +65,8 @@ indent-style = "space"
 skip-magic-trailing-comma = false
 
 [tool.ruff.lint]
-select = [ "E", "F", "W", "I", "COM", "D", "UP",]
-ignore = []
+select = [ "E", "F", "W", "I", "COM", "N", "D", "UP", "ANN",]
+ignore = [ "ANN",]
 
 [tool.ruff.pydocstyle]
 convention = "google"

lintro-0.11.0/test_samples/ruff_annotations_violations.py

@@ -0,0 +1,53 @@
+"""Sample file with flake8-annotations (ANN) violations for testing Ruff.
+
+Intentionally violates several ANN-rules, such as:
+- ANN101: missing type annotation for self
+- ANN102: missing type annotation for cls
+- ANN201: missing return type annotation for public function
+- ANN204: missing return type annotation for special method
+- ANN205: missing return type annotation for static method
+- ANN003: missing type annotation for **kwargs
+"""
+
+from typing import Any
+
+
+class SampleClass:
+    """Sample class with annotation violations."""
+
+    def __init__(self, value: int):  # ANN101: missing type for self
+        self.value = value
+
+    @classmethod
+    def from_string(cls, s: str):  # ANN102: missing type for cls
+        return cls(int(s))
+
+    @staticmethod
+    def helper_func(x: int):  # ANN205: missing return type
+        return x * 2
+
+    def __str__(self):  # ANN204: missing return type for special method
+        return f"SampleClass({self.value})"
+
+    def public_method(self, data: list[str]):  # ANN201: missing return type
+        return len(data)
+
+    def kwargs_method(self, **kwargs):  # ANN003: missing type for **kwargs
+        return kwargs
+
+
+def public_function(a: int, b: str):  # ANN201: missing return type
+    """Public function without return type annotation."""
+    return f"{a}: {b}"
+
+
+def kwargs_function(**kwargs):  # ANN003: missing type for **kwargs
+    """Function with kwargs without type annotation."""
+    return kwargs
+
+
+def nested_function():
+    """Function that returns a nested function."""
+    def inner(x: int):  # ANN201: missing return type
+        return x + 1
+    return inner

lintro-0.11.0/test_samples/ruff_naming_violations.py

@@ -0,0 +1,26 @@
+"""Sample file with pep8-naming (N) violations for testing Ruff.
+
+Intentionally violates several N-rules, such as:
+- N802: function name should be lowercase
+- N803: argument name should be lowercase
+- N806: variable in function should be lowercase
+- N815: mixedCase variable in class scope
+"""
+
+
+def BadFunctionName(BadArg: int) -> int:  # N802, N803
+    BadLocal = BadArg + 1  # N806
+    return BadLocal
+
+
+class SampleClass:
+    camelCaseAttr = 1  # N815
+
+    def GoodMethod(self, BadParam: int) -> int:  # N803
+        BadLocalVar = BadParam * 2  # N806
+        return BadLocalVar
+
+
+CONSTANT_ok = 1  # not enforcing caps here; focus on N8xx basics
+
+

{lintro-0.9.0 → lintro-0.11.0}/tests/cli/test_cli.py

@@ -9,7 +9,7 @@ from assertpy import assert_that
 from lintro.cli import cli
 
 
-def test_cli_help():
+def test_cli_help() -> None:
     """Test that CLI shows help."""
     from click.testing import CliRunner
 
@@ -19,7 +19,7 @@ def test_cli_help():
     assert_that(result.output).contains("Lintro")
 
 
-def test_cli_version():
+def test_cli_version() -> None:
     """Test that CLI shows version."""
     from click.testing import CliRunner
 
@@ -29,7 +29,7 @@ def test_cli_version():
     assert_that(result.output.lower()).contains("version")
 
 
-def test_cli_commands_registered():
+def test_cli_commands_registered() -> None:
     """Test that all commands are registered."""
     from click.testing import CliRunner
 
@@ -42,7 +42,7 @@ def test_cli_commands_registered():
     assert_that(result.exit_code).is_equal_to(0)
 
 
-def test_main_function():
+def test_main_function() -> None:
     """Test the main function."""
     from click.testing import CliRunner
 
@@ -52,7 +52,7 @@ def test_main_function():
     assert_that(result.output).contains("Lintro")
 
 
-def test_cli_command_aliases():
+def test_cli_command_aliases() -> None:
     """Test that command aliases work."""
     from click.testing import CliRunner
 
@@ -65,7 +65,7 @@ def test_cli_command_aliases():
     assert_that(result.exit_code).is_equal_to(0)
 
 
-def test_cli_with_no_args():
+def test_cli_with_no_args() -> None:
     """Test CLI with no arguments."""
     from click.testing import CliRunner
 
@@ -75,7 +75,7 @@ def test_cli_with_no_args():
     assert_that(result.output).is_equal_to("")
 
 
-def test_main_module_execution():
+def test_main_module_execution() -> None:
     """Test that __main__.py can be executed directly."""
     with patch.object(sys, "argv", ["lintro", "--help"]):
         import lintro.__main__
@@ -83,7 +83,7 @@ def test_main_module_execution():
         assert_that(lintro.__main__).is_not_none()
 
 
-def test_main_module_as_script():
+def test_main_module_as_script() -> None:
     """Test that __main__.py works when run as a script."""
     result = subprocess.run(
         [sys.executable, "-m", "lintro", "--help"],

{lintro-0.9.0 → lintro-0.11.0}/tests/conftest.py

@@ -32,7 +32,7 @@ def _ensure_test_docker_images_built() -> None:
     return
 
 
-def pytest_collection_modifyitems(config, items):
+def pytest_collection_modifyitems(config, items) -> None:
     """Optionally skip docker tests locally unless explicitly enabled.
 
     If `LINTRO_RUN_DOCKER_TESTS` is not set to "1", mark tests under

{lintro-0.9.0 → lintro-0.11.0}/tests/formatters/test_formatters.py

@@ -13,7 +13,7 @@ from lintro.formatters.styles.markdown import MarkdownStyle
 from lintro.formatters.styles.plain import PlainStyle
 
 
-def test_output_style_abstract():
+def test_output_style_abstract() -> None:
     """Test that OutputStyle is an abstract base class."""
     from abc import ABC
 
@@ -21,7 +21,7 @@ def test_output_style_abstract():
     assert_that(hasattr(OutputStyle, "format")).is_true()
 
 
-def test_table_descriptor_abstract():
+def test_table_descriptor_abstract() -> None:
     """Test TableDescriptor is an abstract base class."""
     from abc import ABC
 
@@ -30,13 +30,13 @@ def test_table_descriptor_abstract():
     assert_that(hasattr(TableDescriptor, "get_rows")).is_true()
 
 
-def test_table_descriptor_methods():
+def test_table_descriptor_methods() -> None:
     """Test TableDescriptor abstract methods exist."""
     assert_that(callable(TableDescriptor.get_columns)).is_true()
     assert_that(callable(TableDescriptor.get_rows)).is_true()
 
 
-def test_csv_style_format():
+def test_csv_style_format() -> None:
     """Test CSV style formatting."""
     style = CsvStyle()
     result = style.format(["col1", "col2"], [["val1", "val2"], ["val3", "val4"]])
@@ -45,14 +45,14 @@ def test_csv_style_format():
     assert_that(result).contains("val3,val4")
 
 
-def test_csv_style_format_empty():
+def test_csv_style_format_empty() -> None:
     """Test CSV style formatting with empty data."""
     style = CsvStyle()
     result = style.format([], [])
     assert_that(result).is_equal_to("")
 
 
-def test_grid_style_format():
+def test_grid_style_format() -> None:
     """Test grid style formatting."""
     style = GridStyle()
     result = style.format(["col1", "col2"], [["val1", "val2"], ["val3", "val4"]])
@@ -62,14 +62,14 @@ def test_grid_style_format():
     assert_that(result).contains("val2")
 
 
-def test_grid_style_format_empty():
+def test_grid_style_format_empty() -> None:
     """Test grid style formatting with empty data."""
     style = GridStyle()
     result = style.format([], [])
     assert_that(result).is_equal_to("")
 
 
-def test_grid_style_format_fallback():
+def test_grid_style_format_fallback() -> None:
     """Test grid style formatting fallback when tabulate is not available."""
     style = GridStyle()
     with pytest.MonkeyPatch().context() as m:
@@ -83,7 +83,7 @@ def test_grid_style_format_fallback():
         assert_that(result).contains(" | ")
 
 
-def test_grid_style_format_fallback_empty():
+def test_grid_style_format_fallback_empty() -> None:
     """Test grid style formatting fallback with empty data."""
     style = GridStyle()
     with pytest.MonkeyPatch().context() as m:
@@ -93,7 +93,7 @@ def test_grid_style_format_fallback_empty():
         assert_that(result).is_equal_to("")
 
 
-def test_grid_style_format_fallback_single_column():
+def test_grid_style_format_fallback_single_column() -> None:
     """Test grid style formatting fallback with single column."""
     style = GridStyle()
     with pytest.MonkeyPatch().context() as m:
@@ -105,7 +105,7 @@ def test_grid_style_format_fallback_single_column():
         assert_that(result).contains("val2")
 
 
-def test_html_style_format():
+def test_html_style_format() -> None:
     """Test HTML style formatting."""
     style = HtmlStyle()
     result = style.format(["col1", "col2"], [["val1", "val2"], ["val3", "val4"]])
@@ -116,7 +116,7 @@ def test_html_style_format():
     assert_that(result).contains("<td>val2</td>")
 
 
-def test_json_style_format():
+def test_json_style_format() -> None:
     """Test JSON style formatting."""
     style = JsonStyle()
     result = style.format(["col1", "col2"], [["val1", "val2"], ["val3", "val4"]])
@@ -126,7 +126,7 @@ def test_json_style_format():
     assert_that(result).contains("val2")
 
 
-def test_markdown_style_format():
+def test_markdown_style_format() -> None:
     """Test markdown style formatting."""
     style = MarkdownStyle()
     result = style.format(["col1", "col2"], [["val1", "val2"], ["val3", "val4"]])
@@ -135,7 +135,7 @@ def test_markdown_style_format():
     assert_that(result).contains("| val3 | val4 |")
 
 
-def test_plain_style_format():
+def test_plain_style_format() -> None:
     """Test plain style formatting."""
     style = PlainStyle()
     result = style.format(["col1", "col2"], [["val1", "val2"], ["val3", "val4"]])
@@ -145,7 +145,7 @@ def test_plain_style_format():
     assert_that(result).contains("val2")
 
 
-def test_all_styles_produce_output():
+def test_all_styles_produce_output() -> None:
     """Test that all styles produce some output."""
     styles = [
         CsvStyle(),
@@ -163,7 +163,7 @@ def test_all_styles_produce_output():
         assert_that(len(result) > 0).is_true()
 
 
-def test_styles_handle_empty_results():
+def test_styles_handle_empty_results() -> None:
     """Test that all styles handle empty results gracefully."""
     styles = [
         CsvStyle(),

{lintro-0.9.0 → lintro-0.11.0}/tests/integration/conftest.py

@@ -33,7 +33,7 @@ def test_files_dir():
 
 
 @pytest.fixture
-def sample_python_file():
+def sample_python_file() -> str:
     """Provide a sample Python file with violations.
 
     Returns:
@@ -50,7 +50,7 @@ def sample_python_file():
 
 
 @pytest.fixture
-def sample_js_file():
+def sample_js_file() -> str:
     """Provide a sample JavaScript file with formatting issues.
 
     Returns:

{lintro-0.9.0 → lintro-0.11.0}/tests/integration/test_actionlint_integration.py

@@ -33,7 +33,7 @@ def actionlint_available() -> bool:
 
 
 @pytest.mark.actionlint
-def test_actionlint_available():
+def test_actionlint_available() -> None:
     """Skip the suite if actionlint is not present locally.
 
     Ensures local runs behave like CI (which always has actionlint in Docker),
@@ -47,7 +47,7 @@ SAMPLE_BAD = Path("test_samples/actionlint_violations.yml")
 
 
 @pytest.mark.actionlint
-def test_actionlint_reports_violations(tmp_path):
+def test_actionlint_reports_violations(tmp_path) -> None:
     """Assert that Lintro detects violations reported by actionlint.
 
     Args:
@@ -71,7 +71,7 @@ def test_actionlint_reports_violations(tmp_path):
 
 
 @pytest.mark.actionlint
-def test_actionlint_no_files(tmp_path):
+def test_actionlint_no_files(tmp_path) -> None:
     """Assert that Lintro succeeds when no workflow files are present.
 
     Args:

{lintro-0.9.0 → lintro-0.11.0}/tests/integration/test_darglint_integration.py

@@ -65,7 +65,7 @@ def _ensure_darglint_cli_available() -> None:
         pytest.skip("darglint CLI not installed/runnable; skipping direct CLI test")
 
 
-def test_darglint_reports_violations_direct(tmp_path):
+def test_darglint_reports_violations_direct(tmp_path) -> None:
     """Darglint CLI: Should detect and report violations in a sample file.
 
     Args:
@@ -82,7 +82,7 @@ def test_darglint_reports_violations_direct(tmp_path):
     assert "DAR" in output, "Darglint output should contain error codes."
 
 
-def test_darglint_reports_violations_through_lintro(tmp_path):
+def test_darglint_reports_violations_through_lintro(tmp_path) -> None:
     """Lintro DarglintTool: Should detect and report violations in a sample file.
 
     Args:
@@ -111,7 +111,7 @@ def test_darglint_reports_violations_through_lintro(tmp_path):
     ), "Lintro DarglintTool output should contain error codes."
 
 
-def test_darglint_output_consistency_direct_vs_lintro(tmp_path):
+def test_darglint_output_consistency_direct_vs_lintro(tmp_path) -> None:
     """Darglint CLI vs Lintro: Should produce consistent results for the same file.
 
     Args:
@@ -137,7 +137,7 @@ def test_darglint_output_consistency_direct_vs_lintro(tmp_path):
     # Optionally compare error codes if output format is stable
 
 
-def test_darglint_fix_method_not_implemented(tmp_path):
+def test_darglint_fix_method_not_implemented(tmp_path) -> None:
     """Lintro DarglintTool: .fix() should raise NotImplementedError.
 
     Args:

{lintro-0.9.0 → lintro-0.11.0}/tests/integration/test_hadolint_integration.py

@@ -69,7 +69,7 @@ def run_hadolint_directly(file_path: Path) -> tuple[bool, str, int]:
 
 
 @pytest.mark.hadolint
-def test_hadolint_available():
+def test_hadolint_available() -> None:
     """Check if hadolint is available in PATH."""
     try:
         result = subprocess.run(
@@ -85,7 +85,7 @@ def test_hadolint_available():
 
 
 @pytest.mark.hadolint
-def test_hadolint_reports_violations_direct(tmp_path):
+def test_hadolint_reports_violations_direct(tmp_path) -> None:
     """Hadolint CLI: Should detect and report violations in a sample file.
 
     Args:
@@ -115,7 +115,7 @@ def test_hadolint_reports_violations_direct(tmp_path):
 
 
 @pytest.mark.hadolint
-def test_hadolint_reports_violations_through_lintro(tmp_path):
+def test_hadolint_reports_violations_through_lintro(tmp_path) -> None:
     """Lintro HadolintTool: Should detect and report violations in a sample file.
 
     Args:
@@ -145,7 +145,7 @@ def test_hadolint_reports_violations_through_lintro(tmp_path):
 
 
 @pytest.mark.hadolint
-def test_hadolint_output_consistency_direct_vs_lintro(tmp_path):
+def test_hadolint_output_consistency_direct_vs_lintro(tmp_path) -> None:
     """Hadolint CLI vs Lintro: Should produce consistent results for the same file.
 
     Args:
@@ -184,7 +184,7 @@ def test_hadolint_output_consistency_direct_vs_lintro(tmp_path):
 
 
 @pytest.mark.hadolint
-def test_hadolint_with_ignore_rules(tmp_path):
+def test_hadolint_with_ignore_rules(tmp_path) -> None:
     """Lintro HadolintTool: Should properly ignore specified rules.
 
     Args:
@@ -206,7 +206,7 @@ def test_hadolint_with_ignore_rules(tmp_path):
 
 
 @pytest.mark.hadolint
-def test_hadolint_fix_method_not_implemented(tmp_path):
+def test_hadolint_fix_method_not_implemented(tmp_path) -> None:
     """Lintro HadolintTool: .fix() should raise NotImplementedError.
 
     Args:
@@ -225,7 +225,7 @@ def test_hadolint_fix_method_not_implemented(tmp_path):
 
 
 @pytest.mark.hadolint
-def test_hadolint_empty_directory(tmp_path):
+def test_hadolint_empty_directory(tmp_path) -> None:
     """Lintro HadolintTool: Should handle empty directories gracefully.
 
     Args:
@@ -243,7 +243,7 @@ def test_hadolint_empty_directory(tmp_path):
 
 
 @pytest.mark.hadolint
-def test_hadolint_parser_validation(tmp_path):
+def test_hadolint_parser_validation(tmp_path) -> None:
     """Test that hadolint parser correctly parses output.
 
     Args:

{lintro-0.9.0 → lintro-0.11.0}/tests/integration/test_prettier_integration.py

@@ -68,7 +68,7 @@ def run_prettier_directly(
     return success, full_output, issues_count
 
 
-def test_prettier_reports_violations_direct(temp_prettier_file):
+def test_prettier_reports_violations_direct(temp_prettier_file) -> None:
     """Prettier CLI: Should detect and report violations in a sample file.
 
     Args:
@@ -84,7 +84,7 @@ def test_prettier_reports_violations_direct(temp_prettier_file):
     assert has_warnings, "Prettier output should contain warning indicators."
 
 
-def test_prettier_reports_violations_through_lintro(temp_prettier_file):
+def test_prettier_reports_violations_through_lintro(temp_prettier_file) -> None:
     """Lintro PrettierTool: Should detect and report violations in a sample file.
 
     Args:
@@ -109,7 +109,7 @@ def test_prettier_reports_violations_through_lintro(temp_prettier_file):
     assert has_warnings, "Lintro PrettierTool output should contain warning indicators."
 
 
-def test_prettier_fix_method(temp_prettier_file):
+def test_prettier_fix_method(temp_prettier_file) -> None:
     """Lintro PrettierTool: Should fix formatting issues.
 
     Args:
@@ -147,7 +147,7 @@ def test_prettier_fix_method(temp_prettier_file):
     assert final_result.issues_count == 0, "Should have no issues after fixing"
 
 
-def test_prettier_output_consistency_direct_vs_lintro(temp_prettier_file):
+def test_prettier_output_consistency_direct_vs_lintro(temp_prettier_file) -> None:
     """Prettier CLI vs Lintro: Should produce consistent results for the same file.
 
     Args:
@@ -178,7 +178,7 @@ def test_prettier_output_consistency_direct_vs_lintro(temp_prettier_file):
     )
 
 
-def test_prettier_fix_sets_issues_for_table(temp_prettier_file):
+def test_prettier_fix_sets_issues_for_table(temp_prettier_file) -> None:
     """PrettierTool.fix should populate issues for table rendering.
 
     Args:

lintro-0.11.0/tests/integration/test_ruff_annotations.py

@@ -0,0 +1,78 @@
+"""Integration tests for Ruff flake8-annotations (ANN) rule family."""
+
+from __future__ import annotations
+
+import os
+import shutil
+import tempfile
+
+from assertpy import assert_that
+
+from lintro.tools.implementations.tool_ruff import RuffTool
+
+
+def test_annotations_rules_detected() -> None:
+    """Ensure Ruff reports ANN-family violations on a known sample file."""
+    sample = os.path.abspath("test_samples/ruff_annotations_violations.py")
+    with tempfile.TemporaryDirectory() as tmp:
+        test_file = os.path.join(tmp, "ruff_annotations_case.py")
+        shutil.copy(sample, test_file)
+
+        ruff = RuffTool()
+        ruff.set_options(select=["ANN"])  # only ANN rules
+        result = ruff.check([test_file])
+
+        assert_that(result.success).is_false()
+        codes = [getattr(i, "code", "") for i in (result.issues or [])]
+        # Expect several representative ANN-codes
+        assert_that(any(code.startswith("ANN") for code in codes)).is_true()
+        assert_that(
+            any(
+                code in {"ANN101", "ANN102", "ANN201", "ANN204", "ANN205", "ANN003"}
+                for code in codes
+            ),
+        ).is_true()
+
+
+def test_annotations_rules_with_other_rules() -> None:
+    """Ensure ANN rules work alongside other rule families."""
+    sample = os.path.abspath("test_samples/ruff_annotations_violations.py")
+    with tempfile.TemporaryDirectory() as tmp:
+        test_file = os.path.join(tmp, "ruff_annotations_mixed.py")
+        shutil.copy(sample, test_file)
+
+        ruff = RuffTool()
+        ruff.set_options(select=["ANN", "F"])  # ANN + pyflakes errors
+        result = ruff.check([test_file])
+
+        assert_that(result.success).is_false()
+        codes = [getattr(i, "code", "") for i in (result.issues or [])]
+        # Should have ANN codes (F codes may not be present in this sample)
+        assert_that(any(code.startswith("ANN") for code in codes)).is_true()
+
+
+def test_annotations_rules_fix_capability() -> None:
+    """Test that ANN rules can be fixed automatically where possible."""
+    sample = os.path.abspath("test_samples/ruff_annotations_violations.py")
+    with tempfile.TemporaryDirectory() as tmp:
+        test_file = os.path.join(tmp, "ruff_annotations_fix.py")
+        shutil.copy(sample, test_file)
+
+        ruff = RuffTool()
+        ruff.set_options(select=["ANN"])
+
+        # Check initial issues
+        initial_result = ruff.check([test_file])
+        initial_count = len(initial_result.issues or [])
+
+        # Apply fixes
+        ruff.fix([test_file])
+
+        # Check remaining issues after fix
+        final_result = ruff.check([test_file])
+        final_count = len(final_result.issues or [])
+
+        # Some issues should be fixed (though ANN rules are often not auto-fixable)
+        # We mainly verify the fix process doesn't crash and reduces issue count
+        assert_that(initial_count).is_greater_than_or_equal_to(final_count)
+        # Fix result may be False if issues remain, which is expected for ANN rules