ASTOS — Abstract Syntax Tree Observer Service

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

pip install astos

Uso

Dentro de qualquer repositório:

# 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.