From ec3ad7333ff3b6cf67cf86b7ff08da7db316ea98 Mon Sep 17 00:00:00 2001
From: "qwen.ai[bot]" <qwenlm-intl@service.alibaba.com>
Date: Wed, 12 Aug 2026 13:10:52 +0000
Subject: [PATCH] =?UTF-8?q?chore:=20=D0=B4=D0=BE=D0=B1=D0=B0=D0=B2=D0=B8?=
 =?UTF-8?q?=D1=82=D1=8C=20=D1=81=D0=BA=D1=80=D0=B8=D0=BF=D1=82=20=D0=B4?=
 =?UTF-8?q?=D0=BB=D1=8F=20=D0=BF=D0=BE=D0=B8=D1=81=D0=BA=D0=B0=20=D1=84?=
 =?UTF-8?q?=D1=83=D0=BD=D0=BA=D1=86=D0=B8=D0=B9=20=D0=B1=D0=B5=D0=B7=20doc?=
 =?UTF-8?q?strings?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 scripts/add_docstrings.py | 57 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 57 insertions(+)
 create mode 100755 scripts/add_docstrings.py

diff --git a/scripts/add_docstrings.py b/scripts/add_docstrings.py
new file mode 100755
index 0000000..186082c
--- /dev/null
+++ b/scripts/add_docstrings.py
@@ -0,0 +1,57 @@
+#!/usr/bin/env python3
+"""Скрипт для поиска функций без docstrings."""
+
+import ast
+import sys
+from pathlib import Path
+
+
+class DocstringChecker(ast.NodeVisitor):
+    def __init__(self, filename: str):
+        self.filename = filename
+        self.missing = []
+
+    def visit_FunctionDef(self, node):
+        if not ast.get_docstring(node):
+            # Пропускаем приватные функции и дюндеры
+            if not node.name.startswith('_') or node.name in ('__init__', '__enter__', '__exit__'):
+                # Проверяем только публичные функции
+                if not node.name.startswith('_'):
+                    self.missing.append((node.lineno, node.name))
+        self.generic_visit(node)
+
+    def visit_AsyncFunctionDef(self, node):
+        self.visit_FunctionDef(node)
+
+
+def check_file(filepath: Path) -> list[tuple[int, str]]:
+    try:
+        source = filepath.read_text(encoding='utf-8')
+        tree = ast.parse(source)
+        checker = DocstringChecker(str(filepath))
+        checker.visit(tree)
+        return checker.missing
+    except Exception as e:
+        print(f"Error parsing {filepath}: {e}", file=sys.stderr)
+        return []
+
+
+def main():
+    src_dir = Path('src/netsleuth')
+    total_missing = 0
+    
+    for py_file in src_dir.glob('*.py'):
+        missing = check_file(py_file)
+        if missing:
+            print(f"\n{py_file.relative_to(Path.cwd())}:")
+            for lineno, funcname in missing:
+                print(f"  Line {lineno}: {funcname}()")
+                total_missing += 1
+    
+    print(f"\n{'='*50}")
+    print(f"Total functions missing docstrings: {total_missing}")
+    return 0 if total_missing == 0 else 1
+
+
+if __name__ == '__main__':
+    sys.exit(main())