From 307916cdd99fc99bb4de567848f0809746db0562 Mon Sep 17 00:00:00 2001
From: Anthonios Partheniou <partheniou@google.com>
Date: Tue, 28 Nov 2023 19:23:29 -0500
Subject: [PATCH] feat: Add support for Python 3.12 (#1421)

* feat: Add support for Python 3.12

* Add samples lint session

* Add constraints file for python 3.12

* chore: Refresh system test creds.

* only run specified nox session for samples

---------

Co-authored-by: Carl Lundin <clundin@google.com>
---
 .github/sync-repo-settings.yaml               |   2 +
 .kokoro/samples-test-setup.sh                 |   4 +-
 .kokoro/samples/lint/common.cfg               |   7 +++
 .kokoro/samples/python3.10/common.cfg         |   6 +++
 .kokoro/samples/python3.11/common.cfg         |  37 ++++++++++++++
 .kokoro/samples/python3.11/continuous.cfg     |   6 +++
 .kokoro/samples/python3.11/periodic-head.cfg  |  11 +++++
 .kokoro/samples/python3.11/periodic.cfg       |   6 +++
 .kokoro/samples/python3.11/presubmit.cfg      |   6 +++
 .kokoro/samples/python3.12/common.cfg         |  37 ++++++++++++++
 .kokoro/samples/python3.12/continuous.cfg     |   6 +++
 .kokoro/samples/python3.12/periodic-head.cfg  |  11 +++++
 .kokoro/samples/python3.12/periodic.cfg       |   6 +++
 .kokoro/samples/python3.12/presubmit.cfg      |   6 +++
 .kokoro/samples/python3.7/common.cfg          |   7 +++
 .kokoro/samples/python3.8/common.cfg          |   6 +++
 .kokoro/samples/python3.9/common.cfg          |   6 +++
 CONTRIBUTING.rst                              |   2 +-
 noxfile.py                                    |   2 +-
 .../authenticate_implicit_with_adc.py         |   2 +-
 samples/cloud-client/snippets/noxfile.py      |  45 ++++++++++++++++--
 setup.py                                      |   1 +
 system_tests/secrets.tar.enc                  | Bin 10324 -> 10324 bytes
 testing/constraints-2.7.txt                   |   1 -
 testing/constraints-3.12.txt                  |   1 +
 25 files changed, 214 insertions(+), 10 deletions(-)
 create mode 100644 .kokoro/samples/python3.11/common.cfg
 create mode 100644 .kokoro/samples/python3.11/continuous.cfg
 create mode 100644 .kokoro/samples/python3.11/periodic-head.cfg
 create mode 100644 .kokoro/samples/python3.11/periodic.cfg
 create mode 100644 .kokoro/samples/python3.11/presubmit.cfg
 create mode 100644 .kokoro/samples/python3.12/common.cfg
 create mode 100644 .kokoro/samples/python3.12/continuous.cfg
 create mode 100644 .kokoro/samples/python3.12/periodic-head.cfg
 create mode 100644 .kokoro/samples/python3.12/periodic.cfg
 create mode 100644 .kokoro/samples/python3.12/presubmit.cfg
 delete mode 100644 testing/constraints-2.7.txt
 create mode 100644 testing/constraints-3.12.txt

diff --git a/.github/sync-repo-settings.yaml b/.github/sync-repo-settings.yaml
index ab8bb03fa..5ebb96e6a 100644
--- a/.github/sync-repo-settings.yaml
+++ b/.github/sync-repo-settings.yaml
@@ -15,6 +15,8 @@ branchProtectionRules:
     - 'Samples - Python 3.8'
     - 'Samples - Python 3.9'
     - 'Samples - Python 3.10'
+    - 'Samples - Python 3.11'
+    - 'Samples - Python 3.12'
 permissionRules:
   - team: actools-python
     permission: admin
diff --git a/.kokoro/samples-test-setup.sh b/.kokoro/samples-test-setup.sh
index 938402a92..5be9713ef 100755
--- a/.kokoro/samples-test-setup.sh
+++ b/.kokoro/samples-test-setup.sh
@@ -44,5 +44,5 @@ gcloud config set project ${PROJECT_ID}
 # Decrypt system test secrets
 ./scripts/decrypt-secrets.sh
 
-# Run system tests which use a different noxfile
-python3 -m nox -f samples/cloud-client/snippets/noxfile.py
+# Run samples tests which use a different noxfile
+python3 -m nox -f samples/cloud-client/snippets/noxfile.py -s "$RUN_TESTS_SESSION"
diff --git a/.kokoro/samples/lint/common.cfg b/.kokoro/samples/lint/common.cfg
index da47830eb..e38920a08 100644
--- a/.kokoro/samples/lint/common.cfg
+++ b/.kokoro/samples/lint/common.cfg
@@ -7,6 +7,13 @@ action {
   }
 }
 
+# Specify which tests to run
+env_vars: {
+    key: "RUN_TESTS_SESSION"
+    value: "lint"
+}
+
+
 # Download trampoline resources.
 gfile_resources: "/bigstore/cloud-devrel-kokoro-resources/trampoline"
 
diff --git a/.kokoro/samples/python3.10/common.cfg b/.kokoro/samples/python3.10/common.cfg
index da47830eb..022eaafda 100644
--- a/.kokoro/samples/python3.10/common.cfg
+++ b/.kokoro/samples/python3.10/common.cfg
@@ -7,6 +7,12 @@ action {
   }
 }
 
+# Specify which tests to run
+env_vars: {
+    key: "RUN_TESTS_SESSION"
+    value: "unit-3.10"
+}
+
 # Download trampoline resources.
 gfile_resources: "/bigstore/cloud-devrel-kokoro-resources/trampoline"
 
