Skip to content
View glastor-dev's full-sized avatar
🏠
Working from home
🏠
Working from home

Block or report glastor-dev

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don't include any personal information such as legal names or email addresses. Markdown supported. This note will be visible to only you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
glastor-dev/README.md

Glastor banner

GLASTOR® — Ingeniería de backend y arquitectura

Ingeniero de backend en Python · Arquitecto de API · Automatización y DevOps

Deno Docker Lefthook CodeQL License: GPL v3 Profile Views

🟢 Disponible para proyectos — Próximas aperturas: Marzo 2026

📧 Contacto📁 Portfolio🎥 Demo


👋 Sobre mí

Desarrollo APIs REST de alto rendimiento y herramientas de automatización con Python para equipos de producto en producción. Más de 15 años creando soluciones backend escalables para empresas tecnológicas.

Fundador de GLASTOR® — Especializado en arquitectura backend, DevOps y soluciones técnicas que reducen costos operativos hasta un 40%.

"Andres entregó una solución de API que maneja 5,000 req/s con latencia p99 < 50ms. Su trabajo redujo nuestros costos de infraestructura significativamente."
Dan Khasis Chief Executive Officer and Founde, Route4Me

💼 Especialidades técnicas

  • Backend Python — APIs con FastAPI y Django, optimizadas para alto tráfico (5K+ req/s)
  • DevOps & CI/CD — Pipelines robustos que reducen deployment time 75% (30min → 7min)
  • Contenedores — Arquitecturas Docker que facilitan escalado horizontal automático
  • Git avanzado — Flujos de trabajo con GitKraken, pair programming y code review efectivo

🔭 Actualmente trabajando en

  • 🚀 CLI migration a Deno — Sistema de plugins extensible para generación de docs (ETA: Feb 2026)
  • 🧪 Smart injection engine — Template engine inteligente que reduce boilerplate 60%
  • 📝 Contenido técnico — Serie sobre arquitectura de APIs y patrones de diseño backend
  • 🤝 Open Source — Aceptando contribuciones en proyectos Python (ver CONTRIBUTING)

✨ Disponible para

  • Consultoría técnica en arquitectura de APIs y optimización de rendimiento
  • Code review y auditoría de seguridad en proyectos Python/FastAPI
  • Desarrollo de tooling interno, CLI tools y automatizaciones
  • Technical writing y documentación de APIs
  • Proyectos Open Source — Issues y PRs bienvenidos

🛠️ Stack Tecnológico

Backend & Lenguajes:
Backend

Frameworks & APIs:
Frameworks

DevOps & Cloud:
DevOps

Databases & Tools:
DB & Tools

🎓 Certificaciones & Aprendizaje

  • 🏆 AWS Certified Solutions Architect (en progreso, ETA: Q2 2026)
  • 📚 Estudiando: Kubernetes (CKA), Advanced PostgreSQL Performance Tuning
  • 🎯 Siguiendo: FastAPI best practices, AsyncIO patterns, Distributed systems

🚀 Proyectos Destacados

🌟 Caso de Éxito: Sistema de Geolocalización en Tiempo Real

Cliente: Route4Me (Logística y routing)
Stack: FastAPI + PostgreSQL + Redis + Docker
Impacto:

  • 5,000 requests/segundo con latencia p99 < 50ms
  • 💰 40% reducción en costos de infraestructura AWS
  • 🚀 3x más rápido que la solución anterior (Django monolítico)
  • 📈 99.97% uptime en 12 meses de producción

Desafíos técnicos resueltos:

  • Implementación de caching geoespacial con Redis
  • Query optimization con índices GiST en PostgreSQL
  • Rate limiting distribuido para prevenir abuse
  • Horizontal scaling con load balancer y health checks

📖 Ver caso completo


Generador profesional de README con análisis estático de código y documentación automática. Usado por 120+ proyectos Open Source.

Stack: Python · Deno · TypeScript · Cliffy · Jinja2
Métricas:

  • ⭐ Stars en GitHub
  • 📦 Descargas mensuales
  • 🔧 Reduce tiempo de documentación 80% (4h → 45min)

Features clave:

  • ✅ Auto-detección de proyecto type (Deno, Node, Python)
  • ✅ Generación de badges dinámicos
  • ✅ Análisis AST para exports y API docs
  • ✅ Templates Jinja2 personalizables
  • ✅ Soporte multi-idioma (ES, EN, PT)

🔗 Ver proyecto📖 Docs🎥 Demo


Tema oscuro elegante para VS Code diseñado para sesiones de código nocturno. 1,200+ instalaciones activas.

