RIFC v1.0

Release v1.0.0 — RIFC (Rama's Instant Flow Chart)

---

ENGLISH

We are excited to announce the initial release of RIFC (Rama's Instant Flow Chart), a lightweight, text-to-diagram desktop application built to turn intuitive pseudocode into structured flowcharts in real time.

Distribution Formats

RIFC 1.0.0 is distributed in two formats to suit different user needs:

1. Portable Bundle (.zip) — Plug & Play:

   • Includes the compiled standalone executable (RIFC.exe), the custom application icon, and all runtime dependencies pre-packaged.

   • Zero installation required: Just unzip and launch. Ideal for users who want to run RIFC immediately on Windows without configuring a Python environment.

2. Standalone Python Source:

   • The pure Python source code.

   • Ultra-lightweight: Orders of magnitude smaller in download size and memory overhead.

   • Recommended for developers, cross-platform users (Linux, macOS), or anyone who prefers running scripts in their own virtual environment.

Highlights & Core Features

• Intuitive Text-Based Syntax:
  Write structured diagrams using clean commands:

  • start(...) and end(...): Diagram entry and exit points.

  • act(label)(description): Process boxes (with optional jumping labels).

  • io(...): Input/Output blocks (parallelogram shape).

  • db(...): Database blocks (cylinder shape).

  • doc(...): Document blocks.

  • If (condition)( If1 ... If2 ... ): Multi-branch decision blocks (diamond shape).

  • loopstart(name) / loopend(name)(condition): Native loops with return paths.

  • jmp(label): Jump directly to any labeled process.

• Real-Time Interactive Preview:

  • Fast native canvas rendering with syntax-aware layout calculation.

  • Instant refresh shortcut (Ctrl + Enter).

  • Canvas pan and zoom via Ctrl + Mouse Wheel.

• Code Editor Ergonomics:

  • Automatic parenthesis closing () to speed up typing.

  • Integrated syntax validator that warns about unclosed blocks or missing target labels.

• Export Capabilities:

  • Native SVG Export: Scalable vector output generated directly with zero external dependencies.

  • PNG & PDF Export: High-resolution exports available via Cairo integration.

• Customization & Themes:

  • Application Themes: Light and Dark interface modes.

  • Diagram Styles: Pre-configured palettes (Clásico, Moderno, Académico) plus a fully customizable color palette (Personalizado).

  • Persistent user preferences saved automatically (rifc_config.json and rifc_presets.json).

• Bilingual Support (i18n):

  • Seamless runtime switching between English (may have some things untranslated) and Spanish.

Requirements (Source Code Only)

If you are running RIFC from the source script rather than the portable .exe:

• Python: 3.8 or higher

• Standard Library: tkinter (included with standard Python installers)

• Required Package:

  pip install pillow
  
  

• Optional Package (for PNG/PDF export):

  pip install cairosvg
  
  

  (Note: Cairo requires system DLLs on Windows if exporting to PNG/PDF from source).

---

ESPAÑOL

Nos complace presentar el lanzamiento inicial de RIFC (Rama's Instant Flow Chart), una herramienta de escritorio diseñada para convertir pseudocódigo intuitivo en diagramas de flujo estructurados y limpios en tiempo real.

Formas de Distribución

RIFC 1.0.0 está disponible en dos modalidades según tus necesidades:

1. Paquete Portable (.zip) — Listo para usar:

   • Contiene el ejecutable compilado (RIFC.exe), icono y su carpeta de dependencias empaquetadas.

   • Sin instalación ni configuraciones: Solo descomprimir y ejecutar. Diseñado para usuarios de Windows que no desean lidiar con entornos de Python.

2. Código Fuente Python:

   • El script de código abierto original.

   • Ultra liviano: Pesa una fracción minúscula comparado con el ejecutable compilado y consume el mínimo indispensable de recursos.

   • Ideal para desarrolladores, usuarios de otros sistemas operativos (Linux, macOS) o quienes prefieran ejecutarlo en su propio entorno.

Novedades y Características Principales

• Sintaxis Basada en Texto Intuitiva:
  Diseña diagramas claros y estructurados con comandos simples:

  • start(...) y end(...): Nodos obligatorios de inicio y fin.

  • act(etiqueta)(descripción): Cajas de proceso (admite etiquetas para saltos condicionales).

  • io(...): Bloques de entrada/salida (paralelogramos).

  • db(...): Bloques de base de datos (cilindros).

  • doc(...): Bloques de documentación.

  • If (condición)( If1 ... If2 ... ): Decisiones multirrama estructuradas (rombos).

  • loopstart(nombre) / loopend(nombre)(condición): Bucles nativos con trazado curvo de retorno.

  • jmp(etiqueta): Saltos directos a procesos etiquetados.

• Vista Previa Interactiva:

  • Motor de trazado nativo en lienzo con autoajuste de posiciones y niveles.

  • Atajo rápido de actualización (Ctrl + Enter).

  • Zoom interactivo en el lienzo con Ctrl + Rueda del ratón.

• Editor de Código Ergonómico:

  • Autocierre de paréntesis () para redactar diagramas con mayor agilidad.

  • Validador de sintaxis integrado que reporta errores como paréntesis desbalanceados, bucles sin cerrar o saltos a etiquetas inexistentes.

• Opciones de Exportación:

  • Exportación SVG Nativa: Genera archivos vectoriales escalables limpios directamente, sin requerir librerías externas.

  • Exportación a PNG y PDF: Exportación gráfica de alta resolución (mediante integración con Cairo).

• Personalización y Estilos:

  • Tema de Interfaz: Modo Claro y Modo Oscuro.

  • Estilos de Diagrama: Paletas predefinidas (Clásico, Moderno, Académico) y modo completamente configurable con selector de color (Personalizado).

  • Guardado persistente de preferencias (rifc_config.json y rifc_presets.json).

• Soporte Bilingüe (i18n):

  • Cambio de idioma al vuelo entre Español e Inglés (podría tener partes sin traducir).

Requisitos (Solo para versión en código fuente)

Si decides ejecutar el script .py en lugar del portable compilado:

• Python: 3.8 o superior

• Biblioteca Gráfica: tkinter (incluido habitualmente con Python)

• Dependencia Obligatoria:

  pip install pillow
  
  

• Dependencia Opcional (para exportar a PNG/PDF):

  pip install cairosvg
  
  

You can find the source code in the repo // Puedes encontrar el codigo fuente en el repositorio.

If you find bugs, don't doubt to contact me // Si encuentras bugs no dudes en contactarme