diff --git a/.kokoro/samples/python3.11/common.cfg b/.kokoro/samples/python3.11/common.cfg
new file mode 100644
index 000000000..25be29326
--- /dev/null
+++ b/.kokoro/samples/python3.11/common.cfg
@@ -0,0 +1,37 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Build logs will be here
+action {
+  define_artifacts {
+    regex: "**/*sponge_log.xml"
+  }
+}
+
+# Specify which tests to run
+env_vars: {
+    key: "RUN_TESTS_SESSION"
+    value: "unit-3.11"
+}
+
+# Download trampoline resources.
+gfile_resources: "/bigstore/cloud-devrel-kokoro-resources/trampoline"
+
+# Download resources for system tests (service account key, etc.)
+gfile_resources: "/bigstore/cloud-devrel-kokoro-resources/google-auth-library-python"
+
+# Use the trampoline script to run in docker.
+build_file: "google-auth-library-python/.kokoro/trampoline.sh"
+
+# Configure the docker image for kokoro-trampoline.
+env_vars: {
+    key: "TRAMPOLINE_IMAGE"
+    value: "gcr.io/cloud-devrel-kokoro-resources/python-multi"
+}
+env_vars: {
+    key: "TRAMPOLINE_BUILD_FILE"
+    value: "github/google-auth-library-python/.kokoro/build.sh"
+}
+env_vars: {
+    key: "TRAMPOLINE_BUILD_FILE"
+    value: "github/google-auth-library-python/.kokoro/samples-test-setup.sh"
+}
\ No newline at end of file
diff --git a/.kokoro/samples/python3.11/continuous.cfg b/.kokoro/samples/python3.11/continuous.cfg
new file mode 100644
index 000000000..a1c8d9759
--- /dev/null
+++ b/.kokoro/samples/python3.11/continuous.cfg
@@ -0,0 +1,6 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+env_vars: {
+    key: "INSTALL_LIBRARY_FROM_SOURCE"
+    value: "True"
+}
\ No newline at end of file
diff --git a/.kokoro/samples/python3.11/periodic-head.cfg b/.kokoro/samples/python3.11/periodic-head.cfg
new file mode 100644
index 000000000..83eace873
--- /dev/null
+++ b/.kokoro/samples/python3.11/periodic-head.cfg
@@ -0,0 +1,11 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+env_vars: {
+    key: "INSTALL_LIBRARY_FROM_SOURCE"
+    value: "True"
+}
+
+env_vars: {
+    key: "TRAMPOLINE_BUILD_FILE"
+    value: "github/google-auth-library-python/.kokoro/test-samples-against-head.sh"
+}
diff --git a/.kokoro/samples/python3.11/periodic.cfg b/.kokoro/samples/python3.11/periodic.cfg
new file mode 100644
index 000000000..71cd1e597
--- /dev/null
+++ b/.kokoro/samples/python3.11/periodic.cfg
@@ -0,0 +1,6 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+env_vars: {
+    key: "INSTALL_LIBRARY_FROM_SOURCE"
+    value: "False"
+}
diff --git a/.kokoro/samples/python3.11/presubmit.cfg b/.kokoro/samples/python3.11/presubmit.cfg
new file mode 100644
index 000000000..a1c8d9759
--- /dev/null
+++ b/.kokoro/samples/python3.11/presubmit.cfg
@@ -0,0 +1,6 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+env_vars: {
+    key: "INSTALL_LIBRARY_FROM_SOURCE"
+    value: "True"
+}
\ No newline at end of file
diff --git a/.kokoro/samples/python3.12/common.cfg b/.kokoro/samples/python3.12/common.cfg
new file mode 100644
index 000000000..25d2ea1de
--- /dev/null
+++ b/.kokoro/samples/python3.12/common.cfg
@@ -0,0 +1,37 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Build logs will be here
+action {
+  define_artifacts {
+    regex: "**/*sponge_log.xml"
+  }
+}
+
+# Specify which tests to run
+env_vars: {
+    key: "RUN_TESTS_SESSION"
+    value: "unit-3.12"
+}
+
+# Download trampoline resources.
+gfile_resources: "/bigstore/cloud-devrel-kokoro-resources/trampoline"
+
+# Download resources for system tests (service account key, etc.)
+gfile_resources: "/bigstore/cloud-devrel-kokoro-resources/google-auth-library-python"
+
+# Use the trampoline script to run in docker.
+build_file: "google-auth-library-python/.kokoro/trampoline.sh"
+
+# Configure the docker image for kokoro-trampoline.
+env_vars: {
+    key: "TRAMPOLINE_IMAGE"
+    value: "gcr.io/cloud-devrel-kokoro-resources/python-multi"
+}
+env_vars: {
+    key: "TRAMPOLINE_BUILD_FILE"
+    value: "github/google-auth-library-python/.kokoro/build.sh"
+}
+env_vars: {
+    key: "TRAMPOLINE_BUILD_FILE"
+    value: "github/google-auth-library-python/.kokoro/samples-test-setup.sh"
+}
\ No newline at end of file
diff --git a/.kokoro/samples/python3.12/continuous.cfg b/.kokoro/samples/python3.12/continuous.cfg
new file mode 100644
index 000000000..a1c8d9759
--- /dev/null
+++ b/.kokoro/samples/python3.12/continuous.cfg
@@ -0,0 +1,6 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+env_vars: {
+    key: "INSTALL_LIBRARY_FROM_SOURCE"
+    value: "True"
+}
\ No newline at end of file
diff --git a/.kokoro/samples/python3.12/periodic-head.cfg b/.kokoro/samples/python3.12/periodic-head.cfg
new file mode 100644
index 000000000..83eace873
--- /dev/null
+++ b/.kokoro/samples/python3.12/periodic-head.cfg
@@ -0,0 +1,11 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+env_vars: {
+    key: "INSTALL_LIBRARY_FROM_SOURCE"
+    value: "True"
+}
+
+env_vars: {
+    key: "TRAMPOLINE_BUILD_FILE"
+    value: "github/google-auth-library-python/.kokoro/test-samples-against-head.sh"
+}
diff --git a/.kokoro/samples/python3.12/periodic.cfg b/.kokoro/samples/python3.12/periodic.cfg
new file mode 100644
index 000000000..71cd1e597
--- /dev/null
+++ b/.kokoro/samples/python3.12/periodic.cfg
@@ -0,0 +1,6 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+env_vars: {
+    key: "INSTALL_LIBRARY_FROM_SOURCE"
+    value: "False"
+}
diff --git a/.kokoro/samples/python3.12/presubmit.cfg b/.kokoro/samples/python3.12/presubmit.cfg
new file mode 100644
index 000000000..a1c8d9759
--- /dev/null
+++ b/.kokoro/samples/python3.12/presubmit.cfg
@@ -0,0 +1,6 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+env_vars: {
+    key: "INSTALL_LIBRARY_FROM_SOURCE"
+    value: "True"
+}
\ No newline at end of file
diff --git a/.kokoro/samples/python3.7/common.cfg b/.kokoro/samples/python3.7/common.cfg
index da47830eb..123c3e122 100644
--- a/.kokoro/samples/python3.7/common.cfg
+++ b/.kokoro/samples/python3.7/common.cfg
@@ -7,6 +7,13 @@ action {
   }
 }
 
+
+# Specify which tests to run
+env_vars: {
+    key: "RUN_TESTS_SESSION"
+    value: "unit-3.7"
+}
+
 # Download trampoline resources.
 gfile_resources: "/bigstore/cloud-devrel-kokoro-resources/trampoline"
 
