Setup

Requirements:

• Pyenv for installing Python 3.12+
  • Recommended installation method: the "automatic installer" i.e. curl https://pyenv.run | bash
  • Follow the instructions at the end of the output to make pyenv available in your shell. You may need to restart your shell or even log out and log in again to make the pyenv command available.
• Poetry for installing dependencies
  • Recommended installation method: the "official installer" i.e. curl -sSL https://install.python-poetry.org | python3 -

Install dependencies:

# Install Python specified in `.python-version`
pyenv install
# Install dependencies specified in `pyproject.toml`
poetry install

If pyenv install gives an error about _tkinter, you can ignore it. If you see other errors, you may have to investigate.

If you have trouble with Poetry not picking up pyenv's python installation, try poetry env remove --all and then poetry install again.

Typecheck and run local unit tests:

./check.sh
# or individually:
poetry run mypy .
poetry run pytest -vv

Once you've finished your compiler, edit src/__main__.py to call your compiler in function call_compiler. Then you can run your compiler on a source code file like this:

./compiler.sh compile path/to/source/code --output=path/to/output/file

You can send the finished compiler to Test Gadget for evaluation with:

./test-gadget.py submit

See the course page for more information.

IDE setup

Recommended VSCode extensions:

• Python
• Pylance
• autopep8