https://github.com/obestwalter/mau-mau

Learn about Python by exploring a simple card game simulation.
https://github.com/obestwalter/mau-mau

exploration good-practices learning-python object-oriented structure

Last synced: 6 months ago
JSON representation

Learn about Python by exploring a simple card game simulation.

• Host: GitHub
• URL: https://github.com/obestwalter/mau-mau
• Owner: obestwalter
• License: mit
• Created: 2016-04-02T10:05:58.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2021-05-16T20:25:51.000Z (over 4 years ago)
• Last Synced: 2025-05-07T11:15:38.146Z (6 months ago)
• Topics: exploration, good-practices, learning-python, object-oriented, structure
• Language: Python
• Homepage: http://oliver.bestwalter.de/mau-mau/
• Size: 1.93 MB
• Stars: 12
• Watchers: 2
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Mau Mau [![Project Status: Active - The project has reached a stable, usable state and is being actively developed.](http://www.repostatus.org/badges/latest/active.svg)](http://www.repostatus.org/#active) [![Build Status](https://travis-ci.org/obestwalter/mau-mau.svg?branch=master)](https://travis-ci.org/obestwalter/mau-mau) [![Build status](https://ci.appveyor.com/api/projects/status/mkcjgkpkimk1ayeb/branch/master?svg=true)](https://ci.appveyor.com/project/obestwalter/mau-mau/branch/master) 

Command line implementation of a german card game called [Mau Mau](https://goo.gl/Am29SF). 

## 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.](http://oliver.bestwalter.de/mau-mau/)**

## 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

[![code license](https://upload.wikimedia.org/wikipedia/commons/thumb/0/0b/License_icon-mit-2.svg/32px-License_icon-mit-2.svg.png)](http://opensource.org/licenses/mit-license.php) [![content license](https://i.creativecommons.org/l/by-nc-sa/4.0/88x31.png)](http://creativecommons.org/licenses/by-nc-sa/4.0/)