diff --git a/.kokoro/samples/python3.8/common.cfg b/.kokoro/samples/python3.8/common.cfg
index da47830eb..62108f6be 100644
--- a/.kokoro/samples/python3.8/common.cfg
+++ b/.kokoro/samples/python3.8/common.cfg
@@ -7,6 +7,12 @@ action {
   }
 }
 
+# Specify which tests to run
+env_vars: {
+    key: "RUN_TESTS_SESSION"
+    value: "unit-3.8"
+}
+
 # Download trampoline resources.
 gfile_resources: "/bigstore/cloud-devrel-kokoro-resources/trampoline"
 
diff --git a/.kokoro/samples/python3.9/common.cfg b/.kokoro/samples/python3.9/common.cfg
index da47830eb..2649c6c6e 100644
--- a/.kokoro/samples/python3.9/common.cfg
+++ b/.kokoro/samples/python3.9/common.cfg
@@ -7,6 +7,12 @@ action {
   }
 }
 
+# Specify which tests to run
+env_vars: {
+    key: "RUN_TESTS_SESSION"
+    value: "unit-3.9"
+}
+
 # Download trampoline resources.
 gfile_resources: "/bigstore/cloud-devrel-kokoro-resources/trampoline"
 
diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
index 3d07261ec..34a91ec7a 100644
--- a/CONTRIBUTING.rst
+++ b/CONTRIBUTING.rst
@@ -19,7 +19,7 @@ A few notes on making changes to ``google-auth-library-python``.
   using ``nox -s docgen``.
 
 - The change must work fully on the following CPython versions:
-  3.7, 3.8, 3.9, 3.10 across macOS, Linux, and Windows.
+  3.7, 3.8, 3.9, 3.10, 3.11 and 3.12 across macOS, Linux, and Windows.
 
 - The codebase *must* have 100% test statement coverage after each commit.
   You can test coverage via ``nox -e cover``.
diff --git a/noxfile.py b/noxfile.py
index 4ec313407..07cef9bcc 100644
--- a/noxfile.py
+++ b/noxfile.py
@@ -84,7 +84,7 @@ def mypy(session):
     session.run("mypy", "-p", "google", "-p", "tests", "-p", "tests_async")
 
 
-@nox.session(python=["3.7", "3.8", "3.9", "3.10", "3.11"])
+@nox.session(python=["3.7", "3.8", "3.9", "3.10", "3.11", "3.12"])
 def unit(session):
     constraints_path = str(
         CURRENT_DIRECTORY / "testing" / f"constraints-{session.python}.txt"
diff --git a/samples/cloud-client/snippets/authenticate_implicit_with_adc.py b/samples/cloud-client/snippets/authenticate_implicit_with_adc.py
index 006e75bf6..2c1a0414d 100644
--- a/samples/cloud-client/snippets/authenticate_implicit_with_adc.py
+++ b/samples/cloud-client/snippets/authenticate_implicit_with_adc.py
@@ -43,4 +43,4 @@ def authenticate_implicit_with_adc(project_id="your-google-cloud-project-id"):
         print(bucket.name)
     print("Listed all storage buckets.")
 
-# [END auth_cloud_implicit_adc]
\ No newline at end of file
+# [END auth_cloud_implicit_adc]
diff --git a/samples/cloud-client/snippets/noxfile.py b/samples/cloud-client/snippets/noxfile.py
index e129dca59..f5d827941 100644
--- a/samples/cloud-client/snippets/noxfile.py
+++ b/samples/cloud-client/snippets/noxfile.py
@@ -12,9 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-import os
 import pathlib
-import shutil
 
 import nox
 
@@ -33,7 +31,36 @@
     "docs/conf.py",
 ]
 
-@nox.session(python=["3.7", "3.8", "3.9", "3.10"])
+
+# Error if a python version is missing
+nox.options.error_on_missing_interpreters = True
+
+#
+# Style Checks
+#
+
+
+# Linting with flake8.
+#
+# We ignore the following rules:
+#   E203: whitespace before ‘:’
+#   E266: too many leading ‘#’ for block comment
+#   E501: line too long
+#   I202: Additional newline in a section of imports
+#
+# We also need to specify the rules which are ignored by default:
+# ['E226', 'W504', 'E126', 'E123', 'W503', 'E24', 'E704', 'E121']
+FLAKE8_COMMON_ARGS = [
+    "--show-source",
+    "--builtin=gettext",
+    "--max-complexity=20",
+    "--exclude=.nox,.cache,env,lib,generated_pb2,*_pb2.py,*_pb2_grpc.py",
+    "--ignore=E121,E123,E126,E203,E226,E24,E266,E501,E704,W503,W504,I202",
+    "--max-line-length=88",
+]
+
+
+@nox.session(python=["3.7", "3.8", "3.9", "3.10", "3.11", "3.12"])
 def unit(session):
     # constraints_path = str(
     #     CURRENT_DIRECTORY / "testing" / f"constraints-{session.python}.txt"
@@ -45,4 +72,14 @@ def unit(session):
         f"--junitxml=unit_{session.python}_sponge_log.xml",
         "snippets_test.py",
         # "tests_async",
-    )
\ No newline at end of file
+    )
+
+
+@nox.session
+def lint(session: nox.sessions.Session) -> None:
+    session.install("flake8")
+
+    args = FLAKE8_COMMON_ARGS + [
+        ".",
+    ]
+    session.run("flake8", *args)
diff --git a/setup.py b/setup.py
index 047818ca0..71a3655fa 100644
--- a/setup.py
+++ b/setup.py
@@ -70,6 +70,7 @@
         "Programming Language :: Python :: 3.9",
         "Programming Language :: Python :: 3.10",
         "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
         "Development Status :: 5 - Production/Stable",
         "Intended Audience :: Developers",
         "License :: OSI Approved :: Apache Software License",
diff --git a/system_tests/secrets.tar.enc b/system_tests/secrets.tar.enc
index 06696ab2ab4464b5cd1c5246fa09304e189166b2..937b6f065e8e90a37d6aaba424e4b73010ef785b 100644
GIT binary patch
literal 10324
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

