Skip to content

Tongues: add a third tongue in your mother language #8

Open

Description

@alakanani

Welcome, builder. This is a Hacktoberfest task with a little more meat on it. Comment below to claim it, and name the tongue you are bringing. Questions are welcome in our Discord: https://discord.gg/894FEJhWfZ

The task

God Code speaks two tongues today: Setswana (tn) and isiZulu (zu). Give the language its third tongue, in your mother language. chiShona, Kiswahili, Yoruba, Igbo, Hausa, Amharic, Somali, or another language of Africa and beyond. First come, first served: check the comments so two builders do not bring the same tongue twice.

A tongue maps keywords onto the same tokens, so the parser, interpreter, linter and tools all work unchanged. You are translating a word table, not rewriting the engine.

Where to work

  • godcode/tongues.py: add an alias table for your language mirroring _TN_ALIASES and _ZU_ALIASES, and register your code in the TONGUES dict with its display name.
  • docs/TONGUES.md: add a section with your word table, mirroring the Setswana and isiZulu sections.
  • examples/: add a small greeting scroll in your tongue, following examples/first_blessing_tn.god, and list it in examples/README.md.
  • tests/: cover tongue detection (# tongue: <your code>) and one small running program, following the existing tongue tests.

Rules

  • Only keywords are translated. Named tools (SHA256, UPPER, RANGE and friends) keep their names in every tongue.
  • Mixed scrolls must keep working: English keywords beside your words in one file.
  • If you speak the language, your word choices carry the day. If you are translating with help, say so honestly in the pull request so a speaker can review.

How to verify

pip install -e .
python -m pytest tests/ -q
godcode run --sandbox --json examples/<your_scroll>.god

Done looks like

A scroll beginning with your tongue pragma runs end to end, the docs carry the full word table, tests pass, and the full suite stays green.

Please read CONTRIBUTING.md and our Code of Conduct before you start. You are welcome here.

Activity

  1. AceBoss1 commented on Oct 15, 2026

    @AceBoss1
    Collaborator

    glad to bring Nigeria Pidgin and Igbo on board

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requesthacktoberfestHacktoberfest 2026: welcome, buildershelp wantedExtra attention is needed

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions