Browse Source

Initial commit

feedback
github-classroom[bot] 2 years ago committed by GitHub
commit
35a9c9319a
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
  1. 14
      .github/classroom/autograding.json
  2. 21
      .github/workflows/classroom.yaml
  3. 160
      .gitignore
  4. 21
      LICENSE
  5. 70
      README.md
  6. 0
      app/__init__.py
  7. 190
      app/hangman.py
  8. 74
      poetry.lock
  9. 15
      pyproject.toml
  10. 0
      tests/__init__.py
  11. 7
      tests/test_hangman.py

14
.github/classroom/autograding.json

@ -0,0 +1,14 @@ @@ -0,0 +1,14 @@
{
"tests": [
{
"name": "Regression",
"setup": "sudo -H pip3 install poetry ; poetry install",
"run": "poetry run pytest .",
"input": "",
"output": "",
"comparison": "included",
"timeout": 5,
"points": 1
}
]
}

21
.github/workflows/classroom.yaml

@ -0,0 +1,21 @@ @@ -0,0 +1,21 @@
name: GitHub Classroom Workflow
on: [push]
jobs:
build:
permissions: write-all
name: Autograding
strategy:
fail-fast: false
matrix:
python-version: [3.11.0]
poetry-version: [1.7.0]
os: [ubuntu-latest]
runs-on: ${{ matrix.os }}
steps:
- uses: actions/checkout@v2
- uses: actions/setup-python@v4
with:
python-version: ${{ matrix.python-version }}
- uses: education/autograding@v1

160
.gitignore vendored

@ -0,0 +1,160 @@ @@ -0,0 +1,160 @@
# Byte-compiled / optimized / DLL files
__pycache__/
*.py[cod]
*$py.class
# C extensions
*.so
# Distribution / packaging
.Python
build/
develop-eggs/
dist/
downloads/
eggs/
.eggs/
lib/
lib64/
parts/
sdist/
var/
wheels/
share/python-wheels/
*.egg-info/
.installed.cfg
*.egg
MANIFEST
# PyInstaller
# Usually these files are written by a python script from a template
# before PyInstaller builds the exe, so as to inject date/other infos into it.
*.manifest
*.spec
# Installer logs
pip-log.txt
pip-delete-this-directory.txt
# Unit test / coverage reports
htmlcov/
.tox/
.nox/
.coverage
.coverage.*
.cache
nosetests.xml
coverage.xml
*.cover
*.py,cover
.hypothesis/
.pytest_cache/
cover/
# Translations
*.mo
*.pot
# Django stuff:
*.log
local_settings.py
db.sqlite3
db.sqlite3-journal
# Flask stuff:
instance/
.webassets-cache
# Scrapy stuff:
.scrapy
# Sphinx documentation
docs/_build/
# PyBuilder
.pybuilder/
target/
# Jupyter Notebook
.ipynb_checkpoints
# IPython
profile_default/
ipython_config.py
# pyenv
# For a library or package, you might want to ignore these files since the code is
# intended to run in multiple environments; otherwise, check them in:
# .python-version
# pipenv
# According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
# However, in case of collaboration, if having platform-specific dependencies or dependencies
# having no cross-platform support, pipenv may install dependencies that don't work, or not
# install all needed dependencies.
#Pipfile.lock
# poetry
# Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
# This is especially recommended for binary packages to ensure reproducibility, and is more
# commonly ignored for libraries.
# https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
#poetry.lock
# pdm
# Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
#pdm.lock
# pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
# in version control.
# https://pdm.fming.dev/#use-with-ide
.pdm.toml
# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
__pypackages__/
# Celery stuff
celerybeat-schedule
celerybeat.pid
# SageMath parsed files
*.sage.py
# Environments
.env
.venv
env/
venv/
ENV/
env.bak/
venv.bak/
# Spyder project settings
.spyderproject
.spyproject
# Rope project settings
.ropeproject
# mkdocs documentation
/site
# mypy
.mypy_cache/
.dmypy.json
dmypy.json
# Pyre type checker
.pyre/
# pytype static type analyzer
.pytype/
# Cython debug symbols
cython_debug/
# PyCharm
# JetBrains specific template is maintained in a separate JetBrains.gitignore that can
# be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
# and can be added to the global gitignore or merged into this file. For a more nuclear
# option (not recommended) you can uncomment the following to ignore the entire idea folder.
#.idea/

21
LICENSE

@ -0,0 +1,21 @@ @@ -0,0 +1,21 @@
MIT License
Copyright (c) 2023 Mark Patterson
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

70
README.md