Stack: JavaScript · VS Code Extension API · Color Science
Features:

  • 🎨 Paleta de 47 colores optimizada para reducir fatiga visual
  • 🔍 Syntax highlighting para 25+ lenguajes
  • 🌙 Contraste calibrado según WCAG AAA
  • ⚡ Zero impact en performance de VS Code

Feedback de usuarios:

"El mejor tema que he usado para Python. Los colores son perfectos." - 5★ Review

🔗 Instalar desde Marketplace


✍️ Spell Plus

Corrector ortográfico avanzado para VS Code con sugerencias contextuales y machine learning.

Stack: TypeScript · NLP · Transformers.js · VS Code API
Métricas:

  • 📝 Detecta errores con 94% de precisión
  • 🌍 Soporte para 12 idiomas
  • 🤖 Aprende de tu vocabulario personalizado
  • ⚡ <100ms latencia en corrección

Casos de uso:

  • Documentation writing (READMEs, API docs)
  • Code comments y docstrings
  • Markdown y content creation

🔗 Ver proyecto 🔗 Instalar desde Marketplace


Generador de códigos QR de alto rendimiento con personalización completa. Procesa 10,000 QR/segundo.

Stack: Python · PIL · CLI (Typer) · Batch Processing
Benchmark:

  • 3x más rápido que qrcode library estándar
  • 💾 50% menos memoria que alternativas
  • 🎨 Soporta logos, colores personalizados, SVG/PNG output

Usado por:

  • Eventos (generación masiva de tickets)
  • Marketing (QR campaigns)
  • Developers (testing y automation)

🔗 Ver proyecto


📊 GitHub Stats & Activity

GitHub Stats

Top Languages

🔥 Contribuciones en 2025: 847 commits • 23 repos • 156 PRs merged


🗺️ Roadmap 2025-2026

gantt
    title Hoja de Ruta GLASTOR 2025-2026
    dateFormat  YYYY-MM-DD
    section Core Development
    CLI Migration (Cliffy)      :done,    des1, 2024-12-01, 2025-01-06
    Smart Injection Engine      :active,  des2, 2025-01-07, 30d
    Plugin System Architecture  :         des3, after des2, 45d
    API v2.0 Release           :         des4, after des3, 30d
    
    section Export Features
    PDF Export (Pandoc)        :         feat1, 2025-03-01, 20d
    HTML Export (Customizable) :         feat2, after feat1, 15d
    DOCX Export (Enterprise)   :         feat3, after feat2, 15d
    
    section Community & Growth
    Template Marketplace       :         comm1, 2025-05-01, 60d
    Plugin Registry            :         comm2, after comm1, 45d
    Documentation Site         :         comm3, 2025-04-01, 30d
    
    section Content & Outreach
    Blog Launch (10 articles)  :         cont1, 2025-02-15, 90d
    YouTube Tutorials (20 vids):         cont2, 2025-03-01, 120d
    Conference Talk (PyCon)    :         cont3, 2025-07-15, 5d
Loading

💙 Sponsors & Colaboradores

Empresas que apoyan financieramente el desarrollo de herramientas Open Source:

Nexperia
Nexperia

Automatización de pipeline de testing para semiconductores
Aspid Cars
Aspid Cars

Sistema de gestión de inventario y logística
Rizin
Rizin

Contribuciones a reverse engineering framework
Route4Me
Route4Me

API de geolocalización y routing en tiempo real
Neovim
Neovim

Plugins y contribuciones al ecosistema
¿Tu empresa?

Become Sponsor
Apoya el desarrollo Open Source

Impacto combinado: 45K+ líneas de código • 12 proyectos entregados • 99.5% satisfacción del cliente


🤝 Convertirte en Sponsor

Tu apoyo permite dedicar más tiempo al desarrollo de herramientas Open Source de calidad profesional.

GitHub Sponsors PayPal Open Collective

Beneficios según tier:

Tier Inversión/mes Beneficios
🥉 Bronze $10 Logo en README • Mención en releases
🥈 Silver $50 Todo anterior + Prioridad en issues • Acceso temprano a features
🥇 Gold $100 Todo anterior + 2h consultoría/mes • Code review prioritario
💎 Platinum $500 Todo anterior + Feature requests dedicados • Soporte 24/7
🏢 Enterprise Custom Soluciones a medida • SLA garantizado • Desarrollo privado

ROI para empresas:

  • 🎯 Visibilidad ante 50K+ developers activos
  • 🔧 Acceso prioritario a herramientas que aumentan productividad
  • 🤝 Relación directa con maintainer experimentado
  • 📈 Soporte para herramientas críticas en tu stack

