Mastermind - set up the Python skeleton

Git and README

The first thing was to create a git repository, write a README.md file describing the game. Similar to what I posted in the first article of this series.

Create the first test

Then create a file called tests/test_game.py with the following content:

import mastermind.game as mmdef test_game():    mm.play()    assert True

It is not much, but I wanted to see that the tests are going to work.

I also installed pytest:

pip install pytest

Then running pytest:

pytest

got the following error

ModuleNotFoundError: No module named 'mastermind'

This is of course not surprising as I have not created that module.

Creating the skeleton of the module

Next step was to create the file that will hold the implementation of the game. I created the file mastermind/game.py with the following content:

def play():    ...

Very minimalistic, I know, but enough to satisfy the test:

PYTHONPATH=. pytest

This time it was successful.

Setting up GitHub Actions for Continuous Integration (CI)

Having tests is great. Having a CI to run them on every push and every pull-request is way better.

So I created the file .github/workflows/ci.yml with the following content:

name: CIon:  push:  pull_request:  workflow_dispatch:#  schedule:#    - cron: '42 5 * * *'jobs:  test:    strategy:      fail-fast: false      matrix:        runner: [ubuntu-latest, macos-latest, windows-latest]        python-version: ["3.9", "3.10", "3.11"]    runs-on: ${{matrix.runner}}    name: OS ${{matrix.runner}} Python ${{matrix.python-version}}    steps:    - name: Checkout      uses: actions/checkout@v3    - name: Set up Python ${{ matrix.python-version }}      uses: actions/setup-python@v4      with:        python-version: ${{ matrix.python-version }}    - name: Install dependencies      run: |        # pip install -r requirements.txt        pip install pytest    - name: Check Python version      run: python -V    - name: Test with pytest      env:        PYTHONPATH: .      run: pytest -vs

It is funny that so far this is the most complex part of the project, but it won't change a lot.

The last file I added was the .gitignore file with the following content:

__pycache__*.bak

This will help me ensure that we don't add generated files to git by mistake.

Directory layout

To make it easier to understand the project I am also including the directory layout we have now:

. mastermind  game.py README.md .gitignore tests     test_game.py

Conclusion

OK, so when I started to write this project I thought I'll have more free time to make more progress, but after I published the introduction something came up and I only managed to get to this point. Nevertheless one have to start somewhere and it isn't that horrible to make slow progress.
I hope tomorrow I'll have some more time to work on this.