Add linters checks to CI

Author: vgvoleg

.github/scripts/increment_version.py

@@ -97,17 +97,13 @@ def extract_version(pyproject_content: str):
     return VersionLine(old_line=version_line, version_str=version_part)
 
 
-def increment_version_at_pyproject(
-    pyproject_path: str, inc_type: str, with_beta: bool
-) -> str:
+def increment_version_at_pyproject(pyproject_path: str, inc_type: str, with_beta: bool) -> str:
     with open(pyproject_path, "rt") as f:
         setup_content = f.read()
 
     version = extract_version(setup_content)
     version.increment(inc_type, with_beta)
-    setup_content = setup_content.replace(
-        version.old_line, version.version_line_with_mark()
-    )
+    setup_content = setup_content.replace(version.old_line, version.version_line_with_mark())
 
     with open(pyproject_path, "w") as f:
         f.write(setup_content)
@@ -143,9 +139,7 @@ def main():
         help="increment version type: patch or minor",
         choices=["minor", "patch"],
     )
-    parser.add_argument(
-        "--beta", choices=["true", "false"], help="is beta version"
-    )
+    parser.add_argument("--beta", choices=["true", "false"], help="is beta version")
     parser.add_argument(
         "--changelog-path",
         default=DEFAULT_CHANGELOG_PATH,
@@ -158,13 +152,11 @@ def main():
 
     is_beta = args.beta == "true"
 
-    new_version = increment_version_at_pyproject(
-        args.pyproject_path, args.inc_type, is_beta
-    )
+    new_version = increment_version_at_pyproject(args.pyproject_path, args.inc_type, is_beta)
     add_changelog_version(args.changelog_path, new_version)
     set_version_in_version_file(DEFAULT_YDB_VERSION_FILE, new_version)
     print(new_version)
 
 
 if __name__ == "__main__":
-    main()
+    main()

.github/workflows/run-linters.yml

@@ -0,0 +1,26 @@
+name: Linters
+
+on:
+  push:
+    branches:
+      - '**'
+  pull_request_target:
+    branches:
+      - '**'
+  workflow_dispatch:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.13'
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+      - name: Run tests
+        run: make lint

.github/workflows/run-tests.yml

@@ -1,4 +1,4 @@
-name: Run Tests
+name: Tests
 
 on:
   push:
@@ -22,6 +22,5 @@ jobs:
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
-          pip install -r requirements-dev.txt
       - name: Run tests
         run: make test

Makefile

@@ -43,21 +43,17 @@ run-server:
 
 # Run lint checks
 lint: dev
-	flake8 ydb_mcp tests
+	ruff check ydb_mcp tests
 	mypy ydb_mcp
-	black --check ydb_mcp tests
-	isort --check-only --profile black ydb_mcp tests
 
 # Format code
 format: dev
-	black ydb_mcp tests
-	isort --profile black ydb_mcp tests
+	ruff format ydb_mcp tests
 
 # Install package
 install:
 	pip install -e .
 
 # Install development dependencies
 dev:
-	pip install -e ".[dev]"
-	pip install -r requirements-dev.txt
+	pip install -e ".[dev]"

pyproject.toml

@@ -28,23 +28,34 @@ dependencies = [
 [project.optional-dependencies]
 dev = [
     "pytest>=7.0.0",
-    "black>=22.0.0",
-    "isort>=5.0.0",
+    "pytest-asyncio>=0.21.0",
+    "pytest-cov>=4.1.0",
+    "pytest-assume>=2.4.3",
+    "ruff>=0.11.0",
     "mypy>=0.9.0",
+    "docker>=7.0.0",
 ]
 
 [project.scripts]
 ydb-mcp = "ydb_mcp.__main__:main"
 
-[tool.black]
-line-length = 100
-target-version = ["py38"]
+[tool.ruff]
+line-length = 121
+target-version = "py310"
 
-[tool.isort]
-profile = "black"
-line_length = 100
+[tool.ruff.lint]
+select = [
+  "E",    # pycodestyle
+  "F",    # pyflakes
+  "I",    # isort
+  # TODO: extend with more rules
+]
 
 [tool.mypy]
-python_version = "3.8"
+python_version = "3.10"
 warn_return_any = true
-warn_unused_configs = true
+warn_unused_configs = true
+
+[[tool.mypy.overrides]]
+module = "ydb.*"
+ignore_missing_imports = true

requirements-dev.txt

@@ -3,9 +3,6 @@ pytest>=7.3.1
 pytest-asyncio>=0.21.0
 pytest-cov>=4.1.0
 pytest-assume>=2.4.3
-black>=23.3.0
-isort>=5.12.0
 mypy>=1.3.0
-flake8>=6.0.0
-httpx>=0.24.0
+ruff>=0.11.0
 docker>=7.0.0  # For YDB Docker container management in tests

tests/conftest.py

@@ -1,7 +1,7 @@
 """Pytest configuration for testing YDB MCP server."""
 
 import os
-from unittest.mock import AsyncMock, MagicMock, patch
+from unittest.mock import AsyncMock, patch
 
 import pytest
 

tests/docker_utils.py

@@ -1,6 +1,5 @@
 import logging
 import os
-import platform
 import socket
 import time
 

tests/integration/conftest.py

@@ -15,7 +15,6 @@
 from urllib.parse import urlparse
 
 import pytest
-import ydb
 
 from tests.docker_utils import start_ydb_container, stop_container, wait_for_port
 from ydb_mcp.server import AUTH_MODE_ANONYMOUS, YDBMCPServer
@@ -198,34 +197,6 @@ def ydb_server():
     stop_container(container)
 
 
-@pytest.fixture(scope="session")
-async def mcp_server(ydb_server):
-    """Create a YDB MCP server instance for testing."""
-    # Create the server with anonymous credentials
-    server = YDBMCPServer(endpoint=YDB_ENDPOINT, database=YDB_DATABASE)
-
-    # Store the event loop
-    server._loop = ensure_event_loop()
-
-    try:
-        # Initialize the server by creating the driver
-        await server.create_driver()
-        yield server
-
-        # Clean up after tests
-        logger.info("Cleaning up YDB server resources after tests")
-        await cleanup_pending_tasks()
-        if server.driver:
-            await cleanup_driver(server.driver)
-
-    except Exception as e:
-        logger.error(f"Failed to initialize YDB MCP server: {e}")
-        pytest.fail(f"Failed to initialize YDB MCP server: {e}")
-    finally:
-        # Final cleanup
-        await cleanup_pending_tasks()
-
-
 # Create a global variable to cache the server instance
 _mcp_server_instance = None
 
@@ -237,9 +208,7 @@ async def session_mcp_server(ydb_server):
 
     if _mcp_server_instance is None:
         # Create the server with anonymous credentials
-        _mcp_server_instance = YDBMCPServer(
-            endpoint=YDB_ENDPOINT, database=YDB_DATABASE, auth_mode=AUTH_MODE_ANONYMOUS
-        )
+        _mcp_server_instance = YDBMCPServer(endpoint=YDB_ENDPOINT, database=YDB_DATABASE, auth_mode=AUTH_MODE_ANONYMOUS)
 
         try:
             # Ensure we have a valid event loop
@@ -372,11 +341,7 @@ async def cleanup_after_all_tests():
         loop = asyncio.get_running_loop()
         if not loop.is_closed():
             # Cancel all tasks
-            pending = [
-                task
-                for task in asyncio.all_tasks(loop)
-                if not task.done() and task != asyncio.current_task()
-            ]
+            pending = [task for task in asyncio.all_tasks(loop) if not task.done() and task != asyncio.current_task()]
 
             if pending:
                 logger.debug(f"Cleaning up {len(pending)} pending tasks in final cleanup")
@@ -394,9 +359,7 @@ async def cleanup_after_all_tests():
             for task in pending:
                 if not task.done():
                     with suppress(asyncio.CancelledError, Exception):
-                        task._log_destroy_pending = (
-                            False  # Suppress the warning about task destruction
-                        )
+                        task._log_destroy_pending = False  # Suppress the warning about task destruction
 
             # Close the loop
             loop.stop()

tests/integration/test_authentication_integration.py

@@ -14,9 +14,7 @@
 from ydb_mcp.server import AUTH_MODE_ANONYMOUS, AUTH_MODE_LOGIN_PASSWORD
 
 # Suppress the utcfromtimestamp deprecation warning from the YDB library
-warnings.filterwarnings(
-    "ignore", message="datetime.datetime.utcfromtimestamp.*", category=DeprecationWarning
-)
+warnings.filterwarnings("ignore", message="datetime.datetime.utcfromtimestamp.*", category=DeprecationWarning)
 
 # Table name used for tests - using timestamp to avoid conflicts
 TEST_TABLE = f"mcp_integration_test_{int(time.time())}"
@@ -58,12 +56,7 @@ async def test_login_password_authentication(mcp_server):
         # Verify we can execute a query
         result = await call_mcp_tool(mcp_server, "ydb_query", sql="SELECT 1+1 as result")
         # Parse the JSON from the 'text' field if present
-        if (
-            isinstance(result, list)
-            and len(result) > 0
-            and isinstance(result[0], dict)
-            and "text" in result[0]
-        ):
+        if isinstance(result, list) and len(result) > 0 and isinstance(result[0], dict) and "text" in result[0]:
             parsed = json.loads(result[0]["text"])
         else:
             parsed = result
@@ -80,12 +73,7 @@ async def test_login_password_authentication(mcp_server):
         # Query should fail with auth error
         result = await call_mcp_tool(mcp_server, "ydb_query", sql="SELECT 1+1 as result")
         # Parse the JSON from the 'text' field if present
-        if (
-            isinstance(result, list)
-            and len(result) > 0
-            and isinstance(result[0], dict)
-            and "text" in result[0]
-        ):
+        if isinstance(result, list) and len(result) > 0 and isinstance(result[0], dict) and "text" in result[0]:
             parsed = json.loads(result[0]["text"])
         else:
             parsed = result
@@ -111,9 +99,9 @@ async def test_login_password_authentication(mcp_server):
             # Allow empty error message as valid
             pass
         else:
-            assert any(
-                keyword in error_msg for keyword in all_keywords
-            ), f"Unexpected error message: {parsed.get('error')}"
+            assert any(keyword in error_msg for keyword in all_keywords), (
+                f"Unexpected error message: {parsed.get('error')}"
+            )
 
     finally:
         # Switch back to anonymous auth to clean up (fixture will handle final state reset)