pseudocode-i18n

pseudocode-i18n is the multilingual semantic core of the Pseudocode ecosystem. It provides language definitions, tolerant parsing, a canonical AST, canonical formatting, pseudocode → Python transpilation, runtime execution, project configuration and shared semantic vocabulary for companion editor/rendering projects.

Current version: 0.2.0.

Bundled languages: French (fr), English (en), Spanish (es), German (de), Italian (it) and Portuguese (pt).

Fonction factorielle(n):
    r = 1
    Pour i de 1 à n:
        r = r * i
    Renvoyer r

Afficher factorielle(5)

Installation

python -m pip install pseudocode-i18n

On a deliberately system-managed installation that requires it:

python -m pip install --break-system-packages pseudocode-i18n

Main CLI

Run directly or explicitly:

pseudo factorielle.pseudo-fr
pseudo run factorielle.pseudo-fr

These two commands are equivalent.

Other commands:

pseudo check factorielle.pseudo-fr
pseudo transpile factorielle.pseudo-fr
pseudo transpile factorielle.pseudo-fr -o factorielle.py
pseudo format factorielle.pseudo-fr
pseudo format factorielle.pseudo-fr --check

Language options are equivalent:

--language fr
--lang fr
-l fr

Canonical defaults

The parser is intentionally tolerant, while the formatter converges on one predictable style per language:

• indentation-based blocks;
• trailing : by default;
• no explicit Fin ... / End ... markers in canonical output;
• case-insensitive grammar vocabulary;
• accentless equivalents for accented declared vocabulary;
• French canonical return keyword: Renvoyer;
• statement and function-call variants accepted where supported, for example Afficher "Bonjour" and Afficher("Bonjour").

Project configuration

Canonical filename:

pseudocode.config.yml

Example:

language: fr

format:
  colons: true
  indent: 4

The CLI discovers this file from the source directory upward through parent directories. It can also be selected explicitly with --config-file or --config.

Documentation

The MkDocs site is deliberately organized into:

• Installation;
• Configuration;
• Usage — exhaustive user guide plus one generated reference page per supported language;
• Development;
• Reference.

Language-reference pages are generated directly from the bundled YAML definitions:

yarn docs:sync

Documentation structure and navigation are checked with:

yarn docs:check

Project policy: documentation is part of every change. Any modification to code, grammar, CLI behavior, configuration, formatting, transpilation, language data or development workflow must update the relevant documentation in the same revision.

Development

Bootstrap the checkout:

yarn setup

Run the complete validation pipeline:

yarn bfc

yarn bfc synchronizes/checks the version, lints, tests, regenerates/checks/builds documentation, and builds the Python package.

Companion projects

• pygments-lexer-pseudocode-i18n — reusable Pygments lexer;
• mkdocs-pseudocode-i18n — MkDocs integration;
• vscode-pseudocode — VS Code extension.

License

GNU General Public License version 3 or later (GPL-3.0-or-later).