From 7723e963177a5677a20fe079e6200e810dd776ae Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= Date: Tue, 30 Jul 2024 21:17:52 -0500 Subject: [PATCH 0001/1417] =?UTF-8?q?=F0=9F=91=B7=20Update=20tokens=20for?= =?UTF-8?q?=20GitHub=20Actions=20(#11924)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .github/workflows/issue-manager.yml | 3 +++ .github/workflows/label-approved.yml | 3 +++ 2 files changed, 6 insertions(+) diff --git a/.github/workflows/issue-manager.yml b/.github/workflows/issue-manager.yml index 260902e12..d5b947a9c 100644 --- a/.github/workflows/issue-manager.yml +++ b/.github/workflows/issue-manager.yml @@ -14,6 +14,9 @@ on: - labeled workflow_dispatch: +permissions: + issues: write + jobs: issue-manager: if: github.repository_owner == 'fastapi' diff --git a/.github/workflows/label-approved.yml b/.github/workflows/label-approved.yml index 63fb7ff23..939444aaf 100644 --- a/.github/workflows/label-approved.yml +++ b/.github/workflows/label-approved.yml @@ -5,6 +5,9 @@ on: - cron: "0 12 * * *" workflow_dispatch: +permissions: + issues: write + jobs: label-approved: if: github.repository_owner == 'fastapi' From b0801e66d303ba54aaa6bac442642a16f1dbb51b Mon Sep 17 00:00:00 2001 From: github-actions Date: Wed, 31 Jul 2024 02:18:12 +0000 Subject: [PATCH 0002/1417] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20not?= =?UTF-8?q?es?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/en/docs/release-notes.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md index b418ff445..7d23692a5 100644 --- a/docs/en/docs/release-notes.md +++ b/docs/en/docs/release-notes.md @@ -25,6 +25,7 @@ hide: ### Internal +* 👷 Update tokens for GitHub Actions. PR [#11924](https://github.com/fastapi/fastapi/pull/11924) by [@tiangolo](https://github.com/tiangolo). * 👷 Update token permissions to comment deployment URL in docs. PR [#11917](https://github.com/fastapi/fastapi/pull/11917) by [@tiangolo](https://github.com/tiangolo). * 👷 Update token permissions for GitHub Actions. PR [#11915](https://github.com/fastapi/fastapi/pull/11915) by [@tiangolo](https://github.com/tiangolo). * 👷 Update GitHub Actions token usage. PR [#11914](https://github.com/fastapi/fastapi/pull/11914) by [@tiangolo](https://github.com/tiangolo). From 2e35b176cf5ff73e4cb035322f0af8157d654f7d Mon Sep 17 00:00:00 2001 From: jianghuyiyuan Date: Wed, 31 Jul 2024 23:09:15 +0900 Subject: [PATCH 0003/1417] =?UTF-8?q?=E2=9C=8F=EF=B8=8F=20Fix=20typos=20in?= =?UTF-8?q?=20docs=20(#11926)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/en/docs/management.md | 2 +- docs_src/dataclasses/tutorial002.py | 2 +- docs_src/dataclasses/tutorial003.py | 2 +- tests/test_tutorial/test_dataclasses/test_tutorial002.py | 2 +- tests/test_tutorial/test_dataclasses/test_tutorial003.py | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/en/docs/management.md b/docs/en/docs/management.md index ac0ede75f..085a1756f 100644 --- a/docs/en/docs/management.md +++ b/docs/en/docs/management.md @@ -6,7 +6,7 @@ Here's a short description of how the FastAPI repository is managed and maintain I, @tiangolo, am the creator and owner of the FastAPI repository. 🤓 -I normally give the final review to each PR before merging them. I make the final decisions on the the project, I'm the BDFL. 😅 +I normally give the final review to each PR before merging them. I make the final decisions on the project, I'm the BDFL. 😅 ## Team diff --git a/docs_src/dataclasses/tutorial002.py b/docs_src/dataclasses/tutorial002.py index 08a238080..ece2f150c 100644 --- a/docs_src/dataclasses/tutorial002.py +++ b/docs_src/dataclasses/tutorial002.py @@ -21,6 +21,6 @@ async def read_next_item(): return { "name": "Island In The Moon", "price": 12.99, - "description": "A place to be be playin' and havin' fun", + "description": "A place to be playin' and havin' fun", "tags": ["breater"], } diff --git a/docs_src/dataclasses/tutorial003.py b/docs_src/dataclasses/tutorial003.py index 34ce1199e..c61315513 100644 --- a/docs_src/dataclasses/tutorial003.py +++ b/docs_src/dataclasses/tutorial003.py @@ -33,7 +33,7 @@ def get_authors(): # (8) "items": [ { "name": "Island In The Moon", - "description": "A place to be be playin' and havin' fun", + "description": "A place to be playin' and havin' fun", }, {"name": "Holy Buddies"}, ], diff --git a/tests/test_tutorial/test_dataclasses/test_tutorial002.py b/tests/test_tutorial/test_dataclasses/test_tutorial002.py index 4146f4cd6..e6d303cfc 100644 --- a/tests/test_tutorial/test_dataclasses/test_tutorial002.py +++ b/tests/test_tutorial/test_dataclasses/test_tutorial002.py @@ -12,7 +12,7 @@ def test_get_item(): assert response.json() == { "name": "Island In The Moon", "price": 12.99, - "description": "A place to be be playin' and havin' fun", + "description": "A place to be playin' and havin' fun", "tags": ["breater"], "tax": None, } diff --git a/tests/test_tutorial/test_dataclasses/test_tutorial003.py b/tests/test_tutorial/test_dataclasses/test_tutorial003.py index dd0e36735..e1fa45201 100644 --- a/tests/test_tutorial/test_dataclasses/test_tutorial003.py +++ b/tests/test_tutorial/test_dataclasses/test_tutorial003.py @@ -31,7 +31,7 @@ def test_get_authors(): "items": [ { "name": "Island In The Moon", - "description": "A place to be be playin' and havin' fun", + "description": "A place to be playin' and havin' fun", }, {"name": "Holy Buddies", "description": None}, ], From c0ae16ab7a25a0b54d8201479cf31e2492f7090a Mon Sep 17 00:00:00 2001 From: github-actions Date: Wed, 31 Jul 2024 14:09:35 +0000 Subject: [PATCH 0004/1417] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20not?= =?UTF-8?q?es?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/en/docs/release-notes.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md index 7d23692a5..385133266 100644 --- a/docs/en/docs/release-notes.md +++ b/docs/en/docs/release-notes.md @@ -9,6 +9,7 @@ hide: ### Docs +* ✏️ Fix typos in docs. PR [#11926](https://github.com/fastapi/fastapi/pull/11926) by [@jianghuyiyuan](https://github.com/jianghuyiyuan). * 📝 Tweak management docs. PR [#11918](https://github.com/fastapi/fastapi/pull/11918) by [@tiangolo](https://github.com/tiangolo). * 🚚 Rename GitHub links from tiangolo/fastapi to fastapi/fastapi. PR [#11913](https://github.com/fastapi/fastapi/pull/11913) by [@tiangolo](https://github.com/tiangolo). * 📝 Add docs about FastAPI team and project management. PR [#11908](https://github.com/tiangolo/fastapi/pull/11908) by [@tiangolo](https://github.com/tiangolo). From 8b930f88474d3da3551fb1f3e844b0591cce1f84 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= Date: Wed, 31 Jul 2024 18:40:04 -0500 Subject: [PATCH 0005/1417] =?UTF-8?q?=F0=9F=91=B7=20Refactor=20GitHub=20Ac?= =?UTF-8?q?tion=20to=20comment=20docs=20deployment=20URLs=20and=20update?= =?UTF-8?q?=20token=20(#11925)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../comment-docs-preview-in-pr/Dockerfile | 9 --- .../comment-docs-preview-in-pr/action.yml | 13 ---- .../comment-docs-preview-in-pr/app/main.py | 69 ------------------- .github/workflows/deploy-docs.yml | 23 +++++-- ...nts.txt => requirements-github-actions.txt | 4 +- scripts/comment_docs_deploy_url_in_pr.py | 31 +++++++++ 6 files changed, 52 insertions(+), 97 deletions(-) delete mode 100644 .github/actions/comment-docs-preview-in-pr/Dockerfile delete mode 100644 .github/actions/comment-docs-preview-in-pr/action.yml delete mode 100644 .github/actions/comment-docs-preview-in-pr/app/main.py rename .github/actions/comment-docs-preview-in-pr/requirements.txt => requirements-github-actions.txt (55%) create mode 100644 scripts/comment_docs_deploy_url_in_pr.py diff --git a/.github/actions/comment-docs-preview-in-pr/Dockerfile b/.github/actions/comment-docs-preview-in-pr/Dockerfile deleted file mode 100644 index 42627fe19..000000000 --- a/.github/actions/comment-docs-preview-in-pr/Dockerfile +++ /dev/null @@ -1,9 +0,0 @@ -FROM python:3.10 - -COPY ./requirements.txt /app/requirements.txt - -RUN pip install -r /app/requirements.txt - -COPY ./app /app - -CMD ["python", "/app/main.py"] diff --git a/.github/actions/comment-docs-preview-in-pr/action.yml b/.github/actions/comment-docs-preview-in-pr/action.yml deleted file mode 100644 index 0eb64402d..000000000 --- a/.github/actions/comment-docs-preview-in-pr/action.yml +++ /dev/null @@ -1,13 +0,0 @@ -name: Comment Docs Preview in PR -description: Comment with the docs URL preview in the PR -author: Sebastián Ramírez -inputs: - token: - description: Token for the repo. Can be passed in using {{ secrets.GITHUB_TOKEN }} - required: true - deploy_url: - description: The deployment URL to comment in the PR - required: true -runs: - using: docker - image: Dockerfile diff --git a/.github/actions/comment-docs-preview-in-pr/app/main.py b/.github/actions/comment-docs-preview-in-pr/app/main.py deleted file mode 100644 index 8cc119fe0..000000000 --- a/.github/actions/comment-docs-preview-in-pr/app/main.py +++ /dev/null @@ -1,69 +0,0 @@ -import logging -import sys -from pathlib import Path -from typing import Union - -import httpx -from github import Github -from github.PullRequest import PullRequest -from pydantic import BaseModel, SecretStr, ValidationError -from pydantic_settings import BaseSettings - -github_api = "https://api.github.com" - - -class Settings(BaseSettings): - github_repository: str - github_event_path: Path - github_event_name: Union[str, None] = None - input_token: SecretStr - input_deploy_url: str - - -class PartialGithubEventHeadCommit(BaseModel): - id: str - - -class PartialGithubEventWorkflowRun(BaseModel): - head_commit: PartialGithubEventHeadCommit - - -class PartialGithubEvent(BaseModel): - workflow_run: PartialGithubEventWorkflowRun - - -if __name__ == "__main__": - logging.basicConfig(level=logging.INFO) - settings = Settings() - logging.info(f"Using config: {settings.json()}") - g = Github(settings.input_token.get_secret_value()) - repo = g.get_repo(settings.github_repository) - try: - event = PartialGithubEvent.parse_file(settings.github_event_path) - except ValidationError as e: - logging.error(f"Error parsing event file: {e.errors()}") - sys.exit(0) - use_pr: Union[PullRequest, None] = None - for pr in repo.get_pulls(): - if pr.head.sha == event.workflow_run.head_commit.id: - use_pr = pr - break - if not use_pr: - logging.error(f"No PR found for hash: {event.workflow_run.head_commit.id}") - sys.exit(0) - github_headers = { - "Authorization": f"token {settings.input_token.get_secret_value()}" - } - url = f"{github_api}/repos/{settings.github_repository}/issues/{use_pr.number}/comments" - logging.info(f"Using comments URL: {url}") - response = httpx.post( - url, - headers=github_headers, - json={ - "body": f"📝 Docs preview for commit {use_pr.head.sha} at: {settings.input_deploy_url}" - }, - ) - if not (200 <= response.status_code <= 300): - logging.error(f"Error posting comment: {response.text}") - sys.exit(1) - logging.info("Finished") diff --git a/.github/workflows/deploy-docs.yml b/.github/workflows/deploy-docs.yml index 0f2fb4a5a..7d8846bb3 100644 --- a/.github/workflows/deploy-docs.yml +++ b/.github/workflows/deploy-docs.yml @@ -5,9 +5,11 @@ on: - Build Docs types: - completed + permissions: deployments: write issues: write + pull-requests: write jobs: deploy-docs: @@ -41,9 +43,22 @@ jobs: directory: './site' gitHubToken: ${{ secrets.GITHUB_TOKEN }} branch: ${{ ( github.event.workflow_run.head_repository.full_name == github.repository && github.event.workflow_run.head_branch == 'master' && 'main' ) || ( github.event.workflow_run.head_sha ) }} + - name: Set up Python + uses: actions/setup-python@v5 + with: + python-version: "3.11" + - uses: actions/cache@v4 + id: cache + with: + path: ${{ env.pythonLocation }} + key: ${{ runner.os }}-python-github-actions-${{ env.pythonLocation }}-${{ hashFiles('requirements-github-actions.txt') }}-v01 + - name: Install GitHub Actions dependencies + if: steps.cache.outputs.cache-hit != 'true' + run: pip install -r requirements-github-actions.txt - name: Comment Deploy if: steps.deploy.outputs.url != '' - uses: ./.github/actions/comment-docs-preview-in-pr - with: - token: ${{ secrets.GITHUB_TOKEN }} - deploy_url: "${{ steps.deploy.outputs.url }}" + run: python ./scripts/comment_docs_deploy_url_in_pr.py + env: + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} + DEPLOY_URL: ${{ steps.deploy.outputs.url }} + COMMIT_SHA: ${{ github.event.workflow_run.head_sha }} diff --git a/.github/actions/comment-docs-preview-in-pr/requirements.txt b/requirements-github-actions.txt similarity index 55% rename from .github/actions/comment-docs-preview-in-pr/requirements.txt rename to requirements-github-actions.txt index 74a3631f4..559dc06fb 100644 --- a/.github/actions/comment-docs-preview-in-pr/requirements.txt +++ b/requirements-github-actions.txt @@ -1,4 +1,4 @@ -PyGithub +PyGithub>=2.3.0,<3.0.0 pydantic>=2.5.3,<3.0.0 pydantic-settings>=2.1.0,<3.0.0 -httpx +httpx>=0.27.0,<0.28.0 diff --git a/scripts/comment_docs_deploy_url_in_pr.py b/scripts/comment_docs_deploy_url_in_pr.py new file mode 100644 index 000000000..3148a3bb4 --- /dev/null +++ b/scripts/comment_docs_deploy_url_in_pr.py @@ -0,0 +1,31 @@ +import logging +import sys + +from github import Github +from pydantic import SecretStr +from pydantic_settings import BaseSettings + + +class Settings(BaseSettings): + github_repository: str + github_token: SecretStr + deploy_url: str + commit_sha: str + + +if __name__ == "__main__": + logging.basicConfig(level=logging.INFO) + settings = Settings() + logging.info(f"Using config: {settings.model_dump_json()}") + g = Github(settings.github_token.get_secret_value()) + repo = g.get_repo(settings.github_repository) + use_pr = next( + (pr for pr in repo.get_pulls() if pr.head.sha == settings.commit_sha), None + ) + if not use_pr: + logging.error(f"No PR found for hash: {settings.commit_sha}") + sys.exit(0) + use_pr.as_issue().create_comment( + f"📝 Docs preview for commit {settings.commit_sha} at: {settings.deploy_url}" + ) + logging.info("Finished") From b8a06527fcee1b15adb2d24b75f6dbae36ad8b40 Mon Sep 17 00:00:00 2001 From: github-actions Date: Wed, 31 Jul 2024 23:40:27 +0000 Subject: [PATCH 0006/1417] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20not?= =?UTF-8?q?es?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/en/docs/release-notes.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md index 385133266..5701c21cc 100644 --- a/docs/en/docs/release-notes.md +++ b/docs/en/docs/release-notes.md @@ -26,6 +26,7 @@ hide: ### Internal +* 👷 Refactor GitHub Action to comment docs deployment URLs and update token. PR [#11925](https://github.com/fastapi/fastapi/pull/11925) by [@tiangolo](https://github.com/tiangolo). * 👷 Update tokens for GitHub Actions. PR [#11924](https://github.com/fastapi/fastapi/pull/11924) by [@tiangolo](https://github.com/tiangolo). * 👷 Update token permissions to comment deployment URL in docs. PR [#11917](https://github.com/fastapi/fastapi/pull/11917) by [@tiangolo](https://github.com/tiangolo). * 👷 Update token permissions for GitHub Actions. PR [#11915](https://github.com/fastapi/fastapi/pull/11915) by [@tiangolo](https://github.com/tiangolo). From 643a87cc848d9daf0d44b460708f42a202c29652 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= Date: Wed, 31 Jul 2024 21:18:05 -0500 Subject: [PATCH 0007/1417] =?UTF-8?q?=F0=9F=91=B7=20Update=20GitHub=20Acti?= =?UTF-8?q?on=20label-approved=20permissions=20(#11933)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 👷 Update label-approved permissions --- .github/workflows/label-approved.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/label-approved.yml b/.github/workflows/label-approved.yml index 939444aaf..0470fb606 100644 --- a/.github/workflows/label-approved.yml +++ b/.github/workflows/label-approved.yml @@ -6,7 +6,7 @@ on: workflow_dispatch: permissions: - issues: write + pull-requests: write jobs: label-approved: From 9d41d6e8a82affdb7e40ce16800f41eec61397ff Mon Sep 17 00:00:00 2001 From: github-actions Date: Thu, 1 Aug 2024 02:18:34 +0000 Subject: [PATCH 0008/1417] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20not?= =?UTF-8?q?es?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/en/docs/release-notes.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md index 5701c21cc..62d566403 100644 --- a/docs/en/docs/release-notes.md +++ b/docs/en/docs/release-notes.md @@ -26,6 +26,7 @@ hide: ### Internal +* 👷 Update GitHub Action label-approved permissions. PR [#11933](https://github.com/fastapi/fastapi/pull/11933) by [@tiangolo](https://github.com/tiangolo). * 👷 Refactor GitHub Action to comment docs deployment URLs and update token. PR [#11925](https://github.com/fastapi/fastapi/pull/11925) by [@tiangolo](https://github.com/tiangolo). * 👷 Update tokens for GitHub Actions. PR [#11924](https://github.com/fastapi/fastapi/pull/11924) by [@tiangolo](https://github.com/tiangolo). * 👷 Update token permissions to comment deployment URL in docs. PR [#11917](https://github.com/fastapi/fastapi/pull/11917) by [@tiangolo](https://github.com/tiangolo). From efb4a077bebf5e8cd27d1d2de076f64fac26b31f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= Date: Wed, 31 Jul 2024 23:53:51 -0500 Subject: [PATCH 0009/1417] =?UTF-8?q?=F0=9F=94=A7=20Update=20sponsors:=20a?= =?UTF-8?q?dd=20liblab=20(#11934)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 1 + docs/en/data/sponsors.yml | 3 +++ docs/en/docs/advanced/generate-clients.md | 6 +++++- docs/en/docs/img/sponsors/liblab-banner.png | Bin 0 -> 12453 bytes docs/en/docs/img/sponsors/liblab.png | Bin 0 -> 8637 bytes docs/en/overrides/main.html | 6 ++++++ 6 files changed, 15 insertions(+), 1 deletion(-) create mode 100644 docs/en/docs/img/sponsors/liblab-banner.png create mode 100644 docs/en/docs/img/sponsors/liblab.png diff --git a/README.md b/README.md index 43cc7198c..739e77627 100644 --- a/README.md +++ b/README.md @@ -57,6 +57,7 @@ The key features are: + diff --git a/docs/en/data/sponsors.yml b/docs/en/data/sponsors.yml index 39654a361..8c0956ac5 100644 --- a/docs/en/data/sponsors.yml +++ b/docs/en/data/sponsors.yml @@ -32,6 +32,9 @@ gold: - url: https://fine.dev?ref=fastapibadge title: "Fine's AI FastAPI Workflow: Effortlessly Deploy and Integrate FastAPI into Your Project" img: https://fastapi.tiangolo.com/img/sponsors/fine.png + - url: https://liblab.com?utm_source=fastapi + title: liblab - Generate SDKs from FastAPI + img: https://fastapi.tiangolo.com/img/sponsors/liblab.png silver: - url: https://github.com/deepset-ai/haystack/ title: Build powerful search from composable, open source building blocks diff --git a/docs/en/docs/advanced/generate-clients.md b/docs/en/docs/advanced/generate-clients.md index 136ddb064..0053ac9bb 100644 --- a/docs/en/docs/advanced/generate-clients.md +++ b/docs/en/docs/advanced/generate-clients.md @@ -20,7 +20,11 @@ Some of them also ✨ [**sponsor FastAPI**](../help-fastapi.md#sponsor-the-autho And it shows their true commitment to FastAPI and its **community** (you), as they not only want to provide you a **good service** but also want to make sure you have a **good and healthy framework**, FastAPI. 🙇 -For example, you might want to try Speakeasy and Stainless. +For example, you might want to try: + +* Speakeasy +* Stainless +* liblab There are also several other companies offering similar services that you can search and find online. 🤓 diff --git a/docs/en/docs/img/sponsors/liblab-banner.png b/docs/en/docs/img/sponsors/liblab-banner.png new file mode 100644 index 0000000000000000000000000000000000000000..299ff816b8b97e8428eb53de4abcfe011bd15f02 GIT binary patch literal 12453 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�bh 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 literal 0 HcmV?d00001 diff --git a/docs/en/docs/img/sponsors/liblab.png b/docs/en/docs/img/sponsors/liblab.png new file mode 100644 index 0000000000000000000000000000000000000000..ee461d7bcad65f6edd6c622492ad162d33acca3c GIT binary patch literal 8637 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