Add repository baseline: layout, tooling, assets, README, Doxyfile and CI (MIL-001)

Task: MIL-001#1
Task: MIL-001#2
Task: MIL-001#3
Task: MIL-001#4
Task: MIL-001#5
Task: MIL-001#6

src/us_states_game/__init__.py

@@ -0,0 +1,5 @@
+"""The U.S. States Game package: name the 50 states on a Turtle map.
+
+@file __init__.py
+@brief Package marker of the game.
+"""

src/us_states_game/constants.py

@@ -0,0 +1,39 @@
+"""Constants of the U.S. States Game: titles, file names and limits.
+
+@file constants.py
+@brief Titles, file names and limits used by the game.
+
+Every value the game needs in more than one place lives here, so the
+game logic and the Turtle screen never repeat a literal.
+"""
+
+from pathlib import Path
+
+## Folder of this package.
+PACKAGE_DIR = Path(__file__).resolve().parent
+
+## Folder with the course files the game reads at run time.
+DATA_DIR = PACKAGE_DIR / "data"
+
+## CSV file with the columns state, x and y for all 50 states.
+STATES_CSV_PATH = DATA_DIR / "50_states.csv"
+
+## GIF of the blank U.S. map, registered as a Turtle shape.
+MAP_IMAGE_PATH = DATA_DIR / "blank_states_img.gif"
+
+## File written when the game ends, listing the states the player missed.
+STATES_TO_LEARN_FILENAME = "states_to_learn.csv"
+
+## Column names in the states CSV file.
+STATE_COLUMN = "state"
+X_COLUMN = "x"
+Y_COLUMN = "y"
+
+## Title of the game window.
+SCREEN_TITLE = "U.S. States Game"
+
+## Number of states the player has to name.
+NUMBER_OF_STATES = 50
+
+## Text the player types to leave the game early.
+EXIT_COMMAND = "exit"

src/us_states_game/data/50_states.csv

@@ -0,0 +1,51 @@
+state,x,y
+Alabama,139,-77
+Alaska,-204,-170
+Arizona,-203,-40
+Arkansas,57,-53
+California,-297,13
+Colorado,-112,20
+Connecticut,297,96
+Delaware,275,42
+Florida,220,-145
+Georgia,182,-75
+Hawaii,-317,-143
+Idaho,-216,122
+Illinois,95,37
+Indiana,133,39
+Iowa,38,65
+Kansas,-17,5
+Kentucky,149,1
+Louisiana,59,-114
+Maine,319,164
+Maryland,288,27
+Massachusetts,312,112
+Michigan,148,101
+Minnesota,23,135
+Mississippi,94,-78
+Missouri,49,6
+Montana,-141,150
+Nebraska,-61,66
+Nevada,-257,56
+New Hampshire,302,127
+New Jersey,282,65
+New Mexico,-128,-43
+New York,236,104
+North Carolina,239,-22
+North Dakota,-44,158
+Ohio,176,52
+Oklahoma,-8,-41
+Oregon,-278,138
+Pennsylvania,238,72
+Rhode Island,318,94
+South Carolina,218,-51
+South Dakota,-44,109
+Tennessee,131,-34
+Texas,-38,-106
+Utah,-189,34
+Vermont,282,154
+Virginia,234,12
+Washington,-257,193
+West Virginia,200,20
+Wisconsin,83,113
+Wyoming,-134,90