Skip to content

Add links to Python packages docs #24045

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: production
Choose a base branch
from
Open

Add links to Python packages docs #24045

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions src/content/docs/workers/languages/python/packages/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,10 +9,10 @@ head:
import { Render } from "~/components";

[Pywrangler](https://github.com/cloudflare/workers-py?tab=readme-ov-file#pywrangler) is a CLI tool for managing packages and Python Workers.
It is meant as a wrapper for wrangler that sets up a full environment for you, including bundling your packages into
It is meant as a wrapper for [Wrangler CLI](/workers/wrangler/) that sets up a full Python virtual environment for you, including bundling your packages into
Copy link
Contributor

@mikenomitch mikenomitch Jul 29, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@dom96 is this part true? What we're doing versus what uv is doing re virtual env?

Copy link
Contributor

@mikenomitch mikenomitch Jul 29, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
It is meant as a wrapper for [Wrangler CLI](/workers/wrangler/) that sets up a full Python virtual environment for you, including bundling your packages into
It is a wrapper for [Wrangler CLI](/workers/wrangler/) that uses [`uv`](https://github.com/astral-sh/uv) to set up a full Python virtual environment for you, including bundling your packages into

Copy link
Contributor

@mikenomitch mikenomitch Jul 29, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think true w this edit and also provides context on uv

Copy link
Contributor

@dom96 dom96 Jul 30, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah, with that edit it makes sense.

your worker bundle on deployment.

To get started, create a pyproject.toml file with the following contents:
To get started, create a `pyproject.toml` file with the following contents:
Copy link
Contributor Author

@irvinebroque irvinebroque Jul 29, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I wonder if we should clarify that you should still put any Workers specific config in a wrangler.toml or wrangler.jsonc file and link to that?

Copy link
Contributor Author

@irvinebroque irvinebroque Jul 29, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
To get started, create a `pyproject.toml` file with the following contents:
To get started, create a [`pyproject.toml` file](https://docs.astral.sh/uv/guides/projects/) with the following contents:


```toml
[project]
Expand All @@ -28,7 +28,7 @@ dependencies = [
dev = ["workers-py"]
```

The above will allow your worker to depend on the [FastAPI](https://fastapi.tiangolo.com/) package.
The above will allow your Worker to depend on the [FastAPI](https://fastapi.tiangolo.com/) package.

To run the worker locally:

Expand All @@ -44,7 +44,7 @@ uv run pywrangler deploy

Your dependencies will get bundled with your worker automatically on deployment.

The `pywrangler` CLI also supports all commands supported by the `wrangler` tool, for the full list of commands run `uv run pywrangler --help`.
`pywrangler` also supports all [commands supported by Wrangler](/workers/wrangler/commands/). For the full list of commands run `uv run pywrangler --help`.

## HTTP Client Libraries

Expand Down