literal 10324
zcmV-aD67{BB>?tKRTCXZ$2ub<@DVU>P11%?W~F|`r&7(iSZxGx_$LeV0pt>@Pyp}n
zz;8Un=ZwXIM2MlO#gxAAU~-*0`h0Mb7*GEegX^tA0|D1&55uC265pWE0Fb9-AQc6v
ze}$1*l!M8p4rJVXfag{}Hto#OKzNfRqZUS+MzF^kQ>1`dF04r1)Z!<2$2CA9wm1Ex
z1|8*h5Fz{lplc<O*-1h}EsQ+ywQjQUx-`w9fYkW(tm=$4O?Uc^RVhd_&n6vxN;gD}
z*h4q~Tv`7<P1znfI{oatL9t$u%nOCY-r%-JM@Bw~KCHLNA~C7|IVEenL2vy4p|j{K
za<G+e8D$JrVic)%ofcz+b5%BJ2MQ`7kED;PV<r#yb|`a8z;6*E@W?FHBJS&zu}^2^
ztD`HKau+pW9@A3lE8Ap&%Vk9w4^WOpZq~j&A*MlhamTVi@O&0hWaFhX2TTREpi;vi
z!YJJXr+iq3^@$f$=fb9aCy_%B$OJ_p1SbXgX_F)K1VP1+^XTyk_!LMxf%GdOR29yn
zc@CByjZ2^Sb*^ros9x0U41&mFktGqSc4j<oy|dp^u{mOxu}WEj_d%?-qqAxn1gn8d
z#B#9dDK<_|c`5Y{OL>r#R2s7(N<d$JJQl4jF+2qf^Z~^E-57@aV{Qm6vA%6B_50u?
z@Co!m*LUC_^xItIO2o~ngXh8shOfYP$}kn-f!eXy?Z=G@m4U(iy25V>YlWUY*Ro!c
z9%9I<*vAzKV8&f4;$y-|PI&b!z|5m*XhWwZT3sdEyn_zUI30G`F@`hg3_y^Cw#NEg
zwh30W<yhkp|D1wMToj=^YfrIrBbPi@tGfFN8w%ZI*$YVy%yojz)x2ut1QI%yR0l7N
zz$1Dq`hGAlxNMp%!cudndGz=}XQ^ym7nto<)p$U)qGRZ%liAAdSZo*11NkkfJ`yKD
zuj4USp7PyU;qyyvGXZx~mq{}|Prn%HuNl4GdF!IzBzovq%>;l33#dIjG*oyebF?Bb
zbb}xX81*@`b^)mWK9uwHEj^K+qJCNNA)aC_G!6hip{VJBjl`>=nN_WSnOm6u_jbVU
zI;Yv1=Qo%tTLwfd5*a4dgF;M#u0kaoo(_xA9%$s2SjgxUvBbH>p5cX-WT<!jbUv~{
z1Y-{+B0!SgBf6E|-FN=Q1N+W2kLx@vy652~YMYX=uEgNakZ>?et7y7nF!!|J6f)4{
z#*&UU)vocfjU2_dgsK%t3T=_?%(kc4xK?!+(D5sI?-$$};R_1u8$84dY8JW<unKPS
zuCC-pwxb;@;V??aS&rL>mPaUmrh;r&vgVlE_R9HjhlB2#a?b3?_6+mxGvb*}B_OCy
zRWpZL^uUreJ6*S_e((<AAWFm4;~?6l6W$vO0CuYmfa#FDL}%-GKCqU;WhcRd8aZ^N
zhK7oX962aEjrNNrhK*?^gvtNp1ccm1dGZbyi6YldBSywKx^}tfI;R84wk(nFwsK`D
z)!M=`Hq*8!v&@e(-0vX5U`?-(+>h4Czp~^ThKQvYZTTrl&{t3zDs5wV8RHb{-uiIW
z%on!_T4PLINtbq`r0ZwfGwtp>s~!*7&S`ci%ZllDs(?5R8JxQ)uND?(akI5Nk7tir
z46Ejz4!XkToCI3Cm9VJ{f%a+Vl>OiE)Go*@W&iQ!q&V(scPOavB+M@AkwJM_xdZnt
zdS$X-in2}pQgC~bB0`2XhLIt8wR#zl^-b3#N?>rdC$7m4j@<}OI0}B;fHgpsaZRNr
z1O0w%?vmk6%|4V$bnmoA8gnf4pP2DKp<Jnd0|@~k<Jwk}=|XYJuhXqGSnYrxp2t*k
zC8#e9$erzS5z?eHX{9ypW7f-s%FcdZe;O(4cJY^7A;+M>jq$D?#VrH5+7B9eC@VKW
zbI#hwVfuf@?n@c|n<jwjoi?=SnHVRqZKQ9Lv(C)X1S-PQo+{glQI$pTTK)m(m{g2W
z1nh!Y@D=}~c{8E`lx4#T5?j<ivEH6Z*3?c62HTZdXgy@`&3+`@94u^=GambXmMnJ`
z>^cjN5WB8BtSEUjbeDyT$knn^l1E4TQtR0q>gPK>k2eja=JR-6v1U-1ba-s0U^7}9
z?)<n_edZ~?t%>%JQ^)@goAiwG=XumtsS77h%Go~=D*MIy1p|Lq-wRzdKzq)uk|dc1
z$#?cn9_hC_vk$u<!et#@*sx5o;No4nh#hV2G)WnhAWOUQK5ifFT-cUYOB!@Gg%MD|
zl?0xjW1vxA3~Sh7gEloFd^BVI($J;}jCM$_9L2B$;*eQ=O-|P)S@J3R7C;HkoK66q
zUEYaVbza^o+NkgygQb(jRVdPR-{=g>UcgS`+-1H}Y~DQ?i>HTAS=Fs>Nv$LO(DHS!
zG(7=_zh?ApOegic{LOO6(gV~3fJPTA*ziR=&igdUIh;jc%a5bL0`&Zsb}NRtzmFb~
z>O7)|6DK=Y+EW&o%^Htb;*jDW_pRw`RM+nbEK4IUEQA^Gqk~4bCQfpKJ5@kgqtlOc
zfsu7nUMhN_G4&Hs9SsG&6K^bX6qsdfq4fGNtAgZA7IM^+*fcZk1(uElEI>Iei+coT
z-UfoE?3Y?=ZJ=D+HdTGlSnQJ2M}Fa^>D5Zyq#Z60%4OHKG-AqWgvv^@{>H6k!$@{q
zQJ{S$1Ofi_Un&p_mg8180FNSljxTpfU%yyL#^RXY<u0!v&N#)slJ{0V<U-z<w(YmI
zk;5XQveHg@X!ijXR3iLUl0cxb`Gy&C4tkIs>9;@{5V8uYC5#PB=#aiTg1l~!r}Kon
zWWk5(SmfXpaoA?!Dz>dYzU(IfMvDt(W09(M&rTxfD!U_40?;FH!>as&t=St)-Lr~u
zv6X5D$HXlHt6AyRoKTLvnS!1$x=v>UVOLq3mz87iVPm=703GY(W#a|;E)na4<siOA
z+Jw0B@@|Xp)7yTXFr%FpK&5aM^&d)A2p-j3Z*_xif1vCVQZVRqxwD`|L#4pDdzjV%
z?4hwx50E5mbUI1rLoSpMhlmLKx3+gSs<q>bTNM!e1N3&#`R$JDHL=1sw2bDTFA3pY
z8yPBn7N$XX$O3UJZz|rvy*!}j&o~`WF}=7|n<ji+4At%KaO2>oXz_V7I61^`T@Db3
zOFJ04fqK#>8yEoK3OzUy<95kn4vXm(=pFH2zZsB#$Wkjs6UEb-A}*S6pXQHYZC}-)
zsVTPQ6H}3AuU0sP=Amiq!~|qa56u=F%YRfeACrg>mqz-_U~?tY+C5K%sf?RPZ0TGh
zy849T)E5hVoXZyp9(Fky$jX1R)2$`0Qx+-eF_<{ANwe5Q!&jxYolV$&2321KP?@P*
zht&@$le=k;jMA0)jFOe|#^^KK>Betox3Gid&3nDGU-lJdT;|s9OY{ynz)}uNla28I
z`)fB||F4t!Pnnk)CuZ#8F<f47nh;C(*Bx$a&wmHUr$9aIKvi<F>jli1%>nTBqKL{K
zlvComr#De_Tz@I#kwmX%t$SCL)a4Tc*+PRqDF%4)(ubm&oQyMV5u6IoT@=)%B+GR{
zw<r3_3UxxRETJP%)HFpm)D(*b;bw?ya|WlW`|b}E`sqLNo$97=%*SoYK7+*y!|jLq
z$DPK6356t~Lu+hRdaXBeHWP}ta2xlG(+=FJ(0>B*uQwOhaj0DKIpi|O*vs&u6C(D%
z$a0|u_>HCFist2_)?skl2>XF+$|G1SnKr~t)uMcgML68K;#cq_=@Ud8#eePTXB@NP
zhj9sf>CFepRQX@K$q%UJf3w7W;~p>Jam`j7^ngDI=-lq(7};U<11bMa2s%mOxny1z
zFo05(-pX&fSnL8g(=Z;Sy^@WcA0E<kY)Qq<-ge!r3NPb}v#69iTjNs2+iTjEWss->
zkDXeY6)6u;Q+kq{ZT(TGxv`%lgJHfw5yMK!f70yA_bgh|D##2t4d+y|U%sniH7JM}
z%OT%wb|@YWVlEZtKj<&D$Q`Toc*R;_Pf%4g-VroJHilZC?3dBm{&S02V?y0Va+j{O
zJ22<$Wh|^K?hB&E%;xJ~5iv?+xxXep7OR0qfD_f*vrGRdw!i8e)mMx#2|ot8>XtuP
zl7977_N8A|fUMJUwM@<!;lkLOz3*a&1=j~t4({f)!=}(3`n)kliz!`+ijyn6olxp+
z_Ert7)0`7DpLtFWw#Ma)fB&bt95GPfr}H<oe^4&ofgzc1(`}#`r3Ot1#5Lt_C<(X`
zU(x?U&TSX7oKsk^Lcwdt$ZspfmbvQqEZTd`eW7n&zg@>Z{cctvR^g&X$_5*ef~sCH
z!1bB<^%Wab)|YkbX=QY5<<{-q>ZA)W!Ywu1f|u$7x@`VGBxkI_m(s_2di=gjH-~_d
zL>)uFDG!(`^<q0AroG4LdWl!}Zq{bBTMld#uUE$+C5ROE{~=L5DSr%&AaXJx*%6q{
z(H00~ip=~@-h`G;R~EjQe(z>1&~AmDQ(`aPsPn)c=5Kja2goXjR0m$%SyDdZY0^|`
zz|-ohMvH2<j&(mAOfqxv2a{MoT2g#PZEW8;4bIn?2ndgl7zQSwi-tm2URv%`>R)Rg
z4GmQGSRs7!+F&xvJ((Gi6MmvRZEbFEFKY4{LmCm>u&5qc`?U6sF!!^d^6v1}?de6%
zp_@3V{!=f)$;j0Ht!Zc9gicwQi}mF12l@{N6+>IG_Q09rb4jOatHCHyq%DP75o=Lg
z4-JQH0cByy87>y8`N2g-kvV#td;Ue9$=@ig<Ip2S+ln@z0~_*66c>89pr2<__r7G-
zb%PGx#;$|-5o*?^rGid*g+BLMzIW#Mx9(Qj%TrzN{CTb<n=&h?uwXftM2D(WF!Ffr
zUJa-8rXEM9_5o^_qr3YlF+1z}O9@0A2aJQPH3@&eS6S0MU||$b9le>U$c@I|Z^v~J
zAAc4+;lCHK!d3`Q(5lOMhG8J&$x`SEdUDb2<M%JJ-#E7>%$-Ql^8Gj0vby%tEjZH!
z*d!`*kHo8rN#05r))tJA193aiCjyY9_XBB)FX{7V>W}1)LptnHr3E<9*ey9RVSmrK
za0ej%;zeBAJCMUbbr)~dVLi?mq8qD}KXNQ;fMFUoQG_6kZESu=YQgJ@N(;{I!~M4R
z%6>A$t<*#l())_dJY1lQk>j$w=pUY%M|6!^cQh}meG%Q_+y39KsBACS{Z-7L^6~U5
zV?F7oLs>6fJ-H4CXsra81)^m4VVoE*h44y>QJ?HT$LQXI{utZk1>@h5BQKjX1=4C+
zA;wftC0Gc`qvk}F&Gpjoa7_)}IeQPn@LO1-EkzY>u@=~NPp^~$TVr8JIGQ~UzW3kl
zmjFXsYGBDA^nU+R+|LVrZ#=%fMfySzNW<Dd(5(JJJ+tzSu^V9mqv+RSSYCL#71Pnk
zS^)KqqICaw;BOO3l>ite>!OU4=VmkUdStisNu+C0<dj6$5h+g~6~oB>bfB`=X<rDT
z-4P_?bSvP6MnOlyt$0xJl!05N-hZjhaLGZpz-v8@KjD<<J5ix{>AX&R=e|W}OEbL?
zzVOnHQpJc{5WluUrE4QiEzXqGz{PUEtK#6TLWwMp)EyoafM`#!Cf|&7Tw*@DXkk+Z
zl+BJ4IUT{b$!Pz<|E`Az?0dyR`v*5LCOrj1Lw*$%aNb3^FXd_2!v=T`l0QBfHfnJ}
zpPfu2+Oe7&-3X>ovarl&-7+g>p<$RCJ0OnlpkS1CSnrXV7{>K1hGmk|D^fZZ%N?0(
zWKz1}-a7k`l&*Uvl;)nTn)6MdGWk%~U~L-y3ZT#RC2vLMwl8VhY0|J_Qx27@G8cV#
z{k-9cHq|SdF3lr%<&?JdKdbE4z&;A#sxN6aBXMyvxJRQ|*q+9G!G<%)c8|=2EQ+P0
zwDXZsu*}d6n7NICsD8@Gx@(uCEi`>!=%-%8g%RIeqs3%w$)Mc<sXmeeP5eBT17EYs
zmLAN*#Jz`2_Vpb}Hu|VT%$Q0igJ3;V<|DH(v_Q0+-+C|{BKg*l@-eCji|OJOW9@at
z_P&CDF+rZ}rzE<wNbhAyYmiw$u0Xdv9%7h15MVk{Ox|;@K~M|TvYNhK|Azq>9W3h1
z)$8PtXLuS$lmYz6yUBS@b<&_%B1*4+mbRo}A0;YggK{7(q(j#!0mQTCJ&(+{!wyg2
z1O0t94rnWkTq_8jfmWw9Xyh3Xu<34IRilI|V<UIkt1sp8g)TcdNg&LAe+3JeWDx`+
z%<An{bp3C`Xk*=r0U=~s*5%E$jVSTLd1IG3w)vSL<-~z%+xA^jt-QM6H6NMi8!BCn
z2txkyC@6tgJJRNCMwWu?&1wGI%D$ky|6cNHPdZ1dXC+Y{3|aZ^ac(wcOlZJo#tCZ4
z<s7V#Xif&kSie9racbQFh%J_0p0J(AGc2KvSp_1%F3!f&0j^2wEuy&-@eSPiqz|nq
zN=Vdk`i^_84^M|$V3$?^uB)4?{oz(@7s!s*;UNpv*>TM(bI~iFw=^M5;U4fqv{-lG
z^uq)#XexDiw|DXZ&~7Cb{^mbSK@0pv2~Y4#{d$8}-4%l0?^}@Q0~$@oRN0fgZq6hn
zvi+<<RA^Hi#Srpb;q2YSdW;I;%#<{N%I2hU#JsD3NEL+==r?m+e^umZ<E2%3sDjq|
zz+dp!8Y#TQ!Z?WIn(Wm@mqP$H6Y+&vq+y7%76bu}yZgBEHZs>&SPtl;in1b$ObK!I
z>_2%I-<r2QKT#Sw=~sj}JHPEI48S%ugEnypx;ogOXKN$EITlF#UD<mkgNc2`VM;(x
zTQCF))Wh~tace>UW_Dqn{yL2G`nFn)dMBfUz2uQhuQJP6o8*vg-ZVs<KBb%i5H6f-
zry`j2GL>jzN*xK!(*g4Yi_0o*53!Cva(7wkdoNaKGUC-6hsb&b5!+yJtm~gJ;!>qd
zfJvS`OR#oiaz_517%+RywTg!|8>tQ(VmZc6&|$D*xwqo?+|>vF)haa!tTb60!tI||
zXJWJHUg0>oX5yxb3Xa;q`Y~Wa$1~!3E7!6~CmO|Y`6DTBY;lsswBou)9M@SyDE-~d
zPkC*cc6&7;AHblFTtdDkh^)D8C8OeYc>iPjog_tc)hvtf;*B>oP!@#15AGr40gY&{
z%s48j+(=HBqGSz-i-qY7r?p%f!!g-bK}n$c@5NfQMNJmanoa3c_U9WEO83Ig0M9Xn
zzO(JB<Twi-4l`}ljgqbm8#ONa)T$0cKR<HNcBZt!XM2X|U0*)@=gyxdO{aUW24rj|
z-j|M<xx~R2g!gAs$#=n)j44<uW0*E;udYIC6dk#8T71*}SAr1vX3v$d=?4(H+Dhbh
zrrY1R&$-FP)9+?$xm2|;<HaC{^`FsQ*lJQ3fN5jA$orr&C!7H;CtApa=3Gc~vw>)9
z8d7p%-#T|&lDNWjG{oR>_Zoi$7~@D@ct{n66r0rAK$mpW{$+$uB@-a+zdcer%7o)5
z@9k3GN-?C66Nub`157JnuE~69qd?%BdtlrP*14yMs2Nk8tW8*^m&~sbTV32J51@og
ztQAzhs_I&y*Awc;j$e91zAK9qhjle}kGrpOJ0SYV%t;2N+hr2A6K=shfM9)kHM_;i
zyKvDQD4=xEER|hyXd>iIS5WdxWqM*-ty#S(^-Y6t2l^{HRgHK4pdX#E#II4`j|fll
zP|&2wuF+G#9ZZ|XdQ^I(QR8P#-0|V&<&2jXohot9?3yk>-!pW9^gKEjLZo;(Ogzw3
z*cHZ|DIWMNm`-rv$oz0Cq_V=D7sP(%m1)!sCyqr%2&*5+8_fp=qW!Q*%pBP3S#q@@
zgdIyPx(nclMeqF-@S;=#W>9Jn2t}t8dt)l52#A}}k$EWes=i9j#vcEUK{);>nNB?+
zbcIV3hMe2=&|xC&&H{V!6m`x#dzs0%aE-u+qtCAaC;y@vrT%iniB<gkw`@n*G<TQX
z!NJxkG5v?m;Pd_R?1=$*n_J)87KS#WuQ9e_aS;{y%nQL@g`{NbIbp$Go8^@!Y28<5
zneZd71tc`{VVGW-mKEI({Oiv+A>qaXV5;yHd}1<oZpv)s8&6ZOQZjaHb(&b`Y3Q0~
zs`mUZ9I^1jv-COu`vke{H}!1lE>Cw|nd*Zu*+Rm2E35h3j@&LzkD5zFTy)vdIh(6#
zN%_<YDN#9W#BJzY26wh5l)s3Eh6X=o5GaxXj+UeT7I(R$B%X4;o6!4qQ3u=@oZtoP
zpx`(LkRz<e+-lTZ2vmKd*$dc48XZz)`OUBAa;g+Gmd|TT+(qdkDBJqg&0cDo84jQJ
zL|YypREcP0u#@z~XEmix15e0pX2Ti3wf+?{lN<YC$<WJDnWgaZ;^pdcZustaA0oiY
zi5OF@_n})>U*N$?eKhcbm!3@tB5?P@BL(IrJM{y<*jd%DN)p8hs0plMWY<r5#SWlR
zbczD#Xz!7$P;|GyKJ$#*Wy;NLJSe&waBi!MR6-+sqj1fDfO0)A0bo|)y~T6ewW~7!
z%1bMv%PzW{NKnJJ40If~&;)wd&~#CXv>mZ;2!ygj@f%UVJ`@TEZ<Il(m0+&9u~i3x
zY8s^w&XJB!tn4hWkr}2G4TuN+3%&X5sqmV2K$~6KTZ9qcBQs&9_2;~JwJUt^+*Fss
z6BZ$l9YiR*L8zT#mLQ^z#cqMb8N@P>xEUkC;}gB=Bvz8>-Yv|QFDvb-_$>ABNzKzc
zU@1eXmLkWD0-154HP-6malwIAcG|qUu6A=uXUnol0CIDoCwI2>kLmtmt0&8?!MOCi
zcfk8jCR~{>W9K$cUf_Huhu(fA>p$V|#w2`aZukFH%96=C&LyuN7=yh-YtCQ6wGUpO
z<FnP;_=cEhCMd+9UiCOEyI+9Aba>-QIM503V&cY_<T$^yQ^(Zb#omABUkaJG&9hfh
z;Dv(GTihMG+8G~mtd!x+YTO79eS8;#<ivH~Vn1i^UuhoSX~<0w;h*95-SdaDuu39o
ztPupu?7sf?l&mCs0CRHngm(M`a%C8;!Jp&gahCGE0yP+*jDIj1u08(9<xg{<wzTp#
z-Ib4$`UVUJO+l>8-u99j*-ZeQd}UJ;BZ;M=E5`y^KV=+c+m{(`bGLHsQ`ExAuNZXX
z#<2ud+iSDj+h*81;j``{1+ZP3bX}#mJ1J7lvxTxB-B4*h=I;bC3&PmH8^9G+Yp~mw
zofuHu4C_cYHQ{COvyn*dg_fS;)Q1IdR7apb(aAh<(0Poksgmqm1*t7Gh!(fAoBTC6
z%hR*<oi$>~o)=Ed?xsjX@G~B2X`Cp?4I)Zct!1xwr{Kw66bS8PDUr5?N8}Tht+ZOr
zJnt|*bpL~Hvn(X=K-8YgDa59%M4*HzwTXq<;QnXwwnh6mw4@`{2GN;|4UEAogp4yx
zIaJ7?t(=Ui>Ak;GG$?5pmjv^4J{?zQ=<+>MIt`$B8hHatZ5B$UVxLhlSqS`kD@LQo
zp2<gNYwI1eSFOzf?%HR8=pz})6peb`5P@K;U^(cSlaG`NssV-|p?7pZ&qvb#_h^we
zMQomQxTMs;M8lB`9hen3?mlr{%t#rSNOH6Z|NDt@lMmhV?Li;_+E+24>XRyx7J%-k
z=>2}X3~W*}Amesdi?ao?ur7jiZ){3&r(q<7v>JA*5*(%{-T!}uX4R)VU0g+M7X;LE
zaqUu}J<+ba!$)Ag*ag8J%00>ceyJ7>z>&9v0<PmJM;yOT9B-kZ88I8W4hl+zVaV9X
z-M1zv#8B4{cu<U0$@=^Yy`c`<WvC_gwr}dn@o5dLPEnF7Qv~o6#T1J<o1zglUVeM+
zQ}1S+6+1NQOm+y<T=jIE*)oNENqTrJc~>+UDtD!K44|E(X!=<CCV9br@2&7l{{t3%
zWs_Bqbe?qf!&Y1dvgSb}0m%GKgbqmVL@5qpIkmBTG_C=<Rtj<W9Jth4X3(tNxwEI+
zIo_3%2ped85SiY&qmzg@L6lP%pFXs+%#qX!rfSU(4pj7y82_8&%+_>H{M|BlU869P
zd&cDqoi=yM4O0-^*V*m`Lr~r7t)R8lK2kbXuM1S8@K}x$?v#Q0Ka9)=`kUTIyOV9b
z@X4ko2F5^akQPA_r5)2F129=~G+~pi>N_{?(ZA5}GS2psoZii4&+jnI_}-On=sfP&
zC=y2gEyAIlwD|N1a&XhPut4Q<98XH;{osVu)fT|;5oM{kfG?ger9Qh*i3-Nw)@~b%
zR3}o;f@{!Ilap2s)y4g3jz}F&r)?s4+&8z}b9*6M>!;m}fh--skL5W!LH+(3J;Y%?
zOPFk|=lXN=0L#lT3_%*9p-tW2i0VM~5juU8oPxW0s#@0gu*I8phm7($+E+CI=pyHy
zxuYBDB!X`han+HLW+1!UCY1;-q3w;mvA@9F9ZL}GSml$~i}5kg0X&B%I#x`8G4rf7
zbzBU6Sd%{Mwc60)EA|%&mWsGgK&bgvY-LOSW+Q7In~kd=`&(BL_(8$4@f%FS=R2rs
zTO-9x#bH$mo~^XU1t+EM1glrg@XO|xE1Oy2iwcNq>B;skf~ea$Xfp?i2NcT1yYt;<
zHjkplf?uj%_si-J&9K3H=lYj@GEUu^F`|bXSp6POz`tg|Exb67_a~&4t7AglwkP6M
zVsiUa8-(ifG<4<FRr4bsincSa!TlBq^A?R1yhgg7P={jh$VWhbZZ%p|wX`&?m=o|H
zUnMZ8)}2FWlEC7#eNX~c?$lG7hgXrN<FLulV-gyO76?jUDvK+EeiffJF?)JX*lCHo
zO}0q@&wtQ?yWIxP8&VePG?H8lq64&N5C9n9H+8fzqFwTx2`9dBbxytTKKUKn)`O#$
zQ(|Z+m3Ow~7%TPQNQG^-PpdS~HZctp7B+*ts`<b6jt}k$hLbdtF{MOepiW2|N<OW*
znpHU~>V0T3G!j3Z;L93tlrs^d5TsiCsme`c&isdg^zZIWX>hLk(N7|P82pS3Q9K|F
z@bOzl;``E?b_h6-)vdv~WvCLT5q^?UmJ6|8HyPRTcYy|qbyFN4TTs2}{s*M0WN)*l
zED8|u45>kvx-4EPW>Pm;a~8AMJ2Q&Li0qm9Ra$V*u$H5|b$c+ZRv_)$y97$4I?2o1
za0g7U-m;HY%OPG&-rOv$pDc9)+Mvb@D5gt53zp+XPgfW+;gm)Ru5arX<6kgkLW>Jt
zWHjbH$i0RY%ClZSMXoDZlLI;iTF54)4X-O5`!4F+*}$u}_4cMn_l4u{S@U=U>*N(5
z6MavLiRRSi3Q<%q9Jgc9<l3bkHwz$Z(dG)*d_xnHJAI(4*Fd3(z5o5vjUa_th8UO#
z8kV+;8B!~ZFhP5vt=WX11k$Kjt`97dg($t6SOK+%m6<N$Nm3uu*Or63S-(#u63Ja;
ztm4SRjsIPq{Q>INn2gjJOq!DDL<(=%6NvV2#F-^HsCc>Kv%Pmqp=;B(_J)%oKTqbf
z{_C^8W;pzCw?i&sZh5eehY}=P{yL-YVVS>q4G?Or&3HRrs^@KF9bb~xM>QOlWzYN=
zAs?I0Ik3qDWLekoUxqaJ#k^Q5{(4i#I+=WQWil|tDTpycXp)qU0Af#CQ8a>T(+6^f
ztsV^X7Q_2iVYD~z8rg={0W!LNgDfob3G!_&#lxlj$TZ~H*nn3=okurra53+EGk`%*
z{oG_^H%iDg^>$HT`A$pLbNs#qw=jazm0O%UTNOo>aD!C3)H!*ORqp-4RU_~~3R{Eq
z)cPvepR&W1I7aEHc;^WUASEb10XKI=q~|U@d@Olt8$tRnUuva$spC~<DUvvt$OPy;
zaFTQIP=0Q00q3u4C4#yEyw(OyTDck2QN!$9f-_bN)TqYa7vv<QX5P8>C9*T_W%p81
zMkLU)9ljfg7PF?&dDrpMk`t_^(Up&Gx%9c&rvPRK(eJ*P>4tA$=7-m>@RYB^0hbYp
z7zn#9J#g<JD+Pp8dkI?ww|PG7mVirMjd_JS**^Z4s?NYL9wii;+VpH6XRBb%CN3Lw
zhIkC_nKMfGO!=Ew_xy}x`J$~qRY9ck|4SklVE+h*QO+*=>^_dUO1}kx8-6$#u5;BP
zwD|EkKAIkznGfEfxtB85g<K27XC_aKnQiZbxQ}BBQ#ptd<3rqW=PO_-D8$Cbk$`)g
z$&11RI0%L7M%&mLj~Os>;30_k`GhtnQjGo4ep(IT-i=3vz)K*P71<#e8PN>7n_>tK
zL`Aim<S;wFG4)qUhb*=h|0-W;4X9v{&ksAkMeRE4@~=k8uxB4{O!64JQv`G0?pw>O
zN=nO9zh?%~+bbYw$Fv;kqvOu~H>kT}kII~3P2Y!QDQUZaq-30mE?Il8FlsXiec=c?
zXO;8G*Ax!HYeIHV6Cwlzlz4)Lw0KY38hP1}AH9vl*LNuTr9?Q7=Qy35RKt1>;JjWE
zwT^pA=#G?zS@gO`ZGqn@e$o+R6N~Ck9NVPxe`{w#@<Edqx7{Yz_^XL4pYae>mC(T+
zojcAZM;1TUyqV}vdALuC;Z!`4907UA@Izv2r@nA~%nv+=nRy;1JeTok+}VEYCJdvU
zO8Wk7oV}<5?)7Rcp62^N2$7!m?KQ30^F?>gX5X`au&~gjK9d4a7Bq76dYV%7_N;^q
z7vDwnkY77%cue2Wvb1R)*=w(Ek2NLOIYliKIZ++8=s<fhy$Ze&w;-TIY2-jD{+vYg
zAqK><3Zj8c2f@^N*w`>GK|6B@8w045og02~!#gLxsFlg@z$VeV#e9eJ@Aj}iz`7ia
zyNb<~F%e|fxULVcOk<WiaF@v~Jc;A0)myB+v`Zfp2`J>hUmhu--?8l#A2NVk25ZD@
zd8ZbG02NY=yx~UN&W%tM9sbh7CD>D?fE#Cj@*meUySQNEHaTWz3sQ{O;GO^Q1-cd4
zC7h0V$wOj5BU|;ziu~eI3}|HAJa?5&P0S#W5AMtSS&lWKh#c;tCX6vq%Inm&rFb|K
z`tR(%4J{RNXbt3iYF9#fn-HXGsw<=;pL~DZ;bk_LI(}OI(H&JGVdfKWhTAJWxP4_0
z@Z}?$B5lf>I#Rh-7y_8idrPL|4;c#O3o?Y4@w&;-oU`>zdR&c$Oa`vBEr{OsO7R<z
z;jri|1>~EJPx9U2-QT}{q7i_@*{jfL+5fR_%@N2eZDm*h5>Vs|-j~qsM8z&l&}OaL
zT@3`ndvZnchPNfJ4|q?I0q^h|i~F$HupZrl^%gjOdt!<d#O%V$U0N?JrN>7@-UUhU
z-|0T-L+87u)^!nNz`cvwV`ep9GHJ!(73M{yFU3i`BERa=+$2E@AB?tXnDi%-bbk4S
zXE9h130OVDzx0g1D3z5YfEf?#$dS<VPxm(m*i<4W^1d{_LA?5tL#K&1jpbQ5Rq#$r
zou~^JUF)kb`^}sB89YVDlM!ZA;p})yxr9alzNNSx+~uT!F_=~8C-|XoppOP$U-tAi
zM5Hcd*8EqdL4nRdpSm4B`Xb;pu+UdP6jsD+6*fX%MQi|$?6&B!CX}dI`Jd6B^`Gji
zJUAFp*yN5P2=ywcS{jmIhD)OS*v<h^I>g*Pr}B)oyT?ic%*20M0?-&nG#jA|MoPB?
m<Z6_Jws6v`2ucUDPkRO_>aDa>Rh^@{#K}!?W}skBc_JS4|1<mm

diff --git a/testing/constraints-2.7.txt b/testing/constraints-2.7.txt
deleted file mode 100644
index dcc09f75e..000000000
--- a/testing/constraints-2.7.txt
+++ /dev/null
@@ -1 +0,0 @@
-rsa==3.1.4
\ No newline at end of file
diff --git a/testing/constraints-3.12.txt b/testing/constraints-3.12.txt
new file mode 100644
index 000000000..09aeeca1c
--- /dev/null
+++ b/testing/constraints-3.12.txt
@@ -0,0 +1 @@
+urllib3>2.0.0
\ No newline at end of file