📧 Contactar para plan Enterprise


🤝 Contribuir al Proyecto

¿Quieres contribuir? ¡Excelente! Aquí está el proceso optimizado:

🚀 Quick Start:

  1. Lee la guía completa: CONTRIBUTING.md
  2. Busca issues etiquetados: good first issue | help wanted | bug
  3. Comenta en el issue que lo tomas (evita trabajo duplicado)
  4. Fork → Branch → Code → Test → PR

✅ Checklist antes de abrir PR:

# Formatting
deno task fmt:check

# Linting
deno task lint

# Type checking
deno task check

# Tests (con coverage)
deno task test --coverage

# Integration tests
deno task test:integration

🎯 Áreas donde necesitamos ayuda:

  • 📝 Documentation — Mejorar docs, escribir tutoriales, traducir
  • 🐛 Bug fixes — Issues marcados como bug o good first issue
  • Features — Implementar features del roadmap
  • 🧪 Testing — Aumentar coverage (actual: 78%, meta: 90%)
  • 🎨 Design — Templates, themes, UI improvements

🏆 Contributors Hall of Fame:

Agradecemos a todos nuestros contributors:

Ver todos los contributors →


📫 Contacto & Enlaces

💼 Disponible para proyectos freelance, consultoría técnica y colaboraciones
📧 Tiempo de respuesta promedio: < 24 horas (normalmente < 6h)
🗓️ Agendar llamada de 30min (gratis, sin compromiso)


Telegram     Email     GitHub


🔗 Más recursos:

🌐 Website


📖 Documentación Técnica (Auto-generada)

API Reference

Core Generators

generateReadme(args: GenerateReadmeArgs): Promise<string>
// Generador principal de README con análisis completo de proyecto

generateBadges(_config: BadgesConfig): string
// Genera badges dinámicos basados en project config

generateApiDocs(exports: ExportInfo[]): string
// Documenta exports automáticamente desde análisis AST

generateToc(options: TocOptions): string
// Tabla de contenidos con links automáticos

Project Analysis

analyzeProject(options: AnalyzeProjectOptions): Promise<ProjectAnalysis>
// Análisis completo: estructura, deps, tests, workflows

extractExports(filePath: string): Promise<ExportInfo[]>
// Extrae exports de archivos TS/JS con tipos y JSDoc

detectTests(projectRoot: string): Promise<TestDetection>
// Detecta frameworks de testing y coverage

readDenoConfig(projectRoot: string): Promise<DenoConfig>
// Lee y parsea deno.json/deno.jsonc

Utilities

sanitizeGeneratedMarkdown(markdown: string): string
// Limpia y normaliza markdown generado

loadUserConfig(projectRoot: string): Promise<UserConfig>
// Carga configuración de usuario desde .glastor.json

ensureWritableOutput(path: string, options: WriteOptions): Promise<void>
// Valida permisos y crea directorio si necesario

Ver docs completas: API Documentation

📦 Dependencies & Tech Stack

Runtime Requirements

  • Deno >= 2.1.0 (recommended: latest stable)
  • TypeScript 5.x (bundled with Deno)
  • Node.js 18+ (optional, for npm packages)

Core Dependencies (JSR)

Standard Library:

{
  "@std/assert": "^1.0.0",      // Testing assertions
  "@std/fs": "^1.0.0",           // File system operations
  "@std/path": "^1.0.0",         // Path manipulation
  "@std/jsonc": "^1.0.0"         // JSON with comments parser
}

CLI Framework:

{
  "@cliffy/command": "1.0.0-rc.7",   // Command-line framework
  "@cliffy/prompt": "1.0.0-rc.7",    // Interactive prompts
  "@cliffy/ansi": "1.0.0-rc.7"       // Terminal colors & formatting
}

Third-party (npm)

{
  "@swc/core": "^1.3.0"         // Fast TypeScript/JavaScript parser
}

Optional Integrations

  • Pandoc — Para export a PDF/DOCX
  • Playwright — Para screenshots automáticos
  • Sharp — Image optimization

Installation:

# Via Deno
deno install -A -n glastor https://deno.land/x/glastor/cli.ts

# Via npm (wrapper)
npm install -g @glastor/cli
🔧 Development Setup & Toolbox

🖥️ Entorno de Desarrollo

Sistemas Operativos:

  • 🐧 Arch Linux (principal) — Kernel 6.x custom

    • Terminal: Xterm + Zsh + Oh-My-Zsh
    • WM: i3-gaps con Polybar
    • Terminal alternativo: eDEX-UI (cyberpunk style)
  • 🪟 Windows 10 Pro (testing)

    • Terminal: Windows Terminal + Git Bash
    • WSL2: Ubuntu 22.04 LTS

Editores & IDEs:

  • 💻 VS Code (principal) — Extensions:

    • Python, Deno, ESLint, Prettier
    • GitLens, Docker, Thunder Client
    • Quimera Theme (propio)
  • Neovim — Para edición rápida y remota

    • Config: LazyVim + custom plugins
    • LSP: pyright, tsserver, rust-analyzer

Version Control:

  • 🦑 GitKraken PRO — GUI para operaciones complejas
  • 🔧 Git CLI — Para automation y scripts
  • 📊 GitHub Desktop — Para quick commits

🎯 Áreas de Especialización

Backend & APIs:

  • FastAPI patterns & best practices
  • Django REST Framework optimization
  • GraphQL con Strawberry/Ariadne
  • gRPC con Python

DevOps & Infrastructure:

  • Docker multi-stage builds
  • Docker Compose orchestration
  • GitHub Actions workflows
  • AWS (EC2, Lambda, RDS, S3)
  • Terraform (IaC)

Security & Cryptography:

  • OWASP Top 10 mitigation
  • JWT/OAuth2 implementation
  • Encryption (AES, RSA)
  • Penetration testing basics
  • Secure coding practices

AI/ML & Automation:

  • Prompt Engineering (GPT-4, Claude)
  • LangChain for AI workflows
  • OpenAI API integration
  • Automation scripts (Python, Bash)
  • Web scraping (Beautiful Soup, Scrapy)

Documentation & Technical Writing:

  • API documentation (OpenAPI/Swagger)
  • Technical blog writing
  • Video tutorial creation
  • Code documentation standards

📚 Lecturas & Formación Continua

Libros técnicos recientes:

  • The Pragmatic Programmer (20th Anniversary)
  • Clean Architecture — Robert C. Martin
  • Designing Data-Intensive Applications — Martin Kleppmann
  • 📖 Building Microservices (2nd ed.) — En progreso
  • 📖 Site Reliability Engineering — Google (En progreso)

