From afe18e95a9592434e93b648de5194cfe54443f84 Mon Sep 17 00:00:00 2001
From: Sebastian Rittau <srittau@rittau.biz>
Date: Thu, 20 Jul 2023 16:45:41 +0200
Subject: [PATCH] Add an upstream_repository field to METADATA.toml (#10487)

Closes: #10478
---
 CONTRIBUTING.md                           | 1 +
 scripts/stubsabot.py                      | 5 +++--
 stubs/DateTimeRange/METADATA.toml         | 1 +
 stubs/Deprecated/METADATA.toml            | 1 +
 stubs/ExifRead/METADATA.toml              | 1 +
 stubs/Flask-Cors/METADATA.toml            | 1 +
 stubs/Flask-Migrate/METADATA.toml         | 1 +
 stubs/Markdown/METADATA.toml              | 1 +
 stubs/Pillow/METADATA.toml                | 1 +
 stubs/PyAutoGUI/METADATA.toml             | 1 +
 stubs/PyMySQL/METADATA.toml               | 1 +
 stubs/PyScreeze/METADATA.toml             | 1 +
 stubs/PyYAML/METADATA.toml                | 1 +
 stubs/Pygments/METADATA.toml              | 1 +
 stubs/Send2Trash/METADATA.toml            | 1 +
 stubs/aiofiles/METADATA.toml              | 1 +
 stubs/aws-xray-sdk/METADATA.toml          | 1 +
 stubs/babel/METADATA.toml                 | 1 +
 stubs/bleach/METADATA.toml                | 1 +
 stubs/boltons/METADATA.toml               | 1 +
 stubs/boto/METADATA.toml                  | 1 +
 stubs/cachetools/METADATA.toml            | 1 +
 stubs/caldav/METADATA.toml                | 1 +
 stubs/chevron/METADATA.toml               | 1 +
 stubs/click-spinner/METADATA.toml         | 1 +
 stubs/colorama/METADATA.toml              | 1 +
 stubs/commonmark/METADATA.toml            | 1 +
 stubs/console-menu/METADATA.toml          | 1 +
 stubs/croniter/METADATA.toml              | 1 +
 stubs/dateparser/METADATA.toml            | 1 +
 stubs/decorator/METADATA.toml             | 1 +
 stubs/dj-database-url/METADATA.toml       | 1 +
 stubs/dockerfile-parse/METADATA.toml      | 1 +
 stubs/entrypoints/METADATA.toml           | 1 +
 stubs/first/METADATA.toml                 | 1 +
 stubs/flake8-2020/METADATA.toml           | 1 +
 stubs/flake8-bugbear/METADATA.toml        | 1 +
 stubs/flake8-builtins/METADATA.toml       | 1 +
 stubs/flake8-docstrings/METADATA.toml     | 1 +
 stubs/flake8-plugin-utils/METADATA.toml   | 1 +
 stubs/flake8-rst-docstrings/METADATA.toml | 1 +
 stubs/flake8-simplify/METADATA.toml       | 1 +
 stubs/flake8-typing-imports/METADATA.toml | 1 +
 stubs/fpdf2/METADATA.toml                 | 1 +
 stubs/google-cloud-ndb/METADATA.toml      | 1 +
 stubs/html5lib/METADATA.toml              | 1 +
 stubs/httplib2/METADATA.toml              | 1 +
 stubs/influxdb-client/METADATA.toml       | 1 +
 stubs/invoke/METADATA.toml                | 1 +
 stubs/jmespath/METADATA.toml              | 1 +
 stubs/jsonschema/METADATA.toml            | 1 +
 stubs/keyboard/METADATA.toml              | 1 +
 stubs/ldap3/METADATA.toml                 | 1 +
 stubs/mock/METADATA.toml                  | 1 +
 stubs/mypy-extensions/METADATA.toml       | 1 +
 stubs/mysqlclient/METADATA.toml           | 1 +
 stubs/netaddr/METADATA.toml               | 1 +
 stubs/oauthlib/METADATA.toml              | 1 +
 stubs/opentracing/METADATA.toml           | 1 +
 stubs/paramiko/METADATA.toml              | 1 +
 stubs/parsimonious/METADATA.toml          | 1 +
 stubs/passpy/METADATA.toml                | 1 +
 stubs/peewee/METADATA.toml                | 1 +
 stubs/pep8-naming/METADATA.toml           | 1 +
 stubs/pika/METADATA.toml                  | 1 +
 stubs/playsound/METADATA.toml             | 1 +
 stubs/pluggy/METADATA.toml                | 1 +
 stubs/polib/METADATA.toml                 | 1 +
 stubs/psutil/METADATA.toml                | 1 +
 stubs/psycopg2/METADATA.toml              | 1 +
 stubs/pyOpenSSL/METADATA.toml             | 1 +
 stubs/pyRFC3339/METADATA.toml             | 1 +
 stubs/pyasn1/METADATA.toml                | 1 +
 stubs/pycocotools/METADATA.toml           | 1 +
 stubs/pyfarmhash/METADATA.toml            | 1 +
 stubs/pyflakes/METADATA.toml              | 1 +
 stubs/pyinstaller/METADATA.toml           | 1 +
 stubs/pynput/METADATA.toml                | 1 +
 stubs/pyserial/METADATA.toml              | 1 +
 stubs/pytest-lazy-fixture/METADATA.toml   | 1 +
 stubs/python-datemath/METADATA.toml       | 1 +
 stubs/python-dateutil/METADATA.toml       | 1 +
 stubs/python-gflags/METADATA.toml         | 1 +
 stubs/python-jose/METADATA.toml           | 1 +
 stubs/python-slugify/METADATA.toml        | 1 +
 stubs/python-xlib/METADATA.toml           | 1 +
 stubs/pyvmomi/METADATA.toml               | 1 +
 stubs/pywin32/METADATA.toml               | 1 +
 stubs/qrcode/METADATA.toml                | 1 +
 stubs/redis/METADATA.toml                 | 1 +
 stubs/regex/METADATA.toml                 | 1 +
 stubs/requests/METADATA.toml              | 1 +
 stubs/retry/METADATA.toml                 | 1 +
 stubs/setuptools/METADATA.toml            | 1 +
 stubs/simplejson/METADATA.toml            | 1 +
 stubs/singledispatch/METADATA.toml        | 1 +
 stubs/six/METADATA.toml                   | 1 +
 stubs/slumber/METADATA.toml               | 1 +
 stubs/stdlib-list/METADATA.toml           | 1 +
 stubs/stripe/METADATA.toml                | 1 +
 stubs/tabulate/METADATA.toml              | 1 +
 stubs/toml/METADATA.toml                  | 1 +
 stubs/tqdm/METADATA.toml                  | 1 +
 stubs/translationstring/METADATA.toml     | 1 +
 stubs/tree-sitter-languages/METADATA.toml | 1 +
 stubs/tree-sitter/METADATA.toml           | 1 +
 stubs/ttkthemes/METADATA.toml             | 1 +
 stubs/tzlocal/METADATA.toml               | 1 +
 stubs/ujson/METADATA.toml                 | 1 +
 stubs/urllib3/METADATA.toml               | 1 +
 stubs/waitress/METADATA.toml              | 1 +
 stubs/whatthepatch/METADATA.toml          | 1 +
 stubs/xmltodict/METADATA.toml             | 1 +
 stubs/zstd/METADATA.toml                  | 1 +
 stubs/zxcvbn/METADATA.toml                | 1 +
 tests/parse_metadata.py                   | 5 +++++
 116 files changed, 122 insertions(+), 2 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 1b3e15cf4..5fd6b091d 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -184,6 +184,7 @@ supported:
 * `stub_distribution` (optional): Distribution name to be uploaded to PyPI.
   This defaults to `types-<distribution>` and should only be set in special
   cases.
+* `upstream_repository` (recommended): The URL of the upstream repository.
 * `obsolete_since` (optional): This field is part of our process for
   [removing obsolete third-party libraries](#third-party-library-removal-policy).
   It contains the first version of the corresponding library that ships
diff --git a/scripts/stubsabot.py b/scripts/stubsabot.py
index a45ec1c29..846a47fdf 100644
--- a/scripts/stubsabot.py
+++ b/scripts/stubsabot.py
@@ -246,8 +246,9 @@ async def get_github_repo_info(session: aiohttp.ClientSession, pypi_info: PypiIn
 
     Else, return None.
     """
-    project_urls = pypi_info.info.get("project_urls", {}).values()
-    for project_url in project_urls:
+    # project_urls can be None in the downloaded JSON.
+    project_url_dict = pypi_info.info.get("project_urls") or {}
+    for project_url in project_url_dict.values():
         assert isinstance(project_url, str)
         split_url = urllib.parse.urlsplit(project_url)
         if split_url.netloc == "github.com" and not split_url.query and not split_url.fragment:
diff --git a/stubs/DateTimeRange/METADATA.toml b/stubs/DateTimeRange/METADATA.toml
index 47a9b6f7c..4c818b93c 100644
--- a/stubs/DateTimeRange/METADATA.toml
+++ b/stubs/DateTimeRange/METADATA.toml
@@ -1,3 +1,4 @@
 version = "2.0.*"
+upstream_repository = "https://github.com/thombashi/DateTimeRange"
 requires = ["types-python-dateutil"]
 obsolete_since = "2.1.0" # Released on 2023-02-19
diff --git a/stubs/Deprecated/METADATA.toml b/stubs/Deprecated/METADATA.toml
index 3d4d518df..b491184ae 100644
--- a/stubs/Deprecated/METADATA.toml
+++ b/stubs/Deprecated/METADATA.toml
@@ -1,2 +1,3 @@
 version = "1.2.*"
+upstream_repository = "https://github.com/tantale/deprecated"
 requires = []
diff --git a/stubs/ExifRead/METADATA.toml b/stubs/ExifRead/METADATA.toml
index 4a8e90c0c..bf04067ad 100644
--- a/stubs/ExifRead/METADATA.toml
+++ b/stubs/ExifRead/METADATA.toml
@@ -1 +1,2 @@
 version = "3.0.*"
+upstream_repository = "https://github.com/ianare/exif-py"
diff --git a/stubs/Flask-Cors/METADATA.toml b/stubs/Flask-Cors/METADATA.toml
index 4c491c27e..268976f68 100644
--- a/stubs/Flask-Cors/METADATA.toml
+++ b/stubs/Flask-Cors/METADATA.toml
@@ -1,4 +1,5 @@
 version = "4.0.*"
+upstream_repository = "https://github.com/corydolphin/flask-cors"
 # Requires a version of flask with a `py.typed` file
 requires = ["Flask>=2.0.0"]
 partial_stub = true
diff --git a/stubs/Flask-Migrate/METADATA.toml b/stubs/Flask-Migrate/METADATA.toml
index 7bbc03e43..7b8e26c3c 100644
--- a/stubs/Flask-Migrate/METADATA.toml
+++ b/stubs/Flask-Migrate/METADATA.toml
@@ -1,4 +1,5 @@
 version = "4.0.*"
+upstream_repository = "https://github.com/miguelgrinberg/flask-migrate"
 # Requires versions of flask and Flask-SQLAlchemy with `py.typed` files
 requires = ["Flask>=2.0.0", "Flask-SQLAlchemy>=3.0.1"]
 partial_stub = true
diff --git a/stubs/Markdown/METADATA.toml b/stubs/Markdown/METADATA.toml
index 1756f1f53..baa9a2192 100644
--- a/stubs/Markdown/METADATA.toml
+++ b/stubs/Markdown/METADATA.toml
@@ -1,4 +1,5 @@
 version = "3.4.*"
+upstream_repository = "https://github.com/Python-Markdown/markdown"
 partial_stub = true
 
 [tool.stubtest]
diff --git a/stubs/Pillow/METADATA.toml b/stubs/Pillow/METADATA.toml
index 7d5605c92..9dc403e84 100644
--- a/stubs/Pillow/METADATA.toml
+++ b/stubs/Pillow/METADATA.toml
@@ -1,4 +1,5 @@
 version = "10.0.*"
+upstream_repository = "https://github.com/python-pillow/Pillow"
 partial_stub = true
 
 [tool.stubtest]
diff --git a/stubs/PyAutoGUI/METADATA.toml b/stubs/PyAutoGUI/METADATA.toml
index db0b3838d..11402b62e 100644
--- a/stubs/PyAutoGUI/METADATA.toml
+++ b/stubs/PyAutoGUI/METADATA.toml
@@ -1,2 +1,3 @@
 version = "0.9.*"
+upstream_repository = "https://github.com/asweigart/pyautogui"
 requires = ["types-Pillow", "types-PyScreeze"]
diff --git a/stubs/PyMySQL/METADATA.toml b/stubs/PyMySQL/METADATA.toml
index b4f31a779..8e4adf72f 100644
--- a/stubs/PyMySQL/METADATA.toml
+++ b/stubs/PyMySQL/METADATA.toml
@@ -1,4 +1,5 @@
 version = "1.1.*"
+upstream_repository = "https://github.com/PyMySQL/PyMySQL"
 partial_stub = true
 
 [tool.stubtest]
diff --git a/stubs/PyScreeze/METADATA.toml b/stubs/PyScreeze/METADATA.toml
index 52120c0be..6ed8c06b6 100644
--- a/stubs/PyScreeze/METADATA.toml
+++ b/stubs/PyScreeze/METADATA.toml
@@ -1,2 +1,3 @@
 version = "0.1.*"
+upstream_repository = "https://github.com/asweigart/pyscreeze"
 requires = ["types-Pillow"]
diff --git a/stubs/PyYAML/METADATA.toml b/stubs/PyYAML/METADATA.toml
index 39a61569b..c31b588e6 100644
--- a/stubs/PyYAML/METADATA.toml
+++ b/stubs/PyYAML/METADATA.toml
@@ -1 +1,2 @@
 version = "6.0.*"
+upstream_repository = "https://github.com/yaml/pyyaml"
diff --git a/stubs/Pygments/METADATA.toml b/stubs/Pygments/METADATA.toml
index ed69afcdb..f8fb89d88 100644
--- a/stubs/Pygments/METADATA.toml
+++ b/stubs/Pygments/METADATA.toml
@@ -1,4 +1,5 @@
 version = "2.15.*"
+upstream_repository = "https://github.com/pygments/pygments"
 requires = ["types-docutils", "types-setuptools"]
 partial_stub = true
 
diff --git a/stubs/Send2Trash/METADATA.toml b/stubs/Send2Trash/METADATA.toml
index 8a1eb1a6d..e4eb2fd4c 100644
--- a/stubs/Send2Trash/METADATA.toml
+++ b/stubs/Send2Trash/METADATA.toml
@@ -1,4 +1,5 @@
 version = "1.8.*"
+upstream_repository = "https://github.com/arsenetar/send2trash"
 partial_stub = true
 
 [tool.stubtest]
diff --git a/stubs/aiofiles/METADATA.toml b/stubs/aiofiles/METADATA.toml
index 156974ce2..f9b51ecc6 100644
--- a/stubs/aiofiles/METADATA.toml
+++ b/stubs/aiofiles/METADATA.toml
@@ -1,4 +1,5 @@
 version = "23.1.*"
+upstream_repository = "https://github.com/Tinche/aiofiles"
 
 [tool.stubtest]
 # linux and darwin are equivalent
diff --git a/stubs/aws-xray-sdk/METADATA.toml b/stubs/aws-xray-sdk/METADATA.toml
index dc525a938..792d4b475 100644
--- a/stubs/aws-xray-sdk/METADATA.toml
+++ b/stubs/aws-xray-sdk/METADATA.toml
@@ -1,4 +1,5 @@
 version = "2.12.*"
+upstream_repository = "https://github.com/aws/aws-xray-sdk-python"
 partial_stub = true
 
 [tool.stubtest]
diff --git a/stubs/babel/METADATA.toml b/stubs/babel/METADATA.toml
index a80fc97a8..ac50477bb 100644
--- a/stubs/babel/METADATA.toml
+++ b/stubs/babel/METADATA.toml
@@ -1,4 +1,5 @@
 version = "2.11.*"
+upstream_repository = "https://github.com/python-babel/babel"
 requires = ["types-pytz", "types-setuptools"]
 obsolete_since = "2.12.1" # Released on 2023-02-28
 partial_stub = true
diff --git a/stubs/bleach/METADATA.toml b/stubs/bleach/METADATA.toml
index 276fbcfb4..58f084566 100644
--- a/stubs/bleach/METADATA.toml
+++ b/stubs/bleach/METADATA.toml
@@ -1,4 +1,5 @@
 version = "6.0.*"
+upstream_repository = "https://github.com/mozilla/bleach"
 partial_stub = true
 
 [tool.stubtest]
diff --git a/stubs/boltons/METADATA.toml b/stubs/boltons/METADATA.toml
index 0243ddf54..520e591d7 100644
--- a/stubs/boltons/METADATA.toml
+++ b/stubs/boltons/METADATA.toml
@@ -1,4 +1,5 @@
 version = "23.0.*"
+upstream_repository = "https://github.com/mahmoud/boltons"
 
 [tool.stubtest]
 ignore_missing_stub = false
diff --git a/stubs/boto/METADATA.toml b/stubs/boto/METADATA.toml
index d6d7bfb95..56aaba050 100644
--- a/stubs/boto/METADATA.toml
+++ b/stubs/boto/METADATA.toml
@@ -1,4 +1,5 @@
 version = "2.49.*"
+upstream_repository = "https://github.com/boto/boto"
 requires = []
 partial_stub = true
 
diff --git a/stubs/cachetools/METADATA.toml b/stubs/cachetools/METADATA.toml
index d7cde2e5e..3507d45d8 100644
--- a/stubs/cachetools/METADATA.toml
+++ b/stubs/cachetools/METADATA.toml
@@ -1 +1,2 @@
 version = "5.3.*"
+upstream_repository = "https://github.com/tkem/cachetools"
diff --git a/stubs/caldav/METADATA.toml b/stubs/caldav/METADATA.toml
index 8cc21a470..b25dcd0fe 100644
--- a/stubs/caldav/METADATA.toml
+++ b/stubs/caldav/METADATA.toml
@@ -1,4 +1,5 @@
 version = "1.3.*"
+upstream_repository = "https://github.com/python-caldav/caldav"
 # also types-lxml and types-icalendar when those stubs are added
 requires = ["types-requests", "types-vobject"]
 partial_stub = true
diff --git a/stubs/chevron/METADATA.toml b/stubs/chevron/METADATA.toml
index 48faa3822..10bcb5ccb 100755
--- a/stubs/chevron/METADATA.toml
+++ b/stubs/chevron/METADATA.toml
@@ -1,3 +1,4 @@
 version = "0.14.*"
+upstream_repository = "https://github.com/noahmorrison/chevron"
 
 [tool.stubtest]
diff --git a/stubs/click-spinner/METADATA.toml b/stubs/click-spinner/METADATA.toml
index 37dc09b10..7360ba2d2 100644
--- a/stubs/click-spinner/METADATA.toml
+++ b/stubs/click-spinner/METADATA.toml
@@ -1 +1,2 @@
 version = "0.1.*"
+upstream_repository = "https://github.com/click-contrib/click-spinner"
diff --git a/stubs/colorama/METADATA.toml b/stubs/colorama/METADATA.toml
index 34da26594..40a45767b 100644
--- a/stubs/colorama/METADATA.toml
+++ b/stubs/colorama/METADATA.toml
@@ -1,4 +1,5 @@
 version = "0.4.*"
+upstream_repository = "https://github.com/tartley/colorama"
 
 [tool.stubtest]
 platforms = ["linux", "win32"]
diff --git a/stubs/commonmark/METADATA.toml b/stubs/commonmark/METADATA.toml
index e711a71bf..e085ecf45 100644
--- a/stubs/commonmark/METADATA.toml
+++ b/stubs/commonmark/METADATA.toml
@@ -1,4 +1,5 @@
 version = "0.9.*"
+upstream_repository = "https://github.com/rtfd/commonmark.py"
 partial_stub = true
 
 [tool.stubtest]
diff --git a/stubs/console-menu/METADATA.toml b/stubs/console-menu/METADATA.toml
index 29511ee7d..857d25a71 100644
--- a/stubs/console-menu/METADATA.toml
+++ b/stubs/console-menu/METADATA.toml
@@ -1 +1,2 @@
 version = "0.8.*"
+upstream_repository = "https://github.com/aegirhall/console-menu"
diff --git a/stubs/croniter/METADATA.toml b/stubs/croniter/METADATA.toml
index 6d3b92238..e2699fe30 100644
--- a/stubs/croniter/METADATA.toml
+++ b/stubs/croniter/METADATA.toml
@@ -1 +1,2 @@
 version = "1.4.*"
+upstream_repository = "https://github.com/kiorky/croniter"
diff --git a/stubs/dateparser/METADATA.toml b/stubs/dateparser/METADATA.toml
index ced11fa3e..0fe2c42e9 100644
--- a/stubs/dateparser/METADATA.toml
+++ b/stubs/dateparser/METADATA.toml
@@ -1,4 +1,5 @@
 version = "1.1.*"
+upstream_repository = "https://github.com/scrapinghub/dateparser"
 
 [tool.stubtest]
 extras = ["fasttext", "langdetect"]
diff --git a/stubs/decorator/METADATA.toml b/stubs/decorator/METADATA.toml
index 2c151642b..507ad3d19 100644
--- a/stubs/decorator/METADATA.toml
+++ b/stubs/decorator/METADATA.toml
@@ -1 +1,2 @@
 version = "5.1.*"
+upstream_repository = "https://github.com/micheles/decorator"
diff --git a/stubs/dj-database-url/METADATA.toml b/stubs/dj-database-url/METADATA.toml
index 6c6e91faf..7064924e3 100644
--- a/stubs/dj-database-url/METADATA.toml
+++ b/stubs/dj-database-url/METADATA.toml
@@ -1,2 +1,3 @@
 version = "1.3.*"
+upstream_repository = "https://github.com/jazzband/dj-database-url"
 obsolete_since = "2.0.0" # Released on 2023-04-27
diff --git a/stubs/dockerfile-parse/METADATA.toml b/stubs/dockerfile-parse/METADATA.toml
index 58bc38349..a252e11f2 100644
--- a/stubs/dockerfile-parse/METADATA.toml
+++ b/stubs/dockerfile-parse/METADATA.toml
@@ -1 +1,2 @@
 version = "2.0.*"
+upstream_repository = "https://github.com/containerbuildsystem/dockerfile-parse"
diff --git a/stubs/entrypoints/METADATA.toml b/stubs/entrypoints/METADATA.toml
index 582104d3a..a1a81ef24 100644
--- a/stubs/entrypoints/METADATA.toml
+++ b/stubs/entrypoints/METADATA.toml
@@ -1 +1,2 @@
 version = "0.4.*"
+upstream_repository = "https://github.com/takluyver/entrypoints"
diff --git a/stubs/first/METADATA.toml b/stubs/first/METADATA.toml
index 58bc38349..89a41730f 100644
--- a/stubs/first/METADATA.toml
+++ b/stubs/first/METADATA.toml
@@ -1 +1,2 @@
 version = "2.0.*"
+upstream_repository = "https://github.com/hynek/first"
diff --git a/stubs/flake8-2020/METADATA.toml b/stubs/flake8-2020/METADATA.toml
index 690242a33..27b352770 100644
--- a/stubs/flake8-2020/METADATA.toml
+++ b/stubs/flake8-2020/METADATA.toml
@@ -1 +1,2 @@
 version = "1.8.*"
+upstream_repository = "https://github.com/asottile/flake8-2020"
diff --git a/stubs/flake8-bugbear/METADATA.toml b/stubs/flake8-bugbear/METADATA.toml
index 6266d1691..ccc105020 100644
--- a/stubs/flake8-bugbear/METADATA.toml
+++ b/stubs/flake8-bugbear/METADATA.toml
@@ -1,4 +1,5 @@
 version = "23.7.10"
+upstream_repository = "https://github.com/PyCQA/flake8-bugbear"
 partial_stub = true
 
 [tool.stubtest]
diff --git a/stubs/flake8-builtins/METADATA.toml b/stubs/flake8-builtins/METADATA.toml
index 437b55a26..58507b4be 100644
--- a/stubs/flake8-builtins/METADATA.toml
+++ b/stubs/flake8-builtins/METADATA.toml
@@ -1,4 +1,5 @@
 version = "2.1.*"
+upstream_repository = "https://github.com/gforcada/flake8-builtins"
 partial_stub = true
 
 [tool.stubtest]
diff --git a/stubs/flake8-docstrings/METADATA.toml b/stubs/flake8-docstrings/METADATA.toml
index 4ec4b2b4c..10586ebd1 100644
--- a/stubs/flake8-docstrings/METADATA.toml
+++ b/stubs/flake8-docstrings/METADATA.toml
@@ -1,4 +1,5 @@
 version = "1.7.*"
+upstream_repository = "https://github.com/pycqa/flake8-docstrings"
 partial_stub = true
 
 [tool.stubtest]
diff --git a/stubs/flake8-plugin-utils/METADATA.toml b/stubs/flake8-plugin-utils/METADATA.toml
index eeb399599..4874bcd4d 100644
--- a/stubs/flake8-plugin-utils/METADATA.toml
+++ b/stubs/flake8-plugin-utils/METADATA.toml
@@ -1,4 +1,5 @@
 version = "1.3.*"
+upstream_repository = "https://github.com/afonasev/flake8-plugin-utils"
 partial_stub = true
 obsolete_since = "1.3.3" # Released on 2023-06-26
 
diff --git a/stubs/flake8-rst-docstrings/METADATA.toml b/stubs/flake8-rst-docstrings/METADATA.toml
index a116b6d71..2b76dde36 100644
--- a/stubs/flake8-rst-docstrings/METADATA.toml
+++ b/stubs/flake8-rst-docstrings/METADATA.toml
@@ -1,4 +1,5 @@
 version = "0.3.*"
+upstream_repository = "https://github.com/peterjc/flake8-rst-docstrings"
 partial_stub = true
 
 [tool.stubtest]
diff --git a/stubs/flake8-simplify/METADATA.toml b/stubs/flake8-simplify/METADATA.toml
index 647482d55..1971ff585 100644
--- a/stubs/flake8-simplify/METADATA.toml
+++ b/stubs/flake8-simplify/METADATA.toml
@@ -1,4 +1,5 @@
 version = "0.20.*"
+upstream_repository = "https://github.com/MartinThoma/flake8-simplify"
 partial_stub = true
 
 [tool.stubtest]
diff --git a/stubs/flake8-typing-imports/METADATA.toml b/stubs/flake8-typing-imports/METADATA.toml
index ebd7f83a2..6ac5c40b7 100644
--- a/stubs/flake8-typing-imports/METADATA.toml
+++ b/stubs/flake8-typing-imports/METADATA.toml
@@ -1,4 +1,5 @@
 version = "1.14.*"
+upstream_repository = "https://github.com/asottile/flake8-typing-imports"
 partial_stub = true
 
 [tool.stubtest]
diff --git a/stubs/fpdf2/METADATA.toml b/stubs/fpdf2/METADATA.toml
index 78c0762f0..a47fe4aef 100644
--- a/stubs/fpdf2/METADATA.toml
+++ b/stubs/fpdf2/METADATA.toml
@@ -1,4 +1,5 @@
 version = "2.7.4"
+upstream_repository = "https://github.com/PyFPDF/fpdf2"
 requires = ["types-Pillow>=9.2.0"]
 
 [tool.stubtest]
diff --git a/stubs/google-cloud-ndb/METADATA.toml b/stubs/google-cloud-ndb/METADATA.toml
index 10e0f7f8d..2337e58a1 100644
--- a/stubs/google-cloud-ndb/METADATA.toml
+++ b/stubs/google-cloud-ndb/METADATA.toml
@@ -1,4 +1,5 @@
 version = "2.1.*"
+upstream_repository = "https://github.com/googleapis/python-ndb"
 partial_stub = true
 
 [tool.stubtest]
diff --git a/stubs/html5lib/METADATA.toml b/stubs/html5lib/METADATA.toml
index 80bcc75dc..b1fa786da 100644
--- a/stubs/html5lib/METADATA.toml
+++ b/stubs/html5lib/METADATA.toml
@@ -1,4 +1,5 @@
 version = "1.1.*"
+upstream_repository = "https://github.com/html5lib/html5lib-python"
 partial_stub = true
 
 [tool.stubtest]
diff --git a/stubs/httplib2/METADATA.toml b/stubs/httplib2/METADATA.toml
index 035554b96..7aeadb496 100644
--- a/stubs/httplib2/METADATA.toml
+++ b/stubs/httplib2/METADATA.toml
@@ -1 +1,2 @@
 version = "0.22.*"
+upstream_repository = "https://github.com/httplib2/httplib2"
diff --git a/stubs/influxdb-client/METADATA.toml b/stubs/influxdb-client/METADATA.toml
index bf082ace4..6bc16f3e5 100644
--- a/stubs/influxdb-client/METADATA.toml
+++ b/stubs/influxdb-client/METADATA.toml
@@ -1,4 +1,5 @@
 version = "1.36.*"
+upstream_repository = "https://github.com/influxdata/influxdb-client-python"
 requires = ["types-urllib3"]
 
 [tool.stubtest]
diff --git a/stubs/invoke/METADATA.toml b/stubs/invoke/METADATA.toml
index 0b2ff5be2..1569bee2b 100644
--- a/stubs/invoke/METADATA.toml
+++ b/stubs/invoke/METADATA.toml
@@ -1,4 +1,5 @@
 version = "2.0.*"
+upstream_repository = "https://github.com/pyinvoke/invoke"
 obsolete_since = "2.1.2" # Released on 2023-05-15
 partial_stub = true
 
diff --git a/stubs/jmespath/METADATA.toml b/stubs/jmespath/METADATA.toml
index f3e83f9c4..df1266d7f 100644
--- a/stubs/jmespath/METADATA.toml
+++ b/stubs/jmespath/METADATA.toml
@@ -1 +1,2 @@
 version = "1.0.*"
+upstream_repository = "https://github.com/jmespath/jmespath.py"
diff --git a/stubs/jsonschema/METADATA.toml b/stubs/jsonschema/METADATA.toml
index b4f510c3d..8586b7fa0 100644
--- a/stubs/jsonschema/METADATA.toml
+++ b/stubs/jsonschema/METADATA.toml
@@ -1,4 +1,5 @@
 version = "4.17.*"
+upstream_repository = "https://github.com/python-jsonschema/jsonschema"
 partial_stub = true
 
 [tool.stubtest]
diff --git a/stubs/keyboard/METADATA.toml b/stubs/keyboard/METADATA.toml
index dd6660878..c9280f44f 100644
--- a/stubs/keyboard/METADATA.toml
+++ b/stubs/keyboard/METADATA.toml
@@ -1,4 +1,5 @@
 version = "0.13.*"
+upstream_repository = "https://github.com/boppreh/keyboard"
 
 # [tool.stubtest]
 # While the stubs slightly differ on Windows vs Linux.
diff --git a/stubs/ldap3/METADATA.toml b/stubs/ldap3/METADATA.toml
index 3c34f864a..76740bed3 100644
--- a/stubs/ldap3/METADATA.toml
+++ b/stubs/ldap3/METADATA.toml
@@ -1,4 +1,5 @@
 version = "2.9.*"
+upstream_repository = "https://github.com/cannatag/ldap3"
 requires = ["types-pyasn1"]
 partial_stub = true
 
diff --git a/stubs/mock/METADATA.toml b/stubs/mock/METADATA.toml
index 2c151642b..e6a45ed45 100644
--- a/stubs/mock/METADATA.toml
+++ b/stubs/mock/METADATA.toml
@@ -1 +1,2 @@
 version = "5.1.*"
+upstream_repository = "https://github.com/testing-cabal/mock"
diff --git a/stubs/mypy-extensions/METADATA.toml b/stubs/mypy-extensions/METADATA.toml
index f3e83f9c4..b0da8c5ae 100644
--- a/stubs/mypy-extensions/METADATA.toml
+++ b/stubs/mypy-extensions/METADATA.toml
@@ -1 +1,2 @@
 version = "1.0.*"
+upstream_repository = "https://github.com/python/mypy_extensions"
diff --git a/stubs/mysqlclient/METADATA.toml b/stubs/mysqlclient/METADATA.toml
index 7892149a1..f3c466ea9 100644
--- a/stubs/mysqlclient/METADATA.toml
+++ b/stubs/mysqlclient/METADATA.toml
@@ -1,4 +1,5 @@
 version = "2.2.*"
+upstream_repository = "https://github.com/PyMySQL/mysqlclient"
 
 [tool.stubtest]
 apt_dependencies = ["libmariadb-dev"]
diff --git a/stubs/netaddr/METADATA.toml b/stubs/netaddr/METADATA.toml
index 29511ee7d..b4cfb9f54 100644
--- a/stubs/netaddr/METADATA.toml
+++ b/stubs/netaddr/METADATA.toml
@@ -1 +1,2 @@
 version = "0.8.*"
+upstream_repository = "https://github.com/drkjam/netaddr"
diff --git a/stubs/oauthlib/METADATA.toml b/stubs/oauthlib/METADATA.toml
index 67c8b5c62..04672bf34 100644
--- a/stubs/oauthlib/METADATA.toml
+++ b/stubs/oauthlib/METADATA.toml
@@ -1,4 +1,5 @@
 version = "3.2.*"
+upstream_repository = "https://github.com/oauthlib/oauthlib"
 partial_stub = true
 
 [tool.stubtest]
diff --git a/stubs/opentracing/METADATA.toml b/stubs/opentracing/METADATA.toml
index 43c0d301d..70555adff 100644
--- a/stubs/opentracing/METADATA.toml
+++ b/stubs/opentracing/METADATA.toml
@@ -1,4 +1,5 @@
 version = "2.4.*"
+upstream_repository = "https://github.com/opentracing/opentracing-python"
 partial_stub = true
 
 [tool.stubtest]
diff --git a/stubs/paramiko/METADATA.toml b/stubs/paramiko/METADATA.toml
index 20ba790a4..5379b3f6e 100644
--- a/stubs/paramiko/METADATA.toml
+++ b/stubs/paramiko/METADATA.toml
@@ -1,4 +1,5 @@
 version = "3.2.*"
+upstream_repository = "https://github.com/paramiko/paramiko"
 # Requires a version of cryptography where cryptography.hazmat.primitives.ciphers.Cipher is generic
 requires = ["cryptography>=37.0.0"]
 partial_stub = true
diff --git a/stubs/parsimonious/METADATA.toml b/stubs/parsimonious/METADATA.toml
index 5c7ed21e8..698a927e8 100644
--- a/stubs/parsimonious/METADATA.toml
+++ b/stubs/parsimonious/METADATA.toml
@@ -1 +1,2 @@
 version = "0.10.*"
+upstream_repository = "https://github.com/erikrose/parsimonious"
diff --git a/stubs/passpy/METADATA.toml b/stubs/passpy/METADATA.toml
index f3e83f9c4..106c6bf5e 100644
--- a/stubs/passpy/METADATA.toml
+++ b/stubs/passpy/METADATA.toml
@@ -1 +1,2 @@
 version = "1.0.*"
+upstream_repository = "https://github.com/bfrascher/passpy"
diff --git a/stubs/peewee/METADATA.toml b/stubs/peewee/METADATA.toml
index c1f03f2c7..5adfe58b8 100644
--- a/stubs/peewee/METADATA.toml
+++ b/stubs/peewee/METADATA.toml
@@ -1 +1,2 @@
 version = "3.16.*"
+upstream_repository = "https://github.com/coleifer/peewee"
diff --git a/stubs/pep8-naming/METADATA.toml b/stubs/pep8-naming/METADATA.toml
index 361474831..6e0374aed 100644
--- a/stubs/pep8-naming/METADATA.toml
+++ b/stubs/pep8-naming/METADATA.toml
@@ -1,4 +1,5 @@
 version = "0.13.*"
+upstream_repository = "https://github.com/PyCQA/pep8-naming"
 partial_stub = true
 
 [tool.stubtest]
diff --git a/stubs/pika/METADATA.toml b/stubs/pika/METADATA.toml
index d1d388dbd..e3b0e6a04 100644
--- a/stubs/pika/METADATA.toml
+++ b/stubs/pika/METADATA.toml
@@ -1,4 +1,5 @@
 version = "1.3.*"
+upstream_repository = "https://github.com/pika/pika"
 stub_distribution = "types-pika-ts" # https://github.com/python/typeshed/issues/9246
 extra_description = """\
 The `types-pika` package contains alternate, more complete type stubs, that \
diff --git a/stubs/playsound/METADATA.toml b/stubs/playsound/METADATA.toml
index 3ea18392d..14175f7d7 100644
--- a/stubs/playsound/METADATA.toml
+++ b/stubs/playsound/METADATA.toml
@@ -1 +1,2 @@
 version = "1.3.*"
+upstream_repository = "https://github.com/TaylorSMarks/playsound"
diff --git a/stubs/pluggy/METADATA.toml b/stubs/pluggy/METADATA.toml
index c203c5d89..29b734085 100644
--- a/stubs/pluggy/METADATA.toml
+++ b/stubs/pluggy/METADATA.toml
@@ -1 +1,2 @@
 version = "1.2.0"
+upstream_repository = "https://github.com/pytest-dev/pluggy"
diff --git a/stubs/polib/METADATA.toml b/stubs/polib/METADATA.toml
index 249b0a7c0..5b7355447 100644
--- a/stubs/polib/METADATA.toml
+++ b/stubs/polib/METADATA.toml
@@ -1 +1,2 @@
 version = "1.2.*"
+upstream_repository = "https://github.com/izimobil/polib"
diff --git a/stubs/psutil/METADATA.toml b/stubs/psutil/METADATA.toml
index 8d29ce528..9cd22571b 100644
--- a/stubs/psutil/METADATA.toml
+++ b/stubs/psutil/METADATA.toml
@@ -1,4 +1,5 @@
 version = "5.9.*"
+upstream_repository = "https://github.com/giampaolo/psutil"
 
 [tool.stubtest]
 platforms = ["darwin", "linux", "win32"]
diff --git a/stubs/psycopg2/METADATA.toml b/stubs/psycopg2/METADATA.toml
index 4a249abf8..d5b778dd3 100644
--- a/stubs/psycopg2/METADATA.toml
+++ b/stubs/psycopg2/METADATA.toml
@@ -1,4 +1,5 @@
 version = "2.9.*"
+upstream_repository = "https://github.com/psycopg/psycopg2"
 partial_stub = true
 
 [tool.stubtest]
diff --git a/stubs/pyOpenSSL/METADATA.toml b/stubs/pyOpenSSL/METADATA.toml
index 02e6421bb..46979c185 100644
--- a/stubs/pyOpenSSL/METADATA.toml
+++ b/stubs/pyOpenSSL/METADATA.toml
@@ -1,4 +1,5 @@
 version = "23.2.*"
+upstream_repository = "https://github.com/pyca/pyopenssl"
 # Requires a version of cryptography with a `py.typed` file
 requires = ["cryptography>=35.0.0"]
 partial_stub = true
diff --git a/stubs/pyRFC3339/METADATA.toml b/stubs/pyRFC3339/METADATA.toml
index bad265e4f..e182e92b7 100644
--- a/stubs/pyRFC3339/METADATA.toml
+++ b/stubs/pyRFC3339/METADATA.toml
@@ -1 +1,2 @@
 version = "1.1"
+upstream_repository = "https://github.com/kurtraschke/pyRFC3339"
diff --git a/stubs/pyasn1/METADATA.toml b/stubs/pyasn1/METADATA.toml
index 582104d3a..3effa864a 100644
--- a/stubs/pyasn1/METADATA.toml
+++ b/stubs/pyasn1/METADATA.toml
@@ -1 +1,2 @@
 version = "0.4.*"
+upstream_repository = "https://github.com/pyasn1/pyasn1"
diff --git a/stubs/pycocotools/METADATA.toml b/stubs/pycocotools/METADATA.toml
index 58bc38349..3dd212383 100644
--- a/stubs/pycocotools/METADATA.toml
+++ b/stubs/pycocotools/METADATA.toml
@@ -1 +1,2 @@
 version = "2.0.*"
+upstream_repository = "https://github.com/ppwwyyxx/cocoapi"
diff --git a/stubs/pyfarmhash/METADATA.toml b/stubs/pyfarmhash/METADATA.toml
index d25c8f7d6..c488b9db5 100644
--- a/stubs/pyfarmhash/METADATA.toml
+++ b/stubs/pyfarmhash/METADATA.toml
@@ -1 +1,2 @@
 version = "0.3.*"
+upstream_repository = "https://github.com/veelion/python-farmhash"
diff --git a/stubs/pyflakes/METADATA.toml b/stubs/pyflakes/METADATA.toml
index c3490c9bb..7e4226433 100644
--- a/stubs/pyflakes/METADATA.toml
+++ b/stubs/pyflakes/METADATA.toml
@@ -1,4 +1,5 @@
 version = "3.0.*"
+upstream_repository = "https://github.com/PyCQA/pyflakes"
 partial_stub = true
 
 [tool.stubtest]
diff --git a/stubs/pyinstaller/METADATA.toml b/stubs/pyinstaller/METADATA.toml
index 41fc4b3ec..66f637e9c 100644
--- a/stubs/pyinstaller/METADATA.toml
+++ b/stubs/pyinstaller/METADATA.toml
@@ -1,2 +1,3 @@
 version = "5.13.*"
+upstream_repository = "https://github.com/pyinstaller/pyinstaller"
 requires = ["types-setuptools"]
diff --git a/stubs/pynput/METADATA.toml b/stubs/pynput/METADATA.toml
index c1e49ec2b..82b6146bc 100644
--- a/stubs/pynput/METADATA.toml
+++ b/stubs/pynput/METADATA.toml
@@ -1,4 +1,5 @@
 version = "1.7.*"
+upstream_repository = "https://github.com/moses-palmer/pynput"
 
 [tool.stubtest]
 platforms = ["darwin", "linux", "win32"]
diff --git a/stubs/pyserial/METADATA.toml b/stubs/pyserial/METADATA.toml
index 1e5d0af9f..77a573699 100644
--- a/stubs/pyserial/METADATA.toml
+++ b/stubs/pyserial/METADATA.toml
@@ -1,4 +1,5 @@
 version = "3.5.*"
+upstream_repository = "https://github.com/pyserial/pyserial"
 
 [tool.stubtest]
 platforms = ["darwin", "linux", "win32"]
diff --git a/stubs/pytest-lazy-fixture/METADATA.toml b/stubs/pytest-lazy-fixture/METADATA.toml
index 03031f1e9..68ac0cb52 100644
--- a/stubs/pytest-lazy-fixture/METADATA.toml
+++ b/stubs/pytest-lazy-fixture/METADATA.toml
@@ -1 +1,2 @@
 version = "0.6.*"
+upstream_repository = "https://github.com/tvorog/pytest-lazy-fixture"
diff --git a/stubs/python-datemath/METADATA.toml b/stubs/python-datemath/METADATA.toml
index 744a8cd91..e31cadf8b 100644
--- a/stubs/python-datemath/METADATA.toml
+++ b/stubs/python-datemath/METADATA.toml
@@ -1,4 +1,5 @@
 version = "1.5.*"
+upstream_repository = "https://github.com/nickmaccarthy/python-datemath"
 # Requires a version of arrow with a `py.typed` file
 requires = ["arrow>=1.0.1"]
 partial_stub = true
diff --git a/stubs/python-dateutil/METADATA.toml b/stubs/python-dateutil/METADATA.toml
index 175f394fa..799397d98 100644
--- a/stubs/python-dateutil/METADATA.toml
+++ b/stubs/python-dateutil/METADATA.toml
@@ -1,4 +1,5 @@
 version = "2.8.*"
+upstream_repository = "https://github.com/dateutil/dateutil"
 partial_stub = true
 
 [tool.stubtest]
diff --git a/stubs/python-gflags/METADATA.toml b/stubs/python-gflags/METADATA.toml
index 84307529a..885945de4 100644
--- a/stubs/python-gflags/METADATA.toml
+++ b/stubs/python-gflags/METADATA.toml
@@ -1 +1,2 @@
 version = "3.1.*"
+upstream_repository = "https://github.com/google/python-gflags"
diff --git a/stubs/python-jose/METADATA.toml b/stubs/python-jose/METADATA.toml
index 5cc80a931..5b4b5fa79 100644
--- a/stubs/python-jose/METADATA.toml
+++ b/stubs/python-jose/METADATA.toml
@@ -1,2 +1,3 @@
 version = "3.3.*"
+upstream_repository = "https://github.com/mpdavis/python-jose"
 requires = ["types-pyasn1"] # excluding pyrsa, cryptography until typing is available
diff --git a/stubs/python-slugify/METADATA.toml b/stubs/python-slugify/METADATA.toml
index 629f910b2..85b3cff80 100644
--- a/stubs/python-slugify/METADATA.toml
+++ b/stubs/python-slugify/METADATA.toml
@@ -1 +1,2 @@
 version = "8.0.*"
+upstream_repository = "https://github.com/un33k/python-slugify"
diff --git a/stubs/python-xlib/METADATA.toml b/stubs/python-xlib/METADATA.toml
index 86e974f53..cf9a82a78 100644
--- a/stubs/python-xlib/METADATA.toml
+++ b/stubs/python-xlib/METADATA.toml
@@ -1,2 +1,3 @@
 version = "0.33.*"
+upstream_repository = "https://github.com/python-xlib/python-xlib"
 requires = ["types-Pillow"]
diff --git a/stubs/pyvmomi/METADATA.toml b/stubs/pyvmomi/METADATA.toml
index e47e40f17..6e2e92edd 100644
--- a/stubs/pyvmomi/METADATA.toml
+++ b/stubs/pyvmomi/METADATA.toml
@@ -1,4 +1,5 @@
 version = "8.0.0.*"
+upstream_repository = "https://github.com/vmware/pyvmomi"
 partial_stub = true
 obsolete_since = "8.0.1.0.1" # Released on 2023-05-25
 
diff --git a/stubs/pywin32/METADATA.toml b/stubs/pywin32/METADATA.toml
index 0f4aa7161..70aee5df3 100644
--- a/stubs/pywin32/METADATA.toml
+++ b/stubs/pywin32/METADATA.toml
@@ -1,4 +1,5 @@
 version = "306.*"
+upstream_repository = "https://github.com/mhammond/pywin32"
 
 [tool.stubtest]
 platforms = ["win32"]
diff --git a/stubs/qrcode/METADATA.toml b/stubs/qrcode/METADATA.toml
index cbec45169..e6451e017 100644
--- a/stubs/qrcode/METADATA.toml
+++ b/stubs/qrcode/METADATA.toml
@@ -1,4 +1,5 @@
 version = "7.4.*"
+upstream_repository = "https://github.com/lincolnloop/python-qrcode"
 
 [tool.stubtest]
 extras = ["lxml"]
diff --git a/stubs/redis/METADATA.toml b/stubs/redis/METADATA.toml
index 81e550e9f..b5fa5bc9e 100644
--- a/stubs/redis/METADATA.toml
+++ b/stubs/redis/METADATA.toml
@@ -1,4 +1,5 @@
 version = "4.6.0"
+upstream_repository = "https://github.com/redis/redis-py"
 # Requires a version of cryptography with a `py.typed` file
 requires = ["cryptography>=35.0.0", "types-pyOpenSSL"]
 partial_stub = true
diff --git a/stubs/regex/METADATA.toml b/stubs/regex/METADATA.toml
index f7972b352..d0a5aacf9 100644
--- a/stubs/regex/METADATA.toml
+++ b/stubs/regex/METADATA.toml
@@ -1 +1,2 @@
 version = "2023.6.3"
+upstream_repository = "https://github.com/mrabarnett/mrab-regex"
diff --git a/stubs/requests/METADATA.toml b/stubs/requests/METADATA.toml
index f0410f316..39371b90e 100644
--- a/stubs/requests/METADATA.toml
+++ b/stubs/requests/METADATA.toml
@@ -1,4 +1,5 @@
 version = "2.31.*"
+upstream_repository = "https://github.com/psf/requests"
 requires = ["types-urllib3"]
 
 [tool.stubtest]
diff --git a/stubs/retry/METADATA.toml b/stubs/retry/METADATA.toml
index 51e869b47..a2623b57d 100644
--- a/stubs/retry/METADATA.toml
+++ b/stubs/retry/METADATA.toml
@@ -1 +1,2 @@
 version = "0.9.*"
+upstream_repository = "https://github.com/invl/retry"
diff --git a/stubs/setuptools/METADATA.toml b/stubs/setuptools/METADATA.toml
index 16bd13a4d..55fe528c0 100644
--- a/stubs/setuptools/METADATA.toml
+++ b/stubs/setuptools/METADATA.toml
@@ -1,4 +1,5 @@
 version = "68.0.*"
+upstream_repository = "https://github.com/pypa/setuptools"
 partial_stub = true
 
 [tool.stubtest]
diff --git a/stubs/simplejson/METADATA.toml b/stubs/simplejson/METADATA.toml
index 2f8d0e659..23fe62d9e 100644
--- a/stubs/simplejson/METADATA.toml
+++ b/stubs/simplejson/METADATA.toml
@@ -1,4 +1,5 @@
 version = "3.19.*"
+upstream_repository = "https://github.com/simplejson/simplejson"
 partial_stub = true
 
 [tool.stubtest]
diff --git a/stubs/singledispatch/METADATA.toml b/stubs/singledispatch/METADATA.toml
index 3188e8fc2..8cbdb9a79 100644
--- a/stubs/singledispatch/METADATA.toml
+++ b/stubs/singledispatch/METADATA.toml
@@ -1 +1,2 @@
 version = "4.0.*"
+upstream_repository = "https://github.com/jaraco/singledispatch"
diff --git a/stubs/six/METADATA.toml b/stubs/six/METADATA.toml
index 7aac80450..1e209ddf8 100644
--- a/stubs/six/METADATA.toml
+++ b/stubs/six/METADATA.toml
@@ -1 +1,2 @@
 version = "1.16.*"
+upstream_repository = "https://github.com/benjaminp/six"
diff --git a/stubs/slumber/METADATA.toml b/stubs/slumber/METADATA.toml
index 55019ecce..e408f2381 100644
--- a/stubs/slumber/METADATA.toml
+++ b/stubs/slumber/METADATA.toml
@@ -1,2 +1,3 @@
 version = "0.7.*"
+upstream_repository = "https://github.com/samgiles/slumber"
 requires = ["types-requests"]
diff --git a/stubs/stdlib-list/METADATA.toml b/stubs/stdlib-list/METADATA.toml
index fa7f7796a..4d6dcf39d 100644
--- a/stubs/stdlib-list/METADATA.toml
+++ b/stubs/stdlib-list/METADATA.toml
@@ -1,2 +1,3 @@
 version = "0.8.*"
+upstream_repository = "https://github.com/pypi/stdlib-list"
 obsolete_since = "0.9.0" # Released on 2023-06-22
diff --git a/stubs/stripe/METADATA.toml b/stubs/stripe/METADATA.toml
index 045114fe5..b0a9497ad 100644
--- a/stubs/stripe/METADATA.toml
+++ b/stubs/stripe/METADATA.toml
@@ -1,4 +1,5 @@
 version = "3.5.*"
+upstream_repository = "https://github.com/stripe/stripe-python"
 partial_stub = true
 
 [tool.stubtest]
diff --git a/stubs/tabulate/METADATA.toml b/stubs/tabulate/METADATA.toml
index 51e869b47..c90013533 100644
--- a/stubs/tabulate/METADATA.toml
+++ b/stubs/tabulate/METADATA.toml
@@ -1 +1,2 @@
 version = "0.9.*"
+upstream_repository = "https://github.com/astanin/python-tabulate"
diff --git a/stubs/toml/METADATA.toml b/stubs/toml/METADATA.toml
index 5c7ed21e8..13a5562b3 100644
--- a/stubs/toml/METADATA.toml
+++ b/stubs/toml/METADATA.toml
@@ -1 +1,2 @@
 version = "0.10.*"
+upstream_repository = "https://github.com/uiri/toml"
diff --git a/stubs/tqdm/METADATA.toml b/stubs/tqdm/METADATA.toml
index 987d23754..3c8564d17 100644
--- a/stubs/tqdm/METADATA.toml
+++ b/stubs/tqdm/METADATA.toml
@@ -1,4 +1,5 @@
 version = "4.65.*"
+upstream_repository = "https://github.com/tqdm/tqdm"
 
 [tool.stubtest]
 extras = ["slack", "telegram"]
diff --git a/stubs/translationstring/METADATA.toml b/stubs/translationstring/METADATA.toml
index 6d3b92238..3c910d4fd 100644
--- a/stubs/translationstring/METADATA.toml
+++ b/stubs/translationstring/METADATA.toml
@@ -1 +1,2 @@
 version = "1.4.*"
+upstream_repository = "https://github.com/Pylons/translationstring"
diff --git a/stubs/tree-sitter-languages/METADATA.toml b/stubs/tree-sitter-languages/METADATA.toml
index 1a11f1517..6b15f4dee 100644
--- a/stubs/tree-sitter-languages/METADATA.toml
+++ b/stubs/tree-sitter-languages/METADATA.toml
@@ -1,2 +1,3 @@
 version = "1.7.*"
+upstream_repository = "https://github.com/grantjenks/py-tree-sitter-languages"
 requires = ["types-tree-sitter"]
diff --git a/stubs/tree-sitter/METADATA.toml b/stubs/tree-sitter/METADATA.toml
index ae1fb69ff..85770bf0f 100644
--- a/stubs/tree-sitter/METADATA.toml
+++ b/stubs/tree-sitter/METADATA.toml
@@ -1 +1,2 @@
 version = "0.20.*"
+upstream_repository = "https://github.com/tree-sitter/py-tree-sitter"
diff --git a/stubs/ttkthemes/METADATA.toml b/stubs/ttkthemes/METADATA.toml
index 38c94680a..edbe27fbb 100644
--- a/stubs/ttkthemes/METADATA.toml
+++ b/stubs/ttkthemes/METADATA.toml
@@ -1 +1,2 @@
 version = "3.2.*"
+upstream_repository = "https://github.com/RedFantom/ttkthemes"
diff --git a/stubs/tzlocal/METADATA.toml b/stubs/tzlocal/METADATA.toml
index 4849fa5ea..8f421a002 100644
--- a/stubs/tzlocal/METADATA.toml
+++ b/stubs/tzlocal/METADATA.toml
@@ -1,2 +1,3 @@
 version = "5.0.1"
+upstream_repository = "https://github.com/regebro/tzlocal"
 requires = ["types-pytz"]
diff --git a/stubs/ujson/METADATA.toml b/stubs/ujson/METADATA.toml
index 295659a16..106b24f04 100644
--- a/stubs/ujson/METADATA.toml
+++ b/stubs/ujson/METADATA.toml
@@ -1 +1,2 @@
 version = "5.8.*"
+upstream_repository = "https://github.com/ultrajson/ultrajson"
diff --git a/stubs/urllib3/METADATA.toml b/stubs/urllib3/METADATA.toml
index 344c34462..39f0246a6 100644
--- a/stubs/urllib3/METADATA.toml
+++ b/stubs/urllib3/METADATA.toml
@@ -1,4 +1,5 @@
 version = "1.26.*"
+upstream_repository = "https://github.com/urllib3/urllib3"
 obsolete_since = "2.0.0" # Released on 2023-04-26
 partial_stub = true
 
diff --git a/stubs/waitress/METADATA.toml b/stubs/waitress/METADATA.toml
index be1838d9f..48c7151c4 100644
--- a/stubs/waitress/METADATA.toml
+++ b/stubs/waitress/METADATA.toml
@@ -1,4 +1,5 @@
 version = "2.1.*"
+upstream_repository = "https://github.com/Pylons/waitress"
 requires = []
 partial_stub = true
 
diff --git a/stubs/whatthepatch/METADATA.toml b/stubs/whatthepatch/METADATA.toml
index f3e83f9c4..ff3378e56 100644
--- a/stubs/whatthepatch/METADATA.toml
+++ b/stubs/whatthepatch/METADATA.toml
@@ -1 +1,2 @@
 version = "1.0.*"
+upstream_repository = "https://github.com/cscorley/whatthepatch"
diff --git a/stubs/xmltodict/METADATA.toml b/stubs/xmltodict/METADATA.toml
index 9f7bb49c0..01d8351c2 100644
--- a/stubs/xmltodict/METADATA.toml
+++ b/stubs/xmltodict/METADATA.toml
@@ -1 +1,2 @@
 version = "0.13.*"
+upstream_repository = "https://github.com/martinblech/xmltodict"
diff --git a/stubs/zstd/METADATA.toml b/stubs/zstd/METADATA.toml
index 97ceca8aa..c1f77cd44 100644
--- a/stubs/zstd/METADATA.toml
+++ b/stubs/zstd/METADATA.toml
@@ -1 +1,2 @@
 version = "1.5.*"
+upstream_repository = "https://github.com/sergey-dryabzhinsky/python-zstd"
diff --git a/stubs/zxcvbn/METADATA.toml b/stubs/zxcvbn/METADATA.toml
index 2e800d80f..3d7f4f91d 100644
--- a/stubs/zxcvbn/METADATA.toml
+++ b/stubs/zxcvbn/METADATA.toml
@@ -1 +1,2 @@
 version = "4.4.*"
+upstream_repository = "https://github.com/dwolfhub/zxcvbn-python"
diff --git a/tests/parse_metadata.py b/tests/parse_metadata.py
index a99e89a69..6097049ea 100644
--- a/tests/parse_metadata.py
+++ b/tests/parse_metadata.py
@@ -120,6 +120,7 @@ class StubMetadata:
     requires: Annotated[list[str], "The raw requirements as listed in METADATA.toml"]
     extra_description: str | None
     stub_distribution: Annotated[str, "The name under which the distribution is uploaded to PyPI"]
+    upstream_repository: Annotated[str, "The URL of the upstream repository"] | None
     obsolete_since: Annotated[str, "A string representing a specific version"] | None
     no_longer_updated: bool
     uploaded_to_pypi: Annotated[bool, "Whether or not a distribution is uploaded to PyPI"]
@@ -133,6 +134,7 @@ _KNOWN_METADATA_FIELDS: Final = frozenset(
         "requires",
         "extra_description",
         "stub_distribution",
+        "upstream_repository",
         "obsolete_since",
         "no_longer_updated",
         "upload",
@@ -195,6 +197,8 @@ def read_metadata(distribution: str) -> StubMetadata:
     else:
         stub_distribution = f"types-{distribution}"
 
+    upstream_repository: object = data.get("upstream_repository")
+    assert isinstance(upstream_repository, (str, type(None)))
     obsolete_since: object = data.get("obsolete_since")
     assert isinstance(obsolete_since, (str, type(None)))
     no_longer_updated: object = data.get("no_longer_updated", False)
@@ -219,6 +223,7 @@ def read_metadata(distribution: str) -> StubMetadata:
         requires=requires,
         extra_description=extra_description,
         stub_distribution=stub_distribution,
+        upstream_repository=upstream_repository,
         obsolete_since=obsolete_since,
         no_longer_updated=no_longer_updated,
         uploaded_to_pypi=uploaded_to_pypi,