Resources

GitHub

kemlang-py is fully open source under the MIT license. The entire project - interpreter, CLI, formatter, website - lives in one repository.

sanketmuchhala / kemlang-py

github.com/sanketmuchhala/kemlang-py

Open

A Gujarati-flavored programming language interpreter built in Python. MIT licensed, actively developed.

Report a bug

Found something broken? Open an issue with steps to reproduce.

Open issue

Submit a PR

Want to fix a bug or add a feature? PRs are welcome.

View PRs

Star the repo

If you find kemlang-py useful, a star helps others discover it.

Star on GitHub

Releases

See what changed in each version - release notes and changelogs.

View releases

Repository structure

kemlang/Core interpreter package - lexer, parser, interpreter, CLI

kemlang/lexer.pyTokenizes source code into a token stream

kemlang/parser.pyRecursive-descent parser → AST

kemlang/interpreter.pyTree-walking interpreter

kemlang/cli.pyTyper CLI - kem run / repl / fmt / tokens / ast

tests/pytest test suite - exec, CLI, lexer, parser, fuzz

npm-package/Node.js wrapper that pip-installs kemlang-py

kemlang-website/This Next.js docs site

docs/Project status, design notes, roadmap

Contributing

kemlang-py is a small, readable codebase - a good place to learn how programming language interpreters work. Here's how to get started:

Fork and clone

git clone https://github.com/sanketmuchhala/kemlang-py

Install dev deps

pip install -e .[dev,test]

Run the tests

pytest -m "not slow"

Make your change

Edit kemlang/ files - lexer, parser, or interpreter

Check quality

ruff check kemlang tests && ruff format kemlang tests

Open a PR

Push your branch and open a pull request on GitHub

License

MIT License

kemlang-py is free and open source software. You can use it, modify it, and distribute it freely - even commercially - as long as you include the original license notice.

Read the full license