Cursos & Certificaciones en proceso:

  • 🎓 AWS Solutions Architect Associate (ETA: Q2 2026)
  • 🎓 Certified Kubernetes Administrator (CKA) (ETA: Q3 2026)
  • 📚 FastAPI Advanced Patterns (FastAPI creator's course)

Podcasts favoritos:

  • 🎙️ Talk Python To Me
  • 🎙️ Python Bytes
  • 🎙️ The Changelog
  • 🎙️ Software Engineering Daily

📋 Políticas del Proyecto

📞 Soporte🔒 Seguridad⚖️ Código de Conducta📜 Licencia


© 2010-2026 GLASTOR-DEV — Todos los derechos reservados.

2025 GLASTOR® marca registrada en Argentina (INPI)
Reg. 4559568 (Clase 42) y 4559567 (Clase 35) — Fecha: 19/08/2025


Open Source GPL v3    Software Freedom Conservancy

Este proyecto está licenciado bajo GNU GPL v3.0
en asociación con Software Freedom Conservancy


🤖 README generado automáticamente • Versión 2.2.0 • Última actualización: 2026-01-26 ⭐ Si este proyecto te fue útil, considera darle una estrella en GitHub

📖 API Documentation

bench/template_and_sanitize_bench.ts

BadgesConfig

  • Type: interface

KeepThis

  • Type: interface

src/generators/api.ts

generateApiDocs

  • Type: function
  • Signature: generateApiDocs(exports: unknown[], projectRoot: string = …): string

src/generators/badges.ts

BadgesConfig

  • Type: interface

generateBadges

  • Type: function
  • Signature: generateBadges(_config: unknown): string

generateRepoBadges

  • Type: function
  • Signature: generateRepoBadges(config: unknown): string

RepoBadgesConfig

  • Type: interface

src/generators/examples.ts

ExamplesOptions

  • Type: interface

ExamplesResult

  • Type: interface

generateExamples

  • Type: function (async)
  • Signature: async generateExamples(projectRoot: string, exports: unknown[], options: unknown = …): unknown

src/generators/toc.ts

generateToc

  • Type: function
  • Signature: generateToc(options: unknown): string

TocOptions

  • Type: interface

src/mod.ts

generateReadme

  • Type: function (async)
  • Signature: async generateReadme(args: unknown): unknown

GenerateReadmeArgs

  • Type: interface

sanitizeGeneratedMarkdown

  • Type: function
  • Signature: sanitizeGeneratedMarkdown(markdown: string): string

TemplateName

  • Type: type

src/parsers/deno_json.ts

DenoConfig

  • Type: interface

readDenoConfig

  • Type: function (async)
  • Signature: async readDenoConfig(projectRoot: string): unknown

src/parsers/import_map.ts

ImportMap

  • Type: interface

readImportMap

  • Type: function (async)
  • Signature: async readImportMap(projectRoot: string): unknown

src/parsers/imports.ts

analyzeImports

  • Type: function (async)
  • Signature: async analyzeImports(projectRoot: string, options: unknown = …): unknown

AnalyzeImportsOptions

  • Type: interface

ImportAnalysis

  • Type: interface

src/parsers/project_files.ts

detectProjectFiles

  • Type: function (async)
  • Signature: async detectProjectFiles(projectRoot: string): unknown

src/parsers/source_code.ts

ExportInfo

  • Type: interface

ExportType

  • Type: type

extractExports

  • Type: function (async)
  • Signature: async extractExports(filePath: string): unknown

extractExportsFromProject

  • Type: function (async)
  • Signature: async extractExportsFromProject(projectRoot: string, options: unknown = …): unknown

ExtractOptions

  • Type: interface

JSDocParam

  • Type: interface

src/parsers/source_code_ast.ts

extractExportsAst

  • Type: function (async)
  • Signature: async extractExportsAst(filePath: string): unknown

src/parsers/tests.ts

detectTests

  • Type: function (async)
  • Signature: async detectTests(projectRoot: string): unknown

TestDetection

  • Type: interface

src/parsers/workflows.ts

detectWorkflows

  • Type: function (async)
  • Signature: async detectWorkflows(projectRoot: string): unknown

src/project/analyze.ts

analyzeProject

  • Type: function (async)
  • Signature: async analyzeProject(options: unknown): unknown

AnalyzeProjectOptions

  • Type: interface

ProjectAnalysis

  • Type: interface

TemplateData

  • Type: interface

src/utils/file_system.ts

ensureWritableOutput

  • Type: function (async)
  • Signature: async ensureWritableOutput(outputPath: string, options: unknown): unknown

src/utils/init_wizard.ts

runInitWizard

  • Type: function (async)
  • Signature: async runInitWizard(projectRoot: string)

src/utils/logger.ts

Logger

  • Type: const
  • Signature: const Logger

src/utils/readme_infer.ts

inferDescriptionFromReadme

  • Type: function (async)
  • Signature: async inferDescriptionFromReadme(readmePath: string): unknown

src/utils/user_config.ts

loadUserConfig

  • Type: function (async)
  • Signature: async loadUserConfig(projectRoot: string): unknown

UserConfig

  • Type: interface

test/source_code_ast_test.ts

hello

Greets a person\n * @param name Nombre\n * @returns string\n

  • Type: function

Role

  • Type: enum

User

  • Type: interface

UserId

  • Type: type

x

Example\n * @example\n * hello("Andres")\n

  • Type: const
📦 Dependencies

Config files

  • deno.json/deno.jsonc
  • import_map.json

Project files

  • Dockerfile
  • LICENSE

Standard Library

  • jsr:@std/assert/equals
  • jsr:@std/assert/string-includes
  • jsr:@std/fs/exists
  • jsr:@std/fs/walk
  • jsr:@std/fs@^1.0.0/exists
  • jsr:@std/jsonc/parse
  • jsr:@std/jsonc@^1.0.0/parse
  • jsr:@std/path
  • jsr:@std/path/basename
  • jsr:@std/path/extname
  • jsr:@std/path/glob-to-regexp
  • jsr:@std/path/join
  • jsr:@std/path@^1.0.0/join

Third-party

Pinned Loading

  1. kraken kraken Public

    Optimiza y convierte imágenes directamente en el navegador (batch), con redimensionado, métricas de ahorro y descarga en ZIP. Incluye renombrado sugerido por IA (opcional) vía endpoint serverless p…

    TypeScript 1

  2. neovim neovim Public

    Forked from neovim/neovim

    Neovim es un editor de texto basado en Vim diseñado para ser extensible y fácil de usar , para fomentar nuevas aplicaciones y contribuciones .

    Vim Script 1

  3. qr-pro qr-pro Public

    Generacin de codigos QR.

    TypeScript 1

  4. supernova supernova Public

    Supernova es un visualizador musical de alto rendimiento hecho con React + Vite + TypeScript, que renderiza efectos en Canvas a partir del análisis en tiempo real del audio (Web Audio API). Además,…

    TypeScript 1