Skip to content

Releases: 9th-Floor-Developers/Translatable-Python

v1.0.0 - First Release

07 Oct 03:17

Choose a tag to compare

This marks the first pre-release and first ever tag of the Translatable-Python project.

Purpose & Overview

In this stage, the core system for translating custom keywords from lang.csv into valid Python and executing the full program is complete. Recursive functions, control flow, built-ins, and string handling are supported. The ground is laid for further enhancements.

Key Features

  1. Keywords Translated Via CSV
    • Users define mappings in lang.csv (e.g. if,whenever) and those are applied across the entire program.
  2. Control Flow Support
    • Keywords like if, while, try, def, etc. are all fully supported.
    • Recursion and return types for more advanced programs are operational.
  3. String Literal Detection
    • String-scanning logic exists so that programs do not translate keywords if they are within string literals.
    • The intention for this is to prevent translations for any string literals, specifically literals in print statements.
  4. Simple/Clear Architecture
    • Clean separation of concerns with functions
    • Plenty of documentation with single line comments and docstrings for functions
    • Function name abstraction (e.g.: translate_program, run_program)
    • Structured file hierarchy with possibility for improvements and expansion in example/
    • Compiler runs efficiently inside a <145 line Python file (lang.py).
  5. Potential For Future Additions
    • Project is structured to dynamically translate keywords located in lang.csv
    • Users can modify lang.csv with their own language or keywords and write their own programs in a dedicated folder inside examples/.

Languages

Version v1.0.0 supports Russian, Thai, and Gen Alpha slang.

Contributors

For setup and usage instructions, see README.md.