nginx-lens 0.1.2__tar.gz → 0.1.4__tar.gz

{nginx_lens-0.1.2 → nginx_lens-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nginx-lens
-Version: 0.1.2
+Version: 0.1.4
 Summary: CLI-инструмент для анализа, визуализации и диагностики конфигураций Nginx
 Author: Daniil Astrouski
 Author-email: shelovesuastra@gmail.com

{nginx_lens-0.1.2 → nginx_lens-0.1.4}/commands/analyze.py

@@ -15,7 +15,20 @@ console = Console()
 
 def analyze(config_path: str = typer.Argument(..., help="Путь к nginx.conf")):
     """
-    Анализирует конфигурацию Nginx на типовые проблемы. Выводит таблицу issue_type/issue_description.
+    Анализирует конфигурацию Nginx на типовые проблемы и best practices.
+
+    Показывает:
+      - Конфликты location-ов
+      - Дублирующиеся директивы
+      - Пустые блоки
+      - Потенциальные проблемы (proxy_pass без схемы, autoindex on, if, server_tokens on, SSL, лимиты, deprecated и др.)
+      - Неиспользуемые переменные
+      - Конфликты listen/server_name
+      - Проблемы с rewrite
+      - Мертвые location-ы
+
+    Пример:
+        nginx-lens analyze /etc/nginx/nginx.conf
     """
     tree = parse_nginx_config(config_path)
     conflicts = find_location_conflicts(tree)

{nginx_lens-0.1.2 → nginx_lens-0.1.4}/commands/diff.py

@@ -13,6 +13,9 @@ def diff(
 ):
     """
     Сравнивает две конфигурации Nginx и выводит отличия side-by-side.
+
+    Пример:
+        nginx-lens diff /etc/nginx/nginx.conf /etc/nginx/nginx.conf.bak
     """
     tree1 = parse_nginx_config(config1)
     tree2 = parse_nginx_config(config2)

{nginx_lens-0.1.2 → nginx_lens-0.1.4}/commands/graph.py

@@ -12,6 +12,10 @@ def graph(
 ):
     """
     Генерирует схему маршрутизации nginx (dot/mermaid).
+
+    Пример:
+        nginx-lens graph /etc/nginx/nginx.conf --format dot
+        nginx-lens graph /etc/nginx/nginx.conf --format mermaid
     """
     tree = parse_nginx_config(config_path)
     if format == "dot":

{nginx_lens-0.1.2 → nginx_lens-0.1.4}/commands/health.py

@@ -14,6 +14,10 @@ def health(
 ):
     """
     Проверяет доступность upstream-серверов, определённых в nginx.conf. Выводит таблицу.
+
+    Пример:
+        nginx-lens health /etc/nginx/nginx.conf
+        nginx-lens health /etc/nginx/nginx.conf --timeout 5 --retries 3
     """
     tree = parse_nginx_config(config_path)
     upstreams = tree.get_upstreams()

{nginx_lens-0.1.2 → nginx_lens-0.1.4}/commands/include.py

@@ -13,6 +13,10 @@ def include_tree(
 ):
     """
     Показывает дерево include-ов, циклы и shadowing директив.
+
+    Пример:
+        nginx-lens include-tree /etc/nginx/nginx.conf
+        nginx-lens include-tree /etc/nginx/nginx.conf --directive server_name
     """
     tree = build_include_tree(config_path)
     rich_tree = Tree(f"[bold blue]{config_path}[/bold blue]")

{nginx_lens-0.1.2 → nginx_lens-0.1.4}/commands/logs.py

@@ -4,7 +4,7 @@ from rich.table import Table
 import re
 from collections import Counter, defaultdict
 
-app = typer.Typer()
+app = typer.Typer(help="Анализ access.log/error.log: топ-статусы, пути, IP, User-Agent, ошибки.")
 console = Console()
 
 log_line_re = re.compile(r'(?P<ip>\S+) \S+ \S+ \[(?P<time>[^\]]+)\] "(?P<method>\S+) (?P<path>\S+) [^\"]+" (?P<status>\d{3})')
@@ -15,7 +15,17 @@ def logs(
     top: int = typer.Option(10, help="Сколько топ-значений выводить")
 ):
     """
-    Анализирует access.log/error.log: топ-404, топ-500, частые запросы, подозрительные user-agent, IP.
+    Анализирует access.log/error.log.
+
+    Показывает:
+      - Топ HTTP-статусов (404, 500 и др.)
+      - Топ путей
+      - Топ IP-адресов
+      - Топ User-Agent
+      - Топ путей с ошибками 404/500
+
+    Пример:
+        nginx-lens logs /var/log/nginx/access.log --top 20
     """
     status_counter = Counter()
     path_counter = Counter()

{nginx_lens-0.1.2 → nginx_lens-0.1.4}/commands/route.py

@@ -13,6 +13,9 @@ def route(
 ):
     """
     Показывает, какой server/location обслуживает указанный URL.
+
+    Пример:
+        nginx-lens route /etc/nginx/nginx.conf http://example.com/api/v1
     """
     tree = parse_nginx_config(config_path)
     res = find_route(tree, url)

{nginx_lens-0.1.2 → nginx_lens-0.1.4}/commands/syntax.py

@@ -5,7 +5,7 @@ import subprocess
 import os
 import re
 
-app = typer.Typer()
+app = typer.Typer(help="Проверка синтаксиса nginx-конфига через nginx -t с подсветкой ошибок.")
 console = Console()
 
 ERROR_RE = re.compile(r'in (.+?):(\d+)')
@@ -16,7 +16,13 @@ def syntax(
     nginx_path: str = typer.Option("nginx", help="Путь к бинарю nginx (по умолчанию 'nginx')")
 ):
     """
-    Проверяет синтаксис nginx-конфига через nginx -t. В случае ошибки показывает место в виде таблицы.
+    Проверяет синтаксис nginx-конфига через nginx -t.
+
+    В случае ошибки показывает место в виде таблицы с контекстом.
+
+    Пример:
+        nginx-lens syntax /etc/nginx/nginx.conf
+        nginx-lens syntax /etc/nginx/nginx.conf --nginx-path /usr/local/sbin/nginx
     """
     cmd = [nginx_path, "-t", "-c", os.path.abspath(config_path)]
     try:

{nginx_lens-0.1.2 → nginx_lens-0.1.4}/commands/tree.py

@@ -28,6 +28,11 @@ def tree(
 ):
     """
     Визуализирует структуру nginx.conf в виде дерева.
+
+    Пример:
+        nginx-lens tree /etc/nginx/nginx.conf
+        nginx-lens tree /etc/nginx/nginx.conf --markdown
+        nginx-lens tree /etc/nginx/nginx.conf --html
     """
     tree_obj = parse_nginx_config(config_path)
     root = RichTree(f"[bold blue]nginx.conf[/bold blue]")

{nginx_lens-0.1.2 → nginx_lens-0.1.4}/nginx_lens.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nginx-lens
-Version: 0.1.2
+Version: 0.1.4
 Summary: CLI-инструмент для анализа, визуализации и диагностики конфигураций Nginx
 Author: Daniil Astrouski
 Author-email: shelovesuastra@gmail.com

{nginx_lens-0.1.2 → nginx_lens-0.1.4}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name="nginx-lens",
-    version="0.1.2",
+    version="0.1.4",
     description="CLI-инструмент для анализа, визуализации и диагностики конфигураций Nginx",
     author="Daniil Astrouski",
     author_email="shelovesuastra@gmail.com",
@@ -12,7 +12,6 @@ setup(
         "typer[all]>=0.9.0",
         "rich>=13.0.0",
         "requests>=2.25.0",
-        # "textual>=0.30.0",  # опционально для интерактивного режима
     ],
     entry_points={
         "console_scripts": [