@ -0,0 +1,70 @@ @@ -0,0 +1,70 @@
# Hangman Game
Python console app hangman game based on the [code](https://github.com/markpatterson27/hangman-game) by [Mark Patterson](https://github.com/markpatterson27)
## Install dependencies and run
1. `pip install poetry`
2. `poetry install`
3. `poetry run python app/hangman.py`
# Lab "Test Coverage" Assignment
### Important instructions
1. do not move/delete the source files from the folders
1. submission: _commit_ and _push_ your changes to the current project to GitHub
1. do not edit _autograding_ or _classroom_ files
> :warning: **Note:** the autograding is simplified on purpose, it will be overwritten after the submission deadline with additional tests and quiz grading
> :warning: **Note:** `app/hangman.py` should not be changed, anyways it will be overwritten in the post processing for the final autograding
> :warning: **Note:** `tests/test_hangman.py` All your tests should be in this file
> :warning: **Note:** `.github/workflows/main.yaml` Your CI pipeline should be in this file
> :warning: **Note:** For the coverage threashold, use the command line only in the pipeline.
## Basis path testing (1pt)
* Calculate the minimum number of the basis path test cases needed for the 'hangman.py::hangman'
* Add the number here between the brackets.
> _Your answer. For example (5):_
>
> **Q1** (__)
## Create test cases (3pt)
* Create test cases with the minimum *85% of combined coverage* (lines and branch coverage) for the whole `hangman.py`
* Place your tests under the `tests/test_hangman.py` folder
> :warning: **Note:** the `hangman.py` should not be modified. It will be overwriten for in the final autograding stage after the submission deadline.
## Calculate coverage (1pt)
* What is the line coverage of your test suite for the `hangman.py`?
> _Your answer in %. For example (86):_
>
> **Q2** (__)
* What is the current branch coverage of your test suite for the `hangman.py`?
> _Your answer in %. For example (86):_
>
> **Q3** (__)
## Add CI (1pt)
* Add `main.yaml` that runs your test suite from `tests/` and has the minimum coverage criteria for the whole `hangman.py` of **85%** for the **combined** coverage (**total** coverage including lines + branches)
> :warning: **Note:** For the coverage threashold, use the command line only in the pipeline. Do not use config files.
# Hints
* Check the [basis path tutorial](https://www.tutorialspoint.com/path-testing-and-basis-path-testing-with-example)
* Check the [python testing tutorial](https://testdriven.io/blog/testing-python/)
## Spoilers
* you may need to recall the lab on metrics to get the answer to _Q1_
* you may need _pytest-cov_ module installed
* you may need to generate and check _coverage.json_ to get the raw data and calculate exact numbers for the coverage

0
app/__init__.py

190
app/hangman.py

@ -0,0 +1,190 @@ @@ -0,0 +1,190 @@
# Console based hangman game.
# DO NOT EDIT. IT WILL BE OVERWRITTEN IN THE FINAL AUTOGRADING AFTER THE SUBMISSION DEADLINE
import random
import os
# Constants
WORDS = ("python", "jumble", "easy", "difficult", "answer", "xylophone", "hangman",
"computer", "science", "programming", "mathematics", "player", "condition",
"reverse", "water", "board", "geeks", "keyboard", "laptop", "headphone",
"mouse", "printer", "scanner", "software", "hardware", "network", "server")
HANGMAN_STAGES = (
"""
-------
|/ |
|
|
|
|
|
/|\\
-----------
""","""
-------
|/ |
| O
|
|
|
|
/|\\
-----------
""","""
-------
|/ |
| O
| |
|
|
|
/|\\
-----------
""","""
-------
|/ |
| O
| |
| |
|
|
/|\\
-----------
""","""
-------
|/ |
| O
| /|
| |
|
|
/|\\
-----------
""","""
-------
|/ |
| O
| /|\\
| |
|
|
/|\\
-----------
""","""
-------
|/ |
| O
| /|\\
| |
| /
|
/|\\
-----------
""","""
-------
|/ |
| O
| /|\\
| |
| / \\
|
/|\\
-----------
""")
# Functions
def clear_screen():
"""Clears the screen."""
os.system("cls" if os.name == "nt" else "clear")
def get_random_word():
"""Returns a random word from the WORDS tuple."""
return random.choice(WORDS)
def splash_screen():
"""The splash screen."""
print("""
_ _ -----
| | | | __ _ _ __ __ _ _ __ ___ __ _ _ __ | o
| |_| |/ _` | '_ \\ / _` | '_ ` _ \\ / _` | '_ \\ | /|\\
| _ | (_| | | | | (_| | | | | | | (_| | | | | | / \\
|_| |_|\\__,_|_| |_|\\__, |_| |_| |_|\\__,_|_| |_| |
|___/ v1.0
""")
input("Press enter to continue...")
clear_screen()
def hangman():
"""The hangman game."""
try:
# game outer loop
while True:
# Setup
word = get_random_word()
guessed_letters = []
guessed_word = ["_"] * len(word)
wrong_guesses = 0
# game inner loop
while True:
clear_screen()
print("Hangman game. Try to guess the word. (CTRL+C to quit)")
print(HANGMAN_STAGES[wrong_guesses])
print(" ".join(guessed_word), end=' ')
print("(Guessed letters: " + ", ".join(guessed_letters),")")
print()
# check if player has won
if "_" not in guessed_word:
print("You win!")
break
# check if player has lost
if wrong_guesses == len(HANGMAN_STAGES)-1:
print("You lose!")
break
# make sure player enters a single letter
while True:
guess = input("Guess a letter: ").lower()
if len(guess) == 1 and guess.isalpha():
# check if letter has already been guessed
if guess in guessed_letters:
print("You have already guessed that letter.")
else:
break
else:
print("Invalid guess. Please enter a single letter.")
# add guess to guessed letters
guessed_letters.append(guess)
# check if guess is in word
if guess in word:
# add guess to guessed word
for i in range(len(word)):
if word[i] == guess:
guessed_word[i] = guess
else:
# increment wrong guesses
wrong_guesses += 1
# Ask the player if they want to play again
play_again = input("Play again? (y/n): ").lower()
if play_again != "y":
break
print("\nGoodbye!")
except KeyboardInterrupt:
print("\nGoodbye!")
exit()
# Main
if __name__ == "__main__":
splash_screen()
hangman()

74
poetry.lock

@ -0,0 +1,74 @@ @@ -0,0 +1,74 @@
# This file is automatically @generated by Poetry 1.7.1 and should not be changed by hand.
[[package]]
name = "colorama"
version = "0.4.6"
description = "Cross-platform colored terminal text."
optional = false
python-versions = "!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,!=3.5.*,!=3.6.*,>=2.7"
files = [
{file = "colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6"},
{file = "colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44"},
]
[[package]]
name = "iniconfig"
version = "2.0.0"
description = "brain-dead simple config-ini parsing"
optional = false
python-versions = ">=3.7"
files = [
{file = "iniconfig-2.0.0-py3-none-any.whl", hash = "sha256:b6a85871a79d2e3b22d2d1b94ac2824226a63c6b741c88f7ae975f18b6778374"},
{file = "iniconfig-2.0.0.tar.gz", hash = "sha256:2d91e135bf72d31a410b17c16da610a82cb55f6b0477d1a902134b24a455b8b3"},
]
[[package]]
name = "packaging"
version = "23.2"
description = "Core utilities for Python packages"
optional = false
python-versions = ">=3.7"
files = [
{file = "packaging-23.2-py3-none-any.whl", hash = "sha256:8c491190033a9af7e1d931d0b5dacc2ef47509b34dd0de67ed209b5203fc88c7"},
{file = "packaging-23.2.tar.gz", hash = "sha256:048fb0e9405036518eaaf48a55953c750c11e1a1b68e0dd1a9d62ed0c092cfc5"},
]
[[package]]
name = "pluggy"
version = "1.4.0"
description = "plugin and hook calling mechanisms for python"
optional = false
python-versions = ">=3.8"
files = [
{file = "pluggy-1.4.0-py3-none-any.whl", hash = "sha256:7db9f7b503d67d1c5b95f59773ebb58a8c1c288129a88665838012cfb07b8981"},
{file = "pluggy-1.4.0.tar.gz", hash = "sha256:8c85c2876142a764e5b7548e7d9a0e0ddb46f5185161049a79b7e974454223be"},
]
[package.extras]
dev = ["pre-commit", "tox"]
testing = ["pytest", "pytest-benchmark"]
[[package]]
name = "pytest"
version = "8.0.0"
description = "pytest: simple powerful testing with Python"
optional = false
python-versions = ">=3.8"
files = [
{file = "pytest-8.0.0-py3-none-any.whl", hash = "sha256:50fb9cbe836c3f20f0dfa99c565201fb75dc54c8d76373cd1bde06b06657bdb6"},
{file = "pytest-8.0.0.tar.gz", hash = "sha256:249b1b0864530ba251b7438274c4d251c58d868edaaec8762893ad4a0d71c36c"},
]
[package.dependencies]
colorama = {version = "*", markers = "sys_platform == \"win32\""}
iniconfig = "*"
packaging = "*"
pluggy = ">=1.3.0,<2.0"
[package.extras]
testing = ["argcomplete", "attrs (>=19.2.0)", "hypothesis (>=3.56)", "mock", "nose", "pygments (>=2.7.2)", "requests", "setuptools", "xmlschema"]
[metadata]
lock-version = "2.0"
python-versions = "^3.11"
content-hash = "b439de7b0c1dcc9846389b7d06c9d856f9f0b7eedcfdf44f2c335d4b4aed0ed1"

15
pyproject.toml

@ -0,0 +1,15 @@ @@ -0,0 +1,15 @@
[tool.poetry]
name = "project-hangman-game"
version = "0.1.0"
description = ""
authors = ["Your Name <you@example.com>"]
readme = "README.md"
[tool.poetry.dependencies]
python = "^3.11"
pytest = "^8.0.0"
[build-system]
requires = ["poetry-core"]
build-backend = "poetry.core.masonry.api"

0
tests/__init__.py

7
tests/test_hangman.py

@ -0,0 +1,7 @@ @@ -0,0 +1,7 @@
# add your tests in the test_hangman
# you may use parametrization if needed
import pytest
def test_hangman():
assert True
Loading…
Cancel
Save