nginx-lens 0.1.5__tar.gz → 0.1.7__tar.gz

nginx_lens-0.1.7/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Daniil Astrouski
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE. 

{nginx_lens-0.1.5 → nginx_lens-0.1.7}/PKG-INFO

@@ -1,15 +1,17 @@
 Metadata-Version: 2.4
 Name: nginx-lens
-Version: 0.1.5
+Version: 0.1.7
 Summary: CLI-инструмент для анализа, визуализации и диагностики конфигураций Nginx
 Author: Daniil Astrouski
 Author-email: shelovesuastra@gmail.com
 Requires-Python: >=3.8
+License-File: LICENSE
 Requires-Dist: typer[all]>=0.9.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: requests>=2.25.0
 Dynamic: author
 Dynamic: author-email
+Dynamic: license-file
 Dynamic: requires-dist
 Dynamic: requires-python
 Dynamic: summary

nginx_lens-0.1.7/README.md

@@ -0,0 +1,81 @@
+# nginx-lens
+
+**nginx-lens** — современный CLI-инструмент для анализа, диагностики и визуализации конфигураций Nginx.
+
+## Зачем нужен nginx-lens?
+
+- Быстро находит ошибки и потенциальные проблемы в ваших nginx-конфигах.
+- Визуализирует маршруты и структуру — легко понять, как устроен ваш nginx.
+- Показывает, какой location/server обслуживает конкретный URL.
+- Анализирует логи и помогает выявить аномалии.
+- Упрощает аудит, миграцию и поддержку сложных инфраструктур.
+
+## Примеры работы
+
+### Справочник утилиты
+
+![nginx-lens --help](docs/main-help.png)
+
+### Справочник для команд
+
+![nginx-lens <команда> --help](docs/command-help.png)
+
+### Доступность upstream-серверов
+
+![nginx-lens health <путь_к_конфигу>](docs/example-health.png)
+
+### Древовидная визуализация структуры конфига
+
+![nginx-lens tree <путь_к_конфигу>](docs/example-tree.png)
+
+### Древовидная визуализация include'ов
+
+![nginx-lens include-tree <путь_к_конфигу>](docs/example-include-tree.png)
+
+### Удобный анализатор логов
+
+![nginx-lens logs <путь_к_файлу_лога>](docs/example-logs.png)
+
+### Аудит конфигурации
+
+![nginx-lens analyze <путь_к_конфигу>](docs/example-analyze.png)
+
+### Визуализация маршрутов
+
+![nginx-lens graph <путь_к_конфигу>](docs/example-graph.png)
+
+### Поиск маршрута для URL
+
+![nginx-lens route <URL>](docs/example-route.png)
+
+### Сравнение конфигов
+
+![nginx-lens diff <путь_к_первому_конфигу> <путь_к_второму_конфигу>](docs/example-diff.png)
+
+### Удобная проверка синтаксиса конфига
+
+![nginx-lens syntax](docs/example-syntax.png)
+
+
+## Установка и системные требования
+
+- **Python 3.8+**
+- Linux/macOS (работает и под Windows WSL)
+
+### Установка через PyPI (рекомендуется)
+
+```bash
+pipx install nginx-lens
+```
+или
+```bash
+pip install nginx-lens
+```
+
+## Автор
+
+[Daniil Astrouski](https://github.com/shelovesuastra)
+
+## Лицензия
+
+MIT

{nginx_lens-0.1.5 → nginx_lens-0.1.7}/commands/analyze.py

@@ -58,7 +58,14 @@ def analyze(config_path: str = typer.Argument(..., help="Путь к nginx.conf"
     Пример:
         nginx-lens analyze /etc/nginx/nginx.conf
     """
-    tree = parse_nginx_config(config_path)
+    try:
+        tree = parse_nginx_config(config_path)
+    except FileNotFoundError:
+        console.print(f"[red]Файл {config_path} не найден. Проверьте путь к конфигу.[/red]")
+        return
+    except Exception as e:
+        console.print(f"[red]Ошибка при разборе {config_path}: {e}[/red]")
+        return
     conflicts = find_location_conflicts(tree)
     dups = find_duplicate_directives(tree)
     empties = find_empty_blocks(tree)

nginx_lens-0.1.7/commands/diff.py

@@ -0,0 +1,51 @@
+import typer
+from rich.console import Console
+from rich.table import Table
+from analyzer.diff import diff_trees
+from parser.nginx_parser import parse_nginx_config
+import difflib
+
+app = typer.Typer()
+console = Console()
+
+def diff(
+    config1: str = typer.Argument(..., help="Первый nginx.conf"),
+    config2: str = typer.Argument(..., help="Второй nginx.conf")
+):
+    """
+    Сравнивает две конфигурации Nginx и выводит отличия построчно side-by-side с подсветкой.
+
+    Пример:
+        nginx-lens diff /etc/nginx/nginx.conf /etc/nginx/nginx.conf.bak
+    """
+    try:
+        with open(config1) as f1, open(config2) as f2:
+            lines1 = f1.readlines()
+            lines2 = f2.readlines()
+    except FileNotFoundError as e:
+        console.print(f"[red]Файл {e.filename} не найден. Проверьте путь к конфигу.[/red]")
+        return
+    except Exception as e:
+        console.print(f"[red]Ошибка при чтении файлов: {e}[/red]")
+        return
+    maxlen = max(len(lines1), len(lines2))
+    # Выравниваем длины
+    lines1 += [''] * (maxlen - len(lines1))
+    lines2 += [''] * (maxlen - len(lines2))
+    table = Table(show_header=True, header_style="bold blue")
+    table.add_column("№", style="dim", width=4)
+    table.add_column("Config 1", style="white")
+    table.add_column("№", style="dim", width=4)
+    table.add_column("Config 2", style="white")
+    for i in range(maxlen):
+        l1 = lines1[i].rstrip('\n')
+        l2 = lines2[i].rstrip('\n')
+        n1 = str(i+1) if l1 else ''
+        n2 = str(i+1) if l2 else ''
+        if l1 == l2:
+            table.add_row(n1, l1, n2, l2)
+        else:
+            style1 = "red" if l1 else "on red"
+            style2 = "green" if l2 else "on green"
+            table.add_row(f"[bold]{n1}[/bold]" if l1 else n1, f"[{style1}]{l1}[/{style1}]" if l1 or l2 else '', f"[bold]{n2}[/bold]" if l2 else n2, f"[{style2}]{l2}[/{style2}]" if l1 or l2 else '')
+    console.print(table) 

{nginx_lens-0.1.5 → nginx_lens-0.1.7}/commands/graph.py

@@ -16,7 +16,14 @@ def graph(
     Пример:
         nginx-lens graph /etc/nginx/nginx.conf
     """
-    tree = parse_nginx_config(config_path)
+    try:
+        tree = parse_nginx_config(config_path)
+    except FileNotFoundError:
+        console.print(f"[red]Файл {config_path} не найден. Проверьте путь к конфигу.[/red]")
+        return
+    except Exception as e:
+        console.print(f"[red]Ошибка при разборе {config_path}: {e}[/red]")
+        return
     routes = []
     # Для каждого server/location строим маршрут
     def walk(d, chain, upstreams):
@@ -59,17 +66,61 @@ def graph(
         console.print("[yellow]Не найдено ни одного маршрута[/yellow]")
         return
     # Красивый вывод
+    seen = set()
     for route in routes:
+        if not route or route[0][0] != 'server':
+            continue
+        key = tuple(route)
+        if key in seen:
+            continue
+        seen.add(key)
         t = Text()
-        for i, (typ, val) in enumerate(route):
-            if typ == 'server':
-                t.append(f"server: {val}", style="bold blue")
-            elif typ == 'location':
-                t.append(f" -> location: {val}", style="yellow")
+        # Получаем label для server
+        server_val = route[0][1]
+        server_block = None
+        # Найти сам блок server по arg
+        for d in tree.directives:
+            if d.get('block') == 'server' and (d.get('arg','') == server_val or (not d.get('arg') and (server_val == '[no arg]' or not server_val))):
+                server_block = d
+                break
+        label = get_server_label(server_block) if server_block else (server_val or 'default')
+        t.append(f"[", style="white")
+        t.append(f"server: {label}", style="bold blue")
+        t.append("]", style="white")
+        for i, (typ, val) in enumerate(route[1:]):
+            if typ == 'location':
+                t.append(f" -> [", style="white")
+                t.append(f"location: {val}", style="yellow")
+                t.append("]", style="white")
             elif typ == 'proxy_pass':
                 t.append(f" -> proxy_pass: {val}", style="green")
             elif typ == 'upstream':
-                t.append(f" -> upstream: {val}", style="magenta")
+                t.append(f" -> [", style="white")
+                t.append(f"upstream: {val}", style="magenta")
+                t.append("]", style="white")
             elif typ == 'upstream_server':
-                t.append(f" -> server: {val}", style="grey50")
-        console.print(t) 
+                t.append(f" -> [", style="white")
+                t.append(f"server: {val}", style="grey50")
+                t.append("]", style="white")
+        console.print(t)
+
+def get_server_label(server_block):
+    arg = server_block.get('arg')
+    if arg and arg != '[no arg]':
+        return arg
+    # Ищем server_name
+    names = []
+    listens = []
+    for sub in server_block.get('directives', []):
+        if sub.get('directive') == 'server_name':
+            names += sub.get('args', '').split()
+        if sub.get('directive') == 'listen':
+            listens.append(sub.get('args', ''))
+    if names:
+        return ' '.join(names)
+    if listens:
+        return ','.join(listens)
+    return 'default'
+
+if __name__ == "__main__":
+    app() 

{nginx_lens-0.1.5 → nginx_lens-0.1.7}/commands/health.py

@@ -19,7 +19,14 @@ def health(
         nginx-lens health /etc/nginx/nginx.conf
         nginx-lens health /etc/nginx/nginx.conf --timeout 5 --retries 3
     """
-    tree = parse_nginx_config(config_path)
+    try:
+        tree = parse_nginx_config(config_path)
+    except FileNotFoundError:
+        console.print(f"[red]Файл {config_path} не найден. Проверьте путь к конфигу.[/red]")
+        return
+    except Exception as e:
+        console.print(f"[red]Ошибка при разборе {config_path}: {e}[/red]")
+        return
     upstreams = tree.get_upstreams()
     results = check_upstreams(upstreams, timeout=timeout, retries=retries)
     table = Table(show_header=True, header_style="bold blue")

{nginx_lens-0.1.5 → nginx_lens-0.1.7}/commands/include.py

@@ -18,7 +18,14 @@ def include_tree(
         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)
+    try:
+        tree = build_include_tree(config_path)
+    except FileNotFoundError:
+        console.print(f"[red]Файл {config_path} не найден. Проверьте путь к конфигу.[/red]")
+        return
+    except Exception as e:
+        console.print(f"[red]Ошибка при разборе {config_path}: {e}[/red]")
+        return
     rich_tree = Tree(f"[bold blue]{config_path}[/bold blue]")
     def _add(node, t):
         for k, v in t.items():

{nginx_lens-0.1.5 → nginx_lens-0.1.7}/commands/logs.py

@@ -26,28 +26,36 @@ def logs(
     Пример:
         nginx-lens logs /var/log/nginx/access.log --top 20
     """
+    try:
+        with open(log_path) as f:
+            lines = list(f)
+    except FileNotFoundError:
+        console.print(f"[red]Файл {log_path} не найден. Проверьте путь к логу.[/red]")
+        return
+    except Exception as e:
+        console.print(f"[red]Ошибка при чтении {log_path}: {e}[/red]")
+        return
     status_counter = Counter()
     path_counter = Counter()
     ip_counter = Counter()
     user_agent_counter = Counter()
     errors = defaultdict(list)
-    with open(log_path) as f:
-        for line in f:
-            m = log_line_re.search(line)
-            if m:
-                ip = m.group('ip')
-                path = m.group('path')
-                status = m.group('status')
-                status_counter[status] += 1
-                path_counter[path] += 1
-                ip_counter[ip] += 1
-                if status.startswith('4') or status.startswith('5'):
-                    errors[status].append(path)
-            # user-agent (если есть)
-            if '" "' in line:
-                ua = line.rsplit('" "', 1)[-1].strip().strip('"')
-                if ua:
-                    user_agent_counter[ua] += 1
+    for line in lines:
+        m = log_line_re.search(line)
+        if m:
+            ip = m.group('ip')
+            path = m.group('path')
+            status = m.group('status')
+            status_counter[status] += 1
+            path_counter[path] += 1
+            ip_counter[ip] += 1
+            if status.startswith('4') or status.startswith('5'):
+                errors[status].append(path)
+        # user-agent (если есть)
+        if '" "' in line:
+            ua = line.rsplit('" "', 1)[-1].strip().strip('"')
+            if ua:
+                user_agent_counter[ua] += 1
     # Топ статусов
     table = Table(title="Top HTTP Status Codes", show_header=True, header_style="bold blue")
     table.add_column("Status")

{nginx_lens-0.1.5 → nginx_lens-0.1.7}/commands/route.py

@@ -6,19 +6,22 @@ from parser.nginx_parser import parse_nginx_config
 import glob
 import os
 
-app = typer.Typer()
+app = typer.Typer(help="Показывает, какой server/location обслуживает указанный URL. По умолчанию ищет во всех .conf в /etc/nginx/. Для кастомного пути используйте -c/--config.")
 console = Console()
 
 def route(
-    config_path: str = typer.Argument(None, help="Путь к nginx.conf (если не указан — поиск по всем .conf в /etc/nginx)", show_default=False),
-    url: str = typer.Argument(..., help="URL для маршрутизации (например, http://host/path)")
+    url: str = typer.Argument(..., help="URL для маршрутизации (например, http://host/path)"),
+    config_path: str = typer.Option(None, "-c", "--config", help="Путь к кастомному nginx.conf (если не указан — поиск по всем .conf в /etc/nginx)")
 ):
     """
     Показывает, какой server/location обслуживает указанный URL.
 
-    Пример:
-        nginx-lens route /etc/nginx/nginx.conf http://example.com/api/v1
+    По умолчанию ищет во всех .conf в /etc/nginx/.
+    Для кастомного пути используйте опцию -c/--config.
+
+    Примеры:
         nginx-lens route http://example.com/api/v1
+        nginx-lens route -c /etc/nginx/nginx.conf http://example.com/api/v1
     """
     configs = []
     if config_path:
@@ -31,8 +34,12 @@ def route(
     for conf in configs:
         try:
             tree = parse_nginx_config(conf)
+        except FileNotFoundError:
+            console.print(f"[red]Файл {conf} не найден. Проверьте путь к конфигу.[/red]")
+            continue
         except Exception as e:
-            continue  # пропускаем битые/невалидные
+            console.print(f"[red]Ошибка при разборе {conf}: {e}[/red]")
+            continue
         res = find_route(tree, url)
         if res:
             server = res['server']

{nginx_lens-0.1.5 → nginx_lens-0.1.7}/commands/syntax.py

@@ -33,7 +33,12 @@ def syntax(
         if not config_path:
             console.print("[red]Не удалось найти nginx.conf. Укажите путь через -c.[/red]")
             return
+    if not os.path.isfile(config_path):
+        console.print(f"[red]Файл {config_path} не найден. Проверьте путь к конфигу.[/red]")
+        return
     cmd = [nginx_path, "-t", "-c", os.path.abspath(config_path)]
+    if hasattr(os, 'geteuid') and os.geteuid() != 0:
+        cmd = ["sudo"] + cmd
     try:
         result = subprocess.run(cmd, capture_output=True, text=True, check=False)
         if result.returncode == 0:
@@ -41,8 +46,8 @@ def syntax(
             return
         else:
             console.print("[red]Ошибка синтаксиса![/red]")
-        console.print(result.stdout)
-        console.print(result.stderr)
+            console.print(result.stdout)
+            console.print(result.stderr)
         # Парсим все ошибки
         err = result.stderr or result.stdout
         errors = list(ERRORS_RE.finditer(err))

{nginx_lens-0.1.5 → nginx_lens-0.1.7}/commands/tree.py

@@ -34,7 +34,14 @@ def tree(
         nginx-lens tree /etc/nginx/nginx.conf --markdown
         nginx-lens tree /etc/nginx/nginx.conf --html
     """
-    tree_obj = parse_nginx_config(config_path)
+    try:
+        tree_obj = parse_nginx_config(config_path)
+    except FileNotFoundError:
+        console.print(f"[red]Файл {config_path} не найден. Проверьте путь к конфигу.[/red]")
+        return
+    except Exception as e:
+        console.print(f"[red]Ошибка при разборе {config_path}: {e}[/red]")
+        return
     root = RichTree(f"[bold blue]nginx.conf[/bold blue]")
     _build_tree(tree_obj.directives, root)
     if markdown:

{nginx_lens-0.1.5 → nginx_lens-0.1.7}/nginx_lens.egg-info/PKG-INFO

@@ -1,15 +1,17 @@
 Metadata-Version: 2.4
 Name: nginx-lens
-Version: 0.1.5
+Version: 0.1.7
 Summary: CLI-инструмент для анализа, визуализации и диагностики конфигураций Nginx
 Author: Daniil Astrouski
 Author-email: shelovesuastra@gmail.com
 Requires-Python: >=3.8
+License-File: LICENSE
 Requires-Dist: typer[all]>=0.9.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: requests>=2.25.0
 Dynamic: author
 Dynamic: author-email
+Dynamic: license-file
 Dynamic: requires-dist
 Dynamic: requires-python
 Dynamic: summary

{nginx_lens-0.1.5 → nginx_lens-0.1.7}/nginx_lens.egg-info/SOURCES.txt

@@ -1,3 +1,5 @@
+LICENSE
+README.md
 pyproject.toml
 setup.py
 analyzer/__init__.py

{nginx_lens-0.1.5 → nginx_lens-0.1.7}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name="nginx-lens",
-    version="0.1.5",
+    version="0.1.7",
     description="CLI-инструмент для анализа, визуализации и диагностики конфигураций Nginx",
     author="Daniil Astrouski",
     author_email="shelovesuastra@gmail.com",

nginx_lens-0.1.5/commands/diff.py

@@ -1,39 +0,0 @@
-import typer
-from rich.console import Console
-from rich.table import Table
-from analyzer.diff import diff_trees
-from parser.nginx_parser import parse_nginx_config
-
-app = typer.Typer()
-console = Console()
-
-def diff(
-    config1: str = typer.Argument(..., help="Первый nginx.conf"),
-    config2: str = typer.Argument(..., help="Второй nginx.conf")
-):
-    """
-    Сравнивает две конфигурации 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)
-    diffs = diff_trees(tree1, tree2)
-    if not diffs:
-        console.print("[green]Конфигурации идентичны[/green]")
-        return
-    table = Table(show_header=True, header_style="bold blue")
-    table.add_column("Config 1", style="red")
-    table.add_column("Config 2", style="green")
-    for d in diffs:
-        path = "/".join(d['path'])
-        if d['type'] == 'added':
-            table.add_row("", f"+ {path}")
-        elif d['type'] == 'removed':
-            table.add_row(f"- {path}", "")
-        elif d['type'] == 'changed':
-            v1 = str(d['value1'])
-            v2 = str(d['value2'])
-            table.add_row(f"! {path}\n{v1}", f"! {path}\n{v2}")
-    console.print(table)