diff --git a/.changes/.python-version b/.changes/.python-version new file mode 100644 index 00000000000..e4fba218358 --- /dev/null +++ b/.changes/.python-version @@ -0,0 +1 @@ +3.12 diff --git a/.changes/README.md b/.changes/README.md index ed2b43267a8..d5cb3ca0c48 100644 --- a/.changes/README.md +++ b/.changes/README.md @@ -48,3 +48,27 @@ Then commit the changelog and the `.changes` directory: ```sh > git add CHANGELOG.md .changes ``` + +## Development + +The changelog tool is a python project managed by [uv](https://docs.astral.sh/uv/). +While most usage doesn't require worrying about the underlying python code +due to a lack of dependencies, developers must make use of `uv` to lint and +format code before committing. + +```sh +> uv sync +> uv run ruff check --fix +> uv run ruff format +> uv run pyright +``` + +uv will manage keeping a virtual python environment up to date and ensure that the +right versions of these tools is used. + +uv can also be used to run scripts: + +```sh +> uv sync +> uv run render +``` diff --git a/.changes/amend b/.changes/amend index ff091e48950..0dd6e08067a 100755 --- a/.changes/amend +++ b/.changes/amend @@ -1,60 +1,7 @@ #! /usr/bin/env python3 # Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. # SPDX-License-Identifier: Apache-2.0 -from argparse import ArgumentParser - -from tool.amend import amend - - -def main() -> None: - parser = ArgumentParser( - description="""\ - Amend recently-introduced changelog entries to include a pull request \ - link. This is intended to be run in GitHub as an action, but can be run \ - manually by specifying parameters GitHub would otherwise provide in \ - environment variables. - - This only checks entries that have been staged in the current branch, \ - using git to get a list of newly introduced files. If the entry already \ - has one or more associated pull requests, it is not amended.""", - ) - parser.add_argument( - "-n", - "--pull-request-number", - required=True, - help="The numeric identifier for the pull request.", - ) - parser.add_argument( - "-r", - "--repository", - help="""\ - The name of the repository, defaulting to 'smithy-lang/smithy'. This is \ - provided by GitHub in the GITHUB_REPOSITORY environment variable.""", - ) - parser.add_argument( - "-b", - "--base", - help="""\ - The name of the base branch to diff against, defaulting to 'main'. This \ - is provided by GitHub in the GITHUB_BASE_REF environment variable.""", - ) - parser.add_argument( - "-c", - "--review-comment", - action="store_true", - default=False, - help="""\ - Instead of amending the local files on disk, post a review comment on the \ - PR. This will also post a normal comment if no changelog entry is found.""", - ) - - args = parser.parse_args() - amend( - base=args.base, - repository=args.repository, - pr_number=args.pull_request_number, - review_comment=args.review_comment, - ) +from tool.amend import main if __name__ == "__main__": diff --git a/.changes/new-change b/.changes/new-change index 440fb0ba041..82579cce16f 100755 --- a/.changes/new-change +++ b/.changes/new-change @@ -1,46 +1,7 @@ #! /usr/bin/env python3 # Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. # SPDX-License-Identifier: Apache-2.0 -from argparse import ArgumentParser - -from tool import ChangeType -from tool.new import new_change - - -def main() -> None: - parser = ArgumentParser( - description="""\ - Create a new changelog entry to be staged for the next release. Required \ - values not provided on the command line will be prompted for.""", - ) - parser.add_argument( - "-t", - "--type", - choices=[t.name.lower() for t in ChangeType], - help="The type of change being logged.", - ) - parser.add_argument( - "-d", "--description", type=str, help="A concise description of the change." - ) - parser.add_argument( - "-p", - "--pull-requests", - nargs="+", - help="The pull request that implements the change.", - ) - parser.add_argument( - "-r", - "--repository", - help="The name of the repository, defaulting to 'smithy-lang/smithy'.", - ) - - args = parser.parse_args() - new_change( - change_type=ChangeType[args.type.upper()], - description=args.description, - pull_requests=args.pull_requests, - repository=args.repository, - ) +from tool.new import main if __name__ == "__main__": diff --git a/.changes/next-release/bugfix-a4eb4361f200aabca46d06a5985bbd4ccc1fc60c.json b/.changes/next-release/bugfix-a4eb4361f200aabca46d06a5985bbd4ccc1fc60c.json deleted file mode 100644 index 9a229a99dbe..00000000000 --- a/.changes/next-release/bugfix-a4eb4361f200aabca46d06a5985bbd4ccc1fc60c.json +++ /dev/null @@ -1,7 +0,0 @@ -{ - "type": "bugfix", - "description": "Fixed a bug in smoke test validation where test case ids weren't checked for uniqueness if their operations were bound to a resource shape", - "pull_requests": [ - "[#2482](https://github.com/smithy-lang/smithy/issues/2482)" - ] -} diff --git a/.changes/next-release/documentation-7da019874732a62550914aa13b543b6e4de60a6e.json b/.changes/next-release/documentation-7da019874732a62550914aa13b543b6e4de60a6e.json deleted file mode 100644 index fd775540b53..00000000000 --- a/.changes/next-release/documentation-7da019874732a62550914aa13b543b6e4de60a6e.json +++ /dev/null @@ -1,7 +0,0 @@ -{ - "type": "documentation", - "description": "Added a tool to generate stageable, non-conflicting changelog entries and render a changelog based on staged entries.", - "pull_requests": [ - "[#2462](https://github.com/smithy-lang/smithy/issues/2462)" - ] -} diff --git a/.changes/next-release/feature-4352fb542ea76e90f06860fb12e80bc88b02616f.json b/.changes/next-release/feature-4352fb542ea76e90f06860fb12e80bc88b02616f.json deleted file mode 100644 index 7d9c4af0ef0..00000000000 --- a/.changes/next-release/feature-4352fb542ea76e90f06860fb12e80bc88b02616f.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "type": "feature", - "description": "Add breakingChanges to the removal of sigv4 and sigv4a traits", - "pull_requests": [] -} diff --git a/.changes/next-release/feature-972f78d227a4fe30f8512c53c8e5d2ecb2349fc1.json b/.changes/next-release/feature-972f78d227a4fe30f8512c53c8e5d2ecb2349fc1.json deleted file mode 100644 index b92c376712c..00000000000 --- a/.changes/next-release/feature-972f78d227a4fe30f8512c53c8e5d2ecb2349fc1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "type": "feature", - "description": "Adds MQTT topic filter parsing and conflict support; fixes a parsing bug that treated trailing and preceding empty levels incorrectly", - "pull_requests": [] -} diff --git a/.changes/next-release/feature-f1decfa17cc23bd6a2718e7dddfeb8d5eb252163.json b/.changes/next-release/feature-f1decfa17cc23bd6a2718e7dddfeb8d5eb252163.json deleted file mode 100644 index 87eae0eb82a..00000000000 --- a/.changes/next-release/feature-f1decfa17cc23bd6a2718e7dddfeb8d5eb252163.json +++ /dev/null @@ -1,7 +0,0 @@ -{ - "type": "feature", - "description": "fix: Convert blob default values to Base64", - "pull_requests": [ - "[#2474](https://github.com/smithy-lang/smithy/issues/2474)" - ] -} diff --git a/.changes/pyproject.toml b/.changes/pyproject.toml new file mode 100644 index 00000000000..5b43de89a07 --- /dev/null +++ b/.changes/pyproject.toml @@ -0,0 +1,44 @@ +[project] +name = "changelog" +version = "0.1.0" +description = "A staged changelog tool for Smithy." +readme = "README.md" +requires-python = ">=3.12" +dependencies = [] + +[project.scripts] +amend = "tool.amend:main" +render = "tool.render:main" +new-change = "tool.new:main" + +[dependency-groups] +lint = [ + "ruff>=0.12.3", + "docformatter>=1.7.7", +] +typing = [ + "pyright>=1.1.403" +] + +[tool.uv] +package = true +required-version = ">=0.7.21" +default-groups = ["lint", "typing"] + +[tool.pyright] +typeCheckingMode = "strict" + +[tool.docformatter] +recursive = true +black = true + +[tool.ruff] +target-version = "py312" + +[tool.ruff.lint] +select = [ "ASYNC", "C4", "E1", "E4", "E7", "E9", "F", "FURB", "G", "I", "LOG", "PIE", "RUF", "S", "T", "UP" ] +ignore = [ "T201", "S602", "S324", "S310" ] + +[tool.ruff.format] +docstring-code-format = true + diff --git a/.changes/render b/.changes/render index 4f2b46d9197..c0d904db341 100755 --- a/.changes/render +++ b/.changes/render @@ -1,48 +1,7 @@ #! /usr/bin/env python3 # Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. # SPDX-License-Identifier: Apache-2.0 -from argparse import ArgumentParser - -from tool.release import release -from tool.render import render - - -def main() -> None: - parser = ArgumentParser( - description="""\ - Render the changelog as markdown, optionally including pending features \ - as a new release.""", - ) - release_group = parser.add_argument_group( - "release", - description="""\ - These arguments allow for releasing all pending features in the \ - next-release folder as a new release. If not set, the exisiting releases \ - will be re-rendered.""", - ) - release_group.add_argument( - "-v", - "--release-version", - type=str, - help="""\ - The version to use for the staged changelog release. If set, all pending \ - features will be compiled into a release.""", - ) - release_group.add_argument( - "-d", - "--release-date", - type=str, - help="""\ - The date of the release in ISO format (e.g. 2024-11-13). If not set, \ - today's date, according to your local time zone, will be used.""", - ) - - args = parser.parse_args() - - if args.release_version: - release(args.release_version, args.release_date) - - render() +from tool.render import main if __name__ == "__main__": diff --git a/.changes/tool/__init__.py b/.changes/tool/__init__.py index 9135459e0ad..40f9c3e7162 100644 --- a/.changes/tool/__init__.py +++ b/.changes/tool/__init__.py @@ -35,7 +35,7 @@ def __lt__(self, other: Self) -> bool: class Change: type: ChangeType description: str - pull_requests: list[str] = field(default_factory=list) + pull_requests: list[str] = field(default_factory=list[str]) @classmethod def from_json(cls, data: dict[str, Any]) -> Self: diff --git a/.changes/tool/amend.py b/.changes/tool/amend.py index f1dd55d9dc2..0ee890c11fc 100644 --- a/.changes/tool/amend.py +++ b/.changes/tool/amend.py @@ -2,6 +2,7 @@ # SPDX-License-Identifier: Apache-2.0 import os import subprocess +from argparse import ArgumentParser from pathlib import Path from . import REPO_ROOT, Change @@ -11,6 +12,57 @@ GITHUB_URL = os.environ.get("GITHUB_SERVER_URL", "https://github.com") +def main() -> None: + parser = ArgumentParser( + description="""\ + Amend recently-introduced changelog entries to include a pull request \ + link. This is intended to be run in GitHub as an action, but can be run \ + manually by specifying parameters GitHub would otherwise provide in \ + environment variables. + + This only checks entries that have been staged in the current branch, \ + using git to get a list of newly introduced files. If the entry already \ + has one or more associated pull requests, it is not amended.""", + ) + parser.add_argument( + "-n", + "--pull-request-number", + required=True, + help="The numeric identifier for the pull request.", + ) + parser.add_argument( + "-r", + "--repository", + help="""\ + The name of the repository, defaulting to 'smithy-lang/smithy'. This is \ + provided by GitHub in the GITHUB_REPOSITORY environment variable.""", + ) + parser.add_argument( + "-b", + "--base", + help="""\ + The name of the base branch to diff against, defaulting to 'main'. This \ + is provided by GitHub in the GITHUB_BASE_REF environment variable.""", + ) + parser.add_argument( + "-c", + "--review-comment", + action="store_true", + default=False, + help="""\ + Instead of amending the local files on disk, post a review comment on the \ + PR. This will also post a normal comment if no changelog entry is found.""", + ) + + args = parser.parse_args() + amend( + base=args.base, + repository=args.repository, + pr_number=args.pull_request_number, + review_comment=args.review_comment, + ) + + def amend( *, pr_number: str, diff --git a/.changes/tool/github.py b/.changes/tool/github.py index 43577085160..0523e9acefa 100644 --- a/.changes/tool/github.py +++ b/.changes/tool/github.py @@ -8,10 +8,11 @@ import os import re import time +from collections.abc import Generator from dataclasses import dataclass from http.client import HTTPResponse from pathlib import Path -from typing import Generator, Literal, NotRequired, Required, Self, TypedDict +from typing import Literal, NotRequired, Required, Self, TypedDict from urllib import request from urllib.error import HTTPError @@ -111,8 +112,7 @@ def get_review_comments( raise ValueError( f"Expected list body, but found {type(response.body)}: {response.body}" ) - for comment in response.body: - yield comment # type: ignore + yield from response.body # type: ignore # https://docs.github.com/en/rest/issues/comments?apiVersion=2022-11-28#create-an-issue-comment @@ -147,8 +147,7 @@ def get_comments( raise ValueError( f"Expected list body, but found {type(response.body)}: {response.body}" ) - for comment in response.body: - yield comment # type: ignore + yield from response.body # type: ignore @dataclass diff --git a/.changes/tool/new.py b/.changes/tool/new.py index d5731e64655..a2f1d78d540 100644 --- a/.changes/tool/new.py +++ b/.changes/tool/new.py @@ -6,6 +6,7 @@ import string import subprocess import tempfile +from argparse import ArgumentParser from . import NEXT_RELEASE_DIR, Change, ChangeType @@ -33,6 +34,42 @@ """ +def main() -> None: + parser = ArgumentParser( + description="""\ + Create a new changelog entry to be staged for the next release. Required \ + values not provided on the command line will be prompted for.""", + ) + parser.add_argument( + "-t", + "--type", + choices=[t.name.lower() for t in ChangeType], + help="The type of change being logged.", + ) + parser.add_argument( + "-d", "--description", type=str, help="A concise description of the change." + ) + parser.add_argument( + "-p", + "--pull-requests", + nargs="+", + help="The pull request that implements the change.", + ) + parser.add_argument( + "-r", + "--repository", + help="The name of the repository, defaulting to 'smithy-lang/smithy'.", + ) + + args = parser.parse_args() + new_change( + change_type=ChangeType[args.type.upper()], + description=args.description, + pull_requests=args.pull_requests, + repository=args.repository, + ) + + def new_change( change_type: ChangeType | None = None, description: str | None = None, @@ -128,7 +165,7 @@ def parse_filled_in_contents(contents: str) -> Change | None: # of the description, so we can break once we pull in the # remaining lines. first_line = line.split(":")[1].strip() - full_description = "\n".join([first_line] + list(lines)) + full_description = "\n".join([first_line], *list(lines)) parsed["description"] = full_description.strip() break diff --git a/.changes/tool/render.py b/.changes/tool/render.py index b84b38659d0..16afc495175 100644 --- a/.changes/tool/render.py +++ b/.changes/tool/render.py @@ -1,10 +1,51 @@ # Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. # SPDX-License-Identifier: Apache-2.0 +from argparse import ArgumentParser + from . import RELEASES_DIR, Change, Release +from .release import release as _release TITLE = "Changelog" +def main() -> None: + parser = ArgumentParser( + description="""\ + Render the changelog as markdown, optionally including pending features \ + as a new release.""", + ) + release_group = parser.add_argument_group( + "release", + description="""\ + These arguments allow for releasing all pending features in the \ + next-release folder as a new release. If not set, the exisiting releases \ + will be re-rendered.""", + ) + release_group.add_argument( + "-v", + "--release-version", + type=str, + help="""\ + The version to use for the staged changelog release. If set, all pending \ + features will be compiled into a release.""", + ) + release_group.add_argument( + "-d", + "--release-date", + type=str, + help="""\ + The date of the release in ISO format (e.g. 2024-11-13). If not set, \ + today's date, according to your local time zone, will be used.""", + ) + + args = parser.parse_args() + + if args.release_version: + _release(args.release_version, args.release_date) + + render() + + def render() -> None: rendered = f"# {TITLE}\n\n" for release in get_releases(): diff --git a/.changes/uv.lock b/.changes/uv.lock new file mode 100644 index 00000000000..d0be6c0b96c --- /dev/null +++ b/.changes/uv.lock @@ -0,0 +1,136 @@ +version = 1 +revision = 2 +requires-python = ">=3.12" + +[[package]] +name = "changelog" +version = "0.1.0" +source = { editable = "." } + +[package.dev-dependencies] +lint = [ + { name = "docformatter" }, + { name = "ruff" }, +] +typing = [ + { name = "pyright" }, +] + +[package.metadata] + +[package.metadata.requires-dev] +lint = [ + { name = "docformatter", specifier = ">=1.7.7" }, + { name = "ruff", specifier = ">=0.12.3" }, +] +typing = [{ name = "pyright", specifier = ">=1.1.403" }] + +[[package]] +name = "charset-normalizer" +version = "3.4.2" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/e4/33/89c2ced2b67d1c2a61c19c6751aa8902d46ce3dacb23600a283619f5a12d/charset_normalizer-3.4.2.tar.gz", hash = "sha256:5baececa9ecba31eff645232d59845c07aa030f0c81ee70184a90d35099a0e63", size = 126367, upload-time = "2025-05-02T08:34:42.01Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/d7/a4/37f4d6035c89cac7930395a35cc0f1b872e652eaafb76a6075943754f095/charset_normalizer-3.4.2-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:0c29de6a1a95f24b9a1aa7aefd27d2487263f00dfd55a77719b530788f75cff7", size = 199936, upload-time = "2025-05-02T08:32:33.712Z" }, + { url = "https://files.pythonhosted.org/packages/ee/8a/1a5e33b73e0d9287274f899d967907cd0bf9c343e651755d9307e0dbf2b3/charset_normalizer-3.4.2-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:cddf7bd982eaa998934a91f69d182aec997c6c468898efe6679af88283b498d3", size = 143790, upload-time = "2025-05-02T08:32:35.768Z" }, + { url = "https://files.pythonhosted.org/packages/66/52/59521f1d8e6ab1482164fa21409c5ef44da3e9f653c13ba71becdd98dec3/charset_normalizer-3.4.2-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:fcbe676a55d7445b22c10967bceaaf0ee69407fbe0ece4d032b6eb8d4565982a", size = 153924, upload-time = "2025-05-02T08:32:37.284Z" }, + { url = "https://files.pythonhosted.org/packages/86/2d/fb55fdf41964ec782febbf33cb64be480a6b8f16ded2dbe8db27a405c09f/charset_normalizer-3.4.2-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:d41c4d287cfc69060fa91cae9683eacffad989f1a10811995fa309df656ec214", size = 146626, upload-time = "2025-05-02T08:32:38.803Z" }, + { url = "https://files.pythonhosted.org/packages/8c/73/6ede2ec59bce19b3edf4209d70004253ec5f4e319f9a2e3f2f15601ed5f7/charset_normalizer-3.4.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:4e594135de17ab3866138f496755f302b72157d115086d100c3f19370839dd3a", size = 148567, upload-time = "2025-05-02T08:32:40.251Z" }, + { url = "https://files.pythonhosted.org/packages/09/14/957d03c6dc343c04904530b6bef4e5efae5ec7d7990a7cbb868e4595ee30/charset_normalizer-3.4.2-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:cf713fe9a71ef6fd5adf7a79670135081cd4431c2943864757f0fa3a65b1fafd", size = 150957, upload-time = "2025-05-02T08:32:41.705Z" }, + { url = "https://files.pythonhosted.org/packages/0d/c8/8174d0e5c10ccebdcb1b53cc959591c4c722a3ad92461a273e86b9f5a302/charset_normalizer-3.4.2-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:a370b3e078e418187da8c3674eddb9d983ec09445c99a3a263c2011993522981", size = 145408, upload-time = "2025-05-02T08:32:43.709Z" }, + { url = "https://files.pythonhosted.org/packages/58/aa/8904b84bc8084ac19dc52feb4f5952c6df03ffb460a887b42615ee1382e8/charset_normalizer-3.4.2-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:a955b438e62efdf7e0b7b52a64dc5c3396e2634baa62471768a64bc2adb73d5c", size = 153399, upload-time = "2025-05-02T08:32:46.197Z" }, + { url = "https://files.pythonhosted.org/packages/c2/26/89ee1f0e264d201cb65cf054aca6038c03b1a0c6b4ae998070392a3ce605/charset_normalizer-3.4.2-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:7222ffd5e4de8e57e03ce2cef95a4c43c98fcb72ad86909abdfc2c17d227fc1b", size = 156815, upload-time = "2025-05-02T08:32:48.105Z" }, + { url = "https://files.pythonhosted.org/packages/fd/07/68e95b4b345bad3dbbd3a8681737b4338ff2c9df29856a6d6d23ac4c73cb/charset_normalizer-3.4.2-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:bee093bf902e1d8fc0ac143c88902c3dfc8941f7ea1d6a8dd2bcb786d33db03d", size = 154537, upload-time = "2025-05-02T08:32:49.719Z" }, + { url = "https://files.pythonhosted.org/packages/77/1a/5eefc0ce04affb98af07bc05f3bac9094513c0e23b0562d64af46a06aae4/charset_normalizer-3.4.2-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:dedb8adb91d11846ee08bec4c8236c8549ac721c245678282dcb06b221aab59f", size = 149565, upload-time = "2025-05-02T08:32:51.404Z" }, + { url = "https://files.pythonhosted.org/packages/37/a0/2410e5e6032a174c95e0806b1a6585eb21e12f445ebe239fac441995226a/charset_normalizer-3.4.2-cp312-cp312-win32.whl", hash = "sha256:db4c7bf0e07fc3b7d89ac2a5880a6a8062056801b83ff56d8464b70f65482b6c", size = 98357, upload-time = "2025-05-02T08:32:53.079Z" }, + { url = "https://files.pythonhosted.org/packages/6c/4f/c02d5c493967af3eda9c771ad4d2bbc8df6f99ddbeb37ceea6e8716a32bc/charset_normalizer-3.4.2-cp312-cp312-win_amd64.whl", hash = "sha256:5a9979887252a82fefd3d3ed2a8e3b937a7a809f65dcb1e068b090e165bbe99e", size = 105776, upload-time = "2025-05-02T08:32:54.573Z" }, + { url = "https://files.pythonhosted.org/packages/ea/12/a93df3366ed32db1d907d7593a94f1fe6293903e3e92967bebd6950ed12c/charset_normalizer-3.4.2-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:926ca93accd5d36ccdabd803392ddc3e03e6d4cd1cf17deff3b989ab8e9dbcf0", size = 199622, upload-time = "2025-05-02T08:32:56.363Z" }, + { url = "https://files.pythonhosted.org/packages/04/93/bf204e6f344c39d9937d3c13c8cd5bbfc266472e51fc8c07cb7f64fcd2de/charset_normalizer-3.4.2-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:eba9904b0f38a143592d9fc0e19e2df0fa2e41c3c3745554761c5f6447eedabf", size = 143435, upload-time = "2025-05-02T08:32:58.551Z" }, + { url = "https://files.pythonhosted.org/packages/22/2a/ea8a2095b0bafa6c5b5a55ffdc2f924455233ee7b91c69b7edfcc9e02284/charset_normalizer-3.4.2-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:3fddb7e2c84ac87ac3a947cb4e66d143ca5863ef48e4a5ecb83bd48619e4634e", size = 153653, upload-time = "2025-05-02T08:33:00.342Z" }, + { url = "https://files.pythonhosted.org/packages/b6/57/1b090ff183d13cef485dfbe272e2fe57622a76694061353c59da52c9a659/charset_normalizer-3.4.2-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:98f862da73774290f251b9df8d11161b6cf25b599a66baf087c1ffe340e9bfd1", size = 146231, upload-time = "2025-05-02T08:33:02.081Z" }, + { url = "https://files.pythonhosted.org/packages/e2/28/ffc026b26f441fc67bd21ab7f03b313ab3fe46714a14b516f931abe1a2d8/charset_normalizer-3.4.2-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:6c9379d65defcab82d07b2a9dfbfc2e95bc8fe0ebb1b176a3190230a3ef0e07c", size = 148243, upload-time = "2025-05-02T08:33:04.063Z" }, + { url = "https://files.pythonhosted.org/packages/c0/0f/9abe9bd191629c33e69e47c6ef45ef99773320e9ad8e9cb08b8ab4a8d4cb/charset_normalizer-3.4.2-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:e635b87f01ebc977342e2697d05b56632f5f879a4f15955dfe8cef2448b51691", size = 150442, upload-time = "2025-05-02T08:33:06.418Z" }, + { url = "https://files.pythonhosted.org/packages/67/7c/a123bbcedca91d5916c056407f89a7f5e8fdfce12ba825d7d6b9954a1a3c/charset_normalizer-3.4.2-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:1c95a1e2902a8b722868587c0e1184ad5c55631de5afc0eb96bc4b0d738092c0", size = 145147, upload-time = "2025-05-02T08:33:08.183Z" }, + { url = "https://files.pythonhosted.org/packages/ec/fe/1ac556fa4899d967b83e9893788e86b6af4d83e4726511eaaad035e36595/charset_normalizer-3.4.2-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:ef8de666d6179b009dce7bcb2ad4c4a779f113f12caf8dc77f0162c29d20490b", size = 153057, upload-time = "2025-05-02T08:33:09.986Z" }, + { url = "https://files.pythonhosted.org/packages/2b/ff/acfc0b0a70b19e3e54febdd5301a98b72fa07635e56f24f60502e954c461/charset_normalizer-3.4.2-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:32fc0341d72e0f73f80acb0a2c94216bd704f4f0bce10aedea38f30502b271ff", size = 156454, upload-time = "2025-05-02T08:33:11.814Z" }, + { url = "https://files.pythonhosted.org/packages/92/08/95b458ce9c740d0645feb0e96cea1f5ec946ea9c580a94adfe0b617f3573/charset_normalizer-3.4.2-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:289200a18fa698949d2b39c671c2cc7a24d44096784e76614899a7ccf2574b7b", size = 154174, upload-time = "2025-05-02T08:33:13.707Z" }, + { url = "https://files.pythonhosted.org/packages/78/be/8392efc43487ac051eee6c36d5fbd63032d78f7728cb37aebcc98191f1ff/charset_normalizer-3.4.2-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:4a476b06fbcf359ad25d34a057b7219281286ae2477cc5ff5e3f70a246971148", size = 149166, upload-time = "2025-05-02T08:33:15.458Z" }, + { url = "https://files.pythonhosted.org/packages/44/96/392abd49b094d30b91d9fbda6a69519e95802250b777841cf3bda8fe136c/charset_normalizer-3.4.2-cp313-cp313-win32.whl", hash = "sha256:aaeeb6a479c7667fbe1099af9617c83aaca22182d6cf8c53966491a0f1b7ffb7", size = 98064, upload-time = "2025-05-02T08:33:17.06Z" }, + { url = "https://files.pythonhosted.org/packages/e9/b0/0200da600134e001d91851ddc797809e2fe0ea72de90e09bec5a2fbdaccb/charset_normalizer-3.4.2-cp313-cp313-win_amd64.whl", hash = "sha256:aa6af9e7d59f9c12b33ae4e9450619cf2488e2bbe9b44030905877f0b2324980", size = 105641, upload-time = "2025-05-02T08:33:18.753Z" }, + { url = "https://files.pythonhosted.org/packages/20/94/c5790835a017658cbfabd07f3bfb549140c3ac458cfc196323996b10095a/charset_normalizer-3.4.2-py3-none-any.whl", hash = "sha256:7f56930ab0abd1c45cd15be65cc741c28b1c9a34876ce8c17a2fa107810c0af0", size = 52626, upload-time = "2025-05-02T08:34:40.053Z" }, +] + +[[package]] +name = "docformatter" +version = "1.7.7" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "charset-normalizer" }, + { name = "untokenize" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/2a/7b/ee08cb5fe2627ed0b6f0cc4a1c6be6c9c71de5a3e9785de8174273fc3128/docformatter-1.7.7.tar.gz", hash = "sha256:ea0e1e8867e5af468dfc3f9e947b92230a55be9ec17cd1609556387bffac7978", size = 26587, upload-time = "2025-05-11T04:54:04.356Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/dc/b4/a7ec1eaee86761a9dbfd339732b4706db3c6b65e970c12f0f56cfcce3dcf/docformatter-1.7.7-py3-none-any.whl", hash = "sha256:7af49f8a46346a77858f6651f431b882c503c2f4442c8b4524b920c863277834", size = 33525, upload-time = "2025-05-11T04:54:03.353Z" }, +] + +[[package]] +name = "nodeenv" +version = "1.9.1" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/43/16/fc88b08840de0e0a72a2f9d8c6bae36be573e475a6326ae854bcc549fc45/nodeenv-1.9.1.tar.gz", hash = "sha256:6ec12890a2dab7946721edbfbcd91f3319c6ccc9aec47be7c7e6b7011ee6645f", size = 47437, upload-time = "2024-06-04T18:44:11.171Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/d2/1d/1b658dbd2b9fa9c4c9f32accbfc0205d532c8c6194dc0f2a4c0428e7128a/nodeenv-1.9.1-py2.py3-none-any.whl", hash = "sha256:ba11c9782d29c27c70ffbdda2d7415098754709be8a7056d79a737cd901155c9", size = 22314, upload-time = "2024-06-04T18:44:08.352Z" }, +] + +[[package]] +name = "pyright" +version = "1.1.403" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "nodeenv" }, + { name = "typing-extensions" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/fe/f6/35f885264ff08c960b23d1542038d8da86971c5d8c955cfab195a4f672d7/pyright-1.1.403.tar.gz", hash = "sha256:3ab69b9f41c67fb5bbb4d7a36243256f0d549ed3608678d381d5f51863921104", size = 3913526, upload-time = "2025-07-09T07:15:52.882Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/49/b6/b04e5c2f41a5ccad74a1a4759da41adb20b4bc9d59a5e08d29ba60084d07/pyright-1.1.403-py3-none-any.whl", hash = "sha256:c0eeca5aa76cbef3fcc271259bbd785753c7ad7bcac99a9162b4c4c7daed23b3", size = 5684504, upload-time = "2025-07-09T07:15:50.958Z" }, +] + +[[package]] +name = "ruff" +version = "0.12.3" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/c3/2a/43955b530c49684d3c38fcda18c43caf91e99204c2a065552528e0552d4f/ruff-0.12.3.tar.gz", hash = "sha256:f1b5a4b6668fd7b7ea3697d8d98857390b40c1320a63a178eee6be0899ea2d77", size = 4459341, upload-time = "2025-07-11T13:21:16.086Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/e2/fd/b44c5115539de0d598d75232a1cc7201430b6891808df111b8b0506aae43/ruff-0.12.3-py3-none-linux_armv6l.whl", hash = "sha256:47552138f7206454eaf0c4fe827e546e9ddac62c2a3d2585ca54d29a890137a2", size = 10430499, upload-time = "2025-07-11T13:20:26.321Z" }, + { url = "https://files.pythonhosted.org/packages/43/c5/9eba4f337970d7f639a37077be067e4ec80a2ad359e4cc6c5b56805cbc66/ruff-0.12.3-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:0a9153b000c6fe169bb307f5bd1b691221c4286c133407b8827c406a55282041", size = 11213413, upload-time = "2025-07-11T13:20:30.017Z" }, + { url = "https://files.pythonhosted.org/packages/e2/2c/fac3016236cf1fe0bdc8e5de4f24c76ce53c6dd9b5f350d902549b7719b2/ruff-0.12.3-py3-none-macosx_11_0_arm64.whl", hash = "sha256:fa6b24600cf3b750e48ddb6057e901dd5b9aa426e316addb2a1af185a7509882", size = 10586941, upload-time = "2025-07-11T13:20:33.046Z" }, + { url = "https://files.pythonhosted.org/packages/c5/0f/41fec224e9dfa49a139f0b402ad6f5d53696ba1800e0f77b279d55210ca9/ruff-0.12.3-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e2506961bf6ead54887ba3562604d69cb430f59b42133d36976421bc8bd45901", size = 10783001, upload-time = "2025-07-11T13:20:35.534Z" }, + { url = "https://files.pythonhosted.org/packages/0d/ca/dd64a9ce56d9ed6cad109606ac014860b1c217c883e93bf61536400ba107/ruff-0.12.3-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:c4faaff1f90cea9d3033cbbcdf1acf5d7fb11d8180758feb31337391691f3df0", size = 10269641, upload-time = "2025-07-11T13:20:38.459Z" }, + { url = "https://files.pythonhosted.org/packages/63/5c/2be545034c6bd5ce5bb740ced3e7014d7916f4c445974be11d2a406d5088/ruff-0.12.3-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:40dced4a79d7c264389de1c59467d5d5cefd79e7e06d1dfa2c75497b5269a5a6", size = 11875059, upload-time = "2025-07-11T13:20:41.517Z" }, + { url = "https://files.pythonhosted.org/packages/8e/d4/a74ef1e801ceb5855e9527dae105eaff136afcb9cc4d2056d44feb0e4792/ruff-0.12.3-py3-none-manylinux_2_17_ppc64.manylinux2014_ppc64.whl", hash = "sha256:0262d50ba2767ed0fe212aa7e62112a1dcbfd46b858c5bf7bbd11f326998bafc", size = 12658890, upload-time = "2025-07-11T13:20:44.442Z" }, + { url = "https://files.pythonhosted.org/packages/13/c8/1057916416de02e6d7c9bcd550868a49b72df94e3cca0aeb77457dcd9644/ruff-0.12.3-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:12371aec33e1a3758597c5c631bae9a5286f3c963bdfb4d17acdd2d395406687", size = 12232008, upload-time = "2025-07-11T13:20:47.374Z" }, + { url = "https://files.pythonhosted.org/packages/f5/59/4f7c130cc25220392051fadfe15f63ed70001487eca21d1796db46cbcc04/ruff-0.12.3-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:560f13b6baa49785665276c963edc363f8ad4b4fc910a883e2625bdb14a83a9e", size = 11499096, upload-time = "2025-07-11T13:20:50.348Z" }, + { url = "https://files.pythonhosted.org/packages/d4/01/a0ad24a5d2ed6be03a312e30d32d4e3904bfdbc1cdbe63c47be9d0e82c79/ruff-0.12.3-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:023040a3499f6f974ae9091bcdd0385dd9e9eb4942f231c23c57708147b06311", size = 11688307, upload-time = "2025-07-11T13:20:52.945Z" }, + { url = "https://files.pythonhosted.org/packages/93/72/08f9e826085b1f57c9a0226e48acb27643ff19b61516a34c6cab9d6ff3fa/ruff-0.12.3-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:883d844967bffff5ab28bba1a4d246c1a1b2933f48cb9840f3fdc5111c603b07", size = 10661020, upload-time = "2025-07-11T13:20:55.799Z" }, + { url = "https://files.pythonhosted.org/packages/80/a0/68da1250d12893466c78e54b4a0ff381370a33d848804bb51279367fc688/ruff-0.12.3-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:2120d3aa855ff385e0e562fdee14d564c9675edbe41625c87eeab744a7830d12", size = 10246300, upload-time = "2025-07-11T13:20:58.222Z" }, + { url = "https://files.pythonhosted.org/packages/6a/22/5f0093d556403e04b6fd0984fc0fb32fbb6f6ce116828fd54306a946f444/ruff-0.12.3-py3-none-musllinux_1_2_i686.whl", hash = "sha256:6b16647cbb470eaf4750d27dddc6ebf7758b918887b56d39e9c22cce2049082b", size = 11263119, upload-time = "2025-07-11T13:21:01.503Z" }, + { url = "https://files.pythonhosted.org/packages/92/c9/f4c0b69bdaffb9968ba40dd5fa7df354ae0c73d01f988601d8fac0c639b1/ruff-0.12.3-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:e1417051edb436230023575b149e8ff843a324557fe0a265863b7602df86722f", size = 11746990, upload-time = "2025-07-11T13:21:04.524Z" }, + { url = "https://files.pythonhosted.org/packages/fe/84/7cc7bd73924ee6be4724be0db5414a4a2ed82d06b30827342315a1be9e9c/ruff-0.12.3-py3-none-win32.whl", hash = "sha256:dfd45e6e926deb6409d0616078a666ebce93e55e07f0fb0228d4b2608b2c248d", size = 10589263, upload-time = "2025-07-11T13:21:07.148Z" }, + { url = "https://files.pythonhosted.org/packages/07/87/c070f5f027bd81f3efee7d14cb4d84067ecf67a3a8efb43aadfc72aa79a6/ruff-0.12.3-py3-none-win_amd64.whl", hash = "sha256:a946cf1e7ba3209bdef039eb97647f1c77f6f540e5845ec9c114d3af8df873e7", size = 11695072, upload-time = "2025-07-11T13:21:11.004Z" }, + { url = "https://files.pythonhosted.org/packages/e0/30/f3eaf6563c637b6e66238ed6535f6775480db973c836336e4122161986fc/ruff-0.12.3-py3-none-win_arm64.whl", hash = "sha256:5f9c7c9c8f84c2d7f27e93674d27136fbf489720251544c4da7fb3d742e011b1", size = 10805855, upload-time = "2025-07-11T13:21:13.547Z" }, +] + +[[package]] +name = "typing-extensions" +version = "4.14.1" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/98/5a/da40306b885cc8c09109dc2e1abd358d5684b1425678151cdaed4731c822/typing_extensions-4.14.1.tar.gz", hash = "sha256:38b39f4aeeab64884ce9f74c94263ef78f3c22467c8724005483154c26648d36", size = 107673, upload-time = "2025-07-04T13:28:34.16Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/b5/00/d631e67a838026495268c2f6884f3711a15a9a2a96cd244fdaea53b823fb/typing_extensions-4.14.1-py3-none-any.whl", hash = "sha256:d1e1e3b58374dc93031d6eda2420a48ea44a36c2b4766a4fdeb3710755731d76", size = 43906, upload-time = "2025-07-04T13:28:32.743Z" }, +] + +[[package]] +name = "untokenize" +version = "0.1.1" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/f7/46/e7cea8159199096e1df52da20a57a6665da80c37fb8aeb848a3e47442c32/untokenize-0.1.1.tar.gz", hash = "sha256:3865dbbbb8efb4bb5eaa72f1be7f3e0be00ea8b7f125c69cbd1f5fda926f37a2", size = 3099, upload-time = "2014-02-08T16:30:40.631Z" }