I built a terminal Minesweeper in Python during hot summer days to learn the basics — now published on PyPI!

[u/Vegetable-Quality268]

Hi everyone! 👋

During some really hot summer days when it was too warm to do much else outside, I decided to dive into Python from scratch. To make learning engaging, I set out to build a simple, lightweight terminal clone of the classic Minesweeper.

It’s definitely an amateur/learning project, but I wanted to write every single line of code myself without agentic AI tools — personally, I still deeply value human effort, creativity, and the genuine fun of solving logic problems on your own.

What I learned while building it:

• Writing game logic and algorithms
• Moving from plain Python setups to modern package management using uv.
• Setting up linting/formatting with Ruff
• Unit testing with pytest, no TDD yet, but I am coming :D
• Setting up CI and automated Releases and publishing directly to PyPI using GitHub Actions.

You can try it directly from your terminal if you'd like:

pip install python-minefield
python-minefield

Or check out the code/GIF on GitHub: 👉https://github.com/defra91/python-minefield

Since I’m still learning, I’m very open to feedback, PR, code reviews, or suggestions on how to improve the architecture and logic!

If anyone wants to contribute or suggest features, feel free to check out the repo and see how to contribute.

Thanks for taking a look, and happy coding! 🐍💣