astos 0.1.0__tar.gz

astos-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ASTOS
+
+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.

astos-0.1.0/PKG-INFO

@@ -0,0 +1,93 @@
+Metadata-Version: 2.4
+Name: astos
+Version: 0.1.0
+Summary: ASTOS — Abstract Syntax Tree Observer Service. Mapa 3D imersivo e 100% offline do seu repositório.
+Author: ASTOS
+License: MIT
+Project-URL: Homepage, https://github.com/HonoravelMacho/astos
+Project-URL: Repository, https://github.com/HonoravelMacho/astos
+Keywords: ast,graph,3d,three.js,webgl,cli,visualization
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Environment :: Console
+Classifier: Topic :: Software Development :: Documentation
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0
+Dynamic: license-file
+
+# ASTOS — Abstract Syntax Tree Observer Service
+
+[![PyPI version](https://img.shields.io/pypi/v/astos?style=flat-square&color=22d3ee)](https://pypi.org/project/astos/)
+[![Python](https://img.shields.io/badge/python-%3E%3D3.9-22d3ee?style=flat-square)](https://python.org)
+[![Offline](https://img.shields.io/badge/offline-100%25-f472b6?style=flat-square)]()
+[![License: MIT](https://img.shields.io/badge/license-MIT-fbbf24?style=flat-square)](LICENSE)
+
+> **Observe a estrutura viva do seu código em 3D imersivo. Zero CDN. Puro WebGL Sci-Fi.**
+
+O **ASTOS** escaneia qualquer repositório Python via AST, mapeia módulos,
+importações e dependências diretas, e gera um mapa **3D orbital** (Three.js
+vendorizado, 100% offline) com física de partículas, teia de aranha luminosa,
+**fita RGB animada** nos links selecionados, card HUD Sci-Fi por nó e botão de
+tela cheia.
+
+## Instalação
+
+```bash
+pip install astos
+```
+
+## Uso
+
+Dentro de qualquer repositório:
+
+```bash
+# primeira vez: cria .astos/, analisa, gera e abre no navegador
+astos
+
+# força varredura completa do zero
+astos -a
+astos --all
+```
+
+Isso gera `.astos/index.html` (arquivo único, offline) e abre automaticamente
+no navegador padrão. Pressione `ESC` para sair do fullscreen.
+
+## O que você vê
+
+- **Somente 3D imersivo** — esferas de neon, órbita contínua, zoom/pan/orbit.
+- **Teia de aranha visível de longe** — links com feixe luminoso aditivo + opacidade alta.
+- **Fita RGB animada** — fótons coloridos percorrem as arestas do nó selecionado
+  (toggle global `FLUXO RGB` disponível no HUD).
+- **Card HUD por clique** — nome do arquivo/módulo, caminho relativo,
+  importações/dependências diretas e degree centrality.
+- **Tema Sci-Fi/Chronos** — HUD cyberpunk dark, neon cyan/magenta, painéis foscos,
+  fonte monospace, scanlines + vinheta.
+
+## Como funciona
+
+1. `astos/parser.py` — varre `**/*.py`, parseia `ast.Import` / `ast.ImportFrom`,
+   resolve dependências locais e calcula o grau de cada módulo.
+2. `astos/generator.py` — injeta o grafo + `three.min.js` + `OrbitControls.js`
+   (vendorizados em `astos/vendor/`) em um HTML único, sem nenhum fetch externo.
+3. `astos/cli.py` — gerencia `.astos/`, cache incremental em
+   `.astos/graph.json` e abertura automática no navegador.
+
+## Estrutura
+
+```
+astos/
+  __init__.py
+  cli.py          # CLI `astos` / `astos -a` (click)
+  parser.py       # AST scan -> {nodes, links}
+  generator.py    # HTML 3D Sci-Fi offline (Three.js inline)
+  vendor/
+    three.min.js        # r128 UMD (offline)
+    OrbitControls.js    # UMD compatível com r128 (offline)
+```
+
+## Licença
+
+MIT — veja [LICENSE](LICENSE).

astos-0.1.0/README.md

@@ -0,0 +1,73 @@
+# ASTOS — Abstract Syntax Tree Observer Service
+
+[![PyPI version](https://img.shields.io/pypi/v/astos?style=flat-square&color=22d3ee)](https://pypi.org/project/astos/)
+[![Python](https://img.shields.io/badge/python-%3E%3D3.9-22d3ee?style=flat-square)](https://python.org)
+[![Offline](https://img.shields.io/badge/offline-100%25-f472b6?style=flat-square)]()
+[![License: MIT](https://img.shields.io/badge/license-MIT-fbbf24?style=flat-square)](LICENSE)
+
+> **Observe a estrutura viva do seu código em 3D imersivo. Zero CDN. Puro WebGL Sci-Fi.**
+
+O **ASTOS** escaneia qualquer repositório Python via AST, mapeia módulos,
+importações e dependências diretas, e gera um mapa **3D orbital** (Three.js
+vendorizado, 100% offline) com física de partículas, teia de aranha luminosa,
+**fita RGB animada** nos links selecionados, card HUD Sci-Fi por nó e botão de
+tela cheia.
+
+## Instalação
+
+```bash
+pip install astos
+```
+
+## Uso
+
+Dentro de qualquer repositório:
+
+```bash
+# primeira vez: cria .astos/, analisa, gera e abre no navegador
+astos
+
+# força varredura completa do zero
+astos -a
+astos --all
+```
+
+Isso gera `.astos/index.html` (arquivo único, offline) e abre automaticamente
+no navegador padrão. Pressione `ESC` para sair do fullscreen.
+
+## O que você vê
+
+- **Somente 3D imersivo** — esferas de neon, órbita contínua, zoom/pan/orbit.
+- **Teia de aranha visível de longe** — links com feixe luminoso aditivo + opacidade alta.
+- **Fita RGB animada** — fótons coloridos percorrem as arestas do nó selecionado
+  (toggle global `FLUXO RGB` disponível no HUD).
+- **Card HUD por clique** — nome do arquivo/módulo, caminho relativo,
+  importações/dependências diretas e degree centrality.
+- **Tema Sci-Fi/Chronos** — HUD cyberpunk dark, neon cyan/magenta, painéis foscos,
+  fonte monospace, scanlines + vinheta.
+
+## Como funciona
+
+1. `astos/parser.py` — varre `**/*.py`, parseia `ast.Import` / `ast.ImportFrom`,
+   resolve dependências locais e calcula o grau de cada módulo.
+2. `astos/generator.py` — injeta o grafo + `three.min.js` + `OrbitControls.js`
+   (vendorizados em `astos/vendor/`) em um HTML único, sem nenhum fetch externo.
+3. `astos/cli.py` — gerencia `.astos/`, cache incremental em
+   `.astos/graph.json` e abertura automática no navegador.
+
+## Estrutura
+
+```
+astos/
+  __init__.py
+  cli.py          # CLI `astos` / `astos -a` (click)
+  parser.py       # AST scan -> {nodes, links}
+  generator.py    # HTML 3D Sci-Fi offline (Three.js inline)
+  vendor/
+    three.min.js        # r128 UMD (offline)
+    OrbitControls.js    # UMD compatível com r128 (offline)
+```
+
+## Licença
+
+MIT — veja [LICENSE](LICENSE).

astos-0.1.0/astos/__init__.py

@@ -0,0 +1,4 @@
+"""ASTOS — Abstract Syntax Tree Observer Service."""
+
+__version__ = "0.1.0"
+__all__ = ["__version__"]

astos-0.1.0/astos/cli.py

@@ -0,0 +1,65 @@
+"""CLI do ASTOS: `astos` e `astos -a/--all`."""
+
+from __future__ import annotations
+
+import json
+import time
+import webbrowser
+from pathlib import Path
+
+import click
+
+from .generator import generate
+from .parser import scan_repository
+
+
+@click.command(context_settings={"help_option_names": ["-h", "--help"]})
+@click.option("-a", "--all", "full", is_flag=True,
+              help="Força varredura completa do zero (ignora cache incremental).")
+@click.option("--no-open", is_flag=True, default=False,
+              help="Gera os arquivos sem abrir o navegador.")
+@click.option("--path", "root", default=".", type=click.Path(exists=True, file_okay=False),
+              help="Raiz do repositório a analisar (padrão: diretório atual).")
+def main(full: bool, no_open: bool, root: str) -> None:
+    """ASTOS — Abstract Syntax Tree Observer Service (3D offline)."""
+    repo = Path(root).resolve()
+    astos_dir = repo / ".astos"
+    index = astos_dir / "index.html"
+    cache = astos_dir / "graph.json"
+
+    existed = astos_dir.exists()
+    astos_dir.mkdir(parents=True, exist_ok=True)
+
+    if full and cache.exists():
+        cache.unlink()
+        click.echo("ASTOS :: flag -a/--all detectada — cache descartado, varredura completa do zero.")
+
+    if not existed:
+        click.echo(f"ASTOS :: inicializando observer em {repo}")
+    else:
+        click.echo("ASTOS :: .astos/ encontrada — atualizando dados incrementalmente...")
+
+    t0 = time.time()
+    graph = scan_repository(repo)
+    graph["meta"]["generated_in_s"] = round(time.time() - t0, 2)
+    graph["meta"]["full_rescan"] = bool(full) or not existed
+
+    cache.write_text(json.dumps(graph, ensure_ascii=False, indent=1), encoding="utf-8")
+    generate(index, graph)
+
+    click.echo(
+        f"ASTOS :: {len(graph['nodes'])} nós · {len(graph['links'])} arestas "
+        f"-> {index} (100% offline, 3D imersivo)"
+    )
+    if not no_open:
+        try:
+            webbrowser.open(index.as_uri())
+            click.echo("ASTOS :: interface aberta no navegador padrão.")
+        except Exception as exc:  # noqa: BLE001
+            click.echo(f"ASTOS :: não foi possível abrir o navegador: {exc}")
+            click.echo(f"ASTOS :: abra manualmente: {index}")
+    click.echo("ASTOS :: dica: 'astos -a' força rescan completo · [⛶ FULLSCREEN] + ESC no HUD.")
+
+
+if __name__ == "__main__":
+    main()