obestwalter / mau-mau

Learn about Python by exploring a simple card game simulation.

Mau Mau

Command line implementation of a german card game called Mau Mau.

Why?

This project is intended to be a learning tool with comprehensive documentation. It is not only for learning about Python as a programming language it is meant to demonstrate how the language is part of a vast Open Source ecosystem. This simple application uses all my (current) favorite bells and whistles of this ecosystem.

Read the documentation.

Try it

installation from this github repo:

$ pip install "git+https://github.com/obestwalter/mau-mau.git#egg=mau-mau"

Examples for command line use

play a game against the computer:

$ mau-mau play  # Control+C to stop

let the computer simulate a game:

$ mau-mau sim

list the different functions to run statistics:

$ mau-mau-stats

play many games and calculate the average turns needed to finish the game:

$ mau-mau-stats turns

Licenses and Acknowledgements

Licenses

Code is under MIT license and content is CC BY-NC-SA 4.0