From 0e9134e345930890d9110d0cbd05d39c106b12d2 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Mon, 17 May 2021 21:45:53 -0700
Subject: [PATCH 01/77] Update last exercise

---
 freegames/snake.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/freegames/snake.py b/freegames/snake.py
index 3b8c7b43..7c657894 100644
--- a/freegames/snake.py
+++ b/freegames/snake.py
@@ -5,7 +5,7 @@
 1. How do you make the snake faster or slower?
 2. How can you make the snake go around the edges?
 3. How would you move the food?
-4. Change the snake to respond to arrow keys.
+4. Change the snake to respond to mouse clicks.
 
 """
 

From 3e86c283bdc1f36bbbda29303d60eb39422d93b7 Mon Sep 17 00:00:00 2001
From: David Eynon <davidreynon@gmail.com>
Date: Tue, 1 Jun 2021 06:38:57 +0200
Subject: [PATCH 02/77] #55 - added initial mad libs game and initial test.
 (#65)

Initial mad libs game and with testing.
---
 docs/index.rst        |  1 +
 docs/madlibs.rst      |  6 ++++++
 freegames/madlibs.py  | 41 +++++++++++++++++++++++++++++++++++++++++
 tests/test_madlibs.py | 13 +++++++++++++
 4 files changed, 61 insertions(+)
 create mode 100644 docs/madlibs.rst
 create mode 100644 freegames/madlibs.py
 create mode 100644 tests/test_madlibs.py

diff --git a/docs/index.rst b/docs/index.rst
index 41a30183..0af26523 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -27,3 +27,4 @@
    memory
    pacman
    fidget
+   madlibs
diff --git a/docs/madlibs.rst b/docs/madlibs.rst
new file mode 100644
index 00000000..1f0c31f8
--- /dev/null
+++ b/docs/madlibs.rst
@@ -0,0 +1,6 @@
+Mad Libs
+=====
+
+Create a funny story from a not-so funny story
+
+.. literalinclude:: ../freegames/madlibs.py
\ No newline at end of file
diff --git a/freegames/madlibs.py b/freegames/madlibs.py
new file mode 100644
index 00000000..2066abe3
--- /dev/null
+++ b/freegames/madlibs.py
@@ -0,0 +1,41 @@
+""" Mad Libs: Funny Story Creation Game.
+
+Exercises:
+
+1. Can you create functionality to replace the given story?
+2. Can you load the story and template from a file?
+3. Can you add additional parts of speech?
+4. Can you add flexibility in a loaded story template?
+5. Can you adjust for grammar? (past tense, etc.)
+6. Can you fix the bug that occurs if there is a period after the story?
+7. At what point would you need to encapsulate into a function?
+8. Can you use a function for this?
+9. What problems can occur to the expected output if the program were to 
+    crash mid-run (ex: due to power failure, unexpected computer freeze etc.)
+10. How could you re-engineer this to allow for more robust retention of 
+    the original story and/or the input collected?
+"""
+
+story_template = "The [adj] [adj] [n] [v] over the [adj] [n]"
+# The quick brown fox jumps over the lazy dog
+
+new_story = ""
+
+word_type_key = {
+    "[adj]": "adjective",
+    "[n]": "noun",
+    "[v]": "verb",
+    "[adv]": "adverb"
+}
+
+"Replace word types with user provided words"
+for char_block in story_template.split(' '):
+    if char_block in word_type_key:
+        new_word = input("Please enter a {}: ".format(
+            word_type_key[char_block]))
+        new_story += " {} ".format(new_word)
+    else:
+        new_story += " {} ".format(char_block)
+
+print("Your new story:")
+print(new_story)
diff --git a/tests/test_madlibs.py b/tests/test_madlibs.py
new file mode 100644
index 00000000..56a52508
--- /dev/null
+++ b/tests/test_madlibs.py
@@ -0,0 +1,13 @@
+import random
+import runpy
+import unittest.mock as mock
+
+
+def test_madlibs():
+    random.seed(0)
+    mock_input = mock.Mock()
+    mock_input.side_effect = ["quick", "brown","lazy","brown","dog","car","jumps"]
+    mocks = {'print': lambda *args: None, 'input': mock_input}
+
+    with mock.patch.multiple('builtins', **mocks):
+        runpy.run_module('freegames.madlibs')
\ No newline at end of file

From 1d82dd98bbbc9b56c5c6a72b1b89190a9d71e268 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Mon, 31 May 2021 21:59:30 -0700
Subject: [PATCH 03/77] Update madlibs game

---
 freegames/madlibs.py | 58 ++++++++++++++++++++------------------------
 1 file changed, 26 insertions(+), 32 deletions(-)

diff --git a/freegames/madlibs.py b/freegames/madlibs.py
index 2066abe3..68ff46f1 100644
--- a/freegames/madlibs.py
+++ b/freegames/madlibs.py
@@ -1,41 +1,35 @@
-""" Mad Libs: Funny Story Creation Game.
+"""Mad Libs: Funny Story Creation Game
 
 Exercises:
 
-1. Can you create functionality to replace the given story?
-2. Can you load the story and template from a file?
-3. Can you add additional parts of speech?
-4. Can you add flexibility in a loaded story template?
-5. Can you adjust for grammar? (past tense, etc.)
-6. Can you fix the bug that occurs if there is a period after the story?
-7. At what point would you need to encapsulate into a function?
-8. Can you use a function for this?
-9. What problems can occur to the expected output if the program were to 
-    crash mid-run (ex: due to power failure, unexpected computer freeze etc.)
-10. How could you re-engineer this to allow for more robust retention of 
-    the original story and/or the input collected?
-"""
-
-story_template = "The [adj] [adj] [n] [v] over the [adj] [n]"
-# The quick brown fox jumps over the lazy dog
+1. How to replace the story?
+2. How load the story and from a file?
+3. How to add additional parts of speech?
 
-new_story = ""
+"""
 
-word_type_key = {
-    "[adj]": "adjective",
-    "[n]": "noun",
-    "[v]": "verb",
-    "[adv]": "adverb"
+# The quick brown fox jumps over the lazy dog.
+template = 'The |1| |2| |3| |4| over the |5| |6|.'
+parts = {
+    '1': 'adjective',
+    '2': 'adjective',
+    '3': 'noun',
+    '4': 'verb',
+    '5': 'adjective',
+    '6': 'noun',
 }
 
-"Replace word types with user provided words"
-for char_block in story_template.split(' '):
-    if char_block in word_type_key:
-        new_word = input("Please enter a {}: ".format(
-            word_type_key[char_block]))
-        new_story += " {} ".format(new_word)
+chunks = []
+
+for chunk in template.split('|'):
+    if chunk in parts:
+        description = parts[chunk]
+        prompt = 'Enter [{}]: '.format(description)
+        word = input(prompt)
+        chunks.append(word)
     else:
-        new_story += " {} ".format(char_block)
+        chunks.append(chunk)
 
-print("Your new story:")
-print(new_story)
+print('=' * 80)
+story = ''.join(chunks)
+print(story)

From f0319fc05d3efa0386accac2af747fbc2348c06c Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Mon, 14 Jun 2021 17:13:32 -0700
Subject: [PATCH 04/77] Add GitHub workflow action for integration

---
 .github/workflows/integration.yml | 50 +++++++++++++++++++++++++++++++
 1 file changed, 50 insertions(+)
 create mode 100644 .github/workflows/integration.yml

diff --git a/.github/workflows/integration.yml b/.github/workflows/integration.yml
new file mode 100644
index 00000000..1e9295c9
--- /dev/null
+++ b/.github/workflows/integration.yml
@@ -0,0 +1,50 @@
+name: integration
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+
+jobs:
+
+  checks:
+    runs-on: ubuntu-latest
+    strategy:
+      max-parallel: 6
+      matrix:
+        check: [bluecheck, doc8, docs, isortcheck, flake8, rstcheck]
+    steps:
+    - uses: actions/checkout@v2
+    - uses: actions/setup-python@v2
+      with:
+        python-version: 3.9
+    - name: Setup tox
+      run: |
+        pip install --upgrade pip
+        pip install tox
+    - name: Run checks with tox
+      run: |
+        tox -e ${{ matrix.check }}
+
+  tests:
+    needs: checks
+    runs-on: ${{ matrix.os }}
+    strategy:
+      max-parallel: 4
+      matrix:
+        os: [ubuntu-latest]
+        python-version: [3.6, 3.7, 3.8, 3.9]
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-python@v2
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Setup tox
+        run: |
+          pip install --upgrade pip
+          pip install tox
+      - name: Test with tox
+        run: tox -e py

From e497e613d836cc0d4df0a953fd127b0ed8305ee9 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Mon, 14 Jun 2021 17:19:32 -0700
Subject: [PATCH 05/77] Update readme

---
 README.rst | 15 ++++++---------
 1 file changed, 6 insertions(+), 9 deletions(-)

diff --git a/README.rst b/README.rst
index 133bde98..3efddd88 100644
--- a/README.rst
+++ b/README.rst
@@ -72,16 +72,13 @@ Features
 - Used in hundreds of hours of classroom instruction
 - Fully Documented
 - 100% Test Coverage
-- Developed on Python 3.7
-- Tested on CPython 2.7, 3.4, 3.5, 3.6, and 3.7
-- Tested on Windows, Mac OS X, Raspbian (Raspberry Pi), and Linux
-- Tested using Travis CI and AppVeyor CI
+- Developed on Python 3.9
+- Tested on CPython 3.6, 3.7, 3.8, 3.9
+- Tested on Linux, Mac OS X, and Windows
+- Tested using GitHub Actions
 
-.. image:: https://api.travis-ci.org/grantjenks/free-python-games.svg?branch=master
-    :target: http://www.grantjenks.com/docs/freegames/
-
-.. image:: https://ci.appveyor.com/api/projects/status/github/grantjenks/free-python-games?branch=master&svg=true
-    :target: http://www.grantjenks.com/docs/freegames/
+.. image:: https://github.com/grantjenks/free-python-games/workflows/integration/badge.svg
+   :target: http://www.grantjenks.com/docs/freegames/
 
 
 Quickstart

From c51e19255b45e5f00598216076130794f29d0053 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Mon, 14 Jun 2021 17:43:57 -0700
Subject: [PATCH 06/77] Delete travis/appveyor, update requirements and tox

---
 .travis.yml      | 15 ----------
 appveyor.yml     | 23 ----------------
 requirements.txt |  5 +++-
 tox.ini          | 71 +++++++++++++++++++++++++++++++++++++++++++++++-
 4 files changed, 74 insertions(+), 40 deletions(-)
 delete mode 100644 .travis.yml
 delete mode 100644 appveyor.yml

diff --git a/.travis.yml b/.travis.yml
deleted file mode 100644
index ca04f963..00000000
--- a/.travis.yml
+++ /dev/null
@@ -1,15 +0,0 @@
-sudo: false
-language: python
-install: pip install tox
-script: tox
-matrix:
-  include:
-    - python: 3.4
-      env: TOXENV=py34
-    - python: 3.5
-      env: TOXENV=py35
-    - python: 3.6
-      env: TOXENV=py36
-    - python: 3.7
-      dist: xenial
-      env: TOXENV=py37
diff --git a/appveyor.yml b/appveyor.yml
deleted file mode 100644
index b8f2abfd..00000000
--- a/appveyor.yml
+++ /dev/null
@@ -1,23 +0,0 @@
-environment:
-
-  matrix:
-
-    - PYTHON: "C:\\Python34"
-    - PYTHON: "C:\\Python35"
-    - PYTHON: "C:\\Python36"
-    - PYTHON: "C:\\Python37"
-    - PYTHON: "C:\\Python34-x64"
-    - PYTHON: "C:\\Python35-x64"
-    - PYTHON: "C:\\Python36-x64"
-    - PYTHON: "C:\\Python37-x64"
-
-install:
-
-  - "%PYTHON%\\python.exe -m pip install pytest"
-
-build: off
-
-test_script:
-
-  - set PYTHONPATH=C:\projects\free-python-games;C:\projects\free-python-games\tests
-  - "%PYTHON%\\python.exe -m pytest -v tests"
diff --git a/requirements.txt b/requirements.txt
index eccc7a5b..d845935a 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,6 +1,9 @@
+-e .
+blue
 coverage
 doc8
-gj
+flake8
+isort
 pylint
 pytest
 pytest-cov
diff --git a/tox.ini b/tox.ini
index 57a6a7c6..2ac9f335 100644
--- a/tox.ini
+++ b/tox.ini
@@ -1,5 +1,6 @@
 [tox]
-envlist=py34,py35,py36,py37
+envlist=bluecheck,doc8,docs,isortcheck,flake8,rstcheck,py36,py37,py38,py39
+skip_missing_interpreters=True
 
 [testenv]
 deps=
@@ -9,3 +10,71 @@ deps=
 commands=python -m pytest -v --cov freegames --cov-report term-missing tests
 setenv=
     PYTHONPATH={toxinidir}:{toxinidir}/tests
+
+[testenv:blue]
+commands=blue {toxinidir}/setup.py {toxinidir}/freegames {toxinidir}/tests
+deps=blue
+
+[testenv:bluecheck]
+commands=blue --check {toxinidir}/setup.py {toxinidir}/freegames {toxinidir}/tests
+deps=blue
+
+[testenv:doc8]
+deps=doc8
+commands=doc8 docs --ignore-path docs/_build
+
+[testenv:docs]
+allowlist_externals=make
+changedir=docs
+commands=make html
+deps=
+    sphinx
+
+[testenv:flake8]
+commands=flake8 {toxinidir}/setup.py {toxinidir}/freegames {toxinidir}/tests
+deps=flake8
+
+[testenv:isort]
+commands=isort {toxinidir}/setup.py {toxinidir}/freegames {toxinidir}/tests
+deps=isort
+
+[testenv:isortcheck]
+commands=isort --check {toxinidir}/setup.py {toxinidir}/freegames {toxinidir}/tests
+deps=isort
+
+[testenv:rstcheck]
+commands=rstcheck {toxinidir}/README.rst
+deps=rstcheck
+
+[testenv:uploaddocs]
+allowlist_externals=rsync
+changedir=docs
+commands=
+    rsync -azP --stats --delete _build/html/ \
+        grantjenks.com:/srv/www/www.grantjenks.com/public/docs/freegames/
+
+[isort]
+multi_line_output = 3
+include_trailing_comma = True
+force_grid_wrap = 0
+use_parentheses = True
+ensure_newline_before_comments = True
+line_length = 79
+
+[pytest]
+addopts=
+    -n auto
+    --cov-branch
+    --cov-fail-under=100
+    --cov-report=term-missing
+    --cov=freegames
+    --doctest-glob="*.rst"
+    --doctest-modules
+    --import-mode append
+testpaths=docs freegames tests README.rst
+
+[doc8]
+# ignore=D000
+
+[flake8]
+max-line-length=120

From a5169cb128995b0146ac678af14d1d534731c6c9 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Mon, 14 Jun 2021 17:52:05 -0700
Subject: [PATCH 07/77] First pass with blue

---
 freegames/__main__.py  |  2 ++
 freegames/ant.py       |  3 +++
 freegames/bounce.py    |  4 ++++
 freegames/cannon.py    |  5 +++++
 freegames/connect.py   |  3 +++
 freegames/crypto.py    |  5 +++++
 freegames/fidget.py    |  4 ++++
 freegames/flappy.py    |  5 +++++
 freegames/guess.py     | 10 +++++-----
 freegames/life.py      |  5 ++++-
 freegames/maze.py      |  3 +++
 freegames/memory.py    |  6 ++++++
 freegames/pacman.py    |  6 ++++++
 freegames/paint.py     |  8 ++++++++
 freegames/pong.py      |  6 ++++++
 freegames/simonsays.py |  6 ++++++
 freegames/snake.py     |  4 ++++
 freegames/tictactoe.py |  7 +++++++
 freegames/tiles.py     |  5 +++++
 freegames/tron.py      |  3 +++
 freegames/utils.py     |  3 +++
 setup.py               |  2 ++
 tests/mockturtle.py    |  8 ++++++++
 tests/test_bagels.py   |  1 +
 tests/test_cannon.py   |  4 +---
 tests/test_crypto.py   |  4 ++++
 tests/test_flappy.py   |  8 ++------
 tests/test_madlibs.py  | 12 ++++++++++--
 tests/test_main.py     |  3 +++
 tests/test_tron.py     | 11 +++--------
 tests/test_utils.py    |  2 ++
 31 files changed, 133 insertions(+), 25 deletions(-)

diff --git a/freegames/__main__.py b/freegames/__main__.py
index e92a46ce..b083f70a 100644
--- a/freegames/__main__.py
+++ b/freegames/__main__.py
@@ -8,6 +8,7 @@
 directory = os.path.dirname(os.path.realpath(__file__))
 contents = os.listdir(directory)
 
+
 def game_file(name):
     "Return True if filename represents a game."
     return (
@@ -16,6 +17,7 @@ def game_file(name):
         and name != 'utils.py'
     )
 
+
 games = sorted(name[:-3] for name in contents if game_file(name))
 
 parser = argparse.ArgumentParser(
diff --git a/freegames/ant.py b/freegames/ant.py
index ae388d0d..2d03bf7c 100644
--- a/freegames/ant.py
+++ b/freegames/ant.py
@@ -16,10 +16,12 @@
 ant = vector(0, 0)
 aim = vector(2, 0)
 
+
 def wrap(value):
     "Wrap value around -200 and 200."
     return value  # TODO
 
+
 def draw():
     "Move ant and draw screen."
     ant.move(aim)
@@ -36,6 +38,7 @@ def draw():
     if running:
         ontimer(draw, 100)
 
+
 setup(420, 420, 370, 0)
 hideturtle()
 tracer(False)
diff --git a/freegames/bounce.py b/freegames/bounce.py
index be92e587..7c9fcabb 100644
--- a/freegames/bounce.py
+++ b/freegames/bounce.py
@@ -14,13 +14,16 @@
 from turtle import *
 from freegames import vector
 
+
 def value():
     "Randomly generate value between (-5, -3) or (3, 5)."
     return (3 + random() * 2) * choice([1, -1])
 
+
 ball = vector(0, 0)
 aim = vector(value(), value())
 
+
 def draw():
     "Move ball and draw game."
     ball.move(aim)
@@ -40,6 +43,7 @@ def draw():
 
     ontimer(draw, 50)
 
+
 setup(420, 420, 370, 0)
 hideturtle()
 tracer(False)
diff --git a/freegames/cannon.py b/freegames/cannon.py
index ed21b771..e90ab986 100644
--- a/freegames/cannon.py
+++ b/freegames/cannon.py
@@ -17,6 +17,7 @@
 speed = vector(0, 0)
 targets = []
 
+
 def tap(x, y):
     "Respond to screen tap."
     if not inside(ball):
@@ -25,10 +26,12 @@ def tap(x, y):
         speed.x = (x + 200) / 25
         speed.y = (y + 200) / 25
 
+
 def inside(xy):
     "Return True if xy within screen."
     return -200 < xy.x < 200 and -200 < xy.y < 200
 
+
 def draw():
     "Draw ball and targets."
     clear()
@@ -43,6 +46,7 @@ def draw():
 
     update()
 
+
 def move():
     "Move ball and targets."
     if randrange(40) == 0:
@@ -72,6 +76,7 @@ def move():
 
     ontimer(move, 50)
 
+
 setup(420, 420, 370, 0)
 hideturtle()
 up()
diff --git a/freegames/connect.py b/freegames/connect.py
index 9da2bcd3..5fcf8e8d 100644
--- a/freegames/connect.py
+++ b/freegames/connect.py
@@ -16,6 +16,7 @@
 turns = {'red': 'yellow', 'yellow': 'red'}
 state = {'player': 'yellow', 'rows': [0] * 8}
 
+
 def grid():
     "Draw Connect Four grid."
     bgcolor('light blue')
@@ -31,6 +32,7 @@ def grid():
 
     update()
 
+
 def tap(x, y):
     "Draw red or yellow circle in tapped row."
     player = state['player']
@@ -50,6 +52,7 @@ def tap(x, y):
     rows[row] = count + 1
     state['player'] = turns[player]
 
+
 setup(420, 420, 370, 0)
 hideturtle()
 tracer(False)
diff --git a/freegames/crypto.py b/freegames/crypto.py
index 0d7311e8..f89e52ac 100644
--- a/freegames/crypto.py
+++ b/freegames/crypto.py
@@ -12,6 +12,7 @@
 
 """
 
+
 def encrypt(message, key):
     "Encrypt message with key."
     result = ''
@@ -48,14 +49,17 @@ def encrypt(message, key):
 
     return result
 
+
 def decrypt(message, key):
     "Decrypt message with key."
     return encrypt(message, -key)
 
+
 def decode(message):
     "Decode message without key."
     pass  # TODO
 
+
 def get_key():
     "Get key from user."
     try:
@@ -66,6 +70,7 @@ def get_key():
         print('Invalid key. Using key: 0.')
         return 0
 
+
 print('Do you wish to encrypt, decrypt, or decode a message?')
 choice = input()
 
diff --git a/freegames/fidget.py b/freegames/fidget.py
index 6f649d53..e425acd5 100644
--- a/freegames/fidget.py
+++ b/freegames/fidget.py
@@ -13,6 +13,7 @@
 
 state = {'turn': 0}
 
+
 def spinner():
     "Draw fidget spinner."
     clear()
@@ -32,6 +33,7 @@ def spinner():
     right(120)
     update()
 
+
 def animate():
     "Animate fidget spinner."
     if state['turn'] > 0:
@@ -40,10 +42,12 @@ def animate():
     spinner()
     ontimer(animate, 20)
 
+
 def flick():
     "Flick fidget spinner."
     state['turn'] += 10
 
+
 setup(420, 420, 370, 0)
 hideturtle()
 tracer(False)
diff --git a/freegames/flappy.py b/freegames/flappy.py
index cd62c643..1bfd341d 100644
--- a/freegames/flappy.py
+++ b/freegames/flappy.py
@@ -16,15 +16,18 @@
 bird = vector(0, 0)
 balls = []
 
+
 def tap(x, y):
     "Move bird up in response to screen tap."
     up = vector(0, 30)
     bird.move(up)
 
+
 def inside(point):
     "Return True if point on screen."
     return -200 < point.x < 200 and -200 < point.y < 200
 
+
 def draw(alive):
     "Draw screen objects."
     clear()
@@ -42,6 +45,7 @@ def draw(alive):
 
     update()
 
+
 def move():
     "Update object positions."
     bird.y -= 5
@@ -69,6 +73,7 @@ def move():
     draw(True)
     ontimer(move, 50)
 
+
 setup(420, 420, 370, 0)
 hideturtle()
 up()
diff --git a/freegames/guess.py b/freegames/guess.py
index 2edc8149..d7e5738c 100644
--- a/freegames/guess.py
+++ b/freegames/guess.py
@@ -16,17 +16,17 @@
 value = randint(start, end)
 
 print(value)
-print("I'm thinking of a number between", start, "and", end)
+print("I'm thinking of a number between", start, 'and', end)
 
 guess = None
 
 while guess != value:
-    text = input("Guess the number: ")
+    text = input('Guess the number: ')
     guess = int(text)
 
     if guess < value:
-        print("Higher.")
+        print('Higher.')
     elif guess > value:
-        print("Lower.")
+        print('Lower.')
 
-print("Congratulations! You guessed the right answer:", value)
+print('Congratulations! You guessed the right answer:', value)
diff --git a/freegames/life.py b/freegames/life.py
index cd4d2968..912595cc 100644
--- a/freegames/life.py
+++ b/freegames/life.py
@@ -18,6 +18,7 @@
 
 cells = {}
 
+
 def initialize():
     "Randomly initialize the cells."
     for x in range(-200, 200, 10):
@@ -28,6 +29,7 @@ def initialize():
         for y in range(-50, 50, 10):
             cells[x, y] = choice([True, False])
 
+
 def step():
     "Compute one step in the Game of Life."
     neighbors = {}
@@ -37,7 +39,7 @@ def step():
             count = -cells[x, y]
             for h in [-10, 0, 10]:
                 for v in [-10, 0, 10]:
-                    count += cells[x+h, y+v]
+                    count += cells[x + h, y + v]
             neighbors[x, y] = count
 
     for cell, count in neighbors.items():
@@ -47,6 +49,7 @@ def step():
         elif count == 3:
             cells[cell] = True
 
+
 def draw():
     "Draw all the squares."
     step()
diff --git a/freegames/maze.py b/freegames/maze.py
index 9fe41bf6..24a23bf0 100644
--- a/freegames/maze.py
+++ b/freegames/maze.py
@@ -12,6 +12,7 @@
 from random import random
 from freegames import line
 
+
 def draw():
     "Draw maze."
     color('black')
@@ -26,6 +27,7 @@ def draw():
 
     update()
 
+
 def tap(x, y):
     "Draw line and dot for screen tap."
     if abs(x) > 198 or abs(y) > 198:
@@ -38,6 +40,7 @@ def tap(x, y):
     goto(x, y)
     dot(4)
 
+
 setup(420, 420, 370, 0)
 hideturtle()
 tracer(False)
diff --git a/freegames/memory.py b/freegames/memory.py
index 7ff61aa3..f5a0ee5c 100644
--- a/freegames/memory.py
+++ b/freegames/memory.py
@@ -19,6 +19,7 @@
 state = {'mark': None}
 hide = [True] * 64
 
+
 def square(x, y):
     "Draw white square with black outline at (x, y)."
     up()
@@ -31,14 +32,17 @@ def square(x, y):
         left(90)
     end_fill()
 
+
 def index(x, y):
     "Convert (x, y) coordinates to tiles index."
     return int((x + 200) // 50 + ((y + 200) // 50) * 8)
 
+
 def xy(count):
     "Convert tiles count to (x, y) coordinates."
     return (count % 8) * 50 - 200, (count // 8) * 50 - 200
 
+
 def tap(x, y):
     "Update mark and hidden tiles based on tap."
     spot = index(x, y)
@@ -51,6 +55,7 @@ def tap(x, y):
         hide[mark] = False
         state['mark'] = None
 
+
 def draw():
     "Draw image and tiles."
     clear()
@@ -75,6 +80,7 @@ def draw():
     update()
     ontimer(draw, 100)
 
+
 shuffle(tiles)
 setup(420, 420, 370, 0)
 addshape(car)
diff --git a/freegames/pacman.py b/freegames/pacman.py
index f249a27d..c2fb3ab1 100644
--- a/freegames/pacman.py
+++ b/freegames/pacman.py
@@ -61,6 +61,7 @@ def square(x, y):
 
     path.end_fill()
 
+
 def offset(point):
     "Return offset of point in tiles."
     x = (floor(point.x, 20) + 200) / 20
@@ -68,6 +69,7 @@ def offset(point):
     index = int(x + y * 20)
     return index
 
+
 def valid(point):
     "Return True if point is valid in tiles."
     index = offset(point)
@@ -82,6 +84,7 @@ def valid(point):
 
     return point.x % 20 == 0 or point.y % 20 == 0
 
+
 def world():
     "Draw world using path."
     bgcolor('black')
@@ -100,6 +103,7 @@ def world():
                 path.goto(x + 10, y + 10)
                 path.dot(2, 'white')
 
+
 def move():
     "Move pacman and all ghosts."
     writer.undo()
@@ -149,12 +153,14 @@ def move():
 
     ontimer(move, 100)
 
+
 def change(x, y):
     "Change pacman aim if valid."
     if valid(pacman + vector(x, y)):
         aim.x = x
         aim.y = y
 
+
 setup(420, 420, 370, 0)
 hideturtle()
 tracer(False)
diff --git a/freegames/paint.py b/freegames/paint.py
index b5fb2f2c..4235abcc 100644
--- a/freegames/paint.py
+++ b/freegames/paint.py
@@ -13,6 +13,7 @@
 from turtle import *
 from freegames import vector
 
+
 def line(start, end):
     "Draw line from start to end."
     up()
@@ -20,6 +21,7 @@ def line(start, end):
     down()
     goto(end.x, end.y)
 
+
 def square(start, end):
     "Draw square from start to end."
     up()
@@ -33,18 +35,22 @@ def square(start, end):
 
     end_fill()
 
+
 def circle(start, end):
     "Draw circle from start to end."
     pass  # TODO
 
+
 def rectangle(start, end):
     "Draw rectangle from start to end."
     pass  # TODO
 
+
 def triangle(start, end):
     "Draw triangle from start to end."
     pass  # TODO
 
+
 def tap(x, y):
     "Store starting point or draw shape."
     start = state['start']
@@ -57,10 +63,12 @@ def tap(x, y):
         shape(start, end)
         state['start'] = None
 
+
 def store(key, value):
     "Store value in state at key."
     state[key] = value
 
+
 state = {'start': None, 'shape': line}
 setup(420, 420, 370, 0)
 onscreenclick(tap)
diff --git a/freegames/pong.py b/freegames/pong.py
index 0bdd9685..4e6ec456 100644
--- a/freegames/pong.py
+++ b/freegames/pong.py
@@ -16,18 +16,22 @@
 from turtle import *
 from freegames import vector
 
+
 def value():
     "Randomly generate value between (-5, -3) or (3, 5)."
     return (3 + random() * 2) * choice([1, -1])
 
+
 ball = vector(0, 0)
 aim = vector(value(), value())
 state = {1: 0, 2: 0}
 
+
 def move(player, change):
     "Move player position by change."
     state[player] += change
 
+
 def rectangle(x, y, width, height):
     "Draw rectangle at (x, y) with given width and height."
     up()
@@ -41,6 +45,7 @@ def rectangle(x, y, width, height):
         left(90)
     end_fill()
 
+
 def draw():
     "Draw game and move pong ball."
     clear()
@@ -79,6 +84,7 @@ def draw():
 
     ontimer(draw, 50)
 
+
 setup(420, 420, 370, 0)
 hideturtle()
 tracer(False)
diff --git a/freegames/simonsays.py b/freegames/simonsays.py
index e922a4ce..312e74a1 100644
--- a/freegames/simonsays.py
+++ b/freegames/simonsays.py
@@ -21,6 +21,7 @@
     vector(-200, -200): ('yellow', 'khaki'),
 }
 
+
 def grid():
     "Draw grid of tiles."
     square(0, 0, 200, 'dark red')
@@ -29,6 +30,7 @@ def grid():
     square(-200, -200, 200, 'khaki')
     update()
 
+
 def flash(tile):
     "Flash tile in grid."
     glow, dark = tiles[tile]
@@ -39,6 +41,7 @@ def flash(tile):
     update()
     sleep(0.5)
 
+
 def grow():
     "Grow pattern and flash tiles."
     tile = choice(list(tiles))
@@ -50,6 +53,7 @@ def grow():
     print('Pattern length:', len(pattern))
     guesses.clear()
 
+
 def tap(x, y):
     "Respond to screen tap."
     onscreenclick(None)
@@ -69,11 +73,13 @@ def tap(x, y):
 
     onscreenclick(tap)
 
+
 def start(x, y):
     "Start game."
     grow()
     onscreenclick(tap)
 
+
 setup(420, 420, 370, 0)
 hideturtle()
 tracer(False)
diff --git a/freegames/snake.py b/freegames/snake.py
index 7c657894..9372c38e 100644
--- a/freegames/snake.py
+++ b/freegames/snake.py
@@ -17,15 +17,18 @@
 snake = [vector(10, 0)]
 aim = vector(0, -10)
 
+
 def change(x, y):
     "Change snake direction."
     aim.x = x
     aim.y = y
 
+
 def inside(head):
     "Return True if head inside boundaries."
     return -200 < head.x < 190 and -200 < head.y < 190
 
+
 def move():
     "Move snake forward one segment."
     head = snake[-1].copy()
@@ -54,6 +57,7 @@ def move():
     update()
     ontimer(move, 100)
 
+
 setup(420, 420, 370, 0)
 hideturtle()
 tracer(False)
diff --git a/freegames/tictactoe.py b/freegames/tictactoe.py
index 8bb9dc2a..8857d59b 100644
--- a/freegames/tictactoe.py
+++ b/freegames/tictactoe.py
@@ -12,6 +12,7 @@
 from turtle import *
 from freegames import line
 
+
 def grid():
     "Draw tic-tac-toe grid."
     line(-67, 200, -67, -200)
@@ -19,11 +20,13 @@ def grid():
     line(-200, -67, 200, -67)
     line(-200, 67, 200, 67)
 
+
 def drawx(x, y):
     "Draw X player."
     line(x, y, x + 133, y + 133)
     line(x, y + 133, x + 133, y)
 
+
 def drawo(x, y):
     "Draw O player."
     up()
@@ -31,13 +34,16 @@ def drawo(x, y):
     down()
     circle(62)
 
+
 def floor(value):
     "Round value down to grid with square size 133."
     return ((value + 200) // 133) * 133 - 200
 
+
 state = {'player': 0}
 players = [drawx, drawo]
 
+
 def tap(x, y):
     "Draw X or O in tapped square."
     x = floor(x)
@@ -48,6 +54,7 @@ def tap(x, y):
     update()
     state['player'] = not player
 
+
 setup(420, 420, 370, 0)
 hideturtle()
 tracer(False)
diff --git a/freegames/tiles.py b/freegames/tiles.py
index f7671a82..05083d3d 100644
--- a/freegames/tiles.py
+++ b/freegames/tiles.py
@@ -21,6 +21,7 @@
     vector(0, -100),
 ]
 
+
 def load():
     "Load tiles and scramble."
     count = 1
@@ -43,6 +44,7 @@ def load():
             tiles[mark] = number
             mark = spot
 
+
 def square(mark, number):
     "Draw white square with black outline and number."
     up()
@@ -63,6 +65,7 @@ def square(mark, number):
 
     write(number, font=('Arial', 60, 'normal'))
 
+
 def tap(x, y):
     "Swap tile and empty square."
     x = floor(x, 100)
@@ -79,12 +82,14 @@ def tap(x, y):
             tiles[mark] = None
             square(mark, None)
 
+
 def draw():
     "Draw all tiles."
     for mark in tiles:
         square(mark, tiles[mark])
     update()
 
+
 setup(420, 420, 370, 0)
 hideturtle()
 tracer(False)
diff --git a/freegames/tron.py b/freegames/tron.py
index cefcc57c..3f1b69e6 100644
--- a/freegames/tron.py
+++ b/freegames/tron.py
@@ -20,10 +20,12 @@
 p2aim = vector(-4, 0)
 p2body = set()
 
+
 def inside(head):
     "Return True if head inside screen."
     return -200 < head.x < 200 and -200 < head.y < 200
 
+
 def draw():
     "Advance players and draw game."
     p1xy.move(p1aim)
@@ -48,6 +50,7 @@ def draw():
     update()
     ontimer(draw, 50)
 
+
 setup(420, 420, 370, 0)
 hideturtle()
 tracer(False)
diff --git a/freegames/utils.py b/freegames/utils.py
index 4665a7d4..103d9899 100644
--- a/freegames/utils.py
+++ b/freegames/utils.py
@@ -48,6 +48,7 @@ def path(filename):
 def line(a, b, x, y):
     "Draw line from `(a, b)` to `(x, y)`."
     import turtle
+
     turtle.up()
     turtle.goto(a, b)
     turtle.down()
@@ -61,6 +62,7 @@ def square(x, y, size, name):
 
     """
     import turtle
+
     turtle.up()
     turtle.goto(x, y)
     turtle.down()
@@ -88,6 +90,7 @@ class vector(collections.Sequence):
     vector(-2.0, 1.0)
 
     """
+
     # pylint: disable=invalid-name
     PRECISION = 6
 
diff --git a/setup.py b/setup.py
index addb36b4..645b4d06 100644
--- a/setup.py
+++ b/setup.py
@@ -12,8 +12,10 @@ def finalize_options(self):
         TestCommand.finalize_options(self)
         self.test_args = []
         self.test_suite = True
+
     def run_tests(self):
         import tox
+
         errno = tox.cmdline(self.test_args)
         sys.exit(errno)
 
diff --git a/tests/mockturtle.py b/tests/mockturtle.py
index 5e7d0572..9bb2b019 100644
--- a/tests/mockturtle.py
+++ b/tests/mockturtle.py
@@ -5,6 +5,7 @@
 state = {}
 events = []
 
+
 class Turtle:
     def __init__(self, visible=True):
         pass
@@ -78,6 +79,7 @@ def update(self):
     def undo(self):
         pass
 
+
 _turtle = Turtle()
 goto = _turtle.goto
 up = _turtle.up
@@ -103,22 +105,28 @@ def undo(self):
 update = _turtle.update
 undo = _turtle.undo
 
+
 def setup(width, height, x, y):
     pass
 
+
 def listen():
     pass
 
+
 def onkey(function, key):
     state['key ' + key] = function
 
+
 def ontimer(function, delay):
     state['timer'] = function
     state['delay'] = delay
 
+
 def onscreenclick(function):
     state['click'] = function
 
+
 def done():
     for event in events:
         name = event[0]
diff --git a/tests/test_bagels.py b/tests/test_bagels.py
index 5b24b8b6..9c631592 100644
--- a/tests/test_bagels.py
+++ b/tests/test_bagels.py
@@ -12,6 +12,7 @@ def test_bagels_pass():
     with mock.patch.multiple('builtins', **mocks):
         runpy.run_module('freegames.bagels')
 
+
 def test_bagels_fail():
     random.seed(0)
     mock_input = mock.Mock()
diff --git a/tests/test_cannon.py b/tests/test_cannon.py
index cdcdc615..082c4235 100644
--- a/tests/test_cannon.py
+++ b/tests/test_cannon.py
@@ -10,8 +10,6 @@
 def test_cannon():
     random.seed(0)
     mockturtle.events[:] = (
-        [('timer',)] * 300
-        + [('click', 0, 0)]
-        + [('timer', True)] * 3000
+        [('timer',)] * 300 + [('click', 0, 0)] + [('timer', True)] * 3000
     )
     runpy.run_module('freegames.cannon')
diff --git a/tests/test_crypto.py b/tests/test_crypto.py
index 16b35ac2..2f3a88f7 100644
--- a/tests/test_crypto.py
+++ b/tests/test_crypto.py
@@ -12,6 +12,7 @@ def test_crypto_encrypt():
     with mock.patch.multiple('builtins', **mocks):
         runpy.run_module('freegames.crypto')
 
+
 def test_crypto_encrypt_bad_key():
     random.seed(0)
     mock_input = mock.Mock()
@@ -21,6 +22,7 @@ def test_crypto_encrypt_bad_key():
     with mock.patch.multiple('builtins', **mocks):
         runpy.run_module('freegames.crypto')
 
+
 def test_crypto_bad_command():
     random.seed(0)
     mock_input = mock.Mock()
@@ -30,6 +32,7 @@ def test_crypto_bad_command():
     with mock.patch.multiple('builtins', **mocks):
         runpy.run_module('freegames.crypto')
 
+
 def test_crypto_decrypt():
     random.seed(0)
     mock_input = mock.Mock()
@@ -39,6 +42,7 @@ def test_crypto_decrypt():
     with mock.patch.multiple('builtins', **mocks):
         runpy.run_module('freegames.crypto')
 
+
 def test_crypto_decode():
     random.seed(0)
     mock_input = mock.Mock()
diff --git a/tests/test_flappy.py b/tests/test_flappy.py
index 608da5cf..5e6b0173 100644
--- a/tests/test_flappy.py
+++ b/tests/test_flappy.py
@@ -9,15 +9,11 @@
 
 def test_flappy_outside():
     random.seed(0)
-    mockturtle.events[:] = (
-        [('timer', True)] * 300
-    )
+    mockturtle.events[:] = [('timer', True)] * 300
     runpy.run_module('freegames.flappy')
 
 
 def test_flappy_collision():
     random.seed(0)
-    mockturtle.events[:] = (
-        ([('timer', True)] * 6 + [('click', 0, 0)]) * 100
-    )
+    mockturtle.events[:] = ([('timer', True)] * 6 + [('click', 0, 0)]) * 100
     runpy.run_module('freegames.flappy')
diff --git a/tests/test_madlibs.py b/tests/test_madlibs.py
index 56a52508..7e7c4708 100644
--- a/tests/test_madlibs.py
+++ b/tests/test_madlibs.py
@@ -6,8 +6,16 @@
 def test_madlibs():
     random.seed(0)
     mock_input = mock.Mock()
-    mock_input.side_effect = ["quick", "brown","lazy","brown","dog","car","jumps"]
+    mock_input.side_effect = [
+        'quick',
+        'brown',
+        'lazy',
+        'brown',
+        'dog',
+        'car',
+        'jumps',
+    ]
     mocks = {'print': lambda *args: None, 'input': mock_input}
 
     with mock.patch.multiple('builtins', **mocks):
-        runpy.run_module('freegames.madlibs')
\ No newline at end of file
+        runpy.run_module('freegames.madlibs')
diff --git a/tests/test_main.py b/tests/test_main.py
index d82eb6d3..f85436cd 100644
--- a/tests/test_main.py
+++ b/tests/test_main.py
@@ -11,6 +11,7 @@ def test_main_list():
     with mock.patch('sys.argv', ['__main__.py', 'list']):
         runpy.run_module('freegames.__main__')
 
+
 def test_main_copy():
     random.seed(0)
     mock_open = mock.Mock()
@@ -20,6 +21,7 @@ def test_main_copy():
         with mock.patch('builtins.open', mock_open):
             runpy.run_module('freegames.__main__')
 
+
 def test_main_copy_error():
     cwd = os.getcwd()
     path = os.path.join(cwd, 'guess.py')
@@ -33,6 +35,7 @@ def test_main_copy_error():
     finally:
         os.remove('guess.py')
 
+
 def test_main_show():
     random.seed(0)
 
diff --git a/tests/test_tron.py b/tests/test_tron.py
index 1e9d7362..12753ace 100644
--- a/tests/test_tron.py
+++ b/tests/test_tron.py
@@ -9,16 +9,11 @@
 
 def test_tron_1():
     random.seed(0)
-    mockturtle.events[:] = (
-        [('key a',), ('key a',)]
-        + [('timer', True)] * 600
-    )
+    mockturtle.events[:] = [('key a',), ('key a',)] + [('timer', True)] * 600
     runpy.run_module('freegames.tron')
 
+
 def test_tron_2():
     random.seed(0)
-    mockturtle.events[:] = (
-        [('key j',), ('key j',)]
-        + [('timer', True)] * 600
-    )
+    mockturtle.events[:] = [('key j',), ('key j',)] + [('timer', True)] * 600
     runpy.run_module('freegames.tron')
diff --git a/tests/test_utils.py b/tests/test_utils.py
index 1b0ef11a..435f4638 100644
--- a/tests/test_utils.py
+++ b/tests/test_utils.py
@@ -2,6 +2,7 @@
 
 import freegames.utils as utils
 
+
 def test_change_after_hash():
     v = utils.vector(0, 0)
     hash(v)
@@ -20,6 +21,7 @@ def test_change_after_hash():
     with raises(ValueError):
         v.rotate(90)
 
+
 def test_not_implemented_paths():
     v = utils.vector(0, 0)
     assert not (v == 0)

From 23010c9ecff6284a11891030c733c75212f05eb8 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Mon, 14 Jun 2021 18:16:36 -0700
Subject: [PATCH 08/77] More blue fixes

---
 freegames/pacman.py  |  3 +++
 tests/test_fidget.py |  7 +++----
 tests/test_pacman.py |  7 +++----
 tests/test_pong.py   | 15 +++++++--------
 tests/test_snake.py  | 12 ++++++++----
 5 files changed, 24 insertions(+), 20 deletions(-)

diff --git a/freegames/pacman.py b/freegames/pacman.py
index c2fb3ab1..58e849ea 100644
--- a/freegames/pacman.py
+++ b/freegames/pacman.py
@@ -25,6 +25,7 @@
     [vector(100, 160), vector(0, -5)],
     [vector(100, -160), vector(-5, 0)],
 ]
+# fmt: off
 tiles = [
     0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
     0, 1, 1, 1, 1, 1, 1, 1, 0, 1, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0,
@@ -47,6 +48,8 @@
     0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
     0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
 ]
+# fmt: on
+
 
 def square(x, y):
     "Draw square using path at (x, y)."
diff --git a/tests/test_fidget.py b/tests/test_fidget.py
index 5c48655f..62101c0d 100644
--- a/tests/test_fidget.py
+++ b/tests/test_fidget.py
@@ -9,8 +9,7 @@
 
 def test_fidget():
     random.seed(0)
-    mockturtle.events[:] = (
-        [('timer',), ('key space',)] * 30
-        + [('timer',)] * 600
-    )
+    mockturtle.events.clear()
+    mockturtle.events += [('timer',), ('key space',)] * 30
+    mockturtle.events += [('timer',)] * 600
     runpy.run_module('freegames.fidget')
diff --git a/tests/test_pacman.py b/tests/test_pacman.py
index 2990fe1a..b9f8a45a 100644
--- a/tests/test_pacman.py
+++ b/tests/test_pacman.py
@@ -9,8 +9,7 @@
 
 def test_pacman():
     random.seed(0)
-    mockturtle.events[:] = (
-        [('timer', True), ('key Up',)] * 600
-        + [('timer', True)] * 3000
-    )
+    mockturtle.events.clear()
+    mockturtle.events += [('timer', True), ('key Up',)] * 600
+    mockturtle.events += [('timer', True)] * 3000
     runpy.run_module('freegames.pacman')
diff --git a/tests/test_pong.py b/tests/test_pong.py
index e3a0746c..b2809eb3 100644
--- a/tests/test_pong.py
+++ b/tests/test_pong.py
@@ -9,16 +9,15 @@
 
 def test_pong_1():
     random.seed(0)
-    mockturtle.events[:] = (
-        [('timer',), ('key s',)] * 8
-        + [('timer', True)] * 600
-    )
+    mockturtle.events.clear()
+    mockturtle.events += [('timer',), ('key s',)] * 8
+    mockturtle.events += [('timer', True)] * 600
     runpy.run_module('freegames.pong')
 
+
 def test_pong_2():
     random.seed(1)
-    mockturtle.events[:] = (
-        [('timer',), ('key k',)] * 12
-        + [('timer', True)] * 600
-    )
+    mockturtle.events.clear()
+    mockturtle.events += [('timer',), ('key k',)] * 12
+    mockturtle.events += [('timer', True)] * 600
     runpy.run_module('freegames.pong')
diff --git a/tests/test_snake.py b/tests/test_snake.py
index c6f25a14..d08a954a 100644
--- a/tests/test_snake.py
+++ b/tests/test_snake.py
@@ -9,8 +9,12 @@
 
 def test_snake():
     random.seed(0)
-    mockturtle.events[:] = (
-        [('timer',), ('key Left',), ('timer',), ('key Up',)]
-        + [('timer', True)] * 300
-    )
+    mockturtle.events.clear()
+    mockturtle.events += [
+        ('timer',),
+        ('key Left',),
+        ('timer',),
+        ('key Up',),
+    ]
+    mockturtle.events += [('timer', True)] * 300
     runpy.run_module('freegames.snake')

From f585ae42e9cd2abea2f4a68077c08218b1b1fb16 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Mon, 14 Jun 2021 18:19:16 -0700
Subject: [PATCH 09/77] Fixes for docs

---
 docs/madlibs.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/madlibs.rst b/docs/madlibs.rst
index 1f0c31f8..359ffbc5 100644
--- a/docs/madlibs.rst
+++ b/docs/madlibs.rst
@@ -1,6 +1,6 @@
 Mad Libs
-=====
+========
 
 Create a funny story from a not-so funny story
 
-.. literalinclude:: ../freegames/madlibs.py
\ No newline at end of file
+.. literalinclude:: ../freegames/madlibs.py

From 7d2996c9d525d8ae77079439655f5b08645409f1 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Mon, 14 Jun 2021 18:20:22 -0700
Subject: [PATCH 10/77] isort fixes

---
 freegames/ant.py         | 1 +
 freegames/bounce.py      | 1 +
 freegames/cannon.py      | 1 +
 freegames/connect.py     | 1 +
 freegames/flappy.py      | 1 +
 freegames/life.py        | 1 +
 freegames/maze.py        | 3 ++-
 freegames/memory.py      | 1 +
 freegames/minesweeper.py | 1 +
 freegames/pacman.py      | 1 +
 freegames/paint.py       | 1 +
 freegames/pong.py        | 1 +
 freegames/simonsays.py   | 1 +
 freegames/snake.py       | 3 ++-
 freegames/tictactoe.py   | 1 +
 freegames/tiles.py       | 1 +
 freegames/tron.py        | 1 +
 setup.py                 | 2 +-
 tests/test_bounce.py     | 2 +-
 19 files changed, 21 insertions(+), 4 deletions(-)

diff --git a/freegames/ant.py b/freegames/ant.py
index 2d03bf7c..030a8a16 100644
--- a/freegames/ant.py
+++ b/freegames/ant.py
@@ -11,6 +11,7 @@
 
 from random import *
 from turtle import *
+
 from freegames import vector
 
 ant = vector(0, 0)
diff --git a/freegames/bounce.py b/freegames/bounce.py
index 7c9fcabb..64910ca8 100644
--- a/freegames/bounce.py
+++ b/freegames/bounce.py
@@ -12,6 +12,7 @@
 
 from random import *
 from turtle import *
+
 from freegames import vector
 
 
diff --git a/freegames/cannon.py b/freegames/cannon.py
index e90ab986..b42e8410 100644
--- a/freegames/cannon.py
+++ b/freegames/cannon.py
@@ -11,6 +11,7 @@
 
 from random import randrange
 from turtle import *
+
 from freegames import vector
 
 ball = vector(-200, -200)
diff --git a/freegames/connect.py b/freegames/connect.py
index 5fcf8e8d..a5d103df 100644
--- a/freegames/connect.py
+++ b/freegames/connect.py
@@ -11,6 +11,7 @@
 """
 
 from turtle import *
+
 from freegames import line
 
 turns = {'red': 'yellow', 'yellow': 'red'}
diff --git a/freegames/flappy.py b/freegames/flappy.py
index 1bfd341d..4aec8aaf 100644
--- a/freegames/flappy.py
+++ b/freegames/flappy.py
@@ -11,6 +11,7 @@
 
 from random import *
 from turtle import *
+
 from freegames import vector
 
 bird = vector(0, 0)
diff --git a/freegames/life.py b/freegames/life.py
index 912595cc..8c0bb3aa 100644
--- a/freegames/life.py
+++ b/freegames/life.py
@@ -14,6 +14,7 @@
 
 from random import choice
 from turtle import *
+
 from freegames import square
 
 cells = {}
diff --git a/freegames/maze.py b/freegames/maze.py
index 24a23bf0..f90b6b9f 100644
--- a/freegames/maze.py
+++ b/freegames/maze.py
@@ -8,8 +8,9 @@
 
 """
 
-from turtle import *
 from random import random
+from turtle import *
+
 from freegames import line
 
 
diff --git a/freegames/memory.py b/freegames/memory.py
index f5a0ee5c..80bc62e8 100644
--- a/freegames/memory.py
+++ b/freegames/memory.py
@@ -12,6 +12,7 @@
 
 from random import *
 from turtle import *
+
 from freegames import path
 
 car = path('car.gif')
diff --git a/freegames/minesweeper.py b/freegames/minesweeper.py
index 87b772ca..44efa68e 100644
--- a/freegames/minesweeper.py
+++ b/freegames/minesweeper.py
@@ -10,6 +10,7 @@
 
 from random import randrange, seed
 from turtle import *
+
 from freegames import floor, square
 
 seed(0)
diff --git a/freegames/pacman.py b/freegames/pacman.py
index 58e849ea..2bc70d2f 100644
--- a/freegames/pacman.py
+++ b/freegames/pacman.py
@@ -12,6 +12,7 @@
 
 from random import choice
 from turtle import *
+
 from freegames import floor, vector
 
 state = {'score': 0}
diff --git a/freegames/paint.py b/freegames/paint.py
index 4235abcc..0a7b167e 100644
--- a/freegames/paint.py
+++ b/freegames/paint.py
@@ -11,6 +11,7 @@
 """
 
 from turtle import *
+
 from freegames import vector
 
 
diff --git a/freegames/pong.py b/freegames/pong.py
index 4e6ec456..faf0efd0 100644
--- a/freegames/pong.py
+++ b/freegames/pong.py
@@ -14,6 +14,7 @@
 
 from random import choice, random
 from turtle import *
+
 from freegames import vector
 
 
diff --git a/freegames/simonsays.py b/freegames/simonsays.py
index 312e74a1..c1aa4733 100644
--- a/freegames/simonsays.py
+++ b/freegames/simonsays.py
@@ -10,6 +10,7 @@
 from random import choice
 from time import sleep
 from turtle import *
+
 from freegames import floor, square, vector
 
 pattern = []
diff --git a/freegames/snake.py b/freegames/snake.py
index 9372c38e..8bf5a52f 100644
--- a/freegames/snake.py
+++ b/freegames/snake.py
@@ -9,8 +9,9 @@
 
 """
 
-from turtle import *
 from random import randrange
+from turtle import *
+
 from freegames import square, vector
 
 food = vector(0, 0)
diff --git a/freegames/tictactoe.py b/freegames/tictactoe.py
index 8857d59b..b7a4a2d2 100644
--- a/freegames/tictactoe.py
+++ b/freegames/tictactoe.py
@@ -10,6 +10,7 @@
 """
 
 from turtle import *
+
 from freegames import line
 
 
diff --git a/freegames/tiles.py b/freegames/tiles.py
index 05083d3d..11aef296 100644
--- a/freegames/tiles.py
+++ b/freegames/tiles.py
@@ -11,6 +11,7 @@
 
 from random import *
 from turtle import *
+
 from freegames import floor, vector
 
 tiles = {}
diff --git a/freegames/tron.py b/freegames/tron.py
index 3f1b69e6..5b4cbb58 100644
--- a/freegames/tron.py
+++ b/freegames/tron.py
@@ -10,6 +10,7 @@
 """
 
 from turtle import *
+
 from freegames import square, vector
 
 p1xy = vector(-100, 0)
diff --git a/setup.py b/setup.py
index 645b4d06..c4f12aaa 100644
--- a/setup.py
+++ b/setup.py
@@ -1,7 +1,7 @@
 import io
-import setuptools as st
 import sys
 
+import setuptools as st
 from setuptools.command.test import test as TestCommand
 
 import freegames
diff --git a/tests/test_bounce.py b/tests/test_bounce.py
index d397163c..5cad045a 100644
--- a/tests/test_bounce.py
+++ b/tests/test_bounce.py
@@ -1,7 +1,7 @@
 import random
 import runpy
-import turtle
 import sys
+import turtle
 
 import mockturtle
 

From e8fbdbc021f053e81b583c80ad890512dae91813 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 15 Jun 2021 14:25:50 -0400
Subject: [PATCH 11/77] Add tests for minesweeper

---
 tests/test_minesweeper.py | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)
 create mode 100644 tests/test_minesweeper.py

diff --git a/tests/test_minesweeper.py b/tests/test_minesweeper.py
new file mode 100644
index 00000000..2c4e5e53
--- /dev/null
+++ b/tests/test_minesweeper.py
@@ -0,0 +1,23 @@
+import random
+import runpy
+import sys
+import unittest.mock as mock
+
+import mockturtle
+
+sys.modules['turtle'] = sys.modules['mockturtle']
+
+
+def test_minesweeper():
+    random.seed(0)
+    mockturtle.events[:] = (
+        ('click', 175, -175),
+        ('click', -75, -75),
+        ('click', 125, 125),
+    )
+
+    try:
+        with mock.patch('time.sleep', lambda delay: None):
+            runpy.run_module('freegames.minesweeper')
+    except SystemExit:
+        pass

From 89dfec8361cc15d74aab7a3c31dcd1d56aa6503c Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 15 Jun 2021 14:26:01 -0400
Subject: [PATCH 12/77] Simplify ant game

---
 freegames/ant.py | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/freegames/ant.py b/freegames/ant.py
index 030a8a16..d83c7168 100644
--- a/freegames/ant.py
+++ b/freegames/ant.py
@@ -36,14 +36,12 @@ def draw():
     goto(ant.x, ant.y)
     dot(4)
 
-    if running:
-        ontimer(draw, 100)
+    ontimer(draw, 100)
 
 
 setup(420, 420, 370, 0)
 hideturtle()
 tracer(False)
 up()
-running = True
 draw()
 done()

From ab9ef3ff049b4eef570c8db21d950417c20f9391 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 15 Jun 2021 14:26:24 -0400
Subject: [PATCH 13/77] Simplify crypto branching

---
 freegames/crypto.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/freegames/crypto.py b/freegames/crypto.py
index f89e52ac..92e0805b 100644
--- a/freegames/crypto.py
+++ b/freegames/crypto.py
@@ -30,7 +30,8 @@ def encrypt(message, key):
 
             if letter.isupper():
                 base = ord('A')
-            elif letter.islower():
+            else:
+                assert letter.islower()
                 base = ord('a')
 
             # The encryption equation:

From 83dc3d209ed4fd1895f853cf82e3145f96bf829c Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 15 Jun 2021 14:26:36 -0400
Subject: [PATCH 14/77] Collections abc deprecation warning

---
 freegames/utils.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/freegames/utils.py b/freegames/utils.py
index 103d9899..edf96cbe 100644
--- a/freegames/utils.py
+++ b/freegames/utils.py
@@ -3,7 +3,7 @@
 """
 # pylint: disable=no-member
 
-import collections
+import collections.abc
 import math
 import os
 
@@ -76,7 +76,7 @@ def square(x, y, size, name):
     turtle.end_fill()
 
 
-class vector(collections.Sequence):
+class vector(collections.abc.Sequence):
     """Two-dimensional vector.
 
     Vectors can be modified in-place.

From b4e4a5a0ffecf3cd2d90ad48232eca9e4a81e8ff Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 15 Jun 2021 14:26:50 -0400
Subject: [PATCH 15/77] Test colors

---
 tests/test_paint.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/tests/test_paint.py b/tests/test_paint.py
index 4da7ff7d..492d648f 100644
--- a/tests/test_paint.py
+++ b/tests/test_paint.py
@@ -10,18 +10,23 @@
 def test_paint():
     random.seed(0)
     mockturtle.events[:] = [
+        ('key K',),
         ('key l',),
         ('click', 0, 0),
         ('click', 10, 10),
+        ('key W',),
         ('key s',),
         ('click', 20, 20),
         ('click', 30, 30),
+        ('key G',),
         ('key c',),
         ('click', 30, 30),
         ('click', 40, 40),
+        ('key B',),
         ('key r',),
         ('click', 30, 30),
         ('click', 40, 40),
+        ('key R',),
         ('key t',),
         ('click', 30, 30),
         ('click', 40, 40),

From b24afe478cc0f4937cdedd038d875dddf168b2f8 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 15 Jun 2021 14:26:57 -0400
Subject: [PATCH 16/77] Test back-and-forth

---
 tests/test_pong.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/tests/test_pong.py b/tests/test_pong.py
index b2809eb3..c3500585 100644
--- a/tests/test_pong.py
+++ b/tests/test_pong.py
@@ -10,7 +10,8 @@
 def test_pong_1():
     random.seed(0)
     mockturtle.events.clear()
-    mockturtle.events += [('timer',), ('key s',)] * 8
+    mockturtle.events += [('timer',), ('key s',)] * 12
+    mockturtle.events += [('timer',), ('key w',)] * 4
     mockturtle.events += [('timer', True)] * 600
     runpy.run_module('freegames.pong')
 
@@ -18,6 +19,7 @@ def test_pong_1():
 def test_pong_2():
     random.seed(1)
     mockturtle.events.clear()
-    mockturtle.events += [('timer',), ('key k',)] * 12
+    mockturtle.events += [('timer',), ('key k',)] * 18
+    mockturtle.events += [('timer',), ('key i',)] * 6
     mockturtle.events += [('timer', True)] * 600
     runpy.run_module('freegames.pong')

From a5805a81a6e2c88807b1006e623276139c07ae7d Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 15 Jun 2021 14:27:08 -0400
Subject: [PATCH 17/77] Add test for going in a circle

---
 tests/test_snake.py | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/tests/test_snake.py b/tests/test_snake.py
index d08a954a..2b12276e 100644
--- a/tests/test_snake.py
+++ b/tests/test_snake.py
@@ -15,6 +15,14 @@ def test_snake():
         ('key Left',),
         ('timer',),
         ('key Up',),
+        ('timer',),
+        ('key Right',),
+        ('timer',),
+        ('key Down',),
+        ('timer',),
+        ('key Left',),
+        ('timer',),
+        ('key Up',),
     ]
     mockturtle.events += [('timer', True)] * 300
     runpy.run_module('freegames.snake')

From f84515e73becf9dc1dfcd97b51312cfbf2197a25 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 15 Jun 2021 14:27:26 -0400
Subject: [PATCH 18/77] Go back-and-forth

---
 tests/test_tron.py | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/tests/test_tron.py b/tests/test_tron.py
index 12753ace..0d871d16 100644
--- a/tests/test_tron.py
+++ b/tests/test_tron.py
@@ -9,11 +9,15 @@
 
 def test_tron_1():
     random.seed(0)
-    mockturtle.events[:] = [('key a',), ('key a',)] + [('timer', True)] * 600
+    mockturtle.events.clear()
+    mockturtle.events += [('key a',), ('key d',), ('key a',)]
+    mockturtle.events += [('timer', True)] * 600
     runpy.run_module('freegames.tron')
 
 
 def test_tron_2():
     random.seed(0)
-    mockturtle.events[:] = [('key j',), ('key j',)] + [('timer', True)] * 600
+    mockturtle.events.clear()
+    mockturtle.events += [('key j',), ('key l',), ('key j',)]
+    mockturtle.events += [('timer', True)] * 600
     runpy.run_module('freegames.tron')

From cbe0e8a605f1a1012c8aff86986630f1e416bb02 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 15 Jun 2021 14:27:58 -0400
Subject: [PATCH 19/77] Remove flake8 and simplify switches

---
 tox.ini | 12 +++---------
 1 file changed, 3 insertions(+), 9 deletions(-)

diff --git a/tox.ini b/tox.ini
index 2ac9f335..76758969 100644
--- a/tox.ini
+++ b/tox.ini
@@ -1,5 +1,5 @@
 [tox]
-envlist=bluecheck,doc8,docs,isortcheck,flake8,rstcheck,py36,py37,py38,py39
+envlist=bluecheck,doc8,docs,isortcheck,rstcheck,py36,py37,py38,py39
 skip_missing_interpreters=True
 
 [testenv]
@@ -7,7 +7,7 @@ deps=
     coverage
     pytest
     pytest-cov
-commands=python -m pytest -v --cov freegames --cov-report term-missing tests
+commands=pytest tests
 setenv=
     PYTHONPATH={toxinidir}:{toxinidir}/tests
 
@@ -30,10 +30,6 @@ commands=make html
 deps=
     sphinx
 
-[testenv:flake8]
-commands=flake8 {toxinidir}/setup.py {toxinidir}/freegames {toxinidir}/tests
-deps=flake8
-
 [testenv:isort]
 commands=isort {toxinidir}/setup.py {toxinidir}/freegames {toxinidir}/tests
 deps=isort
@@ -43,7 +39,7 @@ commands=isort --check {toxinidir}/setup.py {toxinidir}/freegames {toxinidir}/te
 deps=isort
 
 [testenv:rstcheck]
-commands=rstcheck {toxinidir}/README.rst
+commands=rstcheck --report warning {toxinidir}/README.rst
 deps=rstcheck
 
 [testenv:uploaddocs]
@@ -63,8 +59,6 @@ line_length = 79
 
 [pytest]
 addopts=
-    -n auto
-    --cov-branch
     --cov-fail-under=100
     --cov-report=term-missing
     --cov=freegames

From 56183bc0d60e268ed791cb2e2cb98c100b6498c9 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 15 Jun 2021 14:34:50 -0400
Subject: [PATCH 20/77] Remove flake8 and test on Windows and MacOS

---
 .github/workflows/integration.yml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/integration.yml b/.github/workflows/integration.yml
index 1e9295c9..ab2c0aa2 100644
--- a/.github/workflows/integration.yml
+++ b/.github/workflows/integration.yml
@@ -13,9 +13,9 @@ jobs:
   checks:
     runs-on: ubuntu-latest
     strategy:
-      max-parallel: 6
+      max-parallel: 5
       matrix:
-        check: [bluecheck, doc8, docs, isortcheck, flake8, rstcheck]
+        check: [bluecheck, doc8, docs, isortcheck, rstcheck]
     steps:
     - uses: actions/checkout@v2
     - uses: actions/setup-python@v2
@@ -35,7 +35,7 @@ jobs:
     strategy:
       max-parallel: 4
       matrix:
-        os: [ubuntu-latest]
+        os: [ubuntu-latest, windows-latest, macos-latest]
         python-version: [3.6, 3.7, 3.8, 3.9]
     steps:
       - uses: actions/checkout@v2

From 615eb562627448953f709b3b13f36e523d44fdf1 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 15 Jun 2021 14:40:33 -0400
Subject: [PATCH 21/77] Update project urls and classifiers

---
 setup.py | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/setup.py b/setup.py
index c4f12aaa..ed4ee8c6 100644
--- a/setup.py
+++ b/setup.py
@@ -29,15 +29,22 @@ def run_tests(self):
     version=freegames.__version__,
     description='Free Games',
     long_description=readme,
+    long_description_content_type='text/x-rst',
     author='Grant Jenks',
     author_email='contact@grantjenks.com',
     url='http://www.grantjenks.com/docs/freegames/',
+    license='Apache 2.0',
     packages=['freegames'],
     include_package_data=True,
     tests_require=['tox'],
     cmdclass={'test': Tox},
-    license='Apache 2.0',
     install_requires=[],
+    project_urls={
+        'Documentation': 'http://www.grantjenks.com/docs/freegames/',
+        'Funding': 'http://gum.co/freegames',
+        'Source': 'https://github.com/grantjenks/free-python-games',
+        'Tracker': 'https://github.com/grantjenks/free-python-games/issues',
+    },
     classifiers=(
         'Development Status :: 5 - Production/Stable',
         'Intended Audience :: Education',
@@ -46,10 +53,10 @@ def run_tests(self):
         'Natural Language :: English',
         'Programming Language :: Python',
         'Programming Language :: Python :: 3',
-        'Programming Language :: Python :: 3.4',
-        'Programming Language :: Python :: 3.5',
         'Programming Language :: Python :: 3.6',
         'Programming Language :: Python :: 3.7',
+        'Programming Language :: Python :: 3.8',
+        'Programming Language :: Python :: 3.9',
         'Programming Language :: Python :: Implementation :: CPython',
         'Topic :: Games/Entertainment',
         'Topic :: Games/Entertainment :: Arcade',

From 65804834ed01b05dc78312bcf57db2a01d19648f Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 15 Jun 2021 14:50:05 -0400
Subject: [PATCH 22/77] Windows %$#@!

---
 .github/workflows/integration.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/integration.yml b/.github/workflows/integration.yml
index ab2c0aa2..88d91c48 100644
--- a/.github/workflows/integration.yml
+++ b/.github/workflows/integration.yml
@@ -35,7 +35,7 @@ jobs:
     strategy:
       max-parallel: 4
       matrix:
-        os: [ubuntu-latest, windows-latest, macos-latest]
+        os: [ubuntu-latest]
         python-version: [3.6, 3.7, 3.8, 3.9]
     steps:
       - uses: actions/checkout@v2

From 9fd4af2b3af669da18cbea457efc5de21279764a Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 15 Jun 2021 14:54:51 -0400
Subject: [PATCH 23/77] Update copyright to 2021

---
 README.rst            | 2 +-
 freegames/__init__.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.rst b/README.rst
index 3efddd88..cef360bf 100644
--- a/README.rst
+++ b/README.rst
@@ -334,7 +334,7 @@ References
 Free Python Games License
 -------------------------
 
-Copyright 2017-2020 Grant Jenks
+Copyright 2017-2021 Grant Jenks
 
 Licensed under the Apache License, Version 2.0 (the "License"); you may not use
 this file except in compliance with the License.  You may obtain a copy of the
diff --git a/freegames/__init__.py b/freegames/__init__.py
index 8cc4db82..76449978 100644
--- a/freegames/__init__.py
+++ b/freegames/__init__.py
@@ -67,4 +67,4 @@
 __build__ = 0x020302
 __author__ = 'Grant Jenks'
 __license__ = 'Apache 2.0'
-__copyright__ = '2017-2020, Grant Jenks'
+__copyright__ = '2017-2021, Grant Jenks'

From db010f8e015e99584d254d5dd34ec294f2b5db58 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 15 Jun 2021 14:57:16 -0400
Subject: [PATCH 24/77] Add replit file for support

---
 .replit | 2 ++
 1 file changed, 2 insertions(+)
 create mode 100644 .replit

diff --git a/.replit b/.replit
new file mode 100644
index 00000000..fc2fa361
--- /dev/null
+++ b/.replit
@@ -0,0 +1,2 @@
+language = "python3"
+run = ""

From 3072487e1387d51f31deb4a2ec9f8d48b5b3f766 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 15 Jun 2021 14:59:44 -0400
Subject: [PATCH 25/77] Remove replit, don't want to grant GitHub access

---
 .replit | 2 --
 1 file changed, 2 deletions(-)
 delete mode 100644 .replit

diff --git a/.replit b/.replit
deleted file mode 100644
index fc2fa361..00000000
--- a/.replit
+++ /dev/null
@@ -1,2 +0,0 @@
-language = "python3"
-run = ""

From 8c67c5499908aed12e057ab44811400b1fd7a8dd Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 15 Jun 2021 15:09:21 -0400
Subject: [PATCH 26/77] Align isort and blue line lengths

---
 tox.ini | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tox.ini b/tox.ini
index 76758969..91a15c5b 100644
--- a/tox.ini
+++ b/tox.ini
@@ -55,7 +55,7 @@ include_trailing_comma = True
 force_grid_wrap = 0
 use_parentheses = True
 ensure_newline_before_comments = True
-line_length = 79
+line_length = 80
 
 [pytest]
 addopts=

From b1f940466698a64e1fd94e708e38e44636c1428c Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Mon, 29 Nov 2021 22:17:06 -0800
Subject: [PATCH 27/77] Update to support Python 3.10 (#75)

* Update to support Python 3.10
* Update copyright
* Add flake8 testing
* Remove unused import
* Update copyright for 2022
* I blue it!
---
 .github/workflows/integration.yml | 10 +++++-----
 LICENSE                           |  2 +-
 README.rst                        |  6 +++---
 freegames/__init__.py             |  1 -
 freegames/__main__.py             |  5 ++---
 freegames/ant.py                  |  5 ++---
 freegames/bagels.py               |  1 -
 freegames/bounce.py               |  5 ++---
 freegames/cannon.py               |  9 ++++-----
 freegames/connect.py              |  5 ++---
 freegames/crypto.py               |  9 ++++-----
 freegames/fidget.py               |  7 +++----
 freegames/flappy.py               |  9 ++++-----
 freegames/guess.py                |  1 -
 freegames/life.py                 |  7 +++----
 freegames/madlibs.py              |  1 -
 freegames/maze.py                 |  5 ++---
 freegames/memory.py               | 11 +++++------
 freegames/minesweeper.py          | 11 +++++------
 freegames/pacman.py               | 13 ++++++-------
 freegames/paint.py                | 15 +++++++--------
 freegames/pong.py                 |  9 ++++-----
 freegames/simonsays.py            | 11 +++++------
 freegames/snake.py                |  7 +++----
 freegames/tictactoe.py            | 11 +++++------
 freegames/tiles.py                |  9 ++++-----
 freegames/tron.py                 |  5 ++---
 freegames/utils.py                |  5 ++---
 setup.py                          |  1 +
 tests/mockturtle.py               |  1 -
 tests/test_bounce.py              |  1 -
 tox.ini                           |  7 ++++++-
 32 files changed, 92 insertions(+), 113 deletions(-)

diff --git a/.github/workflows/integration.yml b/.github/workflows/integration.yml
index 88d91c48..331eba3d 100644
--- a/.github/workflows/integration.yml
+++ b/.github/workflows/integration.yml
@@ -13,14 +13,14 @@ jobs:
   checks:
     runs-on: ubuntu-latest
     strategy:
-      max-parallel: 5
+      max-parallel: 6
       matrix:
-        check: [bluecheck, doc8, docs, isortcheck, rstcheck]
+        check: [bluecheck, doc8, docs, flake8, isortcheck, rstcheck]
     steps:
     - uses: actions/checkout@v2
     - uses: actions/setup-python@v2
       with:
-        python-version: 3.9
+        python-version: '3.10'
     - name: Setup tox
       run: |
         pip install --upgrade pip
@@ -33,10 +33,10 @@ jobs:
     needs: checks
     runs-on: ${{ matrix.os }}
     strategy:
-      max-parallel: 4
+      max-parallel: 5
       matrix:
         os: [ubuntu-latest]
-        python-version: [3.6, 3.7, 3.8, 3.9]
+        python-version: [3.6, 3.7, 3.8, 3.9, '3.10']
     steps:
       - uses: actions/checkout@v2
       - uses: actions/setup-python@v2
diff --git a/LICENSE b/LICENSE
index 7874bf39..1db7e981 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1,4 +1,4 @@
-Copyright 2017-2019 Grant Jenks
+Copyright 2017-2022 Grant Jenks
 
 Licensed under the Apache License, Version 2.0 (the "License"); you may not use
 this file except in compliance with the License.  You may obtain a copy of the
diff --git a/README.rst b/README.rst
index cef360bf..32d87e5c 100644
--- a/README.rst
+++ b/README.rst
@@ -72,8 +72,8 @@ Features
 - Used in hundreds of hours of classroom instruction
 - Fully Documented
 - 100% Test Coverage
-- Developed on Python 3.9
-- Tested on CPython 3.6, 3.7, 3.8, 3.9
+- Developed on Python 3.10
+- Tested on CPython 3.6, 3.7, 3.8, 3.9, 3.10
 - Tested on Linux, Mac OS X, and Windows
 - Tested using GitHub Actions
 
@@ -334,7 +334,7 @@ References
 Free Python Games License
 -------------------------
 
-Copyright 2017-2021 Grant Jenks
+Copyright 2017-2022 Grant Jenks
 
 Licensed under the Apache License, Version 2.0 (the "License"); you may not use
 this file except in compliance with the License.  You may obtain a copy of the
diff --git a/freegames/__init__.py b/freegames/__init__.py
index 76449978..1d73f372 100644
--- a/freegames/__init__.py
+++ b/freegames/__init__.py
@@ -55,7 +55,6 @@
 code. To launch the editor and make changes to the "snake" game run::
 
   $ python3 -m idlelib.idle snake.py
-
 """
 
 from .utils import floor, line, path, square, vector
diff --git a/freegames/__main__.py b/freegames/__main__.py
index b083f70a..3212a184 100644
--- a/freegames/__main__.py
+++ b/freegames/__main__.py
@@ -1,5 +1,4 @@
 """Free Games CLI
-
 """
 
 import argparse
@@ -10,7 +9,7 @@
 
 
 def game_file(name):
-    "Return True if filename represents a game."
+    """Return True if filename represents a game."""
     return (
         name.endswith('.py')
         and not name.startswith('__')
@@ -23,7 +22,7 @@ def game_file(name):
 parser = argparse.ArgumentParser(
     prog='freegames',
     description='Free Python Games',
-    epilog='Copyright 2017 Grant Jenks',
+    epilog='Copyright 2022 Grant Jenks',
 )
 subparsers = parser.add_subparsers(dest='command', help='sub-command help')
 
diff --git a/freegames/ant.py b/freegames/ant.py
index d83c7168..45b32fcd 100644
--- a/freegames/ant.py
+++ b/freegames/ant.py
@@ -6,7 +6,6 @@
 2. Make the ant leave a trail.
 3. Change the ant color based on position.
    Hint: colormode(255); color(0, 100, 200)
-
 """
 
 from random import *
@@ -19,12 +18,12 @@
 
 
 def wrap(value):
-    "Wrap value around -200 and 200."
+    """Wrap value around -200 and 200."""
     return value  # TODO
 
 
 def draw():
-    "Move ant and draw screen."
+    """Move ant and draw screen."""
     ant.move(aim)
     ant.x = wrap(ant.x)
     ant.y = wrap(ant.y)
diff --git a/freegames/bagels.py b/freegames/bagels.py
index 87484eec..4616b2f5 100644
--- a/freegames/bagels.py
+++ b/freegames/bagels.py
@@ -7,7 +7,6 @@
 3. What's the maximum number of digits we could support?
 
 Adapted from code in https://inventwithpython.com/chapter11.html
-
 """
 
 from random import sample, shuffle
diff --git a/freegames/bounce.py b/freegames/bounce.py
index 64910ca8..ddc14ee8 100644
--- a/freegames/bounce.py
+++ b/freegames/bounce.py
@@ -7,7 +7,6 @@
 3. Make the ball leave a trail.
 4. Change the ball color based on position.
    Hint: colormode(255); color(0, 100, 200)
-
 """
 
 from random import *
@@ -17,7 +16,7 @@
 
 
 def value():
-    "Randomly generate value between (-5, -3) or (3, 5)."
+    """Randomly generate value between (-5, -3) or (3, 5)."""
     return (3 + random() * 2) * choice([1, -1])
 
 
@@ -26,7 +25,7 @@ def value():
 
 
 def draw():
-    "Move ball and draw game."
+    """Move ball and draw game."""
     ball.move(aim)
 
     x = ball.x
diff --git a/freegames/cannon.py b/freegames/cannon.py
index b42e8410..c68da9b1 100644
--- a/freegames/cannon.py
+++ b/freegames/cannon.py
@@ -6,7 +6,6 @@
 2. Vary the effect of gravity.
 3. Apply gravity to the targets.
 4. Change the speed of the ball.
-
 """
 
 from random import randrange
@@ -20,7 +19,7 @@
 
 
 def tap(x, y):
-    "Respond to screen tap."
+    """Respond to screen tap."""
     if not inside(ball):
         ball.x = -199
         ball.y = -199
@@ -29,12 +28,12 @@ def tap(x, y):
 
 
 def inside(xy):
-    "Return True if xy within screen."
+    """Return True if xy within screen."""
     return -200 < xy.x < 200 and -200 < xy.y < 200
 
 
 def draw():
-    "Draw ball and targets."
+    """Draw ball and targets."""
     clear()
 
     for target in targets:
@@ -49,7 +48,7 @@ def draw():
 
 
 def move():
-    "Move ball and targets."
+    """Move ball and targets."""
     if randrange(40) == 0:
         y = randrange(-150, 150)
         target = vector(200, y)
diff --git a/freegames/connect.py b/freegames/connect.py
index a5d103df..5c39e166 100644
--- a/freegames/connect.py
+++ b/freegames/connect.py
@@ -7,7 +7,6 @@
 3. Add logic to detect a full row.
 4. Create a random computer player.
 5. How would you detect a winner?
-
 """
 
 from turtle import *
@@ -19,7 +18,7 @@
 
 
 def grid():
-    "Draw Connect Four grid."
+    """Draw Connect Four grid."""
     bgcolor('light blue')
 
     for x in range(-150, 200, 50):
@@ -35,7 +34,7 @@ def grid():
 
 
 def tap(x, y):
-    "Draw red or yellow circle in tapped row."
+    """Draw red or yellow circle in tapped row."""
     player = state['player']
     rows = state['rows']
 
diff --git a/freegames/crypto.py b/freegames/crypto.py
index 92e0805b..a59affda 100644
--- a/freegames/crypto.py
+++ b/freegames/crypto.py
@@ -9,12 +9,11 @@
 5. Make the encryption harder to decode.
 
 Adapted from code in https://inventwithpython.com/chapter14.html
-
 """
 
 
 def encrypt(message, key):
-    "Encrypt message with key."
+    """Encrypt message with key."""
     result = ''
 
     # Iterate letters in message and encrypt each individually.
@@ -52,17 +51,17 @@ def encrypt(message, key):
 
 
 def decrypt(message, key):
-    "Decrypt message with key."
+    """Decrypt message with key."""
     return encrypt(message, -key)
 
 
 def decode(message):
-    "Decode message without key."
+    """Decode message without key."""
     pass  # TODO
 
 
 def get_key():
-    "Get key from user."
+    """Get key from user."""
     try:
         text = input('Enter a key (1 - 25): ')
         key = int(text)
diff --git a/freegames/fidget.py b/freegames/fidget.py
index e425acd5..84d50d50 100644
--- a/freegames/fidget.py
+++ b/freegames/fidget.py
@@ -6,7 +6,6 @@
 2. Respond to mouse clicks.
 3. Change its acceleration.
 4. Make it go forwards and backwards.
-
 """
 
 from turtle import *
@@ -15,7 +14,7 @@
 
 
 def spinner():
-    "Draw fidget spinner."
+    """Draw fidget spinner."""
     clear()
     angle = state['turn'] / 10
     right(angle)
@@ -35,7 +34,7 @@ def spinner():
 
 
 def animate():
-    "Animate fidget spinner."
+    """Animate fidget spinner."""
     if state['turn'] > 0:
         state['turn'] -= 1
 
@@ -44,7 +43,7 @@ def animate():
 
 
 def flick():
-    "Flick fidget spinner."
+    """Flick fidget spinner."""
     state['turn'] += 10
 
 
diff --git a/freegames/flappy.py b/freegames/flappy.py
index 4aec8aaf..1894c2d5 100644
--- a/freegames/flappy.py
+++ b/freegames/flappy.py
@@ -6,7 +6,6 @@
 2. Vary the speed.
 3. Vary the size of the balls.
 4. Allow the bird to move forward and back.
-
 """
 
 from random import *
@@ -19,18 +18,18 @@
 
 
 def tap(x, y):
-    "Move bird up in response to screen tap."
+    """Move bird up in response to screen tap."""
     up = vector(0, 30)
     bird.move(up)
 
 
 def inside(point):
-    "Return True if point on screen."
+    """Return True if point on screen."""
     return -200 < point.x < 200 and -200 < point.y < 200
 
 
 def draw(alive):
-    "Draw screen objects."
+    """Draw screen objects."""
     clear()
 
     goto(bird.x, bird.y)
@@ -48,7 +47,7 @@ def draw(alive):
 
 
 def move():
-    "Update object positions."
+    """Update object positions."""
     bird.y -= 5
 
     for ball in balls:
diff --git a/freegames/guess.py b/freegames/guess.py
index d7e5738c..3cdd60b8 100644
--- a/freegames/guess.py
+++ b/freegames/guess.py
@@ -6,7 +6,6 @@
 2. Can you still guess the number?
 3. Print the number of guesses made.
 4. Limit the number of guesses to the minimum required.
-
 """
 
 from random import randint
diff --git a/freegames/life.py b/freegames/life.py
index 8c0bb3aa..fcee86af 100644
--- a/freegames/life.py
+++ b/freegames/life.py
@@ -9,7 +9,6 @@
 2. How can you make the simulation faster? Or bigger?
 3. How would you modify the initial state?
 4. Try changing the rules of life :)
-
 """
 
 from random import choice
@@ -21,7 +20,7 @@
 
 
 def initialize():
-    "Randomly initialize the cells."
+    """Randomly initialize the cells."""
     for x in range(-200, 200, 10):
         for y in range(-200, 200, 10):
             cells[x, y] = False
@@ -32,7 +31,7 @@ def initialize():
 
 
 def step():
-    "Compute one step in the Game of Life."
+    """Compute one step in the Game of Life."""
     neighbors = {}
 
     for x in range(-190, 190, 10):
@@ -52,7 +51,7 @@ def step():
 
 
 def draw():
-    "Draw all the squares."
+    """Draw all the squares."""
     step()
     clear()
     for (x, y), alive in cells.items():
diff --git a/freegames/madlibs.py b/freegames/madlibs.py
index 68ff46f1..0328d7fc 100644
--- a/freegames/madlibs.py
+++ b/freegames/madlibs.py
@@ -5,7 +5,6 @@
 1. How to replace the story?
 2. How load the story and from a file?
 3. How to add additional parts of speech?
-
 """
 
 # The quick brown fox jumps over the lazy dog.
diff --git a/freegames/maze.py b/freegames/maze.py
index f90b6b9f..ca40786a 100644
--- a/freegames/maze.py
+++ b/freegames/maze.py
@@ -5,7 +5,6 @@
 1. Keep score by counting taps.
 2. Make the maze harder.
 3. Generate the same maze twice.
-
 """
 
 from random import random
@@ -15,7 +14,7 @@
 
 
 def draw():
-    "Draw maze."
+    """Draw maze."""
     color('black')
     width(5)
 
@@ -30,7 +29,7 @@ def draw():
 
 
 def tap(x, y):
-    "Draw line and dot for screen tap."
+    """Draw line and dot for screen tap."""
     if abs(x) > 198 or abs(y) > 198:
         up()
     else:
diff --git a/freegames/memory.py b/freegames/memory.py
index 80bc62e8..c0d2ad3d 100644
--- a/freegames/memory.py
+++ b/freegames/memory.py
@@ -7,7 +7,6 @@
 3. Detect when all tiles are revealed.
 4. Center single-digit tile.
 5. Use letters instead of tiles.
-
 """
 
 from random import *
@@ -22,7 +21,7 @@
 
 
 def square(x, y):
-    "Draw white square with black outline at (x, y)."
+    """Draw white square with black outline at (x, y)."""
     up()
     goto(x, y)
     down()
@@ -35,17 +34,17 @@ def square(x, y):
 
 
 def index(x, y):
-    "Convert (x, y) coordinates to tiles index."
+    """Convert (x, y) coordinates to tiles index."""
     return int((x + 200) // 50 + ((y + 200) // 50) * 8)
 
 
 def xy(count):
-    "Convert tiles count to (x, y) coordinates."
+    """Convert tiles count to (x, y) coordinates."""
     return (count % 8) * 50 - 200, (count // 8) * 50 - 200
 
 
 def tap(x, y):
-    "Update mark and hidden tiles based on tap."
+    """Update mark and hidden tiles based on tap."""
     spot = index(x, y)
     mark = state['mark']
 
@@ -58,7 +57,7 @@ def tap(x, y):
 
 
 def draw():
-    "Draw image and tiles."
+    """Draw image and tiles."""
     clear()
     goto(0, 0)
     shape(car)
diff --git a/freegames/minesweeper.py b/freegames/minesweeper.py
index 44efa68e..4278af03 100644
--- a/freegames/minesweeper.py
+++ b/freegames/minesweeper.py
@@ -5,7 +5,6 @@
 1. What does the `seed(0)` function call do?
 2. Change the number of bombs on the grid.
 3. Change the size of the grid.
-
 """
 
 from random import randrange, seed
@@ -20,7 +19,7 @@
 
 
 def initialize():
-    "Initialize `bombs`, `counts`, and `shown` grids."
+    """Initialize `bombs`, `counts`, and `shown` grids."""
     for x in range(-250, 250, 50):
         for y in range(-250, 250, 50):
             bombs[x, y] = False
@@ -42,21 +41,21 @@ def initialize():
 
 
 def stamp(x, y, text):
-    "Display `text` at coordinates `x` and `y`."
+    """Display `text` at coordinates `x` and `y`."""
     square(x, y, 50, 'white')
     color('black')
     write(text, font=('Arial', 50, 'normal'))
 
 
 def draw():
-    "Draw the initial board grid."
+    """Draw the initial board grid."""
     for x in range(-200, 200, 50):
         for y in range(-200, 200, 50):
             stamp(x, y, '?')
 
 
 def end():
-    "Draw the bombs as X's on the grid."
+    """Draw the bombs as X's on the grid."""
     for x in range(-200, 200, 50):
         for y in range(-200, 200, 50):
             if bombs[x, y]:
@@ -64,7 +63,7 @@ def end():
 
 
 def tap(x, y):
-    "Respond to screen click at `x` and `y` coordinates."
+    """Respond to screen click at `x` and `y` coordinates."""
     x = floor(x, 50)
     y = floor(y, 50)
 
diff --git a/freegames/pacman.py b/freegames/pacman.py
index 2bc70d2f..644b35a4 100644
--- a/freegames/pacman.py
+++ b/freegames/pacman.py
@@ -7,7 +7,6 @@
 3. Change where pacman starts.
 4. Make the ghosts faster/slower.
 5. Make the ghosts smarter.
-
 """
 
 from random import choice
@@ -53,7 +52,7 @@
 
 
 def square(x, y):
-    "Draw square using path at (x, y)."
+    """Draw square using path at (x, y)."""
     path.up()
     path.goto(x, y)
     path.down()
@@ -67,7 +66,7 @@ def square(x, y):
 
 
 def offset(point):
-    "Return offset of point in tiles."
+    """Return offset of point in tiles."""
     x = (floor(point.x, 20) + 200) / 20
     y = (180 - floor(point.y, 20)) / 20
     index = int(x + y * 20)
@@ -75,7 +74,7 @@ def offset(point):
 
 
 def valid(point):
-    "Return True if point is valid in tiles."
+    """Return True if point is valid in tiles."""
     index = offset(point)
 
     if tiles[index] == 0:
@@ -90,7 +89,7 @@ def valid(point):
 
 
 def world():
-    "Draw world using path."
+    """Draw world using path."""
     bgcolor('black')
     path.color('blue')
 
@@ -109,7 +108,7 @@ def world():
 
 
 def move():
-    "Move pacman and all ghosts."
+    """Move pacman and all ghosts."""
     writer.undo()
     writer.write(state['score'])
 
@@ -159,7 +158,7 @@ def move():
 
 
 def change(x, y):
-    "Change pacman aim if valid."
+    """Change pacman aim if valid."""
     if valid(pacman + vector(x, y)):
         aim.x = x
         aim.y = y
diff --git a/freegames/paint.py b/freegames/paint.py
index 0a7b167e..adc5dec5 100644
--- a/freegames/paint.py
+++ b/freegames/paint.py
@@ -7,7 +7,6 @@
 3. Complete rectangle.
 4. Complete triangle.
 5. Add width parameter.
-
 """
 
 from turtle import *
@@ -16,7 +15,7 @@
 
 
 def line(start, end):
-    "Draw line from start to end."
+    """Draw line from start to end."""
     up()
     goto(start.x, start.y)
     down()
@@ -24,7 +23,7 @@ def line(start, end):
 
 
 def square(start, end):
-    "Draw square from start to end."
+    """Draw square from start to end."""
     up()
     goto(start.x, start.y)
     down()
@@ -38,22 +37,22 @@ def square(start, end):
 
 
 def circle(start, end):
-    "Draw circle from start to end."
+    """Draw circle from start to end."""
     pass  # TODO
 
 
 def rectangle(start, end):
-    "Draw rectangle from start to end."
+    """Draw rectangle from start to end."""
     pass  # TODO
 
 
 def triangle(start, end):
-    "Draw triangle from start to end."
+    """Draw triangle from start to end."""
     pass  # TODO
 
 
 def tap(x, y):
-    "Store starting point or draw shape."
+    """Store starting point or draw shape."""
     start = state['start']
 
     if start is None:
@@ -66,7 +65,7 @@ def tap(x, y):
 
 
 def store(key, value):
-    "Store value in state at key."
+    """Store value in state at key."""
     state[key] = value
 
 
diff --git a/freegames/pong.py b/freegames/pong.py
index faf0efd0..cbabedc9 100644
--- a/freegames/pong.py
+++ b/freegames/pong.py
@@ -9,7 +9,6 @@
 5. Change how the ball bounces off walls.
 6. How would you add a computer player?
 6. Add a second ball.
-
 """
 
 from random import choice, random
@@ -19,7 +18,7 @@
 
 
 def value():
-    "Randomly generate value between (-5, -3) or (3, 5)."
+    """Randomly generate value between (-5, -3) or (3, 5)."""
     return (3 + random() * 2) * choice([1, -1])
 
 
@@ -29,12 +28,12 @@ def value():
 
 
 def move(player, change):
-    "Move player position by change."
+    """Move player position by change."""
     state[player] += change
 
 
 def rectangle(x, y, width, height):
-    "Draw rectangle at (x, y) with given width and height."
+    """Draw rectangle at (x, y) with given width and height."""
     up()
     goto(x, y)
     down()
@@ -48,7 +47,7 @@ def rectangle(x, y, width, height):
 
 
 def draw():
-    "Draw game and move pong ball."
+    """Draw game and move pong ball."""
     clear()
     rectangle(-200, state[1], 10, 50)
     rectangle(190, state[2], 10, 50)
diff --git a/freegames/simonsays.py b/freegames/simonsays.py
index c1aa4733..d583afc8 100644
--- a/freegames/simonsays.py
+++ b/freegames/simonsays.py
@@ -4,7 +4,6 @@
 
 1. Speed up tile flash rate.
 2. Add more tiles.
-
 """
 
 from random import choice
@@ -24,7 +23,7 @@
 
 
 def grid():
-    "Draw grid of tiles."
+    """Draw grid of tiles."""
     square(0, 0, 200, 'dark red')
     square(0, -200, 200, 'dark blue')
     square(-200, 0, 200, 'dark green')
@@ -33,7 +32,7 @@ def grid():
 
 
 def flash(tile):
-    "Flash tile in grid."
+    """Flash tile in grid."""
     glow, dark = tiles[tile]
     square(tile.x, tile.y, 200, glow)
     update()
@@ -44,7 +43,7 @@ def flash(tile):
 
 
 def grow():
-    "Grow pattern and flash tiles."
+    """Grow pattern and flash tiles."""
     tile = choice(list(tiles))
     pattern.append(tile)
 
@@ -56,7 +55,7 @@ def grow():
 
 
 def tap(x, y):
-    "Respond to screen tap."
+    """Respond to screen tap."""
     onscreenclick(None)
     x = floor(x, 200)
     y = floor(y, 200)
@@ -76,7 +75,7 @@ def tap(x, y):
 
 
 def start(x, y):
-    "Start game."
+    """Start game."""
     grow()
     onscreenclick(tap)
 
diff --git a/freegames/snake.py b/freegames/snake.py
index 8bf5a52f..f1f2599f 100644
--- a/freegames/snake.py
+++ b/freegames/snake.py
@@ -6,7 +6,6 @@
 2. How can you make the snake go around the edges?
 3. How would you move the food?
 4. Change the snake to respond to mouse clicks.
-
 """
 
 from random import randrange
@@ -20,18 +19,18 @@
 
 
 def change(x, y):
-    "Change snake direction."
+    """Change snake direction."""
     aim.x = x
     aim.y = y
 
 
 def inside(head):
-    "Return True if head inside boundaries."
+    """Return True if head inside boundaries."""
     return -200 < head.x < 190 and -200 < head.y < 190
 
 
 def move():
-    "Move snake forward one segment."
+    """Move snake forward one segment."""
     head = snake[-1].copy()
     head.move(aim)
 
diff --git a/freegames/tictactoe.py b/freegames/tictactoe.py
index b7a4a2d2..23a3142e 100644
--- a/freegames/tictactoe.py
+++ b/freegames/tictactoe.py
@@ -6,7 +6,6 @@
 2. What happens when someone taps a taken spot?
 3. How would you detect when someone has won?
 4. How could you create a computer player?
-
 """
 
 from turtle import *
@@ -15,7 +14,7 @@
 
 
 def grid():
-    "Draw tic-tac-toe grid."
+    """Draw tic-tac-toe grid."""
     line(-67, 200, -67, -200)
     line(67, 200, 67, -200)
     line(-200, -67, 200, -67)
@@ -23,13 +22,13 @@ def grid():
 
 
 def drawx(x, y):
-    "Draw X player."
+    """Draw X player."""
     line(x, y, x + 133, y + 133)
     line(x, y + 133, x + 133, y)
 
 
 def drawo(x, y):
-    "Draw O player."
+    """Draw O player."""
     up()
     goto(x + 67, y + 5)
     down()
@@ -37,7 +36,7 @@ def drawo(x, y):
 
 
 def floor(value):
-    "Round value down to grid with square size 133."
+    """Round value down to grid with square size 133."""
     return ((value + 200) // 133) * 133 - 200
 
 
@@ -46,7 +45,7 @@ def floor(value):
 
 
 def tap(x, y):
-    "Draw X or O in tapped square."
+    """Draw X or O in tapped square."""
     x = floor(x)
     y = floor(y)
     player = state['player']
diff --git a/freegames/tiles.py b/freegames/tiles.py
index 11aef296..94efda28 100644
--- a/freegames/tiles.py
+++ b/freegames/tiles.py
@@ -6,7 +6,6 @@
 2. Permit diagonal squares as neighbors.
 3. Respond to arrow keys instead of mouse clicks.
 4. Make the grid bigger.
-
 """
 
 from random import *
@@ -24,7 +23,7 @@
 
 
 def load():
-    "Load tiles and scramble."
+    """Load tiles and scramble."""
     count = 1
 
     for y in range(-200, 200, 100):
@@ -47,7 +46,7 @@ def load():
 
 
 def square(mark, number):
-    "Draw white square with black outline and number."
+    """Draw white square with black outline and number."""
     up()
     goto(mark.x, mark.y)
     down()
@@ -68,7 +67,7 @@ def square(mark, number):
 
 
 def tap(x, y):
-    "Swap tile and empty square."
+    """Swap tile and empty square."""
     x = floor(x, 100)
     y = floor(y, 100)
     mark = vector(x, y)
@@ -85,7 +84,7 @@ def tap(x, y):
 
 
 def draw():
-    "Draw all tiles."
+    """Draw all tiles."""
     for mark in tiles:
         square(mark, tiles[mark])
     update()
diff --git a/freegames/tron.py b/freegames/tron.py
index 5b4cbb58..6cdf0b1a 100644
--- a/freegames/tron.py
+++ b/freegames/tron.py
@@ -6,7 +6,6 @@
 2. Stop a tron player from running into itself.
 3. Allow the tron player to go around the edge of the screen.
 4. How would you create a computer player?
-
 """
 
 from turtle import *
@@ -23,12 +22,12 @@
 
 
 def inside(head):
-    "Return True if head inside screen."
+    """Return True if head inside screen."""
     return -200 < head.x < 200 and -200 < head.y < 200
 
 
 def draw():
-    "Advance players and draw game."
+    """Advance players and draw game."""
     p1xy.move(p1aim)
     p1head = p1xy.copy()
 
diff --git a/freegames/utils.py b/freegames/utils.py
index edf96cbe..30f63292 100644
--- a/freegames/utils.py
+++ b/freegames/utils.py
@@ -1,5 +1,4 @@
 """Utilities
-
 """
 # pylint: disable=no-member
 
@@ -38,7 +37,7 @@ def floor(value, size, offset=200):
 
 
 def path(filename):
-    "Return full path to `filename` in freegames module."
+    """Return full path to `filename` in freegames module."""
     filepath = os.path.realpath(__file__)
     dirpath = os.path.dirname(filepath)
     fullpath = os.path.join(dirpath, filename)
@@ -46,7 +45,7 @@ def path(filename):
 
 
 def line(a, b, x, y):
-    "Draw line from `(a, b)` to `(x, y)`."
+    """Draw line from `(a, b)` to `(x, y)`."""
     import turtle
 
     turtle.up()
diff --git a/setup.py b/setup.py
index ed4ee8c6..8d4e9e3f 100644
--- a/setup.py
+++ b/setup.py
@@ -57,6 +57,7 @@ def run_tests(self):
         'Programming Language :: Python :: 3.7',
         'Programming Language :: Python :: 3.8',
         'Programming Language :: Python :: 3.9',
+        'Programming Language :: Python :: 3.10',
         'Programming Language :: Python :: Implementation :: CPython',
         'Topic :: Games/Entertainment',
         'Topic :: Games/Entertainment :: Arcade',
diff --git a/tests/mockturtle.py b/tests/mockturtle.py
index 9bb2b019..26e5d52b 100644
--- a/tests/mockturtle.py
+++ b/tests/mockturtle.py
@@ -1,5 +1,4 @@
 """Mock turtle module.
-
 """
 
 state = {}
diff --git a/tests/test_bounce.py b/tests/test_bounce.py
index 5cad045a..eef2bc20 100644
--- a/tests/test_bounce.py
+++ b/tests/test_bounce.py
@@ -1,7 +1,6 @@
 import random
 import runpy
 import sys
-import turtle
 
 import mockturtle
 
diff --git a/tox.ini b/tox.ini
index 91a15c5b..5d835318 100644
--- a/tox.ini
+++ b/tox.ini
@@ -1,5 +1,5 @@
 [tox]
-envlist=bluecheck,doc8,docs,isortcheck,rstcheck,py36,py37,py38,py39
+envlist=bluecheck,doc8,docs,flake8,isortcheck,rstcheck,py36,py37,py38,py39,py310
 skip_missing_interpreters=True
 
 [testenv]
@@ -30,6 +30,10 @@ commands=make html
 deps=
     sphinx
 
+[testenv:flake8]
+commands=flake8 {toxinidir}/setup.py {toxinidir}/freegames {toxinidir}/tests
+deps=flake8
+
 [testenv:isort]
 commands=isort {toxinidir}/setup.py {toxinidir}/freegames {toxinidir}/tests
 deps=isort
@@ -71,4 +75,5 @@ testpaths=docs freegames tests README.rst
 # ignore=D000
 
 [flake8]
+ignore=E722,F403,F405,W503
 max-line-length=120

From 3f27c6555e2c72a9b1c668c4dd8506d7b8378d09 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Mon, 29 Nov 2021 22:22:37 -0800
Subject: [PATCH 28/77] Bump version to 2.4.0

---
 freegames/__init__.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/freegames/__init__.py b/freegames/__init__.py
index 1d73f372..93a04f93 100644
--- a/freegames/__init__.py
+++ b/freegames/__init__.py
@@ -62,8 +62,8 @@
 __all__ = ['floor', 'line', 'path', 'square', 'vector']
 
 __title__ = 'freegames'
-__version__ = '2.3.2'
-__build__ = 0x020302
+__version__ = '2.4.0'
+__build__ = 0x020400
 __author__ = 'Grant Jenks'
 __license__ = 'Apache 2.0'
-__copyright__ = '2017-2021, Grant Jenks'
+__copyright__ = '2017-2022, Grant Jenks'

From b593e16c48dc0e2250c45dd0ce2893d0937f8b97 Mon Sep 17 00:00:00 2001
From: Nitin Kumar <40369168+nitinkumar30@users.noreply.github.com>
Date: Sun, 24 Apr 2022 23:42:56 +0530
Subject: [PATCH 29/77] Not printing value beforehand (#84)

Printing the number before the user can actually guess the number. Doesn't justify the game, so need to comment the line.
---
 freegames/guess.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/freegames/guess.py b/freegames/guess.py
index 3cdd60b8..d77fd842 100644
--- a/freegames/guess.py
+++ b/freegames/guess.py
@@ -14,7 +14,7 @@
 end = 100
 value = randint(start, end)
 
-print(value)
+# print(value)
 print("I'm thinking of a number between", start, 'and', end)
 
 guess = None

From f8374506a16909cd9b3ad941bdd2d6aabe70a34d Mon Sep 17 00:00:00 2001
From: gaurav17467 <84239101+gaurav17467@users.noreply.github.com>
Date: Tue, 27 Dec 2022 09:14:00 +0530
Subject: [PATCH 30/77] Create rock_paper_scissors.py (#70)

---
 freegames/rock_paper_scissors.py | 74 ++++++++++++++++++++++++++++++++
 1 file changed, 74 insertions(+)
 create mode 100644 freegames/rock_paper_scissors.py

diff --git a/freegames/rock_paper_scissors.py b/freegames/rock_paper_scissors.py
new file mode 100644
index 00000000..a7e50a8e
--- /dev/null
+++ b/freegames/rock_paper_scissors.py
@@ -0,0 +1,74 @@
+import random  
+import os 
+
+WIN_LIST_RPS = [('ROCK', 'SCISSORS'),
+                ('SCISSORS', 'PAPER'),  
+                ('PAPER', 'ROCK')]  
+
+SELECTIONS_LIST_RPS = ['ROCK', 'PAPER', 'SCISSORS']
+
+stats_count = {'player':0, 'computer':0, 'ties':0}
+
+def clrscr():
+  if os.name == "posix":  
+    os.system('clear')
+  elif os.name in ("nt", "dos", "ce"): 
+    os.system('CLS')
+
+    
+def lets_play():
+  """ A function that sets which game is going to be played based on the option selected """
+  clrscr()
+  
+  intro = (" Welcome to Rock + Paper + Scissors game!")  
+  option_help = ("\n This game is simple and goes as following:"  
+          "\n *You can choose between: Rock, Paper or Scissors."
+          "\n\n You must take in consideration that:"
+          "\n *Rock crushers Scissors."
+          "\n *Scissors cut Paper."
+          "\n *Paper covers Rock."
+          "\n\n Notes: *The first one that scores 5 points WINS the game!")
+  selections_list = SELECTIONS_LIST_RPS 
+  win_list = WIN_LIST_RPS  
+  print(intro)
+  print(option_help)  
+    
+  while True:
+    player_selection = input("Your Selection {}: ".format(selections_list))
+    player_selection = player_selection.upper()
+    
+    if player_selection in selections_list:
+      clrscr()
+      computer_selection = random.choice(selections_list)
+      
+      print("Player Selection: {}".format(player_selection))
+      print("Computer Selection: {}".format(computer_selection))
+      
+      match = player_selection, computer_selection 
+      
+      if player_selection == computer_selection:
+        stats_count['ties'] += 1
+        print("\nResult: Both are {}! So that's a Tie!".format(player_selection))
+      elif match in win_list:
+        stats_count['player'] += 1
+        print("\nResult: The power of {} beats {}! You won!".format(player_selection, computer_selection))
+      else: 
+        stats_count['computer'] += 1
+        print("\nResult: The power of {} is stronger than {}! You lost!".format(computer_selection, player_selection))
+      print("-------  STATS  -------"
+            "\n YOU  | COMPUTER | DRAW"
+            "\n  {player}        {computer}        {ties}"
+            "\n-----------------------".format(**stats_count))
+      if stats_count['player'] == 5:
+        print("The game is DONE! You won! Congratulations!")
+        exit()
+      elif stats_count['computer'] == 5:
+        print("The game is DONE! You lost against a perfectly designed AI! You're now in the wall of shame!")
+        exit()
+    elif player_selection == 'HELP':
+      clrscr()
+      print(option_help)
+    else:
+      print("Invalid selection. Try again...") 
+      
+lets_play()

From 1a3940eaa41061508ab781c2670a73df3d1d63cf Mon Sep 17 00:00:00 2001
From: Bamboudorer <51965632+Bamboudorer@users.noreply.github.com>
Date: Tue, 27 Dec 2022 07:47:43 +0400
Subject: [PATCH 31/77] Feature horizontal illusion line (#82)

* Feature horizontal illusion line

* Update for test flake8 and isortcheck

* Code reformat with tox -e blue
---
 freegames/illusion.py | 54 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 54 insertions(+)
 create mode 100644 freegames/illusion.py

diff --git a/freegames/illusion.py b/freegames/illusion.py
new file mode 100644
index 00000000..1e283a2e
--- /dev/null
+++ b/freegames/illusion.py
@@ -0,0 +1,54 @@
+"""Illusion, just create a small illusion.
+
+Exercises :
+
+1. Change the number of line.
+2. Change the size of the line or the square
+"""
+
+from turtle import *
+
+from freegames import line, square
+
+square_size = 25
+
+
+def draw_one_line_square(start_x, start_y):
+    for i in range(0, 10):
+        place_x = start_x + (i * square_size * 2)
+        square(place_x, start_y, square_size, 'black')
+
+
+def draw_all_lines():
+    base_x = -200
+    base_y = 150
+    for i in range(0, 11):
+        line(
+            base_x,
+            base_y - i * square_size,
+            base_x + 16 * square_size,
+            base_y - i * square_size,
+        )
+
+
+def draw_all_square():
+    draw_one_line_square(-200, 150)
+    draw_one_line_square(-190, 125)
+    draw_one_line_square(-180, 100)
+    draw_one_line_square(-190, 75)
+    draw_one_line_square(-200, 50)
+    draw_one_line_square(-190, 25)
+    draw_one_line_square(-180, 0)
+    draw_one_line_square(-190, -25)
+    draw_one_line_square(-200, -50)
+    draw_one_line_square(-190, -75)
+    draw_one_line_square(-180, -100)
+
+
+setup(420, 400, 30, 0)
+hideturtle()
+tracer(False)
+listen()
+draw_all_lines()
+draw_all_square()
+done()

From 23914d20d93e267ee977927a1b7c3f6e034151c5 Mon Sep 17 00:00:00 2001
From: BaekMinHyeon <44044119+BaekMinHyeon@users.noreply.github.com>
Date: Tue, 27 Dec 2022 12:53:08 +0900
Subject: [PATCH 32/77] hangman game code (#91)

* hangman game code
* Add docs about hangman
---
 docs/hangman.rst     |   6 +++
 freegames/hangman.py | 112 +++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 118 insertions(+)
 create mode 100644 docs/hangman.rst
 create mode 100644 freegames/hangman.py

diff --git a/docs/hangman.rst b/docs/hangman.rst
new file mode 100644
index 00000000..b017049d
--- /dev/null
+++ b/docs/hangman.rst
@@ -0,0 +1,6 @@
+Hangman
+====
+
+Hangman, a letter guessing game.
+
+.. literalinclude:: ../freegames/hangman.py
\ No newline at end of file
diff --git a/freegames/hangman.py b/freegames/hangman.py
new file mode 100644
index 00000000..9839d79c
--- /dev/null
+++ b/freegames/hangman.py
@@ -0,0 +1,112 @@
+"""Hangman, a letter guessing game
+
+Exercises
+1. Change Hangman's picture (position, length, etc)
+2. Make an additional dictionary, not fruits
+3. Convert lowercase letters to uppercase letters
+"""
+
+from turtle import *
+from random import choice
+import functools
+
+def screen_write(letter):
+    """write text on the screen"""
+    write(letter, move=True, font=("Courier", 14, "normal"))
+
+def move_write(x, y, letter):
+    """After move, write text on the screen"""
+    goto(x, y)
+    screen_write(letter)
+
+
+def draw(x, y, angle, length, straight):
+    """draw a hangman game"""
+    goto(x, y)
+    pendown()
+    left(angle)
+    if straight:
+        forward(length)
+    else:
+        circle(length, None, 100)
+    penup()
+
+def draw_Hangman(step):
+    if step == 1: 
+        # draw head
+        draw(-45, 160, 270, 15, False)
+    elif step == 2:
+        # draw torso
+        draw(-45, 130, 90, 40, True)
+    elif step == 3:
+        # draw left arm
+        draw(-45, 120, 235, 40, True)
+    elif step == 4:
+        # draw right arm
+        draw(-45, 120, 250, 40, True)
+    elif step == 5:
+        # draw left leg
+        draw(-45, 90, 205, 40, True)
+    elif step == 6:
+        # draw right leg
+        draw(-45, 90, 60, 40, True)
+
+def guess(letter):
+    global correct
+    global use
+    global wrong
+    global finish
+    if not finish:
+        if letter not in use:
+            goto(-100,-35)
+            for i in word:
+                if i == letter:
+                    screen_write(letter.lower() + " ")
+                    correct += letter
+                else:
+                     screen_write("_ ") 
+            use += letter 
+            if letter not in word:
+                wrong += 1
+                draw_Hangman(wrong)
+            move_write(-200, -100, "Guesses: ")
+            for i in use:
+                screen_write(i.lower() + " ")
+        if wrong == 6:
+            goto(-100,-35)
+            for i in word:
+                if i in correct:
+                    screen_write("_ ")
+                else:
+                    screen_write(i.lower() + " ")
+            move_write(-130, -60, "Sorry, you lose!")
+            finish = True
+        if len(correct) == len(word):
+            move_write(-130, -60, "Congratulations, you win!")
+            finish = True
+
+hideturtle()
+speed(0)
+
+fruitword = ['apple', 'banana', 'blueberry', 'cherry', 'coconut', 'durian', 'grape', 'kiwi', 'lemon',
+            'lime', 'mango', 'melon', 'orange', 'peach', 'pear', 'pineapple', 'strawberry','watermelon']
+
+"""draw gallows"""
+penup()
+draw(50, 0, 90, 175, True)
+draw(50, 175, 90, 95, True)
+draw(-45, 175, 90, 15, True)
+
+goto(-100,-35)
+word = choice(fruitword)
+correct = []
+use = []
+wrong = 0
+finish = False
+for i in word:
+    screen_write("_ ")
+for ascii in range(ord('a'), ord('z')+1):
+    letter = chr(ascii)
+    onkey(functools.partial(guess, letter), letter)    
+listen()
+done()
\ No newline at end of file

From ce73415be2e5d469934a26f22cb127796eb5c5ea Mon Sep 17 00:00:00 2001
From: hanwooseok1 <44044200+hanwooseok1@users.noreply.github.com>
Date: Tue, 27 Dec 2022 12:54:20 +0900
Subject: [PATCH 33/77] typing game code (#92)

* typing game
* add docs for typing.py.
---
 docs/typing.rst     |  6 +++
 freegames/typing.py | 97 +++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 103 insertions(+)
 create mode 100644 docs/typing.rst
 create mode 100644 freegames/typing.py

diff --git a/docs/typing.rst b/docs/typing.rst
new file mode 100644
index 00000000..e7c5eb26
--- /dev/null
+++ b/docs/typing.rst
@@ -0,0 +1,6 @@
+Typing
+=====
+
+Typing, simple typing game.
+
+.. literalinclude:: ../freegames/typing.py
diff --git a/freegames/typing.py b/freegames/typing.py
new file mode 100644
index 00000000..b7496b6b
--- /dev/null
+++ b/freegames/typing.py
@@ -0,0 +1,97 @@
+""" Typing, typing game to remove the same letters.
+
+Exercises
+
+1. Change the speed of letters.
+2. Change letters to simple words.
+3. Add bonus words.
+
+"""
+from random import *
+from turtle import *
+from string import ascii_lowercase
+from freegames import vector
+
+targets = []
+letters = []
+score = 0
+
+def inside(xy):
+    """Return True if xy within screen."""
+    return -200 < xy.x < 200 and -200 < xy.y < 200
+
+def draw():
+    """Draw letters."""
+    clear()
+    count = 0
+    for target in targets:
+        goto(target.x, target.y)
+        write(letters[count], align='center', font=('Consolas', 20, 'normal'))
+        count += 1
+    update()
+
+def move():
+    """Move letters."""
+    if randrange(10) == 0:
+        x = randrange(-150, 150)
+        target = vector(x, 200)
+        targets.append(target)
+        while True:
+            letter = choice(ascii_lowercase)
+            if letter not in letters:
+                letters.append(letter)
+                break
+    for target in targets:
+        target.y -= 5
+    draw()
+    for target in targets:
+        if not inside(target):
+            return
+    ontimer(move, 100)
+
+def press(c):
+    """Press key."""
+    global score
+    if c in letters:
+        score += 1
+        k = letters.index(c)
+        del targets[k]
+        del letters[k]
+        print('score:', score)
+    else:
+        score -= 1
+        print('score:', score)
+
+setup(420, 420, 370, 0)
+hideturtle()
+up()
+tracer(False)
+listen()
+onkey(lambda: press('a'), 'a')
+onkey(lambda: press('b'), 'b')
+onkey(lambda: press('c'), 'c')
+onkey(lambda: press('d'), 'd')
+onkey(lambda: press('e'), 'e')
+onkey(lambda: press('f'), 'f')
+onkey(lambda: press('g'), 'g')
+onkey(lambda: press('h'), 'h')
+onkey(lambda: press('i'), 'i')
+onkey(lambda: press('j'), 'j')
+onkey(lambda: press('k'), 'k')
+onkey(lambda: press('l'), 'l')
+onkey(lambda: press('m'), 'm')
+onkey(lambda: press('n'), 'n')
+onkey(lambda: press('o'), 'o')
+onkey(lambda: press('p'), 'p')
+onkey(lambda: press('q'), 'q')
+onkey(lambda: press('r'), 'r')
+onkey(lambda: press('s'), 's')
+onkey(lambda: press('t'), 't')
+onkey(lambda: press('u'), 'u')
+onkey(lambda: press('v'), 'v')
+onkey(lambda: press('w'), 'w')
+onkey(lambda: press('x'), 'x')
+onkey(lambda: press('y'), 'y')
+onkey(lambda: press('z'), 'z')
+move()
+done()
\ No newline at end of file

From b13ca795a0abd1b4df93e3a9951fb7ed1c63f5c0 Mon Sep 17 00:00:00 2001
From: SongJungHyun1004 <44044105+SongJungHyun1004@users.noreply.github.com>
Date: Tue, 27 Dec 2022 12:55:59 +0900
Subject: [PATCH 34/77] Add Avoid game (#93)

* add avoid.py game
* Condensing four lists to a single list & modifying some codes
* add rst file to docs
---
 docs/avoid.rst     |  6 +++
 freegames/avoid.py | 99 ++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 105 insertions(+)
 create mode 100644 docs/avoid.rst
 create mode 100644 freegames/avoid.py

diff --git a/docs/avoid.rst b/docs/avoid.rst
new file mode 100644
index 00000000..de259a1d
--- /dev/null
+++ b/docs/avoid.rst
@@ -0,0 +1,6 @@
+Avoid
+======
+
+Avoid, classic arcade game.
+
+.. literalinclude:: ../freegames/avoid.py
diff --git a/freegames/avoid.py b/freegames/avoid.py
new file mode 100644
index 00000000..ab1bc9aa
--- /dev/null
+++ b/freegames/avoid.py
@@ -0,0 +1,99 @@
+"""Avoid, classic arcade game.
+
+Exercises
+
+1. Check the time you've lived.
+2. Vary the person's speed & bomb's speed.
+3. Vary the size of the bombs.
+4. Vary the person's color & bomb's color.
+"""
+from random import *
+from turtle import *
+import time
+from freegames import vector
+
+person = vector(0, 0)
+bombs = []
+speeds = []
+aim = vector(0, 0)
+start = time.time()
+
+def change(x, y):
+    """Change person direction."""
+    aim.x = x
+    aim.y = y
+
+def inside(point):
+    """Return True if point on screen."""
+    return -200 < point.x < 200 and -200 < point.y < 200
+
+def draw(alive):
+    """Draw screen objects."""
+    clear()
+    goto(person.x, person.y)
+    if alive:
+        dot(10, 'blue')
+    else:
+        dot(10, 'red')
+    for bomb in bombs:
+        goto(bomb.x, bomb.y)
+        dot(20, 'black')
+
+    present = time.time()
+    print('\rtime : %.3f' %float(present-start), end='sec')
+    update()
+
+def move():
+    """Update object positions."""
+    person.move(aim)
+
+    for bomb, speed in zip(bombs, speeds):
+        bomb.move(speed)
+
+    if randrange(10) == 0:
+        x = randrange(-199, 199)
+        y = randrange(-199, 199)
+        dir = randrange(4)
+        s = randrange(3, 11)
+        if dir == 0:
+            bomb = vector(x, 199)
+            speed = vector(0, -s)
+        elif dir == 1:
+            bomb = vector(x, -199)
+            speed = vector(0, s)
+        elif dir == 2:
+            bomb = vector(199, y)
+            speed = vector(-s, 0)
+        else:
+            bomb = vector(-199, y)
+            speed = vector(s, 0)
+        bombs.append(bomb)
+        speeds.append(speed)
+
+    while len(bombs) > 0 and not inside(bombs[0]):
+        bombs.pop(0)
+        speeds.pop(0)
+
+    if not inside(person):
+        draw(False)
+        return
+
+    for bomb in bombs:
+        if abs(bomb - person) < 15:
+            draw(False)
+            return
+
+    draw(True)
+    ontimer(move, 50)
+
+setup(420, 420, 370, 0)
+hideturtle()
+up()
+tracer(False)
+listen()
+onkey(lambda: change(5, 0), 'Right')
+onkey(lambda: change(-5, 0), 'Left')
+onkey(lambda: change(0, 5), 'Up')
+onkey(lambda: change(0, -5), 'Down')
+move()
+done()
\ No newline at end of file

From 27803c0eee055b964cfb4f90ca896a96bf109066 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Sat, 5 Nov 2022 21:17:30 -0700
Subject: [PATCH 35/77] Add link to youtube video

---
 docs/give-gift-python.rst | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/docs/give-gift-python.rst b/docs/give-gift-python.rst
index 3b1512fc..69a2246f 100644
--- a/docs/give-gift-python.rst
+++ b/docs/give-gift-python.rst
@@ -1,7 +1,10 @@
 Give the Gift of Python
 =======================
 
-*Talk given at SF Python Holiday Party on December 5, 2018.*
+* `Give the Gift of Python Video`_
+* Talk given at SF Python Holiday Party on December 5, 2018.
+
+.. _`Give the Gift of Python Video`: https://www.youtube.com/watch?v=BVI78g4V4so
 
 Who am I?
 ---------

From 06a07b85e0208b1adefee30f91368844f868c02e Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Mon, 26 Dec 2022 23:59:17 -0800
Subject: [PATCH 36/77] Update rock, paper, scissors to use different
 strategies

---
 freegames/rock_paper_scissors.py | 74 -------------------------
 freegames/rps.py                 | 92 ++++++++++++++++++++++++++++++++
 2 files changed, 92 insertions(+), 74 deletions(-)
 delete mode 100644 freegames/rock_paper_scissors.py
 create mode 100644 freegames/rps.py

diff --git a/freegames/rock_paper_scissors.py b/freegames/rock_paper_scissors.py
deleted file mode 100644
index a7e50a8e..00000000
--- a/freegames/rock_paper_scissors.py
+++ /dev/null
@@ -1,74 +0,0 @@
-import random  
-import os 
-
-WIN_LIST_RPS = [('ROCK', 'SCISSORS'),
-                ('SCISSORS', 'PAPER'),  
-                ('PAPER', 'ROCK')]  
-
-SELECTIONS_LIST_RPS = ['ROCK', 'PAPER', 'SCISSORS']
-
-stats_count = {'player':0, 'computer':0, 'ties':0}
-
-def clrscr():
-  if os.name == "posix":  
-    os.system('clear')
-  elif os.name in ("nt", "dos", "ce"): 
-    os.system('CLS')
-
-    
-def lets_play():
-  """ A function that sets which game is going to be played based on the option selected """
-  clrscr()
-  
-  intro = (" Welcome to Rock + Paper + Scissors game!")  
-  option_help = ("\n This game is simple and goes as following:"  
-          "\n *You can choose between: Rock, Paper or Scissors."
-          "\n\n You must take in consideration that:"
-          "\n *Rock crushers Scissors."
-          "\n *Scissors cut Paper."
-          "\n *Paper covers Rock."
-          "\n\n Notes: *The first one that scores 5 points WINS the game!")
-  selections_list = SELECTIONS_LIST_RPS 
-  win_list = WIN_LIST_RPS  
-  print(intro)
-  print(option_help)  
-    
-  while True:
-    player_selection = input("Your Selection {}: ".format(selections_list))
-    player_selection = player_selection.upper()
-    
-    if player_selection in selections_list:
-      clrscr()
-      computer_selection = random.choice(selections_list)
-      
-      print("Player Selection: {}".format(player_selection))
-      print("Computer Selection: {}".format(computer_selection))
-      
-      match = player_selection, computer_selection 
-      
-      if player_selection == computer_selection:
-        stats_count['ties'] += 1
-        print("\nResult: Both are {}! So that's a Tie!".format(player_selection))
-      elif match in win_list:
-        stats_count['player'] += 1
-        print("\nResult: The power of {} beats {}! You won!".format(player_selection, computer_selection))
-      else: 
-        stats_count['computer'] += 1
-        print("\nResult: The power of {} is stronger than {}! You lost!".format(computer_selection, player_selection))
-      print("-------  STATS  -------"
-            "\n YOU  | COMPUTER | DRAW"
-            "\n  {player}        {computer}        {ties}"
-            "\n-----------------------".format(**stats_count))
-      if stats_count['player'] == 5:
-        print("The game is DONE! You won! Congratulations!")
-        exit()
-      elif stats_count['computer'] == 5:
-        print("The game is DONE! You lost against a perfectly designed AI! You're now in the wall of shame!")
-        exit()
-    elif player_selection == 'HELP':
-      clrscr()
-      print(option_help)
-    else:
-      print("Invalid selection. Try again...") 
-      
-lets_play()
diff --git a/freegames/rps.py b/freegames/rps.py
new file mode 100644
index 00000000..bb1dc650
--- /dev/null
+++ b/freegames/rps.py
@@ -0,0 +1,92 @@
+"""Rock, Paper, Scissors
+
+The game is played in a series as follows:
+
+1. Player chooses "r" for rock, "p" for paper, or "s" for scissors.
+2. The computer will also choose rock, paper, or scissors.
+3. The result will either be a win, loss, or tie:
+   a. Rock crushes scissors.
+   b. Scissors cuts paper.
+   c. Paper covers rock.
+
+First to score 5 points wins the series!
+
+Exercises:
+
+1. Create a strategy to rotate through 'r', 'p', and 's' in a cycle.
+2. Create a strategy to do the same as the last computer choice.
+3. Create a new strategy of your own.
+"""
+
+import random
+
+beats = {'r': 's', 'p': 'r', 's': 'p'}
+loses = {value: key for key, value in beats.items()}
+state = {'player': 0, 'computer': 0, 'ties': 0}
+guesses = []
+default = random.choice('rps')
+
+
+def always_same():
+    return default
+
+
+def random_strategy():
+    return random.choice('rps')
+
+
+def beat_last():
+    if not guesses:
+        return default
+    last, _ = guesses[-1]
+    return loses[last]
+
+
+strategies = [always_same, random_strategy, beat_last]
+strategy = random.choice(strategies)
+
+
+def get_option():
+    while True:
+        choice = input('Enter "r" for rock, "p" for paper, "s" for scissors: ')
+        if choice not in beats:
+            print('Invalid choice.')
+            continue
+        return choice
+
+
+print(__doc__)
+
+while True:
+    player = get_option()
+    computer = strategy()
+    guess = (player, computer)
+    guesses.append(guess)
+
+    print('Player chooses:', player)
+    print('Computer chooses:', computer)
+
+    if player == computer:
+        state['ties'] += 1
+        print('Tie!')
+    elif beats[player] == computer:
+        state['player'] += 1
+        print('Player wins!')
+    else:
+        state['computer'] += 1
+        print('Computer wins!')
+
+    print()
+    print('Player points:', state['player'])
+    print('Computer points:', state['computer'])
+    print()
+
+    if state['player'] == 5:
+        print('PLAYER WINS!')
+        break
+
+    if state['computer'] == 5:
+        print('COMPUTER WINS!')
+        break
+
+print('Computer strategy:', strategy.__name__)

From e882097c2de0d22e35ab300afceddc1714fa1adc Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 00:10:43 -0800
Subject: [PATCH 37/77] Simplify illusion

---
 freegames/illusion.py | 62 +++++++++++++++++--------------------------
 1 file changed, 25 insertions(+), 37 deletions(-)

diff --git a/freegames/illusion.py b/freegames/illusion.py
index 1e283a2e..1054015c 100644
--- a/freegames/illusion.py
+++ b/freegames/illusion.py
@@ -1,54 +1,42 @@
-"""Illusion, just create a small illusion.
+"""Illusion
 
-Exercises :
+Exercises:
 
-1. Change the number of line.
-2. Change the size of the line or the square
+1. Change the size of the squares.
+2. Change the number of rows and lines.
 """
 
 from turtle import *
-
+from itertools import cycle
 from freegames import line, square
 
-square_size = 25
+size = 25
 
 
-def draw_one_line_square(start_x, start_y):
+def draw_row(x, y):
     for i in range(0, 10):
-        place_x = start_x + (i * square_size * 2)
-        square(place_x, start_y, square_size, 'black')
-
-
-def draw_all_lines():
-    base_x = -200
-    base_y = 150
-    for i in range(0, 11):
-        line(
-            base_x,
-            base_y - i * square_size,
-            base_x + 16 * square_size,
-            base_y - i * square_size,
-        )
-
-
-def draw_all_square():
-    draw_one_line_square(-200, 150)
-    draw_one_line_square(-190, 125)
-    draw_one_line_square(-180, 100)
-    draw_one_line_square(-190, 75)
-    draw_one_line_square(-200, 50)
-    draw_one_line_square(-190, 25)
-    draw_one_line_square(-180, 0)
-    draw_one_line_square(-190, -25)
-    draw_one_line_square(-200, -50)
-    draw_one_line_square(-190, -75)
-    draw_one_line_square(-180, -100)
+        offset = x + (i * size * 2)
+        square(offset, y, size, 'black')
+
+
+def draw_rows():
+    offsets = [-200, -190, -180, -190]
+    pairs = zip(cycle(offsets), range(150, -176, -25))
+    for offset, y in pairs:
+        draw_row(offset, y)
+
+
+def draw_lines():
+    x = -200
+    y = 150
+    for i in range(0, 14):
+        line(x, y - i * size, x + 16 * size, y - i * size)
 
 
 setup(420, 400, 30, 0)
 hideturtle()
 tracer(False)
 listen()
-draw_all_lines()
-draw_all_square()
+draw_rows()
+draw_lines()
 done()

From 4ab7f7df25426b1c77b5376a9058aeb9aab5a6cd Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 15:11:57 -0800
Subject: [PATCH 38/77] Add vector.set and refactor/simplify game

---
 freegames/avoid.py | 90 ++++++++++++++++++++++------------------------
 freegames/utils.py | 13 +++++++
 2 files changed, 55 insertions(+), 48 deletions(-)

diff --git a/freegames/avoid.py b/freegames/avoid.py
index ab1bc9aa..ec96b5f0 100644
--- a/freegames/avoid.py
+++ b/freegames/avoid.py
@@ -2,98 +2,92 @@
 
 Exercises
 
-1. Check the time you've lived.
-2. Vary the person's speed & bomb's speed.
-3. Vary the size of the bombs.
-4. Vary the person's color & bomb's color.
+1. Display the duration of the game.
+2. Vary the size of the bombs.
+3. Vary the speed of the bombs.
 """
+
 from random import *
 from turtle import *
-import time
 from freegames import vector
 
-person = vector(0, 0)
+north, south = vector(0, 4), vector(0, -4)
+east, west = vector(4, 0), vector(-4, 0)
+options = north, south, east, west
+
+player = vector(0, 0)
+aim = choice(options).copy()
 bombs = []
 speeds = []
-aim = vector(0, 0)
-start = time.time()
 
-def change(x, y):
-    """Change person direction."""
-    aim.x = x
-    aim.y = y
 
 def inside(point):
     """Return True if point on screen."""
     return -200 < point.x < 200 and -200 < point.y < 200
 
+
 def draw(alive):
     """Draw screen objects."""
     clear()
-    goto(person.x, person.y)
-    if alive:
-        dot(10, 'blue')
-    else:
-        dot(10, 'red')
+    goto(player.x, player.y)
+    color = 'blue' if alive else 'red'
+    dot(10, color)
     for bomb in bombs:
         goto(bomb.x, bomb.y)
         dot(20, 'black')
-
-    present = time.time()
-    print('\rtime : %.3f' %float(present-start), end='sec')
     update()
 
+
 def move():
-    """Update object positions."""
-    person.move(aim)
+    """Update player and bomb positions."""
+    player.move(aim)
 
     for bomb, speed in zip(bombs, speeds):
         bomb.move(speed)
 
     if randrange(10) == 0:
-        x = randrange(-199, 199)
-        y = randrange(-199, 199)
-        dir = randrange(4)
-        s = randrange(3, 11)
-        if dir == 0:
-            bomb = vector(x, 199)
-            speed = vector(0, -s)
-        elif dir == 1:
-            bomb = vector(x, -199)
-            speed = vector(0, s)
-        elif dir == 2:
-            bomb = vector(199, y)
-            speed = vector(-s, 0)
-        else:
-            bomb = vector(-199, y)
-            speed = vector(s, 0)
+        speed = choice(options).copy()
+        offset = randrange(-199, 200)
+
+        if speed == north:
+            bomb = vector(offset, -199)
+        if speed == south:
+            bomb = vector(offset, 199)
+        if speed == east:
+            bomb = vector(-199, offset)
+        if speed == west:
+            bomb = vector(199, offset)
+
         bombs.append(bomb)
         speeds.append(speed)
 
-    while len(bombs) > 0 and not inside(bombs[0]):
-        bombs.pop(0)
-        speeds.pop(0)
+    for index in reversed(range(len(bombs))):
+        bomb = bombs[index]
+        if not inside(bomb):
+            del bombs[index]
+            del speeds[index]
 
-    if not inside(person):
+    if not inside(player):
         draw(False)
         return
 
     for bomb in bombs:
-        if abs(bomb - person) < 15:
+        if abs(bomb - player) < 15:
             draw(False)
             return
 
     draw(True)
     ontimer(move, 50)
 
+
 setup(420, 420, 370, 0)
 hideturtle()
 up()
 tracer(False)
 listen()
-onkey(lambda: change(5, 0), 'Right')
-onkey(lambda: change(-5, 0), 'Left')
-onkey(lambda: change(0, 5), 'Up')
-onkey(lambda: change(0, -5), 'Down')
+onkey(lambda: aim.set(north), 'Up')
+onkey(lambda: aim.set(south), 'Down')
+onkey(lambda: aim.set(east), 'Right')
+onkey(lambda: aim.set(west), 'Left')
 move()
-done()
\ No newline at end of file
+done()
diff --git a/freegames/utils.py b/freegames/utils.py
index 30f63292..ce9a56e0 100644
--- a/freegames/utils.py
+++ b/freegames/utils.py
@@ -165,6 +165,19 @@ def __hash__(self):
             self._hash = hash(pair)
         return self._hash
 
+    def set(self, other):
+        """Set vector x, y to other x, y.
+
+        >>> a = vector(0, 0)
+        >>> b = vector(1, 2)
+        >>> a.set(b)
+        >>> a
+        vector(1, 2)
+
+        """
+        self.x = other.x
+        self.y = other.y
+
     def __len__(self):
         """v.__len__() -> len(v)
 

From 873dc2a46a4dcc719b087180c13eab337ea156eb Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 16:16:28 -0800
Subject: [PATCH 39/77] Refactor typing and tune speed

---
 freegames/typing.py | 90 +++++++++++++++++++--------------------------
 1 file changed, 37 insertions(+), 53 deletions(-)

diff --git a/freegames/typing.py b/freegames/typing.py
index b7496b6b..fe85d87f 100644
--- a/freegames/typing.py
+++ b/freegames/typing.py
@@ -1,14 +1,15 @@
-""" Typing, typing game to remove the same letters.
+"""Game to practice typing.
 
 Exercises
 
 1. Change the speed of letters.
-2. Change letters to simple words.
-3. Add bonus words.
-
+2. Add uppercase letters.
+3. Make the game faster as the score gets higher.
+4. Make the letters more frequent as the score gets higher.
 """
-from random import *
+
 from turtle import *
+from random import choice, randrange
 from string import ascii_lowercase
 from freegames import vector
 
@@ -16,82 +17,65 @@
 letters = []
 score = 0
 
-def inside(xy):
-    """Return True if xy within screen."""
-    return -200 < xy.x < 200 and -200 < xy.y < 200
+
+def inside(point):
+    """Return True if point on screen."""
+    return -200 < point.x < 200 and -200 < point.y < 200
+
 
 def draw():
     """Draw letters."""
     clear()
-    count = 0
-    for target in targets:
+
+    for target, letter in zip(targets, letters):
         goto(target.x, target.y)
-        write(letters[count], align='center', font=('Consolas', 20, 'normal'))
-        count += 1
+        write(letter, align='center', font=('Consolas', 20, 'normal'))
+
     update()
 
+
 def move():
     """Move letters."""
-    if randrange(10) == 0:
+    if randrange(20) == 0:
         x = randrange(-150, 150)
         target = vector(x, 200)
         targets.append(target)
-        while True:
-            letter = choice(ascii_lowercase)
-            if letter not in letters:
-                letters.append(letter)
-                break
+        letter = choice(ascii_lowercase)
+        letters.append(letter)
+
     for target in targets:
-        target.y -= 5
+        target.y -= 1
+
     draw()
+
     for target in targets:
         if not inside(target):
             return
+
     ontimer(move, 100)
 
-def press(c):
+
+def press(key):
     """Press key."""
     global score
-    if c in letters:
+
+    if key in letters:
         score += 1
-        k = letters.index(c)
-        del targets[k]
-        del letters[k]
-        print('score:', score)
+        pos = letters.index(key)
+        del targets[pos]
+        del letters[pos]
     else:
         score -= 1
-        print('score:', score)
+
+    print('Score:', score)
+
 
 setup(420, 420, 370, 0)
 hideturtle()
 up()
 tracer(False)
 listen()
-onkey(lambda: press('a'), 'a')
-onkey(lambda: press('b'), 'b')
-onkey(lambda: press('c'), 'c')
-onkey(lambda: press('d'), 'd')
-onkey(lambda: press('e'), 'e')
-onkey(lambda: press('f'), 'f')
-onkey(lambda: press('g'), 'g')
-onkey(lambda: press('h'), 'h')
-onkey(lambda: press('i'), 'i')
-onkey(lambda: press('j'), 'j')
-onkey(lambda: press('k'), 'k')
-onkey(lambda: press('l'), 'l')
-onkey(lambda: press('m'), 'm')
-onkey(lambda: press('n'), 'n')
-onkey(lambda: press('o'), 'o')
-onkey(lambda: press('p'), 'p')
-onkey(lambda: press('q'), 'q')
-onkey(lambda: press('r'), 'r')
-onkey(lambda: press('s'), 's')
-onkey(lambda: press('t'), 't')
-onkey(lambda: press('u'), 'u')
-onkey(lambda: press('v'), 'v')
-onkey(lambda: press('w'), 'w')
-onkey(lambda: press('x'), 'x')
-onkey(lambda: press('y'), 'y')
-onkey(lambda: press('z'), 'z')
+for letter in ascii_lowercase:
+    onkey(lambda letter=letter: press(letter), letter)
 move()
-done()
\ No newline at end of file
+done()

From 4dad2845175aaca6124a94e8d7a059202cbe32c0 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 16:37:49 -0800
Subject: [PATCH 40/77] Game is problematic

---
 freegames/hangman.py | 112 -------------------------------------------
 1 file changed, 112 deletions(-)
 delete mode 100644 freegames/hangman.py

diff --git a/freegames/hangman.py b/freegames/hangman.py
deleted file mode 100644
index 9839d79c..00000000
--- a/freegames/hangman.py
+++ /dev/null
@@ -1,112 +0,0 @@
-"""Hangman, a letter guessing game
-
-Exercises
-1. Change Hangman's picture (position, length, etc)
-2. Make an additional dictionary, not fruits
-3. Convert lowercase letters to uppercase letters
-"""
-
-from turtle import *
-from random import choice
-import functools
-
-def screen_write(letter):
-    """write text on the screen"""
-    write(letter, move=True, font=("Courier", 14, "normal"))
-
-def move_write(x, y, letter):
-    """After move, write text on the screen"""
-    goto(x, y)
-    screen_write(letter)
-
-
-def draw(x, y, angle, length, straight):
-    """draw a hangman game"""
-    goto(x, y)
-    pendown()
-    left(angle)
-    if straight:
-        forward(length)
-    else:
-        circle(length, None, 100)
-    penup()
-
-def draw_Hangman(step):
-    if step == 1: 
-        # draw head
-        draw(-45, 160, 270, 15, False)
-    elif step == 2:
-        # draw torso
-        draw(-45, 130, 90, 40, True)
-    elif step == 3:
-        # draw left arm
-        draw(-45, 120, 235, 40, True)
-    elif step == 4:
-        # draw right arm
-        draw(-45, 120, 250, 40, True)
-    elif step == 5:
-        # draw left leg
-        draw(-45, 90, 205, 40, True)
-    elif step == 6:
-        # draw right leg
-        draw(-45, 90, 60, 40, True)
-
-def guess(letter):
-    global correct
-    global use
-    global wrong
-    global finish
-    if not finish:
-        if letter not in use:
-            goto(-100,-35)
-            for i in word:
-                if i == letter:
-                    screen_write(letter.lower() + " ")
-                    correct += letter
-                else:
-                     screen_write("_ ") 
-            use += letter 
-            if letter not in word:
-                wrong += 1
-                draw_Hangman(wrong)
-            move_write(-200, -100, "Guesses: ")
-            for i in use:
-                screen_write(i.lower() + " ")
-        if wrong == 6:
-            goto(-100,-35)
-            for i in word:
-                if i in correct:
-                    screen_write("_ ")
-                else:
-                    screen_write(i.lower() + " ")
-            move_write(-130, -60, "Sorry, you lose!")
-            finish = True
-        if len(correct) == len(word):
-            move_write(-130, -60, "Congratulations, you win!")
-            finish = True
-
-hideturtle()
-speed(0)
-
-fruitword = ['apple', 'banana', 'blueberry', 'cherry', 'coconut', 'durian', 'grape', 'kiwi', 'lemon',
-            'lime', 'mango', 'melon', 'orange', 'peach', 'pear', 'pineapple', 'strawberry','watermelon']
-
-"""draw gallows"""
-penup()
-draw(50, 0, 90, 175, True)
-draw(50, 175, 90, 95, True)
-draw(-45, 175, 90, 15, True)
-
-goto(-100,-35)
-word = choice(fruitword)
-correct = []
-use = []
-wrong = 0
-finish = False
-for i in word:
-    screen_write("_ ")
-for ascii in range(ord('a'), ord('z')+1):
-    letter = chr(ascii)
-    onkey(functools.partial(guess, letter), letter)    
-listen()
-done()
\ No newline at end of file

From 673c1fdbde4bdbae753faa0ecc3861e4c5f4f0ef Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 16:41:13 -0800
Subject: [PATCH 41/77] i sort it

---
 freegames/avoid.py    | 1 +
 freegames/illusion.py | 3 ++-
 freegames/typing.py   | 3 ++-
 3 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/freegames/avoid.py b/freegames/avoid.py
index ec96b5f0..4c33933a 100644
--- a/freegames/avoid.py
+++ b/freegames/avoid.py
@@ -9,6 +9,7 @@
 
 from random import *
 from turtle import *
+
 from freegames import vector
 
 north, south = vector(0, 4), vector(0, -4)
diff --git a/freegames/illusion.py b/freegames/illusion.py
index 1054015c..a102d5ac 100644
--- a/freegames/illusion.py
+++ b/freegames/illusion.py
@@ -6,8 +6,9 @@
 2. Change the number of rows and lines.
 """
 
-from turtle import *
 from itertools import cycle
+from turtle import *
+
 from freegames import line, square
 
 size = 25
diff --git a/freegames/typing.py b/freegames/typing.py
index fe85d87f..cb40098c 100644
--- a/freegames/typing.py
+++ b/freegames/typing.py
@@ -8,9 +8,10 @@
 4. Make the letters more frequent as the score gets higher.
 """
 
-from turtle import *
 from random import choice, randrange
 from string import ascii_lowercase
+from turtle import *
+
 from freegames import vector
 
 targets = []

From 427f8a149125478b0847b9fd14607ab13203c19e Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 16:42:28 -0800
Subject: [PATCH 42/77] doc8 fixes

---
 docs/hangman.rst | 6 ------
 docs/typing.rst  | 2 +-
 2 files changed, 1 insertion(+), 7 deletions(-)
 delete mode 100644 docs/hangman.rst

diff --git a/docs/hangman.rst b/docs/hangman.rst
deleted file mode 100644
index b017049d..00000000
--- a/docs/hangman.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-Hangman
-====
-
-Hangman, a letter guessing game.
-
-.. literalinclude:: ../freegames/hangman.py
\ No newline at end of file
diff --git a/docs/typing.rst b/docs/typing.rst
index e7c5eb26..e7a3597e 100644
--- a/docs/typing.rst
+++ b/docs/typing.rst
@@ -1,5 +1,5 @@
 Typing
-=====
+======
 
 Typing, simple typing game.
 

From 24d5e962b478d9ba4e5ac1bfd63dee6419c29009 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 17:01:08 -0800
Subject: [PATCH 43/77] Add tests for typing game

---
 tests/test_typing.py | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)
 create mode 100644 tests/test_typing.py

diff --git a/tests/test_typing.py b/tests/test_typing.py
new file mode 100644
index 00000000..23ba07e6
--- /dev/null
+++ b/tests/test_typing.py
@@ -0,0 +1,18 @@
+import random
+import runpy
+import sys
+
+import mockturtle
+
+sys.modules['turtle'] = sys.modules['mockturtle']
+
+
+def test_typing():
+    random.seed(0)
+    mockturtle.events.clear()
+    mockturtle.events += [('timer',)] * 100
+    mockturtle.events += [('key i',)]
+    mockturtle.events += [('timer',)] * 100
+    mockturtle.events += [('key k',)]
+    mockturtle.events += [('timer', True)] * 1000
+    runpy.run_module('freegames.typing')

From f3953c712bcf9015368985c4ead04f5fae131dfe Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 17:01:25 -0800
Subject: [PATCH 44/77] Add tests for optical illusion

---
 tests/test_illusion.py | 14 ++++++++++++++
 1 file changed, 14 insertions(+)
 create mode 100644 tests/test_illusion.py

diff --git a/tests/test_illusion.py b/tests/test_illusion.py
new file mode 100644
index 00000000..6a0fad11
--- /dev/null
+++ b/tests/test_illusion.py
@@ -0,0 +1,14 @@
+import random
+import runpy
+import sys
+
+import mockturtle
+
+sys.modules['turtle'] = sys.modules['mockturtle']
+
+
+def test_illusion():
+    random.seed(0)
+    mockturtle.events.clear()
+    mockturtle.events += [('timer', True)] * 10
+    runpy.run_module('freegames.illusion')

From 8ee9ad94b7f6c600bd2a1f8fab6483c93641dc9d Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 17:01:56 -0800
Subject: [PATCH 45/77] Accept `align` param to turtle.write

---
 tests/mockturtle.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/mockturtle.py b/tests/mockturtle.py
index 26e5d52b..8a26ac3c 100644
--- a/tests/mockturtle.py
+++ b/tests/mockturtle.py
@@ -24,7 +24,7 @@ def width(self, size):
     def color(self, fill, outline=None):
         pass
 
-    def write(self, text, font=None):
+    def write(self, text, font=None, align=None):
         pass
 
     def begin_fill(self):

From b5f1268468526a3d14e96a878916dfa5b3629e1f Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 17:15:02 -0800
Subject: [PATCH 46/77] Move exercises to comments

---
 freegames/rps.py | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/freegames/rps.py b/freegames/rps.py
index bb1dc650..24b32bfe 100644
--- a/freegames/rps.py
+++ b/freegames/rps.py
@@ -10,13 +10,12 @@
    c. Paper covers rock.
 
 First to score 5 points wins the series!
-
-Exercises:
-
-1. Create a strategy to rotate through 'r', 'p', and 's' in a cycle.
-2. Create a strategy to do the same as the last computer choice.
-3. Create a new strategy of your own.
 """
+# Exercises:
+#
+# 1. Create a strategy to rotate through 'r', 'p', and 's' in a cycle.
+# 2. Create a strategy to do the same as the last computer choice.
+# 3. Create a new strategy of your own.
 
 import random
 

From 6f2def0b2ae84dc69256297c3577d9d600eec227 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 17:15:17 -0800
Subject: [PATCH 47/77] Add tests for rock, paper, scissors

---
 tests/test_rps.py | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)
 create mode 100644 tests/test_rps.py

diff --git a/tests/test_rps.py b/tests/test_rps.py
new file mode 100644
index 00000000..8afece14
--- /dev/null
+++ b/tests/test_rps.py
@@ -0,0 +1,33 @@
+import random
+import runpy
+import unittest.mock as mock
+
+
+def test_rps_same():
+    random.seed(0)
+    mock_input = mock.Mock()
+    mock_input.side_effect = list('xrpsrpsrpsrpsrpsrpsrpsrps')
+    mocks = {'print': lambda *args: None, 'input': mock_input}
+
+    with mock.patch.multiple('builtins', **mocks):
+        runpy.run_module('freegames.rps')
+
+
+def test_rps_beat_last():
+    random.seed(1)
+    mock_input = mock.Mock()
+    mock_input.side_effect = list('sprsprsprsprsprsprsprspr')
+    mocks = {'print': lambda *args: None, 'input': mock_input}
+
+    with mock.patch.multiple('builtins', **mocks):
+        runpy.run_module('freegames.rps')
+
+
+def test_rps_random():
+    random.seed(2)
+    mock_input = mock.Mock()
+    mock_input.side_effect = list('rpsrpsrpsrpsrpsrpsrpsrps')
+    mocks = {'print': lambda *args: None, 'input': mock_input}
+
+    with mock.patch.multiple('builtins', **mocks):
+        runpy.run_module('freegames.rps')

From 0f9a3a21efcca9266858dee2b20ca4b7db4c53c3 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 17:35:33 -0800
Subject: [PATCH 48/77] Add tests for "avoid" game

---
 tests/test_avoid.py | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)
 create mode 100644 tests/test_avoid.py

diff --git a/tests/test_avoid.py b/tests/test_avoid.py
new file mode 100644
index 00000000..d2dd6c54
--- /dev/null
+++ b/tests/test_avoid.py
@@ -0,0 +1,30 @@
+import random
+import runpy
+import sys
+
+import mockturtle
+
+sys.modules['turtle'] = sys.modules['mockturtle']
+
+
+def test_avoid_1():
+    random.seed(0)
+    mockturtle.events.clear()
+    mockturtle.events += [('timer',)] * 10
+    mockturtle.events += [('key Up',)]
+    mockturtle.events += [('timer',)] * 10
+    mockturtle.events += [('key Down',)]
+    mockturtle.events += [('timer', True)] * 1000
+    runpy.run_module('freegames.avoid')
+
+
+def test_avoid_2():
+    random.seed(0)
+    mockturtle.events.clear()
+    mockturtle.events += [
+        ('timer', True),
+        ('key Up',),
+        ('timer', True),
+        ('key Down',),
+    ] * 1000
+    runpy.run_module('freegames.avoid')

From f3737e1e1bc0f3661e3f7e549ecf6a7b25d0abae Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 17:39:03 -0800
Subject: [PATCH 49/77] Skip testing for Python 3.6 and 3.7

---
 tox.ini | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tox.ini b/tox.ini
index 5d835318..8c0beb36 100644
--- a/tox.ini
+++ b/tox.ini
@@ -1,5 +1,5 @@
 [tox]
-envlist=bluecheck,doc8,docs,flake8,isortcheck,rstcheck,py36,py37,py38,py39,py310
+envlist=bluecheck,doc8,docs,flake8,isortcheck,rstcheck,py38,py39,py310
 skip_missing_interpreters=True
 
 [testenv]

From ec577c5a9bc874cc52324f4c518dcbde411c0ff6 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 17:39:18 -0800
Subject: [PATCH 50/77] i blue it

---
 freegames/utils.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/freegames/utils.py b/freegames/utils.py
index ce9a56e0..e535aeff 100644
--- a/freegames/utils.py
+++ b/freegames/utils.py
@@ -454,7 +454,7 @@ def __abs__(self):
         5.0
 
         """
-        return (self.x ** 2 + self.y ** 2) ** 0.5
+        return (self.x**2 + self.y**2) ** 0.5
 
     def rotate(self, angle):
         """Rotate vector counter-clockwise by angle (in-place).

From 80af1ecc2944778ca2141b6904471fd86fba44ec Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 19:31:32 -0800
Subject: [PATCH 51/77] Include Python 3.7 and 3.11

---
 tox.ini | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tox.ini b/tox.ini
index 8c0beb36..a669ad0a 100644
--- a/tox.ini
+++ b/tox.ini
@@ -1,5 +1,5 @@
 [tox]
-envlist=bluecheck,doc8,docs,flake8,isortcheck,rstcheck,py38,py39,py310
+envlist=bluecheck,doc8,docs,flake8,isortcheck,rstcheck,py37,py38,py39,py310,py311
 skip_missing_interpreters=True
 
 [testenv]

From 8abccd0248b37365a89270572e9e926cfcce0ad2 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 19:31:49 -0800
Subject: [PATCH 52/77] Change --report to --report-level for rstcheck

---
 tox.ini | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tox.ini b/tox.ini
index a669ad0a..276e4d80 100644
--- a/tox.ini
+++ b/tox.ini
@@ -43,7 +43,7 @@ commands=isort --check {toxinidir}/setup.py {toxinidir}/freegames {toxinidir}/te
 deps=isort
 
 [testenv:rstcheck]
-commands=rstcheck --report warning {toxinidir}/README.rst
+commands=rstcheck --report-level warning {toxinidir}/README.rst
 deps=rstcheck
 
 [testenv:uploaddocs]

From 874bfd90560817174e484a8b98d224d8cc038e45 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 19:32:06 -0800
Subject: [PATCH 53/77] Add 3.11 for Python testing

---
 .github/workflows/integration.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/integration.yml b/.github/workflows/integration.yml
index 331eba3d..0f00038b 100644
--- a/.github/workflows/integration.yml
+++ b/.github/workflows/integration.yml
@@ -36,7 +36,7 @@ jobs:
       max-parallel: 5
       matrix:
         os: [ubuntu-latest]
-        python-version: [3.6, 3.7, 3.8, 3.9, '3.10']
+        python-version: [3.7, 3.8, 3.9, '3.10', 3.11]
     steps:
       - uses: actions/checkout@v2
       - uses: actions/setup-python@v2

From 2f901de9d478e5bd3162f28a8038fa30c76638f0 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 19:38:49 -0800
Subject: [PATCH 54/77] Re-arrange requirements and requirements-dev

---
 requirements-dev.txt | 14 ++++++++++++++
 requirements.txt     | 13 -------------
 2 files changed, 14 insertions(+), 13 deletions(-)
 create mode 100644 requirements-dev.txt

diff --git a/requirements-dev.txt b/requirements-dev.txt
new file mode 100644
index 00000000..7f3b5cfa
--- /dev/null
+++ b/requirements-dev.txt
@@ -0,0 +1,14 @@
+-r requirements.txt
+blue
+build
+coverage
+doc8
+flake8
+isort
+ipython
+pytest
+pytest-cov
+rstcheck
+sphinx
+tox
+twine
diff --git a/requirements.txt b/requirements.txt
index d845935a..d6e1198b 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,14 +1 @@
 -e .
-blue
-coverage
-doc8
-flake8
-isort
-pylint
-pytest
-pytest-cov
-rstcheck
-sphinx
-tox
-twine
-wheel

From 0794ff927321e2e99aeddf3657b7094f48c6f077 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 19:39:06 -0800
Subject: [PATCH 55/77] Add release workflow

---
 .github/workflows/release.yml | 34 ++++++++++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)
 create mode 100644 .github/workflows/release.yml

diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
new file mode 100644
index 00000000..20753098
--- /dev/null
+++ b/.github/workflows/release.yml
@@ -0,0 +1,34 @@
+name: release
+
+on:
+  push:
+    tags:
+      - v*
+
+jobs:
+
+  upload:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v2
+
+    - name: Set up Python
+      uses: actions/setup-python@v2
+      with:
+        python-version: 3.11
+
+    - name: Install dependencies
+      run: |
+        pip install --upgrade pip
+        pip install -r requirements-dev.txt
+
+    - name: Create dist
+      run: python -m build
+
+    - name: Upload with twine
+      env:
+        TWINE_USERNAME: __token__
+        TWINE_PASSWORD: ${{ secrets.PYPI_PASSWORD }}
+      run: |
+        twine upload dist/*

From b5582e0390824da7e3dc10422aa62bf341c62dd6 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 19:42:01 -0800
Subject: [PATCH 56/77] Bump copyright to 2023

---
 LICENSE               | 2 +-
 README.rst            | 2 +-
 freegames/__init__.py | 2 +-
 freegames/__main__.py | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/LICENSE b/LICENSE
index 1db7e981..38cce0a0 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1,4 +1,4 @@
-Copyright 2017-2022 Grant Jenks
+Copyright 2017-2023 Grant Jenks
 
 Licensed under the Apache License, Version 2.0 (the "License"); you may not use
 this file except in compliance with the License.  You may obtain a copy of the
diff --git a/README.rst b/README.rst
index 32d87e5c..15dba8cf 100644
--- a/README.rst
+++ b/README.rst
@@ -334,7 +334,7 @@ References
 Free Python Games License
 -------------------------
 
-Copyright 2017-2022 Grant Jenks
+Copyright 2017-2023 Grant Jenks
 
 Licensed under the Apache License, Version 2.0 (the "License"); you may not use
 this file except in compliance with the License.  You may obtain a copy of the
diff --git a/freegames/__init__.py b/freegames/__init__.py
index 93a04f93..d5fb8677 100644
--- a/freegames/__init__.py
+++ b/freegames/__init__.py
@@ -66,4 +66,4 @@
 __build__ = 0x020400
 __author__ = 'Grant Jenks'
 __license__ = 'Apache 2.0'
-__copyright__ = '2017-2022, Grant Jenks'
+__copyright__ = '2017-2023, Grant Jenks'
diff --git a/freegames/__main__.py b/freegames/__main__.py
index 3212a184..fee826a2 100644
--- a/freegames/__main__.py
+++ b/freegames/__main__.py
@@ -22,7 +22,7 @@ def game_file(name):
 parser = argparse.ArgumentParser(
     prog='freegames',
     description='Free Python Games',
-    epilog='Copyright 2022 Grant Jenks',
+    epilog='Copyright 2023 Grant Jenks',
 )
 subparsers = parser.add_subparsers(dest='command', help='sub-command help')
 

From f0a7d95ffab43afb3e3d54c2383262498c638bff Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 19:42:12 -0800
Subject: [PATCH 57/77] Bump version to 2.5.0

---
 freegames/__init__.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/freegames/__init__.py b/freegames/__init__.py
index d5fb8677..48914613 100644
--- a/freegames/__init__.py
+++ b/freegames/__init__.py
@@ -62,8 +62,7 @@
 __all__ = ['floor', 'line', 'path', 'square', 'vector']
 
 __title__ = 'freegames'
-__version__ = '2.4.0'
-__build__ = 0x020400
+__version__ = '2.5.0'
 __author__ = 'Grant Jenks'
 __license__ = 'Apache 2.0'
 __copyright__ = '2017-2023, Grant Jenks'

From 51d61c00dcaf8e6822df94a028fd355720c46df6 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 19:49:54 -0800
Subject: [PATCH 58/77] Add docs for illusion, minesweeper, and RPS

---
 docs/illusion.rst    | 6 ++++++
 docs/minesweeper.rst | 6 ++++++
 docs/rps.rst         | 6 ++++++
 3 files changed, 18 insertions(+)
 create mode 100644 docs/illusion.rst
 create mode 100644 docs/minesweeper.rst
 create mode 100644 docs/rps.rst

diff --git a/docs/illusion.rst b/docs/illusion.rst
new file mode 100644
index 00000000..6b750ab7
--- /dev/null
+++ b/docs/illusion.rst
@@ -0,0 +1,6 @@
+Illusion
+========
+
+An optical illusion.
+
+.. literalinclude:: ../freegames/illusion.py
diff --git a/docs/minesweeper.rst b/docs/minesweeper.rst
new file mode 100644
index 00000000..e8f26ee7
--- /dev/null
+++ b/docs/minesweeper.rst
@@ -0,0 +1,6 @@
+Minesweeper
+===========
+
+Minesweeper, a logic puzzle game to clear the hidden mines.
+
+.. literalinclude:: ../freegames/minesweeper.py
diff --git a/docs/rps.rst b/docs/rps.rst
new file mode 100644
index 00000000..6914660a
--- /dev/null
+++ b/docs/rps.rst
@@ -0,0 +1,6 @@
+Rock, Paper, Scissors
+=====================
+
+Rock, Paper, Scissors -- classic hand-to-hand combat game.
+
+.. literalinclude:: ../freegames/rps.py

From a5695853570aea417804927b860961fb18020608 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 20:04:47 -0800
Subject: [PATCH 59/77] Update links and add illusion/typing screenshots

---
 README.rst                |  94 +++++++++++++++++++++++---------------
 docs/_static/illusion.png | Bin 0 -> 5304 bytes
 docs/_static/typing.png   | Bin 0 -> 8466 bytes
 3 files changed, 57 insertions(+), 37 deletions(-)
 create mode 100644 docs/_static/illusion.png
 create mode 100644 docs/_static/typing.png

diff --git a/README.rst b/README.rst
index 15dba8cf..47a0b317 100644
--- a/README.rst
+++ b/README.rst
@@ -29,7 +29,7 @@ with a list of exercises to work through with students. Creativity and
 flexibility is important. There is no right or wrong way to implement a new
 feature or behavior! You never know which games students will engage with best.
 
-.. _`Free Python Games`: http://www.grantjenks.com/docs/freegames/
+.. _`Free Python Games`: https://grantjenks.com/docs/freegames/
 
 
 Testimonials
@@ -78,7 +78,7 @@ Features
 - Tested using GitHub Actions
 
 .. image:: https://github.com/grantjenks/free-python-games/workflows/integration/badge.svg
-   :target: http://www.grantjenks.com/docs/freegames/
+   :target: https://grantjenks.com/docs/freegames/
 
 
 Quickstart
@@ -134,10 +134,10 @@ Paint
 shape and click again to mark its end. Different shapes and colors can be
 selected using the keyboard.
 
-.. image:: http://www.grantjenks.com/docs/freegames/_static/paint.gif
+.. image:: https://grantjenks.com/docs/freegames/_static/paint.gif
    :alt: Paint Free Python Game
 
-.. _`Paint`: http://www.grantjenks.com/docs/freegames/paint.html
+.. _`Paint`: https://grantjenks.com/docs/freegames/paint.html
 
 Snake
 .....
@@ -146,10 +146,10 @@ Snake
 green food. Each time the food is consumed, the snake grows one segment
 longer. Avoid eating yourself or going out of bounds!
 
-.. image:: http://www.grantjenks.com/docs/freegames/_static/snake.gif
+.. image:: https://grantjenks.com/docs/freegames/_static/snake.gif
    :alt: Snake Free Python Game
 
-.. _`Snake`: http://www.grantjenks.com/docs/freegames/snake.html
+.. _`Snake`: https://grantjenks.com/docs/freegames/snake.html
 
 Pacman
 ......
@@ -157,10 +157,10 @@ Pacman
 `Pacman`_ -- classic arcade game. Use the arrow keys to navigate and eat all
 the white food. Watch out for red ghosts that roam the maze.
 
-.. image:: http://www.grantjenks.com/docs/freegames/_static/pacman.gif
+.. image:: https://grantjenks.com/docs/freegames/_static/pacman.gif
    :alt: Pacman Free Python Game
 
-.. _`Pacman`: http://www.grantjenks.com/docs/freegames/pacman.html
+.. _`Pacman`: https://grantjenks.com/docs/freegames/pacman.html
 
 Cannon
 ......
@@ -169,10 +169,10 @@ Cannon
 cannonball pops blue balloons in its path. Pop all the balloons before they can
 cross the screen.
 
-.. image:: http://www.grantjenks.com/docs/freegames/_static/cannon.gif
+.. image:: https://grantjenks.com/docs/freegames/_static/cannon.gif
    :alt: Cannon Free Python Game
 
-.. _`Cannon`: http://www.grantjenks.com/docs/freegames/cannon.html
+.. _`Cannon`: https://grantjenks.com/docs/freegames/cannon.html
 
 Connect
 .......
@@ -180,10 +180,10 @@ Connect
 `Connect`_ -- Connect 4 game. Click a row to drop a disc. The first player to
 connect four discs vertically, horizontally, or diagonally wins!
 
-.. image:: http://www.grantjenks.com/docs/freegames/_static/connect.gif
+.. image:: https://grantjenks.com/docs/freegames/_static/connect.gif
    :alt: Connect 4 Free Python Game
 
-.. _`Connect`: http://www.grantjenks.com/docs/freegames/connect.html
+.. _`Connect`: https://grantjenks.com/docs/freegames/connect.html
 
 Flappy
 ......
@@ -191,10 +191,10 @@ Flappy
 `Flappy`_ -- Flappy-bird inspired game. Click the screen to flap your
 wings. Watch out for black ravens as you fly across the screen.
 
-.. image:: http://www.grantjenks.com/docs/freegames/_static/flappy.gif
+.. image:: https://grantjenks.com/docs/freegames/_static/flappy.gif
    :alt: Flappy Bird Free Python Game
 
-.. _`Flappy`: http://www.grantjenks.com/docs/freegames/flappy.html
+.. _`Flappy`: https://grantjenks.com/docs/freegames/flappy.html
 
 Memory
 ......
@@ -202,10 +202,10 @@ Memory
 `Memory`_ -- puzzle game of number pairs. Click a tile to reveal a
 number. Match two numbers and the tiles will disappear to reveal an image.
 
-.. image:: http://www.grantjenks.com/docs/freegames/_static/memory.gif
+.. image:: https://grantjenks.com/docs/freegames/_static/memory.gif
    :alt: Memory Free Python Game
 
-.. _`Memory`: http://www.grantjenks.com/docs/freegames/memory.html
+.. _`Memory`: https://grantjenks.com/docs/freegames/memory.html
 
 Pong
 ....
@@ -213,10 +213,10 @@ Pong
 `Pong`_ -- classic arcade game. Use the keyboard to move your paddle up and
 down. The first player to miss the ball loses.
 
-.. image:: http://www.grantjenks.com/docs/freegames/_static/pong.gif
+.. image:: https://grantjenks.com/docs/freegames/_static/pong.gif
    :alt: Pong Free Python Game
 
-.. _`Pong`: http://www.grantjenks.com/docs/freegames/pong.html
+.. _`Pong`: https://grantjenks.com/docs/freegames/pong.html
 
 Simon Says
 ..........
@@ -225,10 +225,10 @@ Simon Says
 the pattern and then click the tiles in the same order. Each time you get the
 sequence right the pattern gets one step longer.
 
-.. image:: http://www.grantjenks.com/docs/freegames/_static/simonsays.gif
+.. image:: https://grantjenks.com/docs/freegames/_static/simonsays.gif
    :alt: Simon Says Free Python Game
 
-.. _`Simon Says`: http://www.grantjenks.com/docs/freegames/simonsays.html
+.. _`Simon Says`: https://grantjenks.com/docs/freegames/simonsays.html
 
 Tic Tac Toe
 ...........
@@ -236,10 +236,10 @@ Tic Tac Toe
 `Tic Tac Toe`_ -- classic game. Click the screen to place an X or O. Connect
 three in a row and you win!
 
-.. image:: http://www.grantjenks.com/docs/freegames/_static/tictactoe.gif
+.. image:: https://grantjenks.com/docs/freegames/_static/tictactoe.gif
    :alt: Tic Tac Toe Free Python Game
 
-.. _`Tic Tac Toe`: http://www.grantjenks.com/docs/freegames/tictactoe.html
+.. _`Tic Tac Toe`: https://grantjenks.com/docs/freegames/tictactoe.html
 
 Tiles
 .....
@@ -248,10 +248,10 @@ Tiles
 the empty square to swap positions. Can you make the tiles count one to fifteen
 from left to right and bottom to top?
 
-.. image:: http://www.grantjenks.com/docs/freegames/_static/tiles.gif
+.. image:: https://grantjenks.com/docs/freegames/_static/tiles.gif
    :alt: Tiles Free Python Game
 
-.. _`Tiles`: http://www.grantjenks.com/docs/freegames/tiles.html
+.. _`Tiles`: https://grantjenks.com/docs/freegames/tiles.html
 
 Tron
 ....
@@ -259,10 +259,10 @@ Tron
 `Tron`_ -- classic arcade game. Use the keyboard to change the direction of
 your Tron player. Avoid touching the line drawn by your opponent.
 
-.. image:: http://www.grantjenks.com/docs/freegames/_static/tron.gif
+.. image:: https://grantjenks.com/docs/freegames/_static/tron.gif
    :alt: Tron Free Python Game
 
-.. _`Tron`: http://www.grantjenks.com/docs/freegames/tron.html
+.. _`Tron`: https://grantjenks.com/docs/freegames/tron.html
 
 Life
 ....
@@ -270,10 +270,10 @@ Life
 `Life`_ -- Conway's Game of Life. The classic, zero-player, cellular automation
 created in 1970 by John Conway.
 
-.. image:: http://www.grantjenks.com/docs/freegames/_static/life.gif
+.. image:: https://grantjenks.com/docs/freegames/_static/life.gif
    :alt: Game of Life Free Python Game
 
-.. _`Life`: http://www.grantjenks.com/docs/freegames/life.html
+.. _`Life`: https://grantjenks.com/docs/freegames/life.html
 
 Maze
 ....
@@ -282,10 +282,10 @@ Maze
 of Code with 10 PRINT`_. Tap the screen to trace a path from one side to
 another.
 
-.. image:: http://www.grantjenks.com/docs/freegames/_static/maze.gif
+.. image:: https://grantjenks.com/docs/freegames/_static/maze.gif
    :alt: Maze Free Python Game
 
-.. _`Maze`: http://www.grantjenks.com/docs/freegames/maze.html
+.. _`Maze`: https://grantjenks.com/docs/freegames/maze.html
 .. _`A Universe in One Line of Code with 10 PRINT`: https://www.makeartwithpython.com/blog/10-print-in-python/
 
 Fidget
@@ -294,10 +294,30 @@ Fidget
 `Fidget`_ -- fidget spinner inspired animation. Click the screen to accelerate
 the fidget spinner.
 
-.. image:: http://www.grantjenks.com/docs/freegames/_static/fidget.gif
+.. image:: https://grantjenks.com/docs/freegames/_static/fidget.gif
    :alt: Fidget Spinner Free Python Game
 
-.. _`Fidget`: http://www.grantjenks.com/docs/freegames/fidget.html
+.. _`Fidget`: https://grantjenks.com/docs/freegames/fidget.html
+
+Illusion
+........
+
+`Illusion`_ -- an optical illusion.
+
+.. image:: https://grantjenks.com/docs/freegames/_static/illusion.png
+   :alt: Optical Illusion Free Python Game
+
+.. _`Illusion`: https://grantjenks.com/docs/freegames/illusion.html
+
+Typing
+......
+
+`Typing`_ -- practice typing while letters fall down the screen.
+
+.. image:: https://grantjenks.com/docs/freegames/_static/typing.png
+   :alt: Typing Free Python Game
+
+.. _`Typing`: https://grantjenks.com/docs/freegames/typing.html
 
 
 User Guide
@@ -311,10 +331,10 @@ curriculum, API, and development.
 * `Free Python Games API Reference`_
 * `Free Python Games Development`_
 
-.. _`Talk: Give the Gift of Python`: http://www.grantjenks.com/docs/freegames/give-gift-python.html
-.. _`Free Python Games Curriculum`: http://www.grantjenks.com/docs/freegames/curriculum.html
-.. _`Free Python Games API Reference`: http://www.grantjenks.com/docs/freegames/api.html
-.. _`Free Python Games Development`: http://www.grantjenks.com/docs/freegames/development.html
+.. _`Talk: Give the Gift of Python`: https://grantjenks.com/docs/freegames/give-gift-python.html
+.. _`Free Python Games Curriculum`: https://grantjenks.com/docs/freegames/curriculum.html
+.. _`Free Python Games API Reference`: https://grantjenks.com/docs/freegames/api.html
+.. _`Free Python Games Development`: https://grantjenks.com/docs/freegames/development.html
 
 
 References
@@ -325,7 +345,7 @@ References
 * `Free Python Games at GitHub`_
 * `Free Python Games Issue Tracker`_
 
-.. _`Free Python Games Documentation`: http://www.grantjenks.com/docs/freegames/
+.. _`Free Python Games Documentation`: https://grantjenks.com/docs/freegames/
 .. _`Free Python Games at PyPI`: https://pypi.python.org/pypi/freegames
 .. _`Free Python Games at GitHub`: https://github.com/grantjenks/free-python-games
 .. _`Free Python Games Issue Tracker`: https://github.com/grantjenks/free-python-games/issues
diff --git a/docs/_static/illusion.png b/docs/_static/illusion.png
new file mode 100644
index 0000000000000000000000000000000000000000..6ada11f754c74a82de52b7738b75dadf90bcfa4e
GIT binary patch
literal 5304
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

literal 0
HcmV?d00001

diff --git a/docs/_static/typing.png b/docs/_static/typing.png
new file mode 100644
index 0000000000000000000000000000000000000000..cfb235896e0cd87cba4a777ba309fe453fd0829a
GIT binary patch
literal 8466
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
DTPOj6

literal 0
HcmV?d00001


From ef7b1966fa73d8a3146c2f316323bfec9914527d Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 20:08:20 -0800
Subject: [PATCH 60/77] Bump versions on actions

---
 .github/workflows/integration.yml | 8 ++++----
 .github/workflows/release.yml     | 4 ++--
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/.github/workflows/integration.yml b/.github/workflows/integration.yml
index 0f00038b..1b4ee3f5 100644
--- a/.github/workflows/integration.yml
+++ b/.github/workflows/integration.yml
@@ -17,8 +17,8 @@ jobs:
       matrix:
         check: [bluecheck, doc8, docs, flake8, isortcheck, rstcheck]
     steps:
-    - uses: actions/checkout@v2
-    - uses: actions/setup-python@v2
+    - uses: actions/checkout@v3
+    - uses: actions/setup-python@v4
       with:
         python-version: '3.10'
     - name: Setup tox
@@ -38,8 +38,8 @@ jobs:
         os: [ubuntu-latest]
         python-version: [3.7, 3.8, 3.9, '3.10', 3.11]
     steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-python@v2
+      - uses: actions/checkout@v3
+      - uses: actions/setup-python@v4
         with:
           python-version: ${{ matrix.python-version }}
       - name: Setup tox
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index 20753098..d902ad84 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -11,10 +11,10 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v3
 
     - name: Set up Python
-      uses: actions/setup-python@v2
+      uses: actions/setup-python@v4
       with:
         python-version: 3.11
 

From fc0f7d347dbe2d5823e40c683f733446d1f39cd6 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 20:32:43 -0800
Subject: [PATCH 61/77] Change setup.py to pyproject.toml

---
 .gitignore                                  |   2 +-
 pyproject.toml                              |  46 +++++++++++++
 setup.py                                    |  70 --------------------
 {freegames => src/freegames}/__init__.py    |   0
 {freegames => src/freegames}/__main__.py    |   0
 {freegames => src/freegames}/ant.py         |   0
 {freegames => src/freegames}/avoid.py       |   0
 {freegames => src/freegames}/bagels.py      |   0
 {freegames => src/freegames}/bounce.py      |   0
 {freegames => src/freegames}/cannon.py      |   0
 {freegames => src/freegames}/car.gif        | Bin
 {freegames => src/freegames}/connect.py     |   0
 {freegames => src/freegames}/crypto.py      |   0
 {freegames => src/freegames}/fidget.py      |   0
 {freegames => src/freegames}/flappy.py      |   0
 {freegames => src/freegames}/guess.py       |   0
 {freegames => src/freegames}/illusion.py    |   0
 {freegames => src/freegames}/life.py        |   0
 {freegames => src/freegames}/madlibs.py     |   0
 {freegames => src/freegames}/maze.py        |   0
 {freegames => src/freegames}/memory.py      |   0
 {freegames => src/freegames}/minesweeper.py |   0
 {freegames => src/freegames}/pacman.py      |   0
 {freegames => src/freegames}/paint.py       |   0
 {freegames => src/freegames}/pong.py        |   0
 {freegames => src/freegames}/rps.py         |   0
 {freegames => src/freegames}/simonsays.py   |   0
 {freegames => src/freegames}/snake.py       |   0
 {freegames => src/freegames}/tictactoe.py   |   0
 {freegames => src/freegames}/tiles.py       |   0
 {freegames => src/freegames}/tron.py        |   0
 {freegames => src/freegames}/typing.py      |   0
 {freegames => src/freegames}/utils.py       |   0
 33 files changed, 47 insertions(+), 71 deletions(-)
 create mode 100644 pyproject.toml
 delete mode 100644 setup.py
 rename {freegames => src/freegames}/__init__.py (100%)
 rename {freegames => src/freegames}/__main__.py (100%)
 rename {freegames => src/freegames}/ant.py (100%)
 rename {freegames => src/freegames}/avoid.py (100%)
 rename {freegames => src/freegames}/bagels.py (100%)
 rename {freegames => src/freegames}/bounce.py (100%)
 rename {freegames => src/freegames}/cannon.py (100%)
 rename {freegames => src/freegames}/car.gif (100%)
 rename {freegames => src/freegames}/connect.py (100%)
 rename {freegames => src/freegames}/crypto.py (100%)
 rename {freegames => src/freegames}/fidget.py (100%)
 rename {freegames => src/freegames}/flappy.py (100%)
 rename {freegames => src/freegames}/guess.py (100%)
 rename {freegames => src/freegames}/illusion.py (100%)
 rename {freegames => src/freegames}/life.py (100%)
 rename {freegames => src/freegames}/madlibs.py (100%)
 rename {freegames => src/freegames}/maze.py (100%)
 rename {freegames => src/freegames}/memory.py (100%)
 rename {freegames => src/freegames}/minesweeper.py (100%)
 rename {freegames => src/freegames}/pacman.py (100%)
 rename {freegames => src/freegames}/paint.py (100%)
 rename {freegames => src/freegames}/pong.py (100%)
 rename {freegames => src/freegames}/rps.py (100%)
 rename {freegames => src/freegames}/simonsays.py (100%)
 rename {freegames => src/freegames}/snake.py (100%)
 rename {freegames => src/freegames}/tictactoe.py (100%)
 rename {freegames => src/freegames}/tiles.py (100%)
 rename {freegames => src/freegames}/tron.py (100%)
 rename {freegames => src/freegames}/typing.py (100%)
 rename {freegames => src/freegames}/utils.py (100%)

diff --git a/.gitignore b/.gitignore
index 4f3a167a..dc23d9ba 100644
--- a/.gitignore
+++ b/.gitignore
@@ -13,6 +13,6 @@
 /build/
 /dist/
 /docs/_build/
-/freegames.egg-info/
+*.egg-info/
 
 .DS_Store
diff --git a/pyproject.toml b/pyproject.toml
new file mode 100644
index 00000000..10672a84
--- /dev/null
+++ b/pyproject.toml
@@ -0,0 +1,46 @@
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "freegames"
+description = "Free Python Games"
+authors = [
+    {"name" = "Grant Jenks", "email" = "contact@grantjenks.com"},
+]
+readme = "README.rst"
+requires-python = ">=3.7"
+keywords = ["free", "games"]
+license = {"text" = "Apache 2.0"}
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Education",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: Apache Software License",
+    "Natural Language :: English",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Topic :: Games/Entertainment",
+    "Topic :: Games/Entertainment :: Arcade",
+    "Topic :: Games/Entertainment :: Board Games",
+    "Topic :: Games/Entertainment :: Puzzle Games",
+    "Topic :: Games/Entertainment :: Side-Scrolling/Arcade Games",
+    "Topic :: Games/Entertainment :: Simulation",
+    "Topic :: Games/Entertainment :: Turn Based Strategy",
+]
+dynamic = ["version"]
+
+[project.urls]
+Documentation = "https://grantjenks.com/docs/freegames/"
+Funding = "https://gum.co/freegames"
+Source = "https://github.com/grantjenks/free-python-games"
+Tracker = "https://github.com/grantjenks/django-codemirror6/issues"
+
+[tool.setuptools.dynamic]
+version = {attr = "freegames.__version__"}
+
+[tool.setuptools.package-data]
+freegames = ["*.gif"]
+
+[tool.setuptools.packages.find]
+where = ["src"]
diff --git a/setup.py b/setup.py
deleted file mode 100644
index 8d4e9e3f..00000000
--- a/setup.py
+++ /dev/null
@@ -1,70 +0,0 @@
-import io
-import sys
-
-import setuptools as st
-from setuptools.command.test import test as TestCommand
-
-import freegames
-
-
-class Tox(TestCommand):
-    def finalize_options(self):
-        TestCommand.finalize_options(self)
-        self.test_args = []
-        self.test_suite = True
-
-    def run_tests(self):
-        import tox
-
-        errno = tox.cmdline(self.test_args)
-        sys.exit(errno)
-
-
-with io.open('README.rst', encoding='UTF-8') as reader:
-    readme = reader.read()
-
-
-st.setup(
-    name='freegames',
-    version=freegames.__version__,
-    description='Free Games',
-    long_description=readme,
-    long_description_content_type='text/x-rst',
-    author='Grant Jenks',
-    author_email='contact@grantjenks.com',
-    url='http://www.grantjenks.com/docs/freegames/',
-    license='Apache 2.0',
-    packages=['freegames'],
-    include_package_data=True,
-    tests_require=['tox'],
-    cmdclass={'test': Tox},
-    install_requires=[],
-    project_urls={
-        'Documentation': 'http://www.grantjenks.com/docs/freegames/',
-        'Funding': 'http://gum.co/freegames',
-        'Source': 'https://github.com/grantjenks/free-python-games',
-        'Tracker': 'https://github.com/grantjenks/free-python-games/issues',
-    },
-    classifiers=(
-        'Development Status :: 5 - Production/Stable',
-        'Intended Audience :: Education',
-        'Intended Audience :: End Users/Desktop',
-        'License :: OSI Approved :: Apache Software License',
-        'Natural Language :: English',
-        'Programming Language :: Python',
-        'Programming Language :: Python :: 3',
-        'Programming Language :: Python :: 3.6',
-        'Programming Language :: Python :: 3.7',
-        'Programming Language :: Python :: 3.8',
-        'Programming Language :: Python :: 3.9',
-        'Programming Language :: Python :: 3.10',
-        'Programming Language :: Python :: Implementation :: CPython',
-        'Topic :: Games/Entertainment',
-        'Topic :: Games/Entertainment :: Arcade',
-        'Topic :: Games/Entertainment :: Board Games',
-        'Topic :: Games/Entertainment :: Puzzle Games',
-        'Topic :: Games/Entertainment :: Side-Scrolling/Arcade Games',
-        'Topic :: Games/Entertainment :: Simulation',
-        'Topic :: Games/Entertainment :: Turn Based Strategy',
-    ),
-)
diff --git a/freegames/__init__.py b/src/freegames/__init__.py
similarity index 100%
rename from freegames/__init__.py
rename to src/freegames/__init__.py
diff --git a/freegames/__main__.py b/src/freegames/__main__.py
similarity index 100%
rename from freegames/__main__.py
rename to src/freegames/__main__.py
diff --git a/freegames/ant.py b/src/freegames/ant.py
similarity index 100%
rename from freegames/ant.py
rename to src/freegames/ant.py
diff --git a/freegames/avoid.py b/src/freegames/avoid.py
similarity index 100%
rename from freegames/avoid.py
rename to src/freegames/avoid.py
diff --git a/freegames/bagels.py b/src/freegames/bagels.py
similarity index 100%
rename from freegames/bagels.py
rename to src/freegames/bagels.py
diff --git a/freegames/bounce.py b/src/freegames/bounce.py
similarity index 100%
rename from freegames/bounce.py
rename to src/freegames/bounce.py
diff --git a/freegames/cannon.py b/src/freegames/cannon.py
similarity index 100%
rename from freegames/cannon.py
rename to src/freegames/cannon.py
diff --git a/freegames/car.gif b/src/freegames/car.gif
similarity index 100%
rename from freegames/car.gif
rename to src/freegames/car.gif
diff --git a/freegames/connect.py b/src/freegames/connect.py
similarity index 100%
rename from freegames/connect.py
rename to src/freegames/connect.py
diff --git a/freegames/crypto.py b/src/freegames/crypto.py
similarity index 100%
rename from freegames/crypto.py
rename to src/freegames/crypto.py
diff --git a/freegames/fidget.py b/src/freegames/fidget.py
similarity index 100%
rename from freegames/fidget.py
rename to src/freegames/fidget.py
diff --git a/freegames/flappy.py b/src/freegames/flappy.py
similarity index 100%
rename from freegames/flappy.py
rename to src/freegames/flappy.py
diff --git a/freegames/guess.py b/src/freegames/guess.py
similarity index 100%
rename from freegames/guess.py
rename to src/freegames/guess.py
diff --git a/freegames/illusion.py b/src/freegames/illusion.py
similarity index 100%
rename from freegames/illusion.py
rename to src/freegames/illusion.py
diff --git a/freegames/life.py b/src/freegames/life.py
similarity index 100%
rename from freegames/life.py
rename to src/freegames/life.py
diff --git a/freegames/madlibs.py b/src/freegames/madlibs.py
similarity index 100%
rename from freegames/madlibs.py
rename to src/freegames/madlibs.py
diff --git a/freegames/maze.py b/src/freegames/maze.py
similarity index 100%
rename from freegames/maze.py
rename to src/freegames/maze.py
diff --git a/freegames/memory.py b/src/freegames/memory.py
similarity index 100%
rename from freegames/memory.py
rename to src/freegames/memory.py
diff --git a/freegames/minesweeper.py b/src/freegames/minesweeper.py
similarity index 100%
rename from freegames/minesweeper.py
rename to src/freegames/minesweeper.py
diff --git a/freegames/pacman.py b/src/freegames/pacman.py
similarity index 100%
rename from freegames/pacman.py
rename to src/freegames/pacman.py
diff --git a/freegames/paint.py b/src/freegames/paint.py
similarity index 100%
rename from freegames/paint.py
rename to src/freegames/paint.py
diff --git a/freegames/pong.py b/src/freegames/pong.py
similarity index 100%
rename from freegames/pong.py
rename to src/freegames/pong.py
diff --git a/freegames/rps.py b/src/freegames/rps.py
similarity index 100%
rename from freegames/rps.py
rename to src/freegames/rps.py
diff --git a/freegames/simonsays.py b/src/freegames/simonsays.py
similarity index 100%
rename from freegames/simonsays.py
rename to src/freegames/simonsays.py
diff --git a/freegames/snake.py b/src/freegames/snake.py
similarity index 100%
rename from freegames/snake.py
rename to src/freegames/snake.py
diff --git a/freegames/tictactoe.py b/src/freegames/tictactoe.py
similarity index 100%
rename from freegames/tictactoe.py
rename to src/freegames/tictactoe.py
diff --git a/freegames/tiles.py b/src/freegames/tiles.py
similarity index 100%
rename from freegames/tiles.py
rename to src/freegames/tiles.py
diff --git a/freegames/tron.py b/src/freegames/tron.py
similarity index 100%
rename from freegames/tron.py
rename to src/freegames/tron.py
diff --git a/freegames/typing.py b/src/freegames/typing.py
similarity index 100%
rename from freegames/typing.py
rename to src/freegames/typing.py
diff --git a/freegames/utils.py b/src/freegames/utils.py
similarity index 100%
rename from freegames/utils.py
rename to src/freegames/utils.py

From 888cf20f4fc633484acf969165e8a990ffe614ed Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 20:41:06 -0800
Subject: [PATCH 62/77] Update all literal includes

---
 docs/ant.rst         | 2 +-
 docs/avoid.rst       | 2 +-
 docs/bagels.rst      | 2 +-
 docs/bounce.rst      | 2 +-
 docs/cannon.rst      | 2 +-
 docs/connect.rst     | 2 +-
 docs/crypto.rst      | 2 +-
 docs/fidget.rst      | 2 +-
 docs/flappy.rst      | 2 +-
 docs/guess.rst       | 2 +-
 docs/illusion.rst    | 2 +-
 docs/life.rst        | 2 +-
 docs/madlibs.rst     | 2 +-
 docs/maze.rst        | 2 +-
 docs/memory.rst      | 2 +-
 docs/minesweeper.rst | 2 +-
 docs/pacman.rst      | 2 +-
 docs/paint.rst       | 2 +-
 docs/pong.rst        | 2 +-
 docs/rps.rst         | 2 +-
 docs/simonsays.rst   | 2 +-
 docs/snake.rst       | 2 +-
 docs/tictactoe.rst   | 2 +-
 docs/tiles.rst       | 2 +-
 docs/tron.rst        | 2 +-
 docs/typing.rst      | 2 +-
 26 files changed, 26 insertions(+), 26 deletions(-)

diff --git a/docs/ant.rst b/docs/ant.rst
index 2bf4fe12..43beaf91 100644
--- a/docs/ant.rst
+++ b/docs/ant.rst
@@ -3,4 +3,4 @@ Ant
 
 Ant, simple animation demo.
 
-.. literalinclude:: ../freegames/ant.py
+.. literalinclude:: ../src/freegames/ant.py
diff --git a/docs/avoid.rst b/docs/avoid.rst
index de259a1d..274f4538 100644
--- a/docs/avoid.rst
+++ b/docs/avoid.rst
@@ -3,4 +3,4 @@ Avoid
 
 Avoid, classic arcade game.
 
-.. literalinclude:: ../freegames/avoid.py
+.. literalinclude:: ../src/freegames/avoid.py
diff --git a/docs/bagels.rst b/docs/bagels.rst
index 705413c4..154f58fa 100644
--- a/docs/bagels.rst
+++ b/docs/bagels.rst
@@ -3,4 +3,4 @@ Bagels
 
 Bagels, a number puzzle game.
 
-.. literalinclude:: ../freegames/bagels.py
+.. literalinclude:: ../src/freegames/bagels.py
diff --git a/docs/bounce.rst b/docs/bounce.rst
index 252f265d..f557df66 100644
--- a/docs/bounce.rst
+++ b/docs/bounce.rst
@@ -3,4 +3,4 @@ Bounce
 
 Bounce, a simple animation demo.
 
-.. literalinclude:: ../freegames/bounce.py
+.. literalinclude:: ../src/freegames/bounce.py
diff --git a/docs/cannon.rst b/docs/cannon.rst
index 66575d00..77f66a2d 100644
--- a/docs/cannon.rst
+++ b/docs/cannon.rst
@@ -3,4 +3,4 @@ Cannon
 
 Cannon, hitting targets with projectiles.
 
-.. literalinclude:: ../freegames/cannon.py
+.. literalinclude:: ../src/freegames/cannon.py
diff --git a/docs/connect.rst b/docs/connect.rst
index d1684742..3a346277 100644
--- a/docs/connect.rst
+++ b/docs/connect.rst
@@ -3,4 +3,4 @@ Connect Four
 
 Connect Four, two-player connection game.
 
-.. literalinclude:: ../freegames/connect.py
+.. literalinclude:: ../src/freegames/connect.py
diff --git a/docs/crypto.rst b/docs/crypto.rst
index f628f2f4..70cc34c7 100644
--- a/docs/crypto.rst
+++ b/docs/crypto.rst
@@ -3,4 +3,4 @@ Crypto
 
 Crypto: tool for encrypting and decrypting messages.
 
-.. literalinclude:: ../freegames/crypto.py
+.. literalinclude:: ../src/freegames/crypto.py
diff --git a/docs/fidget.rst b/docs/fidget.rst
index 44f8e3ea..1e5a7348 100644
--- a/docs/fidget.rst
+++ b/docs/fidget.rst
@@ -3,4 +3,4 @@ Fidget
 
 Fidget, inspired by fidget spinners.
 
-.. literalinclude:: ../freegames/fidget.py
+.. literalinclude:: ../src/freegames/fidget.py
diff --git a/docs/flappy.rst b/docs/flappy.rst
index 4d46b070..eaead5fc 100644
--- a/docs/flappy.rst
+++ b/docs/flappy.rst
@@ -3,4 +3,4 @@ Flappy
 
 Flappy, game inspired by Flappy Bird.
 
-.. literalinclude:: ../freegames/flappy.py
+.. literalinclude:: ../src/freegames/flappy.py
diff --git a/docs/guess.rst b/docs/guess.rst
index 885eb2ab..f158f8d5 100644
--- a/docs/guess.rst
+++ b/docs/guess.rst
@@ -3,4 +3,4 @@ Guess
 
 Guess a number within a range.
 
-.. literalinclude:: ../freegames/guess.py
+.. literalinclude:: ../src/freegames/guess.py
diff --git a/docs/illusion.rst b/docs/illusion.rst
index 6b750ab7..6bb58eda 100644
--- a/docs/illusion.rst
+++ b/docs/illusion.rst
@@ -3,4 +3,4 @@ Illusion
 
 An optical illusion.
 
-.. literalinclude:: ../freegames/illusion.py
+.. literalinclude:: ../src/freegames/illusion.py
diff --git a/docs/life.rst b/docs/life.rst
index 1db7e63f..c4e7ad7a 100644
--- a/docs/life.rst
+++ b/docs/life.rst
@@ -3,4 +3,4 @@ Life
 
 Game of Life simulation.
 
-.. literalinclude:: ../freegames/life.py
+.. literalinclude:: ../src/freegames/life.py
diff --git a/docs/madlibs.rst b/docs/madlibs.rst
index 359ffbc5..f10ea4a9 100644
--- a/docs/madlibs.rst
+++ b/docs/madlibs.rst
@@ -3,4 +3,4 @@ Mad Libs
 
 Create a funny story from a not-so funny story
 
-.. literalinclude:: ../freegames/madlibs.py
+.. literalinclude:: ../src/freegames/madlibs.py
diff --git a/docs/maze.rst b/docs/maze.rst
index 9d9bfb7e..5c191e2b 100644
--- a/docs/maze.rst
+++ b/docs/maze.rst
@@ -3,4 +3,4 @@ Maze
 
 Maze, move from one side to another.
 
-.. literalinclude:: ../freegames/maze.py
+.. literalinclude:: ../src/freegames/maze.py
diff --git a/docs/memory.rst b/docs/memory.rst
index 31b70ec5..fb9f1fb3 100644
--- a/docs/memory.rst
+++ b/docs/memory.rst
@@ -3,4 +3,4 @@ Memory
 
 Memory, puzzle game of number pairs.
 
-.. literalinclude:: ../freegames/memory.py
+.. literalinclude:: ../src/freegames/memory.py
diff --git a/docs/minesweeper.rst b/docs/minesweeper.rst
index e8f26ee7..ecb9c182 100644
--- a/docs/minesweeper.rst
+++ b/docs/minesweeper.rst
@@ -3,4 +3,4 @@ Minesweeper
 
 Minesweeper, a logic puzzle game to clear the hidden mines.
 
-.. literalinclude:: ../freegames/minesweeper.py
+.. literalinclude:: ../src/freegames/minesweeper.py
diff --git a/docs/pacman.rst b/docs/pacman.rst
index 6200a566..023ee5bc 100644
--- a/docs/pacman.rst
+++ b/docs/pacman.rst
@@ -3,4 +3,4 @@ Pacman
 
 Pacman, classic arcade game.
 
-.. literalinclude:: ../freegames/pacman.py
+.. literalinclude:: ../src/freegames/pacman.py
diff --git a/docs/paint.rst b/docs/paint.rst
index 8a029bc6..11f39265 100644
--- a/docs/paint.rst
+++ b/docs/paint.rst
@@ -3,4 +3,4 @@ Paint
 
 Paint, for drawing shapes.
 
-.. literalinclude:: ../freegames/paint.py
+.. literalinclude:: ../src/freegames/paint.py
diff --git a/docs/pong.rst b/docs/pong.rst
index dfb740c2..03ba6169 100644
--- a/docs/pong.rst
+++ b/docs/pong.rst
@@ -3,4 +3,4 @@ Pong
 
 Pong, classic arcade game.
 
-.. literalinclude:: ../freegames/pong.py
+.. literalinclude:: ../src/freegames/pong.py
diff --git a/docs/rps.rst b/docs/rps.rst
index 6914660a..57180fe2 100644
--- a/docs/rps.rst
+++ b/docs/rps.rst
@@ -3,4 +3,4 @@ Rock, Paper, Scissors
 
 Rock, Paper, Scissors -- classic hand-to-hand combat game.
 
-.. literalinclude:: ../freegames/rps.py
+.. literalinclude:: ../src/freegames/rps.py
diff --git a/docs/simonsays.rst b/docs/simonsays.rst
index 90a43a28..ceeced18 100644
--- a/docs/simonsays.rst
+++ b/docs/simonsays.rst
@@ -3,4 +3,4 @@ Simon Says
 
 A game of watching and recalling patterns.
 
-.. literalinclude:: ../freegames/simonsays.py
+.. literalinclude:: ../src/freegames/simonsays.py
diff --git a/docs/snake.rst b/docs/snake.rst
index 2dab1b38..a2e62a73 100644
--- a/docs/snake.rst
+++ b/docs/snake.rst
@@ -3,4 +3,4 @@ Snake
 
 Snake, classic arcade game.
 
-.. literalinclude:: ../freegames/snake.py
+.. literalinclude:: ../src/freegames/snake.py
diff --git a/docs/tictactoe.rst b/docs/tictactoe.rst
index c12d9ccd..c4f182e4 100644
--- a/docs/tictactoe.rst
+++ b/docs/tictactoe.rst
@@ -3,4 +3,4 @@ Tic Tac Toe
 
 A paper-and-pencil game for two players.
 
-.. literalinclude:: ../freegames/tictactoe.py
+.. literalinclude:: ../src/freegames/tictactoe.py
diff --git a/docs/tiles.rst b/docs/tiles.rst
index d666b319..b474a3c8 100644
--- a/docs/tiles.rst
+++ b/docs/tiles.rst
@@ -3,4 +3,4 @@ Tiles
 
 Tiles, number swapping game.
 
-.. literalinclude:: ../freegames/tiles.py
+.. literalinclude:: ../src/freegames/tiles.py
diff --git a/docs/tron.rst b/docs/tron.rst
index c584e4b1..4f7daef5 100644
--- a/docs/tron.rst
+++ b/docs/tron.rst
@@ -3,4 +3,4 @@ Tron
 
 Tron, classic arcade game.
 
-.. literalinclude:: ../freegames/tron.py
+.. literalinclude:: ../src/freegames/tron.py
diff --git a/docs/typing.rst b/docs/typing.rst
index e7a3597e..86062c5f 100644
--- a/docs/typing.rst
+++ b/docs/typing.rst
@@ -3,4 +3,4 @@ Typing
 
 Typing, simple typing game.
 
-.. literalinclude:: ../freegames/typing.py
+.. literalinclude:: ../src/freegames/typing.py

From 2a2956a15cf364ed09d34d00e9aee89ac844c255 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 20:45:03 -0800
Subject: [PATCH 63/77] Add missing docs to index

---
 docs/index.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/index.rst b/docs/index.rst
index 0af26523..eeef7451 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -10,6 +10,7 @@
    guess
    snake
    crypto
+   illusion
    paint
    maze
    flappy
@@ -22,9 +23,13 @@
    pong
    life
    tron
+   typing
    tiles
    connect
    memory
+   minesweeper
+   avoid
    pacman
    fidget
    madlibs
+   rps

From 406ba5ddcc57396e28ca59d76ef6c759a29a0d94 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 20:45:36 -0800
Subject: [PATCH 64/77] Set language to 'en'

---
 docs/conf.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/conf.py b/docs/conf.py
index 0c339e44..fc41c1e0 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -62,7 +62,7 @@
 #
 # This is also used if you do content translation via gettext catalogs.
 # Usually you set "language" from the command line for these cases.
-language = None
+language = 'en'
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.

From d38b373b7e31e3cf5a59d5da535858407ad85690 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 20:51:12 -0800
Subject: [PATCH 65/77] Update src paths

---
 tox.ini | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/tox.ini b/tox.ini
index 276e4d80..3e28d2a0 100644
--- a/tox.ini
+++ b/tox.ini
@@ -12,11 +12,11 @@ setenv=
     PYTHONPATH={toxinidir}:{toxinidir}/tests
 
 [testenv:blue]
-commands=blue {toxinidir}/setup.py {toxinidir}/freegames {toxinidir}/tests
+commands=blue {toxinidir}/src/freegames {toxinidir}/tests
 deps=blue
 
 [testenv:bluecheck]
-commands=blue --check {toxinidir}/setup.py {toxinidir}/freegames {toxinidir}/tests
+commands=blue --check {toxinidir}/src/freegames {toxinidir}/tests
 deps=blue
 
 [testenv:doc8]
@@ -31,15 +31,15 @@ deps=
     sphinx
 
 [testenv:flake8]
-commands=flake8 {toxinidir}/setup.py {toxinidir}/freegames {toxinidir}/tests
+commands=flake8 {toxinidir}/src/freegames {toxinidir}/tests
 deps=flake8
 
 [testenv:isort]
-commands=isort {toxinidir}/setup.py {toxinidir}/freegames {toxinidir}/tests
+commands=isort {toxinidir}/src/freegames {toxinidir}/tests
 deps=isort
 
 [testenv:isortcheck]
-commands=isort --check {toxinidir}/setup.py {toxinidir}/freegames {toxinidir}/tests
+commands=isort --check {toxinidir}/src/freegames {toxinidir}/tests
 deps=isort
 
 [testenv:rstcheck]
@@ -69,7 +69,7 @@ addopts=
     --doctest-glob="*.rst"
     --doctest-modules
     --import-mode append
-testpaths=docs freegames tests README.rst
+testpaths=docs src/freegames tests README.rst
 
 [doc8]
 # ignore=D000

From 1ea58b9e35759ab0a58520a556c2fa61ac63a201 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 21:02:21 -0800
Subject: [PATCH 66/77] Bump version to 2.5.1

---
 src/freegames/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/freegames/__init__.py b/src/freegames/__init__.py
index 48914613..8f0b20aa 100644
--- a/src/freegames/__init__.py
+++ b/src/freegames/__init__.py
@@ -62,7 +62,7 @@
 __all__ = ['floor', 'line', 'path', 'square', 'vector']
 
 __title__ = 'freegames'
-__version__ = '2.5.0'
+__version__ = '2.5.1'
 __author__ = 'Grant Jenks'
 __license__ = 'Apache 2.0'
 __copyright__ = '2017-2023, Grant Jenks'

From 56519cf8dbff6c35992f68a61b7b4cb6c0e03510 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 21:32:46 -0800
Subject: [PATCH 67/77] Update rsync command

---
 tox.ini | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/tox.ini b/tox.ini
index 3e28d2a0..257dca07 100644
--- a/tox.ini
+++ b/tox.ini
@@ -50,8 +50,9 @@ deps=rstcheck
 allowlist_externals=rsync
 changedir=docs
 commands=
-    rsync -azP --stats --delete _build/html/ \
-        grantjenks.com:/srv/www/www.grantjenks.com/public/docs/freegames/
+    rsync  --rsync-path 'sudo -u herokuish rsync' -azP --stats --delete \
+        _build/html/ \
+        grantjenks:/srv/www/grantjenks.com/public/docs/freegames/
 
 [isort]
 multi_line_output = 3

From c9b3d3b34343e5fb35f0008f04b0aef829729d88 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 22:00:43 -0800
Subject: [PATCH 68/77] Use gifs

---
 README.rst                |   4 ++--
 docs/_static/illusion.gif | Bin 0 -> 4590 bytes
 docs/_static/illusion.png | Bin 5304 -> 0 bytes
 docs/_static/typing.gif   | Bin 0 -> 65734 bytes
 docs/_static/typing.png   | Bin 8466 -> 0 bytes
 5 files changed, 2 insertions(+), 2 deletions(-)
 create mode 100644 docs/_static/illusion.gif
 delete mode 100644 docs/_static/illusion.png
 create mode 100644 docs/_static/typing.gif
 delete mode 100644 docs/_static/typing.png

diff --git a/README.rst b/README.rst
index 47a0b317..f4e6ccea 100644
--- a/README.rst
+++ b/README.rst
@@ -304,7 +304,7 @@ Illusion
 
 `Illusion`_ -- an optical illusion.
 
-.. image:: https://grantjenks.com/docs/freegames/_static/illusion.png
+.. image:: https://grantjenks.com/docs/freegames/_static/illusion.gif
    :alt: Optical Illusion Free Python Game
 
 .. _`Illusion`: https://grantjenks.com/docs/freegames/illusion.html
@@ -314,7 +314,7 @@ Typing
 
 `Typing`_ -- practice typing while letters fall down the screen.
 
-.. image:: https://grantjenks.com/docs/freegames/_static/typing.png
+.. image:: https://grantjenks.com/docs/freegames/_static/typing.gif
    :alt: Typing Free Python Game
 
 .. _`Typing`: https://grantjenks.com/docs/freegames/typing.html
diff --git a/docs/_static/illusion.gif b/docs/_static/illusion.gif
new file mode 100644
index 0000000000000000000000000000000000000000..edc3f4943c69d076d46d82df4b5d024481f3e600
GIT binary patch
literal 4590
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
YZO{je&<U;33(e3C?a&Vm&;<YhJEEy}7XSbN

literal 0
HcmV?d00001

diff --git a/docs/_static/illusion.png b/docs/_static/illusion.png
deleted file mode 100644
index 6ada11f754c74a82de52b7738b75dadf90bcfa4e..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 5304
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

diff --git a/docs/_static/typing.gif b/docs/_static/typing.gif
new file mode 100644
index 0000000000000000000000000000000000000000..86a4e389780552621d2b17cc49d4c124e14a5b79
GIT binary patch
literal 65734
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%0D9wBjFisX=I{v(Zdv+Z26{a}jj~{ulFr_a3fXlO
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

literal 0
HcmV?d00001

diff --git a/docs/_static/typing.png b/docs/_static/typing.png
deleted file mode 100644
index cfb235896e0cd87cba4a777ba309fe453fd0829a..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 8466
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
DTPOj6


From 4a339aa7acaded1e5bc6f40218fc3bf19f44ef6d Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 22:11:38 -0800
Subject: [PATCH 69/77] Update typing gif

---
 docs/_static/typing.gif | Bin 65734 -> 221787 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/docs/_static/typing.gif b/docs/_static/typing.gif
index 86a4e389780552621d2b17cc49d4c124e14a5b79..d38f09041eee4b443d3e08714185c995b58591f7 100644
GIT binary patch
literal 221787
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

literal 65734
zcmeFZX*`u}+ctijYql&b^R%!Gm83$Fq*~^=mPjfUk|~u8B}r?s%+o@M%=46F9vYS*
zGa)6VGLuwDgC_rzy6*eB@8^1k_rvr1z5n-j`Op_1&K&!3?EAKF`?l?R2D+*{Y?u%e
zdJI;72m}HzFR!SmsI;`SoSdAJlG3hSyR@{lOiWD7&CQP<J!)%f>*VC*=H_<!@?{2t
z5gr~M8ylOPoSd1NSyWV1QBhG}U*Fu^+|||9-{1fI`SbDd@wvIV4<A0PtgNhk;eYWT
z$z>Fp3y^{Q>Ni&ZCV*LCMY-zBi$t|$yS2NhrS;}}$aw-(Vw3{}RP#qly^OcqcsNtx
z-JOaD0=5m$OP;^~a>w`Kd)}P@(y=(<8yFNE5*ik+FA7jPJRT8o@d?)xleEN+iEDFQ
zyOEWhlbdJe&aFj4X6BdPE-R0S1>C{{?zbxL-n-ATCmcJ5U^KL~cXa9radGg7@!sir
z{ABQk0I#TaQ_<6r(Xn7IrT|G~5)8MAa$+&;g5ygcy~Wv@n|a%X&LL2BKIM9))=BI{
z0eKpWQy2lb7}oQ4rI`=H45qqxV{D{bqR8xlN*6}W+G1rNT%uCsSqRRJCp)ZKY#RM`
zAdP#5+hgOgD-pZ>@!bOkz*v$JBzG)H_7%W#PVreAR?10W&mlJVI#m`8ZYM?hiWyx9
zN1;XJWn^g-&7o@76xVjad?UXauMa$<2wFoP`?)W##lFXfK~j%6iO1FB*%^C}2^m#&
z<Y-0%P_yslaBSGoebGC^-Vv;!Xm+M<QEK~OnE-OYqVrzcgM$c63C81k_qUUiHpe)X
z=S=R96I8`j=C<?<t0qtNa)?LmyPJv*d|ZC|RnOh}&+kW?!X)<JyR-aZ=26j!hxhJ&
z`#hgvP96E$ghr?Bb)+gN+`FnE0Mc1RD{U!l6j1;4%FoP;NCR4S5BBXjtl%ig$K^Dy
zfdM42!gAm`E}O}Vt3yLT2<0jmlp8T)%Oi5_Qv-zbVbaLB1M_2%dIYA~2?=923DCLV
zIDu_Sb{vwn6uU4H&2JSgeBhk+Qg*bs2c1Q<NcWnI7UyInkx#@sO(i<!7EC3%RK1?M
z;o7osI@#li({zg0RKawr&!^YZX*7)7Ogclrc_t%xeW9bq2R0Q30=Y#*EC_?=PPdKG
z-JusC;X3M=+m+%tiG@&9nf!~%aZiq%$w39vA>B|pad%I;Fu0hpL=||{ZFpMHcSumk
zkdLD69C7dGY&J0@V}cAp0x`v6ks26^VG}ENv|<23O(R}+3gmVM@||ZyQ@Q(A+ABBK
z_P?q<?b??~%s+^~<#>~A6msc**?IU(%@~Gu_GjcLQN>1ntAi+%7vBSq_LRc;1Et$3
zI=6T)PKH}@?M+y49_09}XvQl`YiKJBSlrwZThLYJxaIzx!(B>7y6)X!FT&l8BLpBP
zKDGDZJUQA{_=;-H_Z1uIz~`BEuR)N^EHTHh3pHSRb*V51Vb3vGlHxtL{qO@_K2UZt
z_M=OM)BU*3;Ca<<f!e8#A93{;rf**C7E`BDAS{La?xlv)Na(dmo*q6U0;__)Y15`2
zGd;DG{PYQ}OEfx~uT)uXO8xvib5D!kOEU^q-x|VX_?-1NR?LjBdwr{uZzT(?&(Xj9
zR<T=yg4|)z{>@k{oRfmY9pB?)+|F_D`-fh=tv{9q4xRh)@u|bDAD@OVzW?!gBxvi;
zFB1vpelE}C-TL`;Ze?g2_ulIF?0s57o9}NmVjq3|<DM}`Nx}Cw51#BH7J;t_7olzG
z@*NlC(VuM3+&(|D@uk2H?v!;%E(MT#PrF)-KVQh9@p;%69*$`PCZE;JAlpgPME-s$
z`W9_8;iO}za6d7?w%&%rJztBYRvbhjWD<k)o25h+g7u9vc@o;1*Ef#sA&@mud?U&m
z#%wt8V@%WHwjd!iO|-O+TX5M`3PskpI63Segt4zwekrLd;dWA@PMLq_?23&Px-IC<
zTpNZ9g+h{8guE|pfi~KT`XFCga*!tC#|Eifw#t^-V9;)OWHIJ?SN8fH?d|)#7h}^2
zIkJM15VG0knt7=vKT?NYDU=S8iX!DWbP|ejBX-Xc*JTj-XqUWL_)nRUTd@2@MZ5-t
zAqsm03g>$!QsYge2c-Rm#Ox7xq8%b?JM=M7;{X|P#;!+YML8UKUB-~uaY~u(F@0Ep
zw(h+7wA@NFRA<$2eMs0LJtoW8v4=O#xD>GmGVJveSxU#5<ZB9c^aiReWe_9swKo{%
zA4rYK{OaMTD_Un7SjdCK11nUj6Lr&olB&!)#{|Ao(H9%fWvs9U46fxTQa4$;;0{a0
z=#KAX(3U==TeynZ+a5LpE>5`PK8^{Cu~C;U@$u-MqEPP5tmmSP0JOr;6^yg^!3zae
z{^pPFh1w+GGWB-4mLUWxSc3d=OB{kfSft@lstadhF*+qzX5NtM;OBR1+AQwK)0i~l
zd_Vq@^fzCf4+>hHX%wjG)e+<?+H()ZuJEP{<r;cE9Ee~P#Y6(OrAu<Kl5QO-#&N8#
zP$ZobDh<%a9a`T3ZT83?&x@OUjeU~C=EK}l{ylck=|DLfLl(6Q-!*vJILwgtV*QR$
z^_d1g|D&(>Y_R32w2^%Qab1$ts83sJ<wv-M$uNr3xo)rYYv(GX8_EhxV~jfjeR1fP
zmvV<<Ng+r>DNN_jQ<kw-21dsbfe$$|4#yR@n_%J($fR4~Xx4-4t|GwK4z$zlQ(Gm&
zqy&~P6qnvf$u>)uibHfd;yxD2Sh!U3^Pco7zE*kCvSq}IzOyXj(Oaq~2VSv4m+y}1
zl#TX7qdqCo<u?6&Wibg|6YF;^w^Jj_uH_j|${k(qu<R*|ukM=Ma(TJanzQ_RtMQc5
zjpZ)KedS4mT~jLc%iXS#<;l~=(`wI`d%SweQ$Kf2@A<a;kj7b&jy0Ll6#d#8yssit
zuzN;#*VjH~WJUG{lh=kvzxH46smR^Y{d(W!uaD9>EAz2>CbI|fcH+P)HsD;v20LMF
zumM`PiVY~tf58UR4qqYDyuRWKoo~JG!`MLn0cXJkj1A7#zdE68%6V%Q8ywf4zVVqx
z_w#2sT)7gkiVdth4n;)A#9liTfACsj(hcu~;N<j-%=4*Pxq10UL01cImSm=;6(roM
z47+{3@^;mofQmbA%)3p^{!z6L+B-b&clJCyUElj?AUpo?)1kwS&tAN=Xl;8nKF~ig
zJ=s0;=3(*N`v+6=AL<sDKIaV%fBBwKH1-2wVY|*Kz2WFPyttL@j6_pVC`mK<sls*5
zP@xwii0ijcidu<lHEOt<W*aE1+h15wRhE-<ZOh4yWP|eD?i;G^v%~G>c@J08DE@dc
zL*@OdTBNW8>a!aP4g`-XH263(vlT9yD;{}~v_1Qv>qzp2Q~B?oJ&in-m-^P>!mDQ?
z!^8IizUsXluJ`&d`=Yb@)~ow8B)hnAP3dS;Fz=@0T{XAITba^Esm8Tslb!M0HV=}G
zrKT@<?zp<XW$D&kcYz0E=;g@MBNc_^SNP|IQ`8=zbgpjurk3&UtlN(##~m)do$t#w
zYt?<}EbV@(IBmaNq;j!`$-s@{*ti#8FF3roFZyHi&x2nUZ}en6%=Z1^vH0#oL)6~F
z-B%Qo5*{XAy=r&%$K#KB`cC_vZXg>y)36z#AIok@_c<v4g)Clff@41?@RippaL%A@
zWmHVuS9UD;T%6|E<?57RqJU_jqp>5XQxy+X`s#Khf<G~MoVN1TF-v&!SN+il&7SMF
z(U%#)6EVgruP0)ux*I32nOitb##!1IOvYPXcs-e59k_Aox?O0(iNqtMAbVa^$zgK%
zS=~|VWVf<5iIm4LLLAHty$w#fX=n;K?)KmFWP`NcyTs-U-`N63zo>ZbliA@H4sT3I
zIGgB{oqS>TbzXX)+-!b!yz^|qT>k3<w;atfr?`;7uhaPf7mjSoDfcs+D5R*(+FRYr
zl$$GU7C1e3yKQ~ZTv?aOo4NAdlFxGSk2HCUsE_^f#?6K_s~>0Y^n89e$~=T!wq{S_
zu9fgQSM)BfdXEgFs6vef_O9f~x^M4FKF-#kE72ONFS);iZ8*E3Z+-E6BVotfd=pVm
zexaG~kc;B2#j%k27*Xk=^U-}Fv!t6PzQt0d!coinJ8Y&}m9B4z4G(YMkZC;IR<&^X
zP}{_ax=_P{&o`y6iH_Oly%C{WAA-Nh?~d<LpK{yet}cC~vSJ<bCilQ#-woVg|D_*e
zT}So{xXbKm-EbjtFzIlG%$fQZr-uyA6>WMd@;t<&)5Gl2%|}1p;=f!e&UM;RnX%LF
za|75VNk@oSGAR&FzjsGSm;?+;0g81Aak<`0l@BP4KsZ4hXhdm$I}Nybfh%Q3>RFd5
z8l~-O{d$IKt`Ibxce?!>Z~TWo2nUo!S`de<0Dy84)CN9rAwWasasmp1;JBBykYm9D
z(`Dz##aL0=iCF}&q{x4J$8{P)O&JNJ*0Ri62l6Y+kpE+rq2^=VWMvfu(d#;XWf`~w
zNfSo`vgHO4S?;rMHOt)gPk}B8oIZcapAi6eAlhdHw9&31%+)NTLxLNV%YJbwscGrf
zYh6iHMnPdwq1b7-CCM+YsH_T%Ty03otM9WKZ1Yz8k;r?Eon77fgwv-HH+mjF>G{=+
zbPSG+W~}xiy>(-=Z{oPJ;a21wm>T`nip>286hD`FGm*@xB?_UQWPfNSK1Ac#1t|G~
zoDdDGsc^@+?e;iH?>oZ|_xg5r`_{7DV>HjQ93y3XCfbrUn$vwlPu1A6*B%(HBva0N
z1K|osgF^^syrgr5Q_~J4N!8VyRd6tn^O^OL`45GMJW1Dl#n|`xAvgqh_$Xw0@pF3`
z0^|CjYKsB|2(jvV1JhsJF9yQovA1BPsQ_q@-PpibYbrP>t5m&dqB9s&ij8$BPCZP7
z<jHPyzL`e>^ZPz!1@g`gdV-IJtn@(|XQ}(6Xu_FpD74N$7HV#5!VEXYa$#BewI3$C
z(~MSZZN`?~JpGFfq^Ts`dV8?^4Gl+XDfNc~JK!Tg=7#zx5H^HO!a_I&hQ-G_eL=MJ
z!`To{7`Os(gTHOWX{B<l<6y1;M&>bG5=K&70pQr|7GDWS`Kr+NU!uDj3IOup*r{F@
z)gjr#92cbR`AZ>Sgs!0XMI~G+#UQli8YE+`o77O95-ER?W&V>6#By$VI|K3c#SoS8
zgN>eM<Et{!=0^sZ4jDgOyku|?$~r6FJ|joq=%Hi%624d5ga<|3q4|u10v|P!6TDu3
zJbuE$)RjAXLnfXUrO9W{Pe+YRKZ_4ltZF&fo4=4={Ep2u@nB9jKG$B`W9s16kC#No
zh&kwv8MQ*T=$0LWe$qGcD<RjT)pPR#-RC9>c~&4uM(2Ft`Pf|cP!SHV^M!XR?4;xC
zyGA>yo~&ij4%8vsaFqN55fW!3{#KJ~)0jFzQI%)Ei^&6l4KWVfKDzYtEkVGrIb9sd
zRA>t#)k%Obl?BC)097^Z>;<I-r7nL*IY(brteJD>k5AvjiiFU_qTcF}!cF}w6g#Wb
z_<4-{P1EOyGmkADj@e_m$W#_Yw9NI~AhINtU3Su+hZnj1OmAnqlaW&Yeo>52^#*Zk
zYY45l+xxQ&$x^1b=&D&vFT`U>qs#jWrs6{M{DH}Mq=aTBkoVO0nq;bKQji-(+Aqn7
z;o!z%WoWmzR7=R+uWw3Qw|twc7(Bc3?QP9;$+vfRKEM0+o`v1|eZE=n-1mjHgla`@
zu?;JXHZA7dcV0R6jG3kVZ7#*xPj_W(!zEu>X@2-Q^dYLRH0eE~f4J}};}P}SNec{@
z5Jfh{>|%48^2Oub+{cGqQ@(|Q;A0#LY%x2nc{}nbD9lYdXE-M+ip65%nWqcfv94EY
zYvA;r_a_rFaC-WUJW2Bmt2P8Om<XXOis_L!DkG**g9ptbIa_mMcQ9xx9)<qAJcqjF
z^`-Cuy#@!D({=Ilm=29zBwGW(PWj2QYn}{HLQr@%TPB@n)8N>rogvh!-=dVX5bkK4
zB{JC7qEfdI;c6a)B9Jw>-mQ!Vq-D^K5PE4>a;76o*@7)lGzfxtwy&^(z3Qdd(;3su
zJcD3PjdXxSb*VGI8#|!#Q;luy`6BNyH*9qek$d5IEx}2Pe<P7D8H0^u(pw-)9vS2i
zHa_Y#?TiqSSNdhlsnSsj<*7pZUc|N?Ew$N-3)dTV^KFal4bN51Gw60c@*(MISFTER
zd-vHYr%2B^@|F#%`*88)^oz|j#61CMU)?z_zom#>-P1DY5ncB}tqmJ}d9tbEu3R5Q
z{9>H#8g@79;n+;4cI|MG2VWM_fOS97<!RUU=4p<sjj|i1I%tgH-i>DYjr?WvU7KF?
z8I%{=QmZ_xb_g+zrdn$|#8JILdr?yUVUF701`ZjT%nkUYD?ix(pt{|X5N8!<*m;CA
zDb#8%Q*i6Y!8`?xgoDH;p|+aW%?Bz4EpBG+=udC4=(E_wHfba}Jg;lM@VMyMcSHUO
zz^Nu5Pmv;R;(yn6P<<+cTJ`k+uIB)ng1Ojr+uj`aIP-y)lx<4*sj%&OZ(mkBo)kS)
z_t5Iz>o=#qp|^5bxO#tXYu$5gerQ6N!NImsmj~GI2_qRuYmJf3$Q2s6+-7Lgayr(#
zHZEu%b%Q$hpgKQXN(VmC^tn4-HsJURs1G8KB(}R^g#<ppsqP=-+pp5M{x3@3jDum0
z?yaZ40rvcdaXJZ)@6yrWu75RO<FoIxHv!PdY5Ct)RspsiCmA737H0>H$SAn<=}BCM
zt6*%>jpURQBr>EEm<p3``J!Z$gf`DA`Nj~75Z996D6hYB*EW&coP@mhprzG>Cju^j
z=!mwy{x-s;ONi`8&z_f>{VIUuq2cM7Xt)9%B#^m>51PIHNaq45xC(NSL1D#}rz0aU
zzaV&I=%{L|7UJ}iwlhtodVqckFYN5&4mJ9riHNgWpiu%xxODc6RePCHF2hX8%F&?Q
z{u;)cWHnEDm<t1JJ$2bq0c$8IoD%zULcyjX6_SfHJat${f1to}#}gh`kB;)h!%fdF
ztFq|+4vEc$Cezkjw9G?;9TDq`H}%(gg&9!O8#Mh8IGN#YBd@`xY9EZ?aUVSJKPrf#
zG23buHzKv$#7etr`A||Mk&W++lc;DZ3GD})yN~o1Ns9ffOf_+&H*#%b>wU?AqXcZc
z2(FKtka_@M6Cz0v>uWyj;4hrqNnWh|s35MQd><y?E}DdIxgwGFKvRG5pXA$kXWIVz
z_kMi);&7C^OhS9*d-=h1mXl`jf(TATmdHh`I1FeAE&0+=%>|#95f^b3nX)NPnP;U}
zE5u4w)IbFOuR`EXOp={ckHEuCL_pI3S7fAY!frYN+8Hb{mI5T2A7LVIasYnZ`#WVA
z@SNM=*{-ydD!MDedP?SW-rI}=P)wr7Iwx^u%@|@}+n05xWw+oO(dSbBC*<2qX1Gd6
z^VOdbQ!_ge2d2^x#C;u9%(9(FyM2<<HG^QXf~`~X2a4KbhxIuEl-Tp{9uJ<N8`PQS
zk*#71Qi9OT>y|P@IGWc5HB6#io}mr|xUzK#sTTN*L`&gWvwf)oc<!XDws-yYLcDm|
z(wuE?vuRdb6vwS-y7UHnCMR8d)^g%(hVz7|s~6$WR<+i3)uiHYZkcj?eTTJ<vGTMj
z!1AaaR-rL@B!j(~a0Q7M7&RqzvP`ZYN@>Y4W@6f85?mJBW%G)aNX$<aN?YSH17COE
zb?xXNru7eZ=5r&M#Xb3@YVV46EMt@<GhP(G>AQnEI$LV|zRaZ@QWve1e|$Xi{o_0@
zc2Hy0YP+S*rfKo)kmJ$#!kbQe7d3v@#NsDaG9sirJ#kFwm1?q<BIv+02Y;)UQPTO^
z;4maE&gLp)NogpFG-`wp#LA;PWhAUTXea?|g@vgYg6s2L*;<)dK>dos$=PUiEedk)
z1-6xXX))_mJtQ~i{qok&&SA&z(zoH(_r<Oq@BbtDw&`)%s~5c7+qP^Ade7)i^#g^=
zCiC))g1KFi6;~mm*j`?P>awLDCaNilE5_H8%E41c@v$(;0=H{}Ec>Xtb|VnR@>OO_
zOH9~|%>jp_2BB&S>Ie~=)8fW{qnf`;-yO05K8%G6yg47B5S~GB&~FlXHXo?kl_Bu6
zNfA*(hpIzp2w#ClV@f)I$VdmfCm-#?h>iZ%aBhURUag>C=+14Zgu3HjAnZg27#UA{
zL!r`wl-UEtYj7A<GX6lyJn}ImMTu3TsbaHYiu0O};ap9#Ul*ciglsa_piNU`kr`}$
zqti|nLgq77*chW&*?B>v@`$XJdiYTkjV{<C4Yn=N1kZiaeL>+y;T2e|nr$VVNmTy2
z3>!xpBS|Nosw7;)ftH$A;IbG8H#_^;ca@SbgmpR!6D*r0*A78@hd6?i6#nkhF6}>+
zKJO1VMhJPT34=|%DvQzM#v2BumK)iuDUf>@*l(TR{<<cH#ueKA#@9g;p*^Xbtvx!!
z*B5-;+cm6?ZjbwTT?AMW0&s2mA=(R#e5Rw4I~qHlxope}Bhw&3CtHg)Ym9O}ox^i+
z40We%#}31Fsw<bZIMXV!1hmMS+~Fgc>l79=sZ<Xfd5J6^UG^aM3?F|b6}1Hus&sf6
zt>CADR$$mv#(kVUluN~^CoK?Cgio8aX$E+da1X>}oIa8}k5O&bh%9q1KK~p)PJYtI
zDR&2XTy~q4^R***pBaCNpP;RC;6aI*s*L-dti(ItwYHjjOh`{>4Bc&GZWa1uv=h{f
z<Jncj0+M=d=1xxIu?Lv`GBRu{VG=q^uH0VXEhi0BotN}&d9HzxR0CJJo0<5#2~^4R
zM{DHVCh)tGtxs+sMKm6g-X=W579guDS;E~@xaYOvgN=y~Zt{%CiA*01xMkJ5sWz#a
zzuxB*J0ni9`$L<pK!vN#?V7_nOV47kHLf;g4d*v4s?JllSbaL7Fd+{(*K73_KDty8
zC+QL;_%9741k+R-{`)FgZum2JZG?69auK=g@>&C#=~?q|t%~}Xc?bBfj<Bq*Xhw#^
z4P=-r!+w>fx_Bjim8Lp(ikX#{U!a#0R9JE=zqqu#A~7<zvbN5*_-5&;`i2X4E6W;N
z&$1o_rM2}uv`M|*JMj2O$CIIF`&ypAd==<6GCtltG2NC{Gc#BF;_ZBW&caf|y^mjR
zy<h&G+57`&v?~ghlCzF}Cdg?sT%R=t`H^q>>qqZv3KjZb)z#KFChjMumHK*;n%(aB
zZC~M>?WwVjghN)1$-+A8yKfk~jQyFWs>tul(vOup)=^QQ;q=Hu4UPNQZyrfiG`QPw
zD<_9xCE+b5s**LRYF`!qU<Y;hNa&fz_i{FHP7M3aPP_~_<oRFIRM)qie%V!9?ojoa
z<$Gb;=>3f8mHq5Sn^o7<MrHo^d0MZ^bvWi0`-Avn-k()m7(4o_z8%UuccwY)bIX;U
zrGuk|o>x4@kMXw8E?S+Gn7H%llm3gSt5LGP2bULa_hb#``(BZqeYde8YOB+pAO3IO
zKkvA8HRi`p`GA&WxId~vdzkP!j%>f#mNVjKSsG8iO7w-E)A+yUi3SKSmaW(Xy{|=&
zt(S_dkqBB}7Gx7DUnN9x-LgLOSU8OpO^Wc+50<{P?%kJGmpxBZPcp@KE|H_TkJm`W
zv=iFxL@9d`r9%(=6;1Uo4WvoS-Hi|2+<Juh<D6zK9e4!aIc+#%^wpsGu%FwblNmlQ
zzjS6KY^=-AiV-_3krf<h_FBlRZsW$J8>vGDiD~h|a*0{TVVWvGw{W(wxN3H`sI<i}
zDLT=+!??iendPRuYnjj96fiABTrw02XJs<4lqDTXFI%IjbT_@N7_d0~w(_Zc(c3EK
zs7P-0W4?O6nqHC-Uv1A!-O3xInOv<rv$rJzTXjF!w-z7xXjuJj-}0={o4XnxcNJND
zE0md6`e5v-(Ab2ray<*uzLnnOc0axFK**tZp@npDZlRSNB)`~Jv_(FreSc<Gc89+1
z>!Qxwm$}8M2`c92Z?wGVvhP`U|FnE}W8?RT-pkxSZuHSi=0fWXFNaunA!hHaf4KLX
zaayhB%b|*s`dGIVU!~L6=dbKPr1a^r#f=~5u9}YrRXU&AwxlxbRNuXL?9rK&(}TW?
zFFpqzI9>R;<L=A5BjJIf`E~;CX~WhdzK1q$;p34_r=!{UXf%}nCSMf+HUKCfa|6+f
znWhH;q&Ur$4#>uoh1VFO;t>d7lf}o&j#4NnY<8}=4%$EF<=5)iy$#FKVl+U@uj9H+
z;THrHS`jc;2*6^%2(1VSm;gD-)$3EluRvCNC)zyQfSInY13*A|*VP|oM}Wq+!<avT
z_ESI@Vh2P3Ft+f-Toxs~4j-}3l%l^!_ap+~sJv8Z+9-4km2NOV<nZS-)lWo%Q=2CD
zg8{TbhZyyFO`Go)GRhS2Yl>q4rzsM!5yFv|bomM904sV*S6nnEDa{86q>}}RiRl`D
zCgV|XmiwC~`<o{Fn<o34Ci}mQCX+SJz#nRB6sY_6UV-ysTa)<L`5?+t>@Sil<5c=T
zIIiG7I4%wDKXF{4c?P&J#xIV``WMHg40Bw^?=VHzIIb1P$OI>3CWS)B4HT<;F$l_>
ztQfLz+a9`)G1jGtcAeT5D(}yMMKlH~Rw>5RD)tDc1sf3GHN<GZgL*xKjsr=H*Yb^X
z<PNoWSkx);YsuSUd3S0Y(d>=qP?y5+%~#?|`>tGOW}fqP+OuIJ*pXy*Y>UA{Ecw9#
z?Q;Gg@tV0b`#Z@!n)+?)>9spgLadNp6o?I^NbP#*#<6gz$+6e~e_n|!2|dj<$)yHt
zvV*Q!s%6I7SGK0Rym2|FKu(BskK2t)=emm1#t8NWe=4{YndF+kJmQEC2|X8ayHvJT
zE-t>(dK-W3Q=P4-*<1T<{I(R40~MJWy&*ZyTMLVi=$y;e;7G{4X~ENxpi(o+5i?eF
zsQycwTpL94u#~53t6InnM;Cc@X{9dO3OF#5@H9e6ED_nP7C_y6L|sPeNxNm0Wmez2
zD`6^C%j2MXQZ&Et{V~*AYjoblD4#hkHg}U$ji*eetqf#6Ro)h@tR%y!gw_;gSR0Z`
zW4OFo(MO?alxHLFd2Tbh7DTb-3g){_y5L8R#vcsNk4v<=K(kRi0oTYsQC+L$>n~=>
z)W4~&zp1Xjsjk1NuKz2kF3#Jfm;p9P1pdomT$+vKzVnj-YIvI5yh65M3l6%QHOy{`
z0#jX7y^Wa}$VFznP-ZsZTIk2`cI76xvJPcy+H9xhg>Ok^npp55#G7lH)Sj&@M0#~)
ziT{b}%4<~QGh_j|Y!igd7YP6T0pL*WVBhO1RE-13t>JpWevH2P<s2ggslmHC`|*)y
z%+02=9n26F3B>5<pHF047fXLmB_p^#Sa0X-t&_i7itMyuQOmw)a*}kpvV3eV>}w}W
zX1a#8ld}JP%Hv(`7N9;V$-CU`rh6uOYcjy_DOBU;QGs#Ek#cNb(x2XWcX7Q8#eClf
z1HQ<8+!1X#*vFN4qQW+YtuY7K5~zu?%ht~HvI)(fXNuaKI#ZVXNQcOxg~=*zvQt2c
z46p*#&YVXaoj59z!;^ehGHCzGGt)3hVg^pvxS!{`ti7!6f~JL3K>CIzSvltnoYi;U
zQ)P?n)+m3xHLl5d)0@Y)j57#c%HzUn+nyvb1Msh{kc{<OgB8Z39InCsBy05H@hbEl
z&EhOEb1&>2s(sA>UnSp{UhLlQ5Hq15>{y<w{*;gIwoA)F$Ma{}^m??)FGowBP?$?_
zE0m>j3Am_Xw`Vjx4eH_NT;&|~d43A+4V@X4niq;_jUf-rL^sRGLM-*e&!0`-W#B_P
z8`b#+pFAH$iSBC8=d%;uH@?bmy*|VJ(`<Mg=C=+eZ|1p|H{5-2vgC+$iEHdCzok>%
z{Nn85D!pZQaqr+2@#9AqLBfY80^TI+{L8yeYi?2&q<!YF@!ehXs{UW6Luj~UO8w1i
z{UN{lo7eiA*ZTi8ul1z?!%4DcAp{Bc)?pB^#1aC4NH4<C=2?6~cJDNb(15tiCu}w1
zjEvvqO2>wj&(INxNa8jYf`lr`<>!^BE`zLx#sS!zqI=HR_~|`53pdvT7T{E+dPBF=
zsI_m|Q7dv-5}(MQ_;EcT3gH0<Ojwyyh%;L9_#n~NhSC}zh7d%d0GiZ()C`0M>gk9!
zgDxvZM8Wu&Bz`x3E4g$;Js`PVQ_WFS!&+0!?1DBLIIsaECufkYCg%ZncDf#kq(}Y}
zMWqKw|LY%GlZ@#BZb%FW!+%lxnlP2~Hw72oJA+^XfOw+qu`3xNB;Kn7uDe#7A<rXJ
zlXCzr`s5X@yf`Tpmks;Uw8T8G_yTrqL4aZefJ@|6GA{fWK$;V-BgNu0y$BYtDIg69
zFhx^zByN^indO^G{1SXgIOZJ{vO}N%nY*4UK+HD9k-0R5EPPVYwk5)XIhq^*!6_(y
zbBKx0gxE<fLnK~yJ7j-&Ny~hyA7bVv8a&N82p{5-Dep9`D-OM6cz%SuPoMZtrcV#B
zL)P%+_*dDju{Sx$58-Y~O@dVc^-Dsq=uQ=Kb$vLa+|S)ZQ)e$dY;x=L0|DC%m-pYI
zR;6z)?pK4Ztm)o-j!HzwL<a|nS;NY=s3WndaaS*|D&LY1r^TjUiCk5_UCy(N(XK4I
zK(Mw(1XxvTvT8hj&Hl?x8p+*FM_1)<by>`7S`T}VaD~C6|CeCksYKP#u!Fc=y)~~x
zVbAl~!-7P1cH-py)Wwe=>`Rs)_1I=VG)JzHWqTSAgYekrw@#o(k}kx}fl)-@0N~a*
z+3Jm>s1yC5M+P)B#V-8XXrmGBhWD}g()lTc9bEVeutu&Sd%q)Ty*zOn`H`vBV)7ob
z3kH-v{mU-<j_KIbkl4$%XCF*b!qd?QT1&=Q8k<YV|7<&dou%ZzpQUdq)zRJX=8*&m
zt_dpDdJDe8(|C*YZVaHL@4NnL{x(vk4L(we&%=vlo3+tb{28k{3U@}>`ClrE@N4#B
z-m4mlxRjHA+*A@WHOHLCdsRQ-oqNlO;OvYDEv?qs|64s#RZ|TgpDC=JXlnY0ZX&X)
zTAZ!Cob|M6?bHTeP0zfZeKXf&y8mtJ?~4|_a81Ysfht&fE6o6??L?sgI}v?->b(uZ
zTNJDYtRwu{#Yap?6B-T0fL#?g+!oZtK)Yb%W!N@^GUMdOt$4_b2Ae_@M_oimSQ?wS
zHFl1xS|fo>SNb_sAx->-KMB3{zzR%iZ~3=V`eg!xPbrJXfAS9rrnnl2En5?MzjPN_
zouGLYsXu)GZRM<+5FU-?7N@NWz4hQc0T9vH;0V|R=IQ|OVq_r*5R+gX$}tC2JeeP$
z@?jI0fdhxOcywCDox8aXJUS>KdatE5%z;ZMlhpRG*UJH?Edrpvp=W238#I~h&-EoH
zCMU;cj0ypc&;&hrttBB&#G>&+f_T2gpE_=;kOFfwjmU+OGC?p|=~~jF7j}98O^OB=
zJ5V2PGi?hpI2y<|qu-yt%|%-_-YTR-h|Z;b=XSF2O@CbriL-sf%Pw||RyPu6p5$!o
z*Mbw4=j+w4*ti)J%~$AQ_?T}eflEYxhH3Bo_*S^Q@l)$aC>Uq`Xp8rJ2Lj8{8C;O^
ztreM_A3fFkqH`L-K(mvZ$Bq6Z^wx7%5HqS;wDI>xVg#&$)oZu$5nxJeSLaZ<)4G9p
zdT8@(#c65j9kHFRqm^f*Ib?R$jL?VQzQXcrbClAwoJMZ#G`3W5qMV*c?G|JBKF<Z?
z6Y)=SeMS0Vn_7J2#Jgt=nqv>!FHema|9Jf`FJLvcTmRG8rp<Z&7V)cJ6O#We;$PJm
zt%>+kQ{P_ww5l=E=KU4ltE(ELGppgfh82&7HAaViMVCxWS)Goe5;ghBsEESy3ML#|
zK+dSVd+#zFTe9f=mR5HzZ3zgF+Ist(ab+Up?Eax=#{kcjSoY_gzP@8qjc{O50D3U>
z&%jPka{}HU*9dk`ryIaJBfv9vRNoGH>k20YCp2S2-x4S!>|4sP*QbY*AMS2ak+E%y
z9SVIQ#Y4z3vJ>;DL@bOx>AZ1&kM2y94d`i2tCX1uWj1Ki!zi(twv^ZD207I2ryAzd
z=?qR@ih4xHL1qA(=ywIcol!JI;R3``mWIC)c;C};ciiTHnc?B-*}K04O=IuG{wd<W
zzP`4FdFzk#W~cM=JIa3@G}q=lWvs@AAa-b*CLOM;jE+hyx2qYctBS_Nk*uthpH-da
z!Y5%YSsB&upTOCzRGIeieE%dx_3Cl8T-w;-$o|}y-m9^V^o3&!HI6=Ncb}R!zVhZ@
zVhf<ZWBdPVY@xqn`~Tj%T{BkcfeAP#8~<lHIq!c`Z!gnUEf2<iL2$jj6cPdJK5e36
zVbgW6V`6ejYFuhYW@tKWtn$gpFDgD$c(e5OiCblrRi+Mn)v)dpHeEL~HZ{Y#&sEcP
zS9j0D-oE}v1F-4(>Cm(1!!KUGf=$=s2PCE@W)2=c`ugp=_wx%rQ%e$ypUJ=Lz^C~J
zBLHYLKdd^Afu(3*i9!e(t#n=t3ec3Jk%^^Jbr@}R02X?s)!1}!w5QfQFOX6a2r$wc
zL-LChq39Ry<fNfSyitPlg?iWWgb;wJKoOx$-sBP|lVsBYY+$YnZ_#kiO{Wv?s0+z@
z5h;k9r&O*@OacZd6&DECe)G0T<ANr>_oJ?RUgF&smToeBJo8nY(u#gxK>xhTUGACl
zLL*)`7}4BHma+=fZYmgbd)3GAZc-qYL&igYTaxm2c3zc%lR(Pvjq|T;-(&>#oiqAC
zQSfNk*;sIlR%#6~M%uHC()Qi0`#7V$>-dTIAHx^ky?k@!knXwQ&kJp3S=d{?SIXYK
z8#*1uWqgOZxD@1>mUiFw+t21?thIv1pC%y5aL}8<?!O8;-`9eDzr?;O>o8##|8UyF
zZn}RIV%TZ_OYFPmb6Evh5o==Ki@dS%=Qsgh0vz--Sf;e*w9kiqF2y%XZml})VV_HN
zO>JGh-9d>vY1X!^)u5Z+yVn-=JCOIg!dI*L5LWz2_#dVGRT%2!Y8`+4I%utmk1qzT
z)$p&JyUB|%nC65yB!lxHMlIYr>CXq8X&{~wlAMBn0U;wH;P+(&YNR9Z3RcuogOe%7
zyh^9GF>Qje$e}7oe<bE%pr?-(iAJP8YVy0h8@lpT#aN%7O(X6h;6HLvytKa@eEVor
zygquV>eD5W2Eic6_M3i<prn5QLjTb_8|LObYOQynwO21iGsy7b!n4~7HvUQ&vJ~##
z2l)H!BxM4M?4~Hj^>o(0$ZomkmlbFD@V-AaSjk}W{~!{M8`haBD677PA<_Qz@F$Mb
z3gAdsaRW$@EY1l~bT|?QD8Q$U$B0H<PrNGTC7zU)?kO6Yk&|mrV&oMSAMqB}=HnK-
zSy`n^0N7MA|D|eHwHOj033xA_hR&O$i<e`&`isOx6CORa;vE`J59xaWKfj5|sb5XO
z+Vfldu=MfM=P%1&zkUDla|Iyr9tS3yC>O1pNmgy88BIIU?0aN(K>mIRtdy66s^ajr
z-F04`6Br7#nE<!>LPHU>Har>UYPa(y#LWdLy_q{rgrjS92ECLnQzo<kaAhcIDVQOH
zuNfvnOzM1(pCos=?q+^A$X_2SxiSw%DG*v{i!7+-H_K!TnHQq1Yxbw__Ts5HR%tU$
z#FA00#ZvP0@uLz;vU~?dN;j)gSJX;84c2p~#U47Z#&~RRZxJEQH=!`HZ4=v0X}eM?
ztMs*5?feAv{h2xc8niBrxbSwrz<QV9HlWRTl`bw@#?nBV0*&aCi}S`Rv@`u0zaHew
zkl3GT(qu68KZ~ZI`R1!Fs~ap-lDgl*(cIfO`tgqM{mr~Td|-fkmc|GQ_74mRk8lr*
zjE*@O#*9t4Zs--Cn38IDE;%hLHp3x1KQ*&p^<5e9mX?RWkFElKSO0Y~Z7q6s$J%x+
zno;K_>wmwwyqWUVH}?@MzF4vL=2lbZIRWU(TI#$-F8Y-^AKGmCl{#-f_TLKu*O@lF
zhB^ls6=RI1XbO9?2VO5L>*t05PH33GiVnv{<FI&Hma7I-l2i$dOAkJz1WJk%2I{e7
zsNYCbj`KXwWSMcXuRng!lPj5tIJrB*ymtGU4UvQpYmcykCT)ftx&Hw}MN^m)`N=j$
zK~WRKj&8=MHmAQdF9}<B@E1@nBkS4Q*)(Fd5h&VEhi4#w5Kwjef=l1vq%A(Pvt+{?
z&#bjY93#(EGX4Zrlfm@=EJ}Z8zyI~@H}iiGiNCYo|J~V-3VHz%I=G4|SYdvUoS#%^
z$ob#<dtmD37pgeG4)hg~MAtj3*$+k)M>)u)kTBq@Swj^^i2%n9@U*r4J%_OXAjKlC
z!TWn$-2l(^RaCK`lZnoNEkq$g0L=!t3Sd-mTpR_2NDypRg`uPg0cewXiW}NH3IwBL
zbuN~6{s$=eU)8dqJvfwpX%q@6FvDi`B_mx+MM73a);b*u3gp`6wmecukb#7hL%Vn&
zZ5lgSJzR=*KD$#^0!M2*sZFP=ZFN^mM6vvPR?-g4wxJ9M*n)O$){vLSn}cA2khHE>
zi}G|SQXFLgMk@+?IFV9{R1gw-D21dJpK<9^UJ!@s^Gs7I!5P^q&;Qz^?{a42q!*U=
zI4pj4KN^VKoppnzp+QG-mxb;bGzBunMcu+l3`u}fyxq<{f7otQ=kU0Q`~vK)J~;BK
zOC(xYuy%)&&Yn57@$aI3@gl|+*lMSYBJ^|0wyrDekpEGSiV%sd-UAF%CSmEoeZGnh
z9IeQ}$a`1oe`XtgoPM=EUf6Vmh7$K8`^CL&758T=!IBvR`l^xvkMx6W{0%nOaM>sc
z9RD)9RUoo0Bk1|>3c1#9P{D2ZjyU}l^7JrFvEYl%)HMCWVJ)!@Ao>uhFbN7*NUR`8
z97Qm1t|3n|BH+@3ATj?{<mpOs(sZ$6uI_j;z<H4`3*3N_rypM+8A9g374oDwgmU4$
z1tU-RZeW1OEgrlu7v^kjYmFedQ*{~DiD>JuLIUpYP98DwM=xF`U9NmJJ`r)5fAaOL
zXZo9W@9o~se^@eG{P<<r;PclXKfeD&^gnmkNN@1R@ye~?ogkvLVY2>hc*m2_Hs|5C
z+gYtqWUbJp4;eDiF%r6k;cgm`|26U+ZB|)XZY+XK&hC<?`FF3R87c!@>8RFLJSA3Y
zBZG_pMuu5DiYnI814U$CI+ONs7K`n~v*z$iNDL9pBP3!}l^f(Bq>2L3d1t!0>V<I8
zfKvP-uA`9iwdc&OzuM#QTOdFEF#SXZ;Rn@^P9>T~u7}+&0Vp&<d4v^Td7sM}!qF}~
zsbZam@ZP{Ez3RQU!~j_=lf?=g{~-X4V1A6aZ-2~Xh-Y2!{N&xI#PSepn7!y-&*>!_
zvgO&bw^$*EbvpU^Wgn8;o8!I`X+azh&p*+-x=ec@LC3AnAMqoo%#8RGb!A5xd=`$Q
z0Ydiqqk$ydNzY?JRo4SWf@R{bXE?7<)bBtE$-*XI?&7>L+1j^HFrM3-7YC$-y3iVt
zH;6Q8wFgk50aDuw0Nj-DGVYLeK6iR-6yN%0ECfb)<D$q4Pqw<BU&aBR^z0`H+dYc}
z1VLTPJSm*E9kT2cq6#KQx%AroLf&hG8!Cu`Z({gg-^80o;!?1gt~9Tb-`mCxcEjVb
zQjVE5GBOXg@*$rUZ@LI$HAcWbVZjrcL_iE&H9Xpj3kmRD;);b0kEvQDoJ$r+N`uKr
z4-~-i2nccH6v91_xd=dN6V|-`TD6E!A?RLXM`u17pg7o|v$<VQ2BXC?T{yTS;B8|J
zanaDR{|b4N^h^Jnn^@!{beLhMAI{HbOkUKW`^5@vQ~##Wj0i?5C<=gRn>NG>*yMi1
z!){iK2E-UgCKPxX-3f-9rAFAs^1Ac+H(pb!V?V9K1>v50Sf9>5oOFDzBCr88%uyab
zJ1=YCaAdzAC`GpvcE8wvS_&Y^8UD5Rx!a{maE^a$6j^@%xP$HLaTaXVfN!E!n7Bz@
z#p_4;W<|%l>nhdC<xT1?T-1P&6%tbU$sFf4pptf@=SSaeIYi@-cy@ry8O4n_M@_t6
zzKdM2bn%>qe$CH!{zw&cuiMoKNSls2+FJC1g+~Sf^T%o5dQacH07fUnI*(q_fA0Jh
zEej_q0mqU5a1%vvM*}MKty!m5lGl9`4NUQ&Xduu+y#PB#S8d16R5k>H$%2{?Ysh7)
z;UX$qHcL{12pZkAWUX14UG_)>2;$$#7QIJqh|LVj_R5G2z_EDG@@ZR(#W9xLXjo~;
zc3nb%M`;TnOlSxt2D<jzic-p)a67gA1g<4V`3P?Ki)~}D;ZaKURF<t{n`HJi3w%_N
z+7bK%_*JlUP}a_BI$>ukVzTp1Ksx0>D{TZ<NF`cxl6N+K)rMb1`e1z3mfK?7d!7uv
z;Q=COmTQw7o#u6}Az_Y(kr?n2@o-B69ziH|v#Qkh+0k(E+*0#qUeWnKk7j?phlv05
zJ){+Xa{rx~OU_nLu2t_m$E7vvlF3_Y)G8-n>u{L9y8Gg?KO+Rr%r0T!Ot^X<@X<_M
z<pjuXZfRNBkug>|1%<S{qLNz|Zot;1-<-gI-Mjpg2>Mg?HZO~PKf;ga)t12HKa2^(
zgB*$_I8RHfL6DUQhhaCEhAWYx-pfa(1O<(#ejitImC$v?@%UM*&X4cF192am0!u~}
zzSsm0YbU0WHi04p(i>t>D`;VHnB;lXiw0`DxB;M0`m~Thdj>_(#B%Mw+t>B=CSvfG
zbyFxjL~*H$vCmVy!>qdbyxMiVBgLq?<i$TW?5N$a`*G6~zS-syQcp#T*(Fh1@Mu@-
zWFsUEi0+xorW}U7V>l@=|8%EdA0%jWNI*)%vxJNDx&Us*`w5mn#>?m%)K_idGE#KK
zk^4UvaS^}-N)lqZjF&`aikG=d{q^pPBCbtdKP1^Oy<5s(|Ln!$+3-S+tc;64_DIY<
z;WI;we3BrWp;__R+mJ`P1bnX%4r}+C>(hB|V0p^24HwAcZ5gZ!^*%`rKBF23+45;K
zMM6DfF4C}vy(am>Jw1qz0YR2!ep>ZO1D$4KDwHiI?m`<q$|-h9&qY`5FE{MiAK4JO
z6YaB@2yfr3>TR{><F!tQx5a5w#&4M7WP#bXF}4Sef;JQ@ZC^DFN)Xv=(mKOfnZm&8
z-)(c`p>Rr$#>B3-5z_(2@lHHA)Bx}KwDqQO0`;4z&OAnvEY^YRH=VUzc$-_ULHPE<
zW=zbVjWSeF4kvr(zrNflz9l*?e@vcSie=X~M`>!T5ngw0K*T*->@x~$gqJy*EUd*2
z9Q{@auQNn=)Gh&IkSN%fm#j~^;N|U-lAV)F!v&Coz4Ktg>jWR*ibLLp2`^(9f_QV@
zKGft@-%>{)!yx4L8VK=eeOxLCI_gkx1O8;B1O_2>00tqWZ|0&J-p()3_!s|`W*HcC
zPS>~`yyX|o^4G9~WKfpf?%CAuxU=1@9gQZ0UI}*1%`sWWAde`@(3)V_p}Ph<nv`JJ
z!9xc?0|m0K8Rn>fSo4BzihhmUM}Pmb=+N_bmmy>@g3U2Rtg|1vgFr&$+jcG@k)XW-
zfiwCnQ&p%HZ!-Jmsp6m3NB!Z;v)QzF*EJX&XxnD!aDAsp!cT!iwfG>%yw;I(FHqNW
zHkVp~0P%Y-M~~eAxNI#xp{JDZ66?WilBnHTtGb5$(39MXp7%#FiF{I)lO^xpL0pGs
zu1Md%)l>r!_&lC>_(}vlf5{x2p0+`{cZbdmK0Nf5?Jtu3Z`fgT;Q5*BuIx^^m*DkL
z{Fy4EA<4!xIs#21Lf*3RZa2V-WI^eTR2x6KRrGKh8`MXqJapaT+z+_L?Y13{j_lpR
zIKQI!y3P6;3eff+Q1hc%cDKdlNKX@DpCC@CHF6*bu3F}aVLsa%4!sbv#@&c=Dg86z
z*a-q*5#9CGOUMefMaT*8<Fo$QZ~Bk^$Z#9*>qn@1{W6Evze-1tPg;TC`PKcV-}+$O
zs|(+`t84v{1Ib3m&S0%S3dXsUF9=*;WnC@#{9xpp1+%Uh@U^q!ya{Jm-!<f04fjXK
z1wmZ{Otn+t%hvu+s@+tK3x~!M#h;FjofYW>h-S?Ao4I3nKp>GtJNe&!{$eI9IHE%*
zE+g=EV~{@@{~p6(6&&Ti-j>L(l&l&_5oQxmP*%{nJ-(d-91w0_*O%4qNJcL;5ozP?
z2@fZTj!ZJBi&1dLyqPCb{8wPT#VpCWt0~Y|`<FTNQ64qRFvYO4@Nto4x$}z-c)#iI
z3|l-@?)a$iSm(cGSm$NdMS~M}EdoY1E<$Y9Mb<bUg|YUo(Lyw(ccZPt{K*2q?<?yu
zvpAp^s^OJ1aY+u*o(#O?c2^GgcS{{My28)iEbrpuzBRr(5DGqax72{j9Hm38cODbI
z-R&8xop6cYE{cUSes*u#%bqQd#sAoE>QnT1D(G1)b8WxrKUOS!c=PJv{i~J3hG0fQ
zMNpQ-IxC^A&`cZE#x&T%-f1p>35dwTNX%(M0i!6t6+q2C?-g+p>9KxHPe<QX>MSSG
zjCFR?z7G)QybKu^uBbUq*Aa3h0_UBYA2hbyqmv=96|>x>uukMQ`#!_}bcb1;q;+DU
zzBTZ+c>PHbHt+p`YE&By+OaCBTH!!>*2!QSR64B@mcjO{4QuP-$UtCR(jBFP0PRI~
zoW2|;_qsX{h;(oZ4F)li`WmS9p<ng3V7*ugyR!?E^s$`;7Hikz_Cg%?O6quiNvP1e
z*EaFc4gIkDBLCQ7_GfeGnL`<8-vlJNcyD@FGgy<jq4uCL?F1e1LVHB6&T=VapKwCs
zCN#j48hLP<Lq=#we<(Kp{sHB51{Tnmat-_Q^BF=-N(3E)8<0Xq^L{coxpl8CLC3Rp
zsD{=`wPXOKz%hL{-p%`ZZPj9L5*}a*ekcC5esd@Af!|!#KNEihcjIK+Kjb89oJ52O
zh$#8BQ+P@E!$|(0CLK{JvI?t=EaL*a<RV~o(s3{-Bof}}6~K&x`%Slm8!#tvI3*)H
z$4??(r@%Zbx8#<`Z%7gqTv~s}8HObiS^{KjZS>vt4y#`kq@uX4^U0w39~Gqa>G*^(
ziPhL#GdcIx64yiSYkv3f(|)*oyhMKfxuUHOFXrfiSpGkSXkRj+46TcTK;B0``UR|6
zl3VRJPm;~ahc1zpUuy+nad;AKgr41LBC-VmdtPXe%~tn)2LO$JV};`f^EIhZwuy)N
ztb+TPAubL}5RffCX}Fz;MQty)cu_cwggvV=mMmgm(a<iWt1s27>I{iv+wSy6BJ1Xh
z9cbEieIkWbRZr{mU>zxk>xLn6)4MSnt<DGk*c<rIe)Hc@{+q$llbxw1^;K`5*SL3L
z3h;SnqsnqU>pxzeSbgXG5<_!|OvlEAa|10Lj2*81yHd4Ew$$r+J)FAq{`$ESG~e-^
zco|&dNF`J1k)CNA@dj!Yq$#XFVb~lp;j`WBs+rX_?wvrtx8WqpV&b^JC>#2Zep6F-
zf8bB;@)cANIS@|#GVzXMA+ovoW3VB6W-QEeUWE~^5a>on5c2sO<hRH76Htxn(lpWC
zfrvvu)Mp-z)`>^J#5PIgU~I<x4vMOIOg|CFV`tET<s2}lojdNl2$9h;>0F7YEXEoR
z3As`e+|O8)S?t%;2dwL!7Ce1%T0W-7(*D>fyt>w8b|#CdEB6{k`OXF0%Eyy}P#704
z0UsA<xmGNn43!3PxDpHVoqf`$jJLA^T#=g{AB#tv5kk6o&I^r*T|;Yk?s0Phg1{#1
zZItZM)}0VDv7r3ampJ+nK5g2%N_zzmZzUl!CRpv@;o1iX^Vj0YwT`ayv&O8lFx`{Q
zRRSq@92mk|?|uLD=KXzum7iy!1YPDEa2w#gfqeTq75I|9zs@)Fr6Eo{Fj=jVayn$e
z7QH)$kE+R{5DhWfi`KMV$F2eVL*||-;ZCuQ(zTyg4X@+wezNOB`V%w&(c7d)j%s;!
z%WM0Q3u<ZoTeR9)hxFydrcgFd>_7^Y{kBHWpJ$Rg!G8Fq_WkpvMm2?ID&3Kl(Tb4r
zEB?(Mu5I`<);$73M-dbuUBE2+B@X&N$V()^9~ISP1H#^G)iJ^r2Smui01K$(E0L@H
zc$&>QDiH`lY_WhneRXycDpE+sBFStJ`5a&A>LB_s5-AP{WFD{&h&8~~@g~6)7>fc<
z1f~xjM0@iCnz$yK#`Ox8#~ptFa9W&np*a|$X~mms3WC}%@FeWN@5i-5*C1M~tXUzv
zfGDRkLE+CEJ`d})GghSV{qv-{fCD!q9XN@{l5%L0+kvlAN+^R*O%g&VXC>+VUb#mL
zk;bZM_TVN%9ZV#z(y5*d561{})uksw(ib7-Km;F1XSZfQcN9DiG|nH0=Av)oBuGSV
zgBMstJtAnw_&9LzN<n}*{*+5`x+fvn1GjV@(5~dYE<XGib;c#rd++65((<R??IpYl
zuDh*^&c#T?_%En$?xkzA8tIZ<ZFbV?#Z`o&_8o9XzPVVN*E~-{dM#{>y$Vi32#=-p
z8)Vb5YYT|hs^i}MA9ZA>C5-lPFKAGaWp)GJPJJ<CBeXH%@d>U>zSe^hc9q8jILysf
zGISicOJ5#4eI=Mj-Se13rXhVd)5c~~=ET!ucOL}zD<&D(N*n&5F`q`t)?!4N+5!c^
z-ufcK{n+0Ns1=f8#GOWxROv!2avW)+b@(OGr;EY~qNk`S-sh>hxw`FZTd1$q*z1xg
zJh;>DWd@XW@UFOqi<izS1Ahq;udHqvZbZW^my{H3hEk@5NgUc~Xo|gn=w*pIA2Bq&
z@c*&*Chk!Ff8YOk&Tb3_W8cP>HBpkSnz3(*$QBw)_N@>}HDf1ajUtVGNg{<xHP(>O
zPN{5JTWHnlK1ciK^Z8!i`}ezkzvI5{>+%P59397aKabb>dOe?yr&Yuc!sqYk1o^q@
zbN77aPB%?f&DAu&o1Htuh(OS3J5Y0GG+klY^17>v30cv-o47~Cb*jlO=dL=+>cu&@
z%$X%fM%7j~UZ!KBoF+7HFO40Z(Of5qSuYV&LM<C>I;P{iYn}?4oOm#Pg!Q?cd6kZ4
zh%vgb;ge}I7QN2nJK?j9%ekYb+EU~<biy|PQP|pN4R6Y{<GFEoK^pA-MMr}ee05j?
zFgauvuL%0h(>$6N9no@_W|f+o?r(Mo-`+cI$9rc_B#{F^5=_tYiw#(j#FYZJ#6j*>
z23hG&5}QF`CnnwOo=^16{@XfUHr~VGQ>WiQj(q?8{Szu$X>lZmFJN)hsXDodlZ!v7
z&g`{MO8CTTu>$vu!_oAnu~@ePjk=6OeIKS2`Lr}gb5EvfJ}nFr)tKqFVc&mf{UN12
zTW{9?EmYk6q-xFM#qnz!p1hwc*$N4gg+Z<COdz<;xHZ1`rdja`33Eo4S;C?QU55Z~
zjf>mLrX%!H{9srd@TOTEw!`Gr*2$a-Ta5p)hukp!+H(3Xb5ZUlLDyR-t><|0Z~oKe
zwV(#D0g|EF-(=`l34zIJ!SC+w>hEhoueoKD_Y1v<Zyv=UHcB{&4+d~YFxMc7p1vqO
zZUCJG4Gh_dzIZ+1fTPSKhP5w`e$b&p$Qn`LyHi&r{}g162=`q!fI}X|tCYx+We+%m
zSwi3o_rvwWMW7ObE5*2gG@<*CpH%wtwhP@EnVQZXn|by;Y3{|stG&GVN3VZ7$p1}-
zW<QX2V>&o^6-<WhDx;!YsDvh1A(@Owm6f&!=oE|+jGvs}n{~EKoC9J_ekNktFE6PH
z_+jrxQ>7B<Xdv=KT5!c}Et#v3OJAItPj4#l*-{KLqBzhfsu6yq%^17mc7cHM2nQU$
z6S~Y(%uhd34qTW1AjphVe2IEGjVq*z3g9_l3I$^zkWi$PX6a-mU~(%{Cj?pXk88m{
z28OxEH!d~4e8SkWQ?W=TT=z(fqP&-PvrC+l3OV`kon{wWu@V}2wQFNUi&-LBna$$<
z2Hw?<&EaBAEM+11-jv3D+@6;iMRs7a@8hYhM0_`o9s~nZmbM8!#6re|B1iQY>Rr}`
znfSbfuz?+&UKS!4Vq)XckQ{ObrW17|1p!;1D*guNarc09JDQKmxE_ZCEkOMaVO>ex
zeknW~aQj(TU(j}IdWsNwSW-%p6OWhV7tN}7*XmSN-lfa0&7jGCbQ0i5-*%_CBxlBq
z4xrqBl@JtwlZW4R%&_m#i>%E*@j-j40DpVoSbr$_dEp8AYwCMfU_$>UH6`KeEm4E<
zc0O<IMH<jwx`4Bz0O&n}N22jbnjCR}mzR&WL`IX3mckWz1^-7p8%}Ky3z-L?uUi02
zXml=aSqETXR4^2k*XxM$yFjxOk-ubyQgP1ej=7~2Es5f_pm;Z2527;E>ZqqygK0*T
zB@ktEe8&wy<-q*WOFbddR5W3`{>!z<XSV?R_}IoXYebUg3?NDv^*Q6R9*g2n(D2^~
zE<ZSEud0HRa-Q{gj8qOcDi@D>hS2Ugq6>$R6~Tf@5rfnH!Db&tZ|LQv&y*P#k5<yQ
z+$PIoI2)`KiYlreu=5INQ-J8b4M`jqI}8Npv`s?igYI}*-%t~|d1dwc;gI_`9v<AA
zS=X7l?@t+u>mOP>c0rawYUY$3SvRilhz1SFEVa^44MTXK4>JB}-YFxqSW>G|<|afa
zxhgfLYSqPpa(Dn?zH9B27~P&EgzPboK~K9fT0CMuDg}x`V;%MR6*$b@sS`8&`EMlz
z!B-dGaPd>a7QdAcG`{@$Y5v-p%>kKKTR%;|o;tJi_4E6eP^k)z4xo(~uvPw%Hx!<H
zz;!VWJEcT$GpMi#9x&1}a8suy<AL=xE}v;%ml{bR!DvC|$$3*uiU#M0B*tNt3+54K
zAY(Ezo;vO2weGf6kN$(S?8!n_5J$Q{b=>e0%RnC+O4j*piE0cK-uNx~t_X?SyMG~W
zq8n19U3S-fo3WJgE-z<t0EwyPo5xFC#E5u%)5h@Sn}-JyaMBS-ievh|V%dDz`KTGp
zHJGy~Hh^h-Issj1E1<B64?LH7p^X+zNMZU@tVMiFbsC!?v!Bs&cqakb*+0<6?o-5C
zdvkE;gxIjK@UYl}vGH^+tROE762mn*@p7KlRTRMTVqx*aE&xa6gArFv3mFYSg(ff#
zf@9YJ3q()^s7?24i}dk436U6J>_Nv7gfxBz(2?lMMDR6z8i)mYay|goBa<xvfL0E^
zA_PGDk);B-(X8<C)39g@v>G&H-DpD<nlU#JcY9#~Z<WuDU0~F$)8BTyf89V_;u*$Y
z(wV>YXh%s@RI-keEM8788m1n}%~}VLTGEh2OjGo0i`}k}lE!?ZquOoV1r!ww03CS3
z02)Xb##n^7s!NCi3_P*L8=vO%`Yu3vN&|^ph(#bi>P0);nMMJ0N+^KEk^Ws@mB-`q
zVC*JO@+{fPV892z@;S1Ex463JktcbADhaGb_kKVgmuIZ2&|ennU)?+o7TP)!wuh(h
zggq)<qPhu2Wr08jTY9#Rc+`ZMmyY9I@u-pZ+)-nW#70Ztrhpf_=4|b{aYN4RT%H8h
zK5o*+&CYrbUbeeBh?~CxZzN0z&+0gX*nDL4bTnKHNH*&0?T+C&w`6e#s~x*Xr0m;0
z!D%#4qf1A}u#hv1H5MjBqvfC8-IgTNt(UpQ1s1`%brYCfTzJV*HrCSUK!>afC!Wg6
zW4>B*MoDdb?Tj(MHjqr%a!@d(cx#AsWn~9bHmf^-%vcvSde~|vf+}vtH>a+1O*~Aa
zy4F6ZUgQU?B!sr4_>b`;rTsLo8>fxpyico}j>X+=cwqg3kv-xwE}i?-CwgfW;8P~F
zB|rEgYf8bZdvnK=FFnxe{V_n!mtCp%V%!!C;7^lksi3x!<b(j*)oo{$*K%&)NHMNc
zRCR%1!+HVQtmufCsPeA5$brsf*l@Y*?X?V(-VR~bKv+0~&0p<$6b59&@HzKagjlQv
z*z^Eur(W3D9mW>J)o<@u+xowS_{OK--g69l{`Nj4e)YRS_Z<IsLtf>l_tsuiYF6X9
z62brK;ZEHC{=|?Yg?@*7Cs(7+aU+SRpHL{QQ4KNiH~lLUqs5gjq(tvl!o*&Qepx-&
z@F`UT5=%y1b*q+zkne!WnN3xpK<I>(b)P0b_tj;-@#CeVnGIWa-z~lHC*PRWIbn7_
zN~Lxi0;{^Cc^y86`#4Z6+P?$(5T<1A?&1&^f|>M-Y)T@>?u<DeTD3VH63UT=c`=3q
zuy*|7OR^Au5QFn@*C&Rh4}_BKS`#^Md=l>`A^Kipo`z4RBV>$PunzN4{JnJ4hQ*6d
zW4FRk3=#BqzVQ!mi-SSLY_!;-<4?%rPjJh*W9W3W4kv0MLH1Jqr&UxaE2s$541S_r
zv736A<&28dsK9L~qi*LOW7idZ4BrEXZDBieAblbEqaeRJ;NBmOX^Qt&FWPjMDhL<2
zz_L>aN{6cjLI2A<;4>GBgx(a3A^#zl;*eZIAOC+Xo%k<^gC7-}dp7nWW0?rQ08Ebj
zNC-Y=(ViIHa&A3$yNj136*^*b!r1fGr<YSfBdqa2J6xRK*;3f}mN|$A?(b@{fN=0@
zAujxU?F$G8Z>cSt0FiLfONr{y*p01FN0l0!!saBHbwaPytoU(=^vIN^p<=1e>JQBH
zTdH}0h}JE#kQpmI!$~1k1bvD$)N_6nnTBFz!4lK(VKqBFQ1GUiPmS}d0UX5%4@eY_
zUTehRjl+SnyBzQdjxh4#Sx*y4$h%73)q5LrC4>MA^XGhxS)~qA>}SvW>jCoBrmvqj
z1ZrL8Ql4H<dHZraOrEqOm?HUVDn#2)nH};*&s75|t$j|($dpHaFQgj3zUG#>(Sg48
zQ%f~;;<+@%N|r(zY-Tzv4++RZS8*bqn67k8AUqF3#N!9h{#0te&;g_Hr5%QX)PZXt
zP@*R2Ci=L{)Mpuo%aVYBMaw-X1A#gbCMO;-PgB})$Lk?rOk)6;%3UB3s#CDn-J>wY
z^{D%nE4&UuCOnKm!|fL*TXaQOIO7jHT`_Q_@lm$@?-o+YO1&StKU4%;n94nXmBq*z
z3#7palG#osw~R&lFpQEQ&8K%9j_uZP0L-q~-*?*g{Oz<wjyeV=dGwaRAjLiOPW;}z
z5@q~uCCfP6<c8uC)>yKDJ%NjXkqI%7ZTG0hhL#A5KbSdrpd>we73Ri00XqKFd4naJ
zHOPAcc?ZtzbJ!MesgiuU8IIf_40McMHz{_M<=Ybc^(+?%+SA0HP9fuq4B%`zS!`%$
zKxp@BVDrL>V7^mpTX;m6G{5CpFc!!c>uE8PcPLe4&8$4F6C_x#OjlB$z0p#FRXSza
z^=fs0{2f7jjUIaZRK-K-1J~=iQMJ{#8}+nS-(~o*k{azEt_`^0biXxV(EX6dY|pOf
zpE%sCqkADld~2s5%3Ui=LQ93TfYM^Wyg^!F^gY?*9=myW0KXlHT$5xA;c(HFLLa2W
z)R%F%z{1lLIO4-}`qn+gfa-yH*O@FPB7S2)cZ8IP#g!%IpqsY%EWt=-!|yowe*%Sk
zDm(jlNNDsGUW_sPg?n8fR;PSiE4?01CFEV<+7!$S47}Xn^5!&=<h;aXx}$kBw}sWc
zrF_bI{IDs}Gdk;DlUn*kCKH#mv*^ksSA6a0HaB16M9uk2pu{Lu)G=yA=Nl8Z*Gmwa
z0wl!zm5J*jBABhh<v|0_LQLFY+ty4Hk$9j2iwh)B*&<17<S3WJ_%y9Amus!Q9CvB#
z<7wk~1_H>D$G~=U6s%d?UgZr{SD8UGi^0Z<QBgDIoSl4SwQ`3ibdLTL6Sv)*V<(e|
ztDK&e{6`_x45^*(g?Lil-#J$%yV4c>CM2DVuSZEM$1!K#$GqV2_5q@&1_^DPOTSwk
z5GEr9SnKH4^BgqC?1X`BCS4sUZ%mvcj1Q1~r-J~b^^Q?p5(gJhf|m!xF%+uq@#${M
z1DpUV+znT*`<I!QDdNy-`)?w?LVH@FJ+085R%lQEB;w1hg8$9H<~9EoZ2mV9uP5md
zA~^p^#C=NQWxk1cgfxCx#3y;d0>->@03_lYe`7TT*Yhx0P2qN!#)`Zn*%n7CK}Lr~
z0yR0yh_J?tlSgz<F^@9>#5Eal+fH||gr^4v#1!sL!2d=K(Eub?Bz&ctVx^m6rJLe^
zcsIrW#S$*LBH=3%z9Qi(622ng|E6B(zw8taKoTzV`yxfEVjY0v#{#6HKMY!t6H+Ar
z7~A^|8u8+-pW2&c`|@%_++Uy(kTU`zg)onY{{|ZI{~#bTDmF7aJ2mo?-Q@fHu_$UA
zY#Yl5h6W%`gkvBM7vjykmXk;cB=6pFK!TJ`<7ylgpQmB6lOJfxzEPggg{M7~FtE7h
z0+{%75e&L0h1AxZA%41XG-vtwr4W8m)wBT@SVF<3Qv2Lm7ZEs~Q}48Cj_Lp$Kqv+c
z%mWBOo4&~}D2Ty`Vih^{aUsY<1}H96UgRc`JRHs+P$JpY0<b{~3@HRjBV&!5Z%Pzx
z$r**Ydb5Q)&y(J&sB&1AAfQUtnq8g{kZFFy$o$l<xtQEdH_S??eKUTV9+#i>LO>=z
zgOVG)w9P=C?dwgQTn$sBol>#`6v$_f;7XNTb5D)2dFFO3NFlw70`NigeCtT<)8IlU
z5kE@DYkhQv_UyH?pD&*|qN5ppezPC>0Y@q)<K$kRl6nrnh;7i6n?-q`9r!4>Xo}P{
z-p$y__0`odMquysl8Z3Q#y3#Bb8-FeR!Zeg+41D)TFICc;)qePERQVyB>vq<ISpp{
zTs`UgdOb)=&w5rsE(uz%4_NAAX`xWNd=ghKipU?rAZXYOJ(abz1VMlw0i==53Ivi+
zz+xEH6k4p4trxpkdVo^eJb~vOz$iRfpk3-5DMXY7_9aAdo!lJHGyjN^9x+DKp|Pmo
z^NvNW^++c=0*)2`#-R1F(k=A`@}c38(We#Ej866p&?anSh;x0kUb{4gMOtgvx^1lJ
zG37NfXga7zWlA`tqpx+TAd^Gouyg4B1up)4AR*!L-bV+@pRXnW^NdKPA#^2vazSU8
zjo|`cDgN2huIpBxsoqbHY`Aspa3vA<S@fXkvqmCNa%JjC3b@S_10b)oZH-#>sf8YG
zp8RkR?;{_wxFBEOGkpZ27u6Z3d8nn|n9RXN(07Wl3*leC(^4YNG*|`PX!-4UDDtc}
z+xt1{?5ovtZ-x3b<zmjcU3Gb$5m@@XvytcUC4G0oC8zd_BIkV@g<iYvc=_1>&8I+!
zjbh%}!cpg^&X0!^7slKu)hZLNs+?<|=Du$6zj#bx;YYjNo%<hn1Xa`H2&kZg7db7J
zNjFhScfTxM<VoTDM2ld35)ey+_UW`sS9Z35umGMT9q3RIA`QupKmC~p{`vi#H`@o~
zfL&te5-;<paSo6Qat@x<LwA|pBq4w|0arNp=6?P9`OW>nr7w$rb4CcxQ!&Gc`;NBS
zwb^=p?-h2OBPpN$bb1SBs7GwLM{2|8Q8q-x?VV4u$~L!v$%hh5?c|%*7k6%aLFnmb
zz;PC2e&ZURP-A$C;{7DK5YoYSR{3B3au^bV3klBkd`nzo>!dUn5-pO82<1i{@(v40
zrv@x<U-9HXeU^b?2k(EDfYDO<C)R%`wgQf~9@#V+xCKKITX?l$HPm3W)m8ZV6SOcf
z7N#5&@d!=^`{vht*+*C6AED~k?7GS^JrSX@Ao<m7m!bGP+{&)EWYvc5Zu5v&ne^}5
z@B+8P?=q=imKW6e@G84Dxm3~9_`1V`JwmSSVq%ZNuRDKymBYZ5DaRZ4x(dF|?b7Cy
zpDQ=9S@rr@vrFMu=HWA036^zp=Z=HH0P*-5<BtmkpJok#+wIr<-e*206C~<CJhdcQ
z6pO8zf&(RwIKVJ4Q~%WlWN5y)`Qj;77{5i%`q@{jBi%(L-!{^8zbCZ68{n8SFZ+kg
zCxGhVn@(bl=zqw(-!mKlkAneeY2O|5jrj;6B7OLq%)5#T2`xM3m)Su7f5`mrx!3`V
zx9?t0|4@9wVvA>AG^hp}lp-edwPfLl+KK>UU^qU8H-S)LmkLh+^o92b=Oi%D5&;HD
zbEKPXX&h|UsSo)JMdQJ>9maHi2=cQ8BLv5}oi(Hy6+Whaqx`TCQzh<tK**8(5ORdF
zi=*d`&Uac991n0+eynY20pYAl`Jd&xq6;?q(Q8`MEC8?|cm{P5aA|>Id~C&m-Mk2t
zniA6Up)8+C9Ban;^&{gWt(lBtr}x>ltzy8~>AJS#$}Z$qFn#;hOMI5^)*ppg=z>W@
z?^HKJ4cx%Rn;X`nS-{*>|9nvb`$ek_fj<wd!~>f3mq5ba_XW@olfzdrE&Zey;H*Fo
zYDJS`;2jIE5{>t<WbFIuCdYCUbXZzl&u|o@7?5Z^fCWfEfkd9@j{I~0?uk<-#$K}~
zEm?CX?hfx27fOO0^X_I@oJrU0sQibQWnT53*LaHhWW{)@_8!ZAQ)iY1w<FcobjCp<
zf<Q-M{q!f~c>y{D&q}3a;CI}7Um_3Hi!zM)EK81x;{7XoTm`AXP0*h@Ps{PBIh!rC
zd`@L0Tkp!R^a2<(^hg%eF6y@)f3gAxJmexaapD1K2_F-iH^z0e7+8~xocuN^f<0)h
z+E6JcYH=<X&pxCfFYl*$tYpurpB|Cle7GouXSMCTzR&8qR-L+)Mv{M+kUn>zl9AP?
zltHtj?IP?vf7s7@6^2`XZij6zm+nrtKoowdGVrcb&ZE7HZ(W~c3s{<phK~u<=N16f
zMg{w(D?K5<x%T`j^H<*Th{(<m4IAqZ-f}Sq0t7SflD&K4OY*)51cUn6dOjisj@s2L
zP;)kno`&6XJs}z|s#<tG$}T}%aPC&5{sqVIrfZ=1Y%(PHZ&0X2ov_^&X2xsIW*ItF
z48Gyh_8fH`u<}%C*=+yKBXUEbpPcjsbxto*`Sehb<Ni|ogR^Y$jn*(?%`hcj!5x?l
zs2l1G-<k{w73yo}m63P8>H-KMVW9P}5Er9uo#Bg)4#3@SAHP^M{?#Ofj{7(r1-04C
z7)1`Wz%hg%0P(djAQt60-?9`3mR~n-7sQ311I?*(1?{^6bjT;$TNOZYrd=@b)%GAN
z;JixrWIOuMvg#}QAK-x#bML-4UX){ahGm>VSRhoDy((tKZnnJfQ^iA$kZW7p#p~vN
zGr%!r-i!|8>tdiZzk5W~QD>i;hkNbsegI52_|YgkfRa3Xt2F8I?&?4=|GqJH1F7BE
zpPHg&2Z|g`?>QgksM(r7>1ufbr_BI}&6ZP}WDZ}QcQGug*B8<p*bF?dptcm#A(_`N
z{BVlOt>VDb*wvvFv2d7zD`s|JZ_PU8Gs}vB;|U;gc=bUc8pD{FAq0M$kOOQrx(Z=-
zGKk@q`(VRI<8Zlk=`8bbc8V^jgt^Q?0T9T6=oZv8?J9)|Cw{oMw22Y3@Z3Ee{5(jE
z4Z>SyFZ?R^`7ZPJY^o>=7^+EPby)ZBGVj@}LQNcYQ_1P>_0W8M>{kc2LIZ-R6uR$5
zfCnlb&a6Zjxrotrp@tc!a-(ER!O}H{zDkn(O6Jvoh&2*~Zu`%;3&iS<{;WV4a0f`B
zGD=vaV1BwA-_(`^Uy&egkySL^yHW44c_w_AR1)>g?eaY;^>^W)Zu^YM>!}F&8BdJ3
z+F6#%qLjBBPrQ=a&4gE-d3b5y(!YYj{eLg~mjm}by#s0gEmzZ*&u>3__Nwpg+jqT-
zK_B10`SN+aF5lJ>MyNUNt5*5^(8ah<u*qmUoQuwuK-qibu9-puO#!V|xy76OEr+GI
zq#9TDN?v!v?OY`(_u954as9pvy#k7>`j=e5L$HT()-pGXF4)}Ci(n<1lx>kl#X1~*
zVpUb2@7hrsdg^qz>E+h5vJJC0&z_-==*{`8epqMqq-T%9?*Z_uR5)u{=qrgwE$LVe
zjpRkk(U@c*t!=FDswPab*6r*xDyz@z$`g=t5)i!YHBicv&Yq{aFn+J>Q(@fqsMHVV
zb2O`%d2`dkcvq&v&c5ak&IkKGgrw9Ms=S>&JAPK1mGA7k=fk%n8a}^L{m@X5Zr*R=
zFdgx(p2y*f;La;|UXLwA8`>{v7HC(0Xhhk=q6p43qc`OOQ2~*B`iF3>#XGt123`8G
z7*{VBUcrFDrI8rX<2PLrtdot32&)Pz^pdWVJ&}idF2@%|%RAU2lT|#>5}fL*(8Lt^
zfI3Q=r-gyLpty*=JJkd`RGhI@4GMtM7WGPb(asv<;aWZdajDLlL(aJyJd7uEYzjV%
z9Pl~1D4FKJ$;Bg|YnAcTai_<XQ~wM^SdL1Sjl0s<e)N_srLcc2E7bKlE?Vx!B{(ay
zcN5=JV(IbYG9JaQ7iUkDqXc|Yg5GJ&B{pW{`X*d5U<NRL3IE4!m8T`&%8zLE@#a?1
zPhb4#lW*qWaJu349)+p%&X28q&rTfmeQ{yB?3CAwi_aS7UR;{*++ll;^VW4b0%b>h
z`CC+~YYV*s4)Ev8wi58q=6`oSU-Au%8-H=3?wrV6cY1kngSTjRT&!@J)yOuDlc)3}
zhb8jvIDeF(-3ws#B9VWynpps?02Va<XJ_tTxHu38_!k%FB=2uroGrg|aa@0Kaddxj
zaYBA_ah!f~aSWH!!NtFGaZ3Kq#YtV};v8D$;si3eIL=Hi&K4#YCjuz^`1S4kuPly@
zQ>~1D!^IIcUONuu(i8L;+s>9|XyIe%oQ#&zEs}x&Vh||ei;c=7B@%S-Ahnck#Gxou
zi;=sP4@jwp&Qk1Ym1Gq_HVxph$q_AZ8NoAd-_N+TEh??{t)lTRv-mff6Ai!77nqMv
z^cNbr38Ik{Z!(G-hA21(v%VF_{z)TYANCBrSVj1*iQk9e2w)YM@ee<X?AfAR0uQ!w
z?{{Lg8LtO`C_)CwegkD5S^ill-*83LUq4Ie4{LL3uCcI}j<5YOdZF`v7Kr6o#!^(Y
z{4+sm5VQRNPL#+8i#(UQ{Ci#L=sW{JQ4+svQP8jE%iedlXg^*r54cCgbpwKr#vxjf
ze#M1}V7{`Rx%or;b96<@7J{LK_u`j5`&kptnU0^Kw*)lw(dH=ta6TF@+4rD$4G2E~
z=QW1nqrz0|6El&)fw~f7Sx$`OAk23Zl_KNTqkXFuGzIEBW`{KpZSW=b4Z*L3O$bRy
zjMQQIr|M)duGFHK-Fx1$YI~_QkMpCdbqe>-ti2p1^3YOos2+c#$Vn@~<fOP=QN=FP
z`~3n@CytYk?PxrcueC4c*}l1$Gf&!fVMVwyFdm~-36htF^ae5~uG1Z!dM933CrOEq
z+b8-(@qy~Cils=XGyc4<#`BEJ1tNxGn;$d<Gc|GNx2P+<rg1@9@C`U3{i!Kf3L5}E
zqHmphJx5&YDC;aM^zJ3AiX9z)KqY)i*x{H%;MeBeFh3~ZN;-e}(<4CuFZAlh*Du2#
zSm^AiipBS00b%$75)7Po9ii2S(nXiux?#|a)Pm~RHN7<YkMYsJ4#V%J$B&RuauaE~
z2Pp2GhFtbpJM<#)IT?D7-nQWD&VkaFNcVEXHMZ>8H(bS3?>)81+9GgW#_d%M^=N+S
z1#T~w7gLkw14i&xU1@>JsjOh=sr$;1Gg{y%yBQCyLw$%RdxEhp56z&YD>*);FUGS}
z+dh7#EPwCpOga6QxOIi_^E$3S`h33`rWJ%E)Q(M@zT!xSI-3sS$vn-1nbHWWNpZlU
z<7387$lp7FN8S*$!oYZo>`$+;@i=!{<@C+ht5=JuQ%u0f)JrZs=&d{!J@A<-)+F@2
z3xf<e^sx4zpDeOOAprWRz*Wz~74&pD*rE6+Zo{9N$n5jI5TFf(T$5)PzBvG8%d21Y
zC^kNObzOoBRZp1QW~%oanu(dgS_R(whgZj(ME(*}IQ?f#LFf0F!mi(93NgQ83O2vR
z6v}_a6r#Sz6s&&66bygG6q<j;6si~x9zFh<P=KPK;j92NqA>UR&93Lnh=LFI+pkO3
z4+My7K?X?0a4UJEX&CedtfUFyR*g<N0Mu+5Haa76QTz%JBy4}?5ln&)z!ST-J=%Df
zsLc<I&`WOwJV!OT(Su3xOL?T??e6$lMjYKJ<$OIpxUIj$B7Sv>N%r8KD!X8NYLM!`
z1|{SeBazBvM~ivR7!)#S7K?HLsZrw3ZLo;|eRSlaC=A1|b6Vjn?g(=3CLj?_2E?R2
zd3*UqAe<ho>viNFRVOyUT$CS>AOrYhxuzPe5uQzWE-qTc#T`mFZ}V;#ASl-^4r6`S
zqO97kU2x<Gz~gq0prYSiKtIMA@B4J=!|UnWr*`)L11RCom;(DkOO(EHF3~XTZ804d
zzp*LZ6A`J5utM86Ev2u^wM0;3KCSjDO5CvC`VksLkn#_XCR_Ds2sXU2h>M|F6drm>
znJ`aL^o}3e{&lpt-(4z0uSHbx7K#$A^X9g=X*wsvdJCYrs$G`|7<0jiz3l?jeWCmE
z41`MwWz++-`Ank?GX#Dr>zze1U(!BxPJl;ImU~M?K#3JhTl%#t{Sw_yAE|f2g;3O?
zM*@_r!$$}uoxOK}GGUi_V1p&T+gl~cq;9)yG4DDW>~ZOGi#GGs-P&G-XTMjqB}Olj
zR9N$ff{}`6?1f9XO7fmcNor~cm*vjNs;pkM!Kdp^>TLr_DNK>ar``+>)fs=a?amqj
zYLujXOG;`!Iv12w_gqm3^pJV18L0F#)OGxQPZ7=hCP<;?fY)JIc&Q&L?;J~ct5FWC
zTFI{Vy2V5ql0Z4UTTytL6PqvQIlP=uXepEKUrRkfX~@U=!NO}PK5MTr6AFWB_MsYK
zw`g5}Dr2yN9PBE`Fy8R|&25YSD5gMrHyNSE-)ug;@W2LhNgQL<`lX{zVwHCzPw(-W
zvBwnayzz%rt2+P2SSzrmDe;h{62`8~YE5f?87m`qCMFXSwL2SqF1<ZhXHdOx3+{k6
z+n}UBQC0uw<6P}EC9NH1H#X7rwXz=6e0tIRE2hvNcIq<YWe4>Hrz|~ezK=u~_kdC5
zwf&$ZYm3=Mo;B^>7-fUSd6AD38#&z?X1<_@K?~q%>!A@Ruq$T&6|_Hv(c&)-6}Vff
zu=agQ%Hev=;<AdQb@Go-&~Gt?D&2zjQWWX~m-%QSt`PGxrZDPOFtzbTNZ?<>0stgh
z?0@XdWMLRbk|>(`=ibaw3Xs){b<zEH9x=bV7XY>%SY~Rw3Rx}lvl3l}w<Iz5W;7VE
z%xlhIo=1!!VsivkSOPl<F|`waK%1)}vf&<Kmhf_~3lK=%QB=sU?LPvk|HjXPK<a-Z
zIsYv<`Zu!SseRNSIu(ZFBYehQ=#K`qvw-<MjEs{6@Tj&TL$|(c(~=3aWdjCoPi-^+
zlZ@ni&OIi|>q+7LBVL+|O0bn}JHJ7-70-SqHy~SvhZKY3jq?#PU1PllG#z@-_N@Tp
zUQev2ORI`_VYAvNQq#P%I!Bq^2whx-dbQ`rQALdX(gNcYUja*>vIQ5#!`S17|F@&c
z#IA28J{)p)USO#VGxav^;g@GyFOSfa=fgxjMp<g9Z8PJ~)y?ck-VFcgY3#`>sT&`O
zfPE|+Uml5woB`Q|ad(}ZPekYTUTBoD&DC9;dVSs4g5IJN1;ZFocOIMw;RQrla7Gk$
zK$(6GSwU?eYM}7o1CTod4ss?_=}VNjVQW%58bYp&sh!6avH&u1^$c$@ZE*YH$Iz<H
zMQKKVT<we$gP{QTI_tK9r%AfUS2w^aIn7w@*r+*KV<rVzW9<Dj+s>o%=~2hMGf#6U
zaV#k=I%zY7yIo;cG?)Z7eOnUIi%z9@kGX;X7FP#g5c!jL<3h*A$N<d!9Vkr{ZaXYZ
z8{^7D5$*OsQ(szwNpVy7c2)#Hf#~(=QMEE<jnJm;Fd7Hwz`)3nyCx-P*HS}?%7D&l
zIgsIAeQNMxVM27Xt@xRS1S1wXBz>(=U3ECa)lX;Oj$D0%naLC~#p2ZShT*+)&l^YL
zAiB$s&!?rIpHHUg$95f*T_fykVpj&+_jrdP%1WD$5cl<7p-^!VjDE)Pfp<<{-1Q88
zMvdR|`%eym4_MhH4@BXuuT}^o&^w>Bd$43N)-O_GrY!&lT&fB?T&v@l&__ogr0=;<
zu{XuL9}j-yDq)<r_eh+ku)=OMwXn1%%{J@E1gtqK=hm`+Fk#$O%k7K7k<G0-b@wHU
zX7tl93sa?rbRi+%w^OmZfosir<@cf?yGM{cVYcKmyw)|38e?VHp!|A*OwFS6p}fnB
zydP4#UXD8f!*zJL)#Hwq2>EIaKD^k*1zvlB6YAHF9r(PDZ<UPj(^-cmTrjY<t!4??
zr}?li7J}iP-p^~Y?u!=hHjcn%em1Rx&742vo0fQ;wXj8@e8dG9XzOpKJ{GF*iFm8K
zxOWmQ^v>)nUfmT6m=VwPi^B@)WS0^=gqc^B!2^dl;neigUp+5d5vJe;5+nFH9V)8U
z#2)($_%c5Ltg3i<sDoYr+tAg*9`P5^`dNyd;v@V%giqt$mKTSPa`R&_?>6_bxX7?(
z?wr;pP;YYLLq*}_&tLCrUXiodt1?G?K^j=^Db;V%{Q89IyG$CIpBldfE2`ETl%&A(
zQZQ?lih63Rk4)u=3ra2)ZhL!?{Y3#HAo$N#(F>$ASJT%><EWMh0>1t23<`Fv4iQf9
zssj8*;A?1im(*i{Rf_3U1ZxI5aZ(j|kc0(f8Myd(5}rWiQ+`NC_fkQ2DWuE$Pb68C
zEYEf>{Ei|*tLf48UCZYYv$C~6_hzdUaFrw$etPPy-ZHhu?i&FSuk%K5<?6vVjgThf
z%-=t{H2|h$bNnIM)0q$^*Bmr3{sAmz#$lWIL8KD#2%NN-{QcB%S`3z;W6iJj4FMYG
zAVLI0<Ckj?DAb4y=0!Ue3SI~3iWMGb)*u+ehyo|Y2%L%KP#pFMq~oH6Jj6;Suz1fm
z9XE&I`@J{pg|}En_CehjI-)|<`#-ub{?n5EcjU;W*yF|!IpSx(#S-$ipZpsNF)0(F
zBcwT!Eq((A81o&Zy3&kj6<Cd2xw8ZX9g~wWvacg*;noH^n^cL1=Y3+138QK^%7Q+S
zh+|17d<TwZ$~b*s$Hk74;VdGns2Ih?lTeG1*IK~RVAYM<lxx})H(GQYI;p|w)AvgW
zr4QGsd+sVg2x|lM0r1i(`$HF&FC|46!~swcfs*kGeSfJ+(;B7P^JP5{DQ^2>dQqDg
z%tZm?=LTQy&aDM{s1u_v@0w*6oU{j@=+4AG{_30wiTLzohs`J9vL_U&&WGMGc*MdH
zS0rgLLAx{(2+24l>V+OR!;*Vj69myw-m^rOKkF@f1k{t=OHFu9A|Yf<>HPglbOfW|
zFqSL5%USheJ)q!ao#CbhSmUvlfbzRy&2}jUpaN&?nb71}3^fhfT9cWQx!vQ~h}CxQ
zp;RPepWI}w`%&-7V_x5~{sO&b^n{F~`2kD?SB{#$Z3ihhX;<ji9}4b|v5ZTiePt?m
zlM0XZL)Dws#aD6VG<hNvab7D%N|ICFB?|>v_z_fVtN7H}!zkccIMtCQe4BwqP2XC^
zKB8G!?^b|v%vUk9vgtZXA4?jmJ@*WTbU>DD6RtlS4%`jWQH+&8e=Zz5jXV+bkCLtM
zviZ$D-<OvcC$Ho4^#&>fMZ)5mVqmdfeGO55G28DZq8>uAQKGi=ykpM7{v$~pv4YfE
zztw{y(VQNG>@tZq+m(HJT@(6)s$m1tzQPe0iA~U5oK&$#uCW@w%7YI8w+jsM7wgo@
zuGPxqIbXSFpOW}E^);2XweR8rOKZwUJiH=6tL&~@TNpya-BKr-%`n51x2<j{SoDNm
z)*%s+^h2h2A8>Xw4&%~4eZEm7*1H3lbI8i2j+fHs6rQ+o^^3*vG(#l~oA@=O?<VvS
z!)sb{18G4;I*P*|csYawA5J?^@@)ViUlpg@M>3zqbyozoEbVDmx?iJzV*@&^{)L@3
z_KhpUH(eDl<vSF6$66sU_FkXil72_d+}9t6ankB9ctQN@7;cpH5zVzYuk$p=+CyvF
zgO47fOWb^MZ3cucBtd(=C`bT8sh>@+`?C{4Rth5!lxhX+RE{CApbf0nyh>OdaT!ks
z&u8!=wMI6}s1jiSeJ8AbbR+ioe9VtH?8W(5<>W$~=dU=d%65%Icee)9M;u|B%WKUo
zYeRI>_>tSE&fU|n*h{3JU<ou-=YGZRDNAr3=&@8;BeG`Sn4JYmlmf)<O58Wybc4Gc
zaXC1$3NDSK44DmH5qVGw6+vs?zizQeXnwkIgo<PK4|nMZzDi3NZXK1Mx^hyP%EM{F
zXrB$^!88@h%@-1@VfbT3Bl5Iz9RTy*kQ}#OF4nYO5V^S)1rQjK=RYwB*nyb5V*~KU
z769#zr~?i%c-gA2D~MoftgwZ$w@pfZNp{({BIsb=<PtgpS9{I(yJTN8?%Q+xb$&~(
z6!QLj_ji!N&s)V`l)GeJ*O-7~>ofdQxfh|GYE(V2?)$KP4LWzSc8vr0ve0FaL7cr9
zg1Fq55}(ebwAeF+{3z3l6q}Yrhm^bA4$^U|sn}^|OJF)A<5V-w+;b46C6KA&XLyJW
z45+op_M3`(a@~Mhi-bLVl82s*FhqsYMkjwiQvbC!<=+q6e^>5bu&A#Q9rfkrOG#qd
zBy|fC7{`ij{*pZ1LOs5Y<><B$s$yFK5-2hGoYo0ThdD^@VOYiZ48|8x?6u}<b?<F4
z6|6mgQG;z|hfiu|rLAZ7Yn+|+mwkp4tdHio()zuKj%e;T&>F+GQGnXST{ET76Ck=+
z#~`;wn?1d9;CqKA1yU?po(quP=3*pCCG8xlzwEeNR&-|sPgQ4wwFy8&Syajw`RIaa
zq>%6x3!M79L!uQYSZYZ<@1r1dlhHch<Gw?i-ZzU)+fcJ?X=nQ1dot6+G}?JF5_?Hq
z59|e7Q@_*uedQw?xn$`yq&bmDi{^OHwgs?o$z2-N29#^Nkqr~?TsEQboI{|@EHs8!
zQAb=3zYtyr;laBMi#PhR&=M(H_v%SX5y@Oq8v*Ni6Dz=Mue<gDq~WUY`Bx>{JOnk|
z9^0OEso73(7sPCw6OE4`uQ6e@eho8|c|o0WQ~4qHSg>0+9GvV)-g|T#4W<@FwLT&!
z%dkIr*$$w>bQOVCF`eNBiK5Hlcq(8Ol)YWU!%p9OO^<gFD+Ucv*iySAO|FaFBSDKT
zP;Xauan-FN5YQD(vxQX;7h0b_iyIKd9Jh}q02J8aB#$+s_2f)gNyRh8YbBs9*r2?@
zUs2S(G#_t$`QmfMQqhPO`SG$-zlQB!%6;m`tzu1uX90MBp*(S|Jj1Ic*nPxM!MUz$
zUYN2E3$wxWKNTndE_Vs1f>PIQVz_O>#Yt79*}JWD|3Pt5&kZc;7(G_qH4(6cW^eUL
zp8Rt<)tIzWMEFy8*Gw#@<jFT)lUWrlNO`wZmKVWF7*hW|Nz7&};znUT+XcOJ?%U}T
z8RjBRdxb2`1yZ_vud6Hb*$eIka&{Y<P!Bps9^1fW-u?EyaB@lq@>sM&%L1?0*oj3v
zH~-tki7eZI4^P!szrarJ5H@Q^V}omA+tRR{b<+;k!?FPto}&v~U`%!F-fde8mR=E{
zlbe1oUw`#}Ud`9S)c&hG$>(l%c#f(97BYbyckQ)ycHF;Z`=q1OjBn|Od|Ufp#tV|7
zI|WegXSCMilFyT!&mTE-SXBFR?zzu3;Z$gKQk%Sl7bY?Msc$w5e3%5dY5^3&mLZNK
z@*VdkVgjV8FBm3KIv5-%$T;O^TnmS3>%t`f>L;Ec;juP4*0!sa_wULb*3~BZao*^7
z<_`GAu;Kxpv=F>xHe$OBBH4I8)GE^n9*B+_c1a6MXrs(WG_;Nzmx%~*-+pzxJQcHR
z1Vp9T<<QX_Pv|XXclO6uYNoX=Ri0;yUieff`o8O0$W6akyU`tDKa|_7M1rroOVUdz
zVO$pr-@^$a-OUbCXbeKNs~F2;c_4Rp&l&8rJR)u25LcF6wjJjDY2$hL0e}SFd4Gwc
zwh-_b5kPGm5yAx#4S7F3LC0{Cuk@a!O*xd}^NUU!{Bfi{J_rrl3ShTw-<H@%eiU_9
zb#s@4+|f_lcWORu>{~d0JK|-vvv%o*ty6c`?IYu0zawdwGdR?j^(&q`G2iAVe{$fr
ztF!3lEWMV2k;osVA-A_e6>S4Z{%@rrww%Q8{a2pU<tnn>-zA;d33?)cspthvCAT`3
zSpi}HPC$ZwSjYSfR7K_k>G@#_C;cLXq_Je`xfu_!xpUy=z&AM$;kq^as7W|DEc@}q
z({fRvW0P~w{<#3_Kd0og!`)WynM)_lB5XeY>?>0?uh8Q_y%;baIadVt6u_+pEJDZ7
zTF`1`T0XsvE@9iPW3A8Hu6CY7D@bJfDbO*&O;UAKdE|vIizBnsih62ieAo0H<Ne{{
z+{>L-${=FA6TRAOa6S{nkRMYUI+~x7C7_lvZA@wE!+17!c7D4c7gcXX(N;N>#gGt6
z3x+{79Qf3;+*{`Lhz(4*OH>{x+|fKT_`qx}p(>!ZWsLQDLh#a*xX=lJwKsV~mrE;5
z3tn+%>Ah9L=MTVBta4k){NB$?y(&~VJ3)<?3TjZ|6<LSlM>g$Wka-;a-iS^`@g~ry
z2<~lOOIy`Jv%7`yuK@-_mT&%+P~t~^lHM+KZ4(DVuN~H!u=e6@sCb1xLvm9f3z+1x
z`9VEnO>FfxcSz0|2y4Kxp+x(x6oa%Lj#>9qn@8#>E_g>@bm~!;qZc0AxE!-Tg1lb&
zOUb>bPJ~a+#IN3f+J5+C#A8U#wW4aR(*$J!2l|=savmk2gVB*JKEsrA&&ZB!&0zP~
z8HGOY0j8YS-azN2MjR$ST$Xc-?Cg@7i;$cfiVoPq>M^&hYpQX0F-(DfJppj%+Mnd9
zs#Z_Vf;CP1Dcl$&+k(xcu+{RSK~MAXwl_ZdD^w~)EYTFFzFnRFLCKc^ou+M5Cy`fG
zrjs_v1KzFv?rE6SE*+TNLT-uJRvTQKv>+Y0i4i#ks-8L;%kR@wNUF0Cyw{dXlPx0k
zJ;IWX=N?NaN`f)vy!u^e-gzB{Y+4y2M*68s4%S67^<6k`c4Z?^gxeAJSM^F5y-Z#y
zj4qe;jiM3}d(#ZQOE)JnEmxmt;M?x(ozfjB=BJ;NBmzu6%;uWk$?NtiMbCOK%L|md
zhZC)A)MRiYGH?I7P3;I{V@Sz!J!>wQ?~QK0Kw#xwptYT}6;~<Mv388$5ism|IBT8Y
zXbMQ%jxL?Jd$cjK^LnkV<?GH3@6BWTNoeA^`EA70s;{h#*nqpehIOI$Z|bV-eLLv3
zu>0LF!;*dQ8S?tj0T<v-t7jY4Ug%A%*89tZTZoh`x0lM%kU<sf{U`)O<7<T^kn;wu
z8dQWLmDVZ}gn=){dWu5OMHZs=xgt6qt4l=zr*;sY0pQF46$20tq4f+usQw2^9#8sg
zIW>sBG_aZ$g4P!4u+VS0$3k->WIej;^PcpGMhz4E{Af(osF{A=V&Bny@m@U>+S7Gy
zIs)NTP_dzOrdwA%RQdMXvBE0$>H`*s0&b6dj_SI$>EnW<y6>pX*LT;JXYg-IZlL*!
zl^E>!?r1A@rydCuDSl!{42r9M79Vv93wRc-t%mnt!Bq$%a`jPZzHQHa37?_ZtOX!}
zeF@(u%MhlPkvTAExbSp(Cu|XPH^VERj~uz^AQw{+em&^Vtq8cH$SaDxqR1<XyrRhe
zMHCsfqR1<XyrRe}ioBx8|3wrTzM{x0ioBx8D~i0L$p5Dm`TIo>0V(pUf3ru<8#(f$
z)E$dDf1g<_d}hZ9)3Rmzopm4;s&kFo6CTejdfJwl3S9(a)6%jaI)QUwP99XQX5tc6
zR90S8;tK7N^9pL9i{O8vzVct%@77hl5uP||F{<P5->N<A(LJi?n?rF*K6-Pk)4Npl
zVC2z?J4W7YwkJyN1xXuhS0XzQ1lHO2*p>L~F-hPq>swON*k7~uL$JMZwtgORi^(k+
zD^K&2I;C<vxx}jNhZcIP6y<H*MXw4zly9)RezskTOaI|1iERy6hFjV0Ej)L0+VisW
zgn-SO8gsiZ*thbF_l8=--y#g2`KY+rr;2TOp>W~s)9b$#J=tnitv%~SDtSG)@lnDX
zi=Jvejr3`cP(Oou$<`|eWW%06XxOK)&2&e&)L2={>%z-6`vULxNtdRYGg-ZZ^}bK~
zE?@dluGakBGc3B}+B@%8t%lReA3htt4HJ{{wJQ8_DE_TX=b^7ezI^2?9a3U;9jDI`
zqY=E*mNDm58*fJAXJbYWI09u$V)0=JjBEVo6pS$M1(EP4hX@7N#^P6b+$`F+u5%HY
ztQJ?{nreHetJr6A#;9AGZp3?MqWam!QCVa8V^31`3EmT#+l_`qL~WvSUDI|*b(JQw
z9ULl-bu}P+9P?01gf4>j$aZ-~Ss2fJIh~=&kl;-V9tBmaJIXmFzRI;{L`HbY<k7I$
z{F6ys>AQXwJ<XKndQ|;z>c=hD$Mnpkr*k>TW@nBat2*RUb75Dh^R^zZQ=Ub8=A16f
z3YP6WA}B$FF<IW=F)qlf1arqy5hCGfmGFEU%Ix{UuU@n=R-o3u?2&WY^Pl!R=@%ET
zRUDT&+R{+|urTbaeC6dcoepQNoE<w=k)P6Py5_j;f|m0iZu^ta%h6@NoPS+QXz-U>
zLL{lP3BW&DWO6+&iGOP)JP0+OBpvo!ZY4}+=Khi~dx)XDIR((maU?($cJLy|xLUQ`
zN>~lOoW$kaQ3G^K_lDY&7#*G0tf0(F*NvaGgbv?Z3Ga`Lh70xpur}1#?40MfR>B^h
zXYbx`7vOuMPsKyUOPUMR78o)t3L%f^62Dy=&%$ToXh=^+u<{FL9q;1IM*$VdBT0jG
zCFhR77F{s4H%m;tc4Jhb>Js7Z9QBmYAPk+1I1eoC!ET&%fnO~&`hQtVIQvv$B9&8W
z|EVZWx0vK(4D0b;xoy|hj8#x2xYoY0tCDO@m$$m18lO2?S%Nt6QTr~BB5=0mfZdJb
zAwrH9!<{ne#5OoQ-su#lftjOz@Wmlnw^i)a7<R*Gtu3dueJ)Q96q}xeUQVdxi5ia6
z!Q@X>#NTge=Fl&h{ksO1{3@9IYj@4`>>u4V+FpNl*LeKaU6b&uyT<Bgcg=~P-8Esq
zx@&BH>#i~Q)m?M>M|VxdkM5c*W_L{@v%4nr-*wlR<S(B2t+FPG$iu9x=@N9-kpQ{~
zXLm6xYjB*15$8OdQt%`hAi)!saA`nOQe}OGNcK)5)U-fiw{SElE`r*{?$ek}3qWB;
z)SWXPDBS!2ItBso5ddX$!)kti6Jvk%RrK_Sm$u6Tc&M_5jt+;Lin9VOcyxd=#`*IE
zKs}-p;=jx6FB<q~rS+fPHO?OCcuu5r*cwFAwyrLtRz6;UYSkt9q?=nFsVGGP8qU{w
zjgBElS7k{?KXJZ2xkWfedv~kQ%T5j=d4Odb0H_1^hLeTKnwU(6k^AE55@SV_w_Ea7
z(A8Q5C?}M#0(+57oS0f5ZD3s*60_a?l3vbInz9ZdI5{4p0Z&mKOjoy1dng=qBxyvC
z#6VhCkCQc&%iPT1>tV{~sn03%0D9wBjFisX=I{v(Zdv+Z26{a}jj~{ulFr_a3fXlO
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


From 40d19371c4e24cfcf28cde4f31e0b5dc8ade0d77 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 22:42:29 -0800
Subject: [PATCH 70/77] Backslash escapes don't seem to be working :shrug:

---
 tox.ini | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/tox.ini b/tox.ini
index 257dca07..f7883730 100644
--- a/tox.ini
+++ b/tox.ini
@@ -49,10 +49,7 @@ deps=rstcheck
 [testenv:uploaddocs]
 allowlist_externals=rsync
 changedir=docs
-commands=
-    rsync  --rsync-path 'sudo -u herokuish rsync' -azP --stats --delete \
-        _build/html/ \
-        grantjenks:/srv/www/grantjenks.com/public/docs/freegames/
+commands=rsync --rsync-path 'sudo -u herokuish rsync' -avzP --stats --delete _build/html/ grantjenks.com:/srv/www/grantjenks.com/public/docs/freegames/
 
 [isort]
 multi_line_output = 3

From d4f6a9d1785c709d2af5c5a59f3546af7ee4c97e Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 22:43:56 -0800
Subject: [PATCH 71/77] Bump version 2.5.2

---
 src/freegames/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/freegames/__init__.py b/src/freegames/__init__.py
index 8f0b20aa..a5029a89 100644
--- a/src/freegames/__init__.py
+++ b/src/freegames/__init__.py
@@ -62,7 +62,7 @@
 __all__ = ['floor', 'line', 'path', 'square', 'vector']
 
 __title__ = 'freegames'
-__version__ = '2.5.1'
+__version__ = '2.5.2'
 __author__ = 'Grant Jenks'
 __license__ = 'Apache 2.0'
 __copyright__ = '2017-2023, Grant Jenks'

From 5e142cd95882ffdf821ce83aae9b919fcbe627b9 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 23:06:23 -0800
Subject: [PATCH 72/77] Add "freegames" entry-point and "play" subcommand

---
 pyproject.toml            |  3 ++
 src/freegames/__main__.py | 88 ++++++++++++++++++++++-----------------
 2 files changed, 52 insertions(+), 39 deletions(-)

diff --git a/pyproject.toml b/pyproject.toml
index 10672a84..f9fe6efe 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -30,6 +30,9 @@ classifiers = [
 ]
 dynamic = ["version"]
 
+[project.scripts]
+freegames = "freegames.__main__:main"
+
 [project.urls]
 Documentation = "https://grantjenks.com/docs/freegames/"
 Funding = "https://gum.co/freegames"
diff --git a/src/freegames/__main__.py b/src/freegames/__main__.py
index fee826a2..f09f3aba 100644
--- a/src/freegames/__main__.py
+++ b/src/freegames/__main__.py
@@ -3,9 +3,7 @@
 
 import argparse
 import os
-
-directory = os.path.dirname(os.path.realpath(__file__))
-contents = os.listdir(directory)
+import runpy
 
 
 def game_file(name):
@@ -17,49 +15,61 @@ def game_file(name):
     )
 
 
-games = sorted(name[:-3] for name in contents if game_file(name))
+def main():
+    directory = os.path.dirname(os.path.realpath(__file__))
+    contents = os.listdir(directory)
+    games = sorted(name[:-3] for name in contents if game_file(name))
 
-parser = argparse.ArgumentParser(
-    prog='freegames',
-    description='Free Python Games',
-    epilog='Copyright 2023 Grant Jenks',
-)
-subparsers = parser.add_subparsers(dest='command', help='sub-command help')
+    parser = argparse.ArgumentParser(
+        prog='freegames',
+        description='Free Python Games',
+        epilog='Copyright 2023 Grant Jenks',
+    )
+    subparsers = parser.add_subparsers(dest='command', help='sub-command help')
+    subparsers.required = True
 
-parser_list = subparsers.add_parser('list', help='list games')
+    parser_list = subparsers.add_parser('list', help='list games')
 
-parser_copy = subparsers.add_parser('copy', help='copy game source code')
-parser_copy.add_argument('game', choices=games, help='game name')
-parser_copy.add_argument(
-    '--force',
-    action='store_true',
-    help='overwrite existing file',
-)
+    parser_play = subparsers.add_parser('play', help='play free Python games')
+    parser_play.add_argument('game', choices=games, help='game name')
 
-parser_show = subparsers.add_parser('show', help='show game source code')
-parser_show.add_argument('game', choices=games, help='game name')
+    parser_show = subparsers.add_parser('show', help='show game source code')
+    parser_show.add_argument('game', choices=games, help='game name')
 
-args = parser.parse_args()
+    parser_copy = subparsers.add_parser('copy', help='copy game source code')
+    parser_copy.add_argument('game', choices=games, help='game name')
+    parser_copy.add_argument(
+        '--force',
+        action='store_true',
+        help='overwrite existing file',
+    )
 
-if args.command == 'list':
-    for game in games:
-        print(game)
-elif args.command == 'copy':
-    filename = args.game + '.py'
+    args = parser.parse_args()
 
-    with open(os.path.join(directory, filename)) as reader:
-        text = reader.read()
+    if args.command == 'list':
+        for game in games:
+            print(game)
+    elif args.command == 'play':
+        runpy.run_module('freegames.' + args.game)
+    elif args.command == 'show':
+        with open(os.path.join(directory, args.game + '.py')) as reader:
+            print(reader.read())
+    else:
+        assert args.command == 'copy'
+        filename = args.game + '.py'
 
-    cwd = os.getcwd()
-    path = os.path.join(cwd, filename)
+        with open(os.path.join(directory, filename)) as reader:
+            text = reader.read()
+
+        cwd = os.getcwd()
+        path = os.path.join(cwd, filename)
+
+        if args.force or not os.path.exists(path):
+            with open(path, 'w') as writer:
+                writer.write(text)
+        else:
+            print('ERROR: File already exists. Specify --force to overwrite.')
 
-    if args.force or not os.path.exists(path):
-        with open(path, 'w') as writer:
-            writer.write(text)
-    else:
-        print('ERROR: File already exists. Specify --force to overwrite.')
-else:
-    assert args.command == 'show'
 
-    with open(os.path.join(directory, args.game + '.py')) as reader:
-        print(reader.read())
+if __name__ == '__main__':
+    main()

From 43004792fca2574b55279f1ac08ffcc17d551b56 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 23:09:52 -0800
Subject: [PATCH 73/77] Add note about pipx support in quickstart

---
 README.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/README.rst b/README.rst
index f4e6ccea..ca6b1cbd 100644
--- a/README.rst
+++ b/README.rst
@@ -123,6 +123,12 @@ help function::
   >>> import freegames
   >>> help(freegames)
 
+Free Python Games also provides an entry-point script for compatibility with
+`pipx <https://pypa.github.io/pipx/>`_::
+
+  $ pipx install freegames
+  $ freegames play life
+
 
 Free Games
 ----------

From a63c62cf068cbb5222e2447706b7c89a847dc5e3 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 23:11:03 -0800
Subject: [PATCH 74/77] Bump version to 2.5.3

---
 src/freegames/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/freegames/__init__.py b/src/freegames/__init__.py
index a5029a89..84e1d1ac 100644
--- a/src/freegames/__init__.py
+++ b/src/freegames/__init__.py
@@ -62,7 +62,7 @@
 __all__ = ['floor', 'line', 'path', 'square', 'vector']
 
 __title__ = 'freegames'
-__version__ = '2.5.2'
+__version__ = '2.5.3'
 __author__ = 'Grant Jenks'
 __license__ = 'Apache 2.0'
 __copyright__ = '2017-2023, Grant Jenks'

From 6a12ec5c446af36c4ab965d5424112531fd21cf2 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 23:12:19 -0800
Subject: [PATCH 75/77] flake8 fix

---
 src/freegames/__main__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/freegames/__main__.py b/src/freegames/__main__.py
index f09f3aba..3631d0ef 100644
--- a/src/freegames/__main__.py
+++ b/src/freegames/__main__.py
@@ -28,7 +28,7 @@ def main():
     subparsers = parser.add_subparsers(dest='command', help='sub-command help')
     subparsers.required = True
 
-    parser_list = subparsers.add_parser('list', help='list games')
+    subparsers.add_parser('list', help='list games')
 
     parser_play = subparsers.add_parser('play', help='play free Python games')
     parser_play.add_argument('game', choices=games, help='game name')

From b88cf6ed20d0b380ae60339cb01ce43c50d93218 Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 23:27:31 -0800
Subject: [PATCH 76/77] Add tests for entry-point changes

---
 src/freegames/__main__.py |  2 +-
 tests/test_main.py        | 21 +++++++++++++++++----
 2 files changed, 18 insertions(+), 5 deletions(-)

diff --git a/src/freegames/__main__.py b/src/freegames/__main__.py
index 3631d0ef..73ed8a6a 100644
--- a/src/freegames/__main__.py
+++ b/src/freegames/__main__.py
@@ -72,4 +72,4 @@ def main():
 
 
 if __name__ == '__main__':
-    main()
+    main()  # pragma: no cover
diff --git a/tests/test_main.py b/tests/test_main.py
index f85436cd..85b4e137 100644
--- a/tests/test_main.py
+++ b/tests/test_main.py
@@ -4,12 +4,14 @@
 import runpy
 import unittest.mock as mock
 
+from freegames import __main__
+
 
 def test_main_list():
     random.seed(0)
 
     with mock.patch('sys.argv', ['__main__.py', 'list']):
-        runpy.run_module('freegames.__main__')
+        __main__.main()
 
 
 def test_main_copy():
@@ -19,7 +21,7 @@ def test_main_copy():
 
     with mock.patch('sys.argv', ['__main__.py', 'copy', 'guess']):
         with mock.patch('builtins.open', mock_open):
-            runpy.run_module('freegames.__main__')
+            __main__.main()
 
 
 def test_main_copy_error():
@@ -31,7 +33,7 @@ def test_main_copy_error():
 
     try:
         with mock.patch('sys.argv', ['__main__.py', 'copy', 'guess']):
-            runpy.run_module('freegames.__main__')
+            __main__.main()
     finally:
         os.remove('guess.py')
 
@@ -40,4 +42,15 @@ def test_main_show():
     random.seed(0)
 
     with mock.patch('sys.argv', ['__main__.py', 'show', 'guess']):
-        runpy.run_module('freegames.__main__')
+        __main__.main()
+
+
+def test_main_play():
+    random.seed(0)
+    mock_input = mock.Mock()
+    mock_input.side_effect = [20, 70, 50]
+    mocks = {'print': lambda *args: None, 'input': mock_input}
+
+    with mock.patch.multiple('builtins', **mocks):
+        with mock.patch('sys.argv', ['__main__.py', 'play', 'guess']):
+            __main__.main()

From cfa331f3d2d20f3fb742c9cd5504cea53504b0ef Mon Sep 17 00:00:00 2001
From: Grant Jenks <grant.jenks@gmail.com>
Date: Tue, 27 Dec 2022 23:31:31 -0800
Subject: [PATCH 77/77] flake8 it

---
 tests/test_main.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/tests/test_main.py b/tests/test_main.py
index 85b4e137..50906473 100644
--- a/tests/test_main.py
+++ b/tests/test_main.py
@@ -1,7 +1,6 @@
 import io
 import os
 import random
-import runpy
 import unittest.mock as mock
 
 from freegames import __main__