Skip to content

Update Python Worker docs to use default entrypoint handlers. #24392

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

Jump to bottom
Merged
merged 1 commit into from
Aug 14, 2025
Merged

Update Python Worker docs to use default entrypoint handlers. #24392

merged 1 commit into from
Aug 14, 2025

Conversation

@dom96
Copy link
Contributor

@dom96 dom96 commented Aug 13, 2025

Summary

Python Workers has a new compat flag which becomes default on 2025-08-14. At which point the global handlers won't be supported in Python anymore. This PR updates all example usage of Python Workers to use the new way of defining the handlers: inside a Default class.

Documentation checklist

@github-actions github-actions bot added product:d1 D1: https://developers.cloudflare.com/d1/ product:durable-objects Durable Objects: https://developers.cloudflare.com/workers/learning/using-durable-objects/ labels Aug 13, 2025
@github-actions github-actions bot added the product:workers Related to Workers product label Aug 13, 2025
@github-actions
Copy link
Contributor

github-actions bot commented Aug 13, 2025 •
edited
Loading

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/content/changelog/ @cloudflare/pm-changelogs, @cloudflare/pcx-technical-writing
/src/content/docs/d1/ @elithrar, @rozenmd, @vy-ton, @joshthoward, @oxyjun, @harshil1712, @cloudflare/pcx-technical-writing
/src/content/docs/durable-objects/ @elithrar, @vy-ton, @joshthoward, @oxyjun, @harshil1712, @mikenomitch, @cloudflare/pcx-technical-writing, @cloudflare/workers-runtime-1
/src/content/docs/workers/ @cloudflare/workers-docs, @GregBrimble, @irvinebroque, @mikenomitch, @korinne, @WalshyDev, @cloudflare/deploy-config, @cloudflare/pcx-technical-writing, @kodster28, @cloudflare/wrangler, @cloudflare/workers-runtime-1, @cloudflare/wrangler
/src/content/partials/workers/ @cloudflare/workers-docs, @GregBrimble, @irvinebroque, @mikenomitch, @WalshyDev, @cloudflare/deploy-config, @cloudflare/pcx-technical-writing, @kodster28, @cloudflare/wrangler, @cloudflare/workers-runtime-1, @cloudflare/wrangler

@dom96 dom96 mentioned this pull request Aug 13, 2025
Merged
6 tasks
@github-actions
Copy link
Contributor

github-actions bot commented Aug 13, 2025 •
edited
Loading

Preview URL: https://9a1af27a.preview.developers.cloudflare.com
Preview Branch URL: https://dominik-update-to-use-default-entrypoint.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link Updated Link
https://developers.cloudflare.com/workers/examples/cors-header-proxy/ https://dominik-update-to-use-default-entrypoint.preview.developers.cloudflare.com/workers/examples/cors-header-proxy/
https://developers.cloudflare.com/workers/examples/signing-requests/ https://dominik-update-to-use-default-entrypoint.preview.developers.cloudflare.com/workers/examples/signing-requests/
https://developers.cloudflare.com/workers/languages/python/examples/ https://dominik-update-to-use-default-entrypoint.preview.developers.cloudflare.com/workers/languages/python/examples/
https://developers.cloudflare.com/workers/examples/security-headers/ https://dominik-update-to-use-default-entrypoint.preview.developers.cloudflare.com/workers/examples/security-headers/
https://developers.cloudflare.com/workers/examples/conditional-response/ https://dominik-update-to-use-default-entrypoint.preview.developers.cloudflare.com/workers/examples/conditional-response/
https://developers.cloudflare.com/workers/examples/geolocation-app-weather/ https://dominik-update-to-use-default-entrypoint.preview.developers.cloudflare.com/workers/examples/geolocation-app-weather/
https://developers.cloudflare.com/workers/examples/data-loss-prevention/ https://dominik-update-to-use-default-entrypoint.preview.developers.cloudflare.com/workers/examples/data-loss-prevention/
https://developers.cloudflare.com/workers/examples/modify-request-property/ https://dominik-update-to-use-default-entrypoint.preview.developers.cloudflare.com/workers/examples/modify-request-property/
https://developers.cloudflare.com/workers/examples/ab-testing/ https://dominik-update-to-use-default-entrypoint.preview.developers.cloudflare.com/workers/examples/ab-testing/
https://developers.cloudflare.com/workers/examples/geolocation-hello-world/ https://dominik-update-to-use-default-entrypoint.preview.developers.cloudflare.com/workers/examples/geolocation-hello-world/
https://developers.cloudflare.com/workers/examples/cache-api/ https://dominik-update-to-use-default-entrypoint.preview.developers.cloudflare.com/workers/examples/cache-api/
https://developers.cloudflare.com/workers/examples/cache-using-fetch/ https://dominik-update-to-use-default-entrypoint.preview.developers.cloudflare.com/workers/examples/cache-using-fetch/
https://developers.cloudflare.com/workers/examples/debugging-logs/ https://dominik-update-to-use-default-entrypoint.preview.developers.cloudflare.com/workers/examples/debugging-logs/
https://developers.cloudflare.com/workers/examples/turnstile-html-rewriter/ https://dominik-update-to-use-default-entrypoint.preview.developers.cloudflare.com/workers/examples/turnstile-html-rewriter/
https://developers.cloudflare.com/workers/examples/rewrite-links/ https://dominik-update-to-use-default-entrypoint.preview.developers.cloudflare.com/workers/examples/rewrite-links/

mikenomitch
mikenomitch reviewed Aug 13, 2025
View reviewed changes
mikenomitch
mikenomitch reviewed Aug 13, 2025
View reviewed changes
mikenomitch
mikenomitch approved these changes Aug 13, 2025
View reviewed changes
Copy link
Contributor

@mikenomitch mikenomitch left a comment

Choose a reason for hiding this comment

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

+1ed to unblock but added a couple questions in comments

hoodmane
hoodmane reviewed Aug 14, 2025
View reviewed changes
hoodmane
hoodmane reviewed Aug 14, 2025
View reviewed changes
hoodmane
hoodmane reviewed Aug 14, 2025
View reviewed changes
hoodmane
hoodmane reviewed Aug 14, 2025
View reviewed changes
hoodmane
hoodmane reviewed Aug 14, 2025
View reviewed changes
@dom96 dom96 force-pushed the dominik/update-to-use-default-entrypoint branch from 8fdcd97 to 04c7217 Compare August 14, 2025 11:37
@github-actions
Copy link
Contributor

github-actions bot commented Aug 14, 2025 •
edited
Loading

This PR requires additional review attention because it affects the following areas:

Partials

This PR updates partial files, which are pieces of content used across multiple files in our Render component.

hoodmane
hoodmane reviewed Aug 14, 2025
View reviewed changes
@dom96 dom96 force-pushed the dominik/update-to-use-default-entrypoint branch from 04c7217 to bba2642 Compare August 14, 2025 11:42
hoodmane
hoodmane approved these changes Aug 14, 2025
View reviewed changes
@dom96 dom96 force-pushed the dominik/update-to-use-default-entrypoint branch 2 times, most recently from 94dc061 to b499756 Compare August 14, 2025 13:52
@dom96 dom96 force-pushed the dominik/update-to-use-default-entrypoint branch from b499756 to 9a1af27 Compare August 14, 2025 15:45
@dom96 dom96 merged commit 82e2257 into production Aug 14, 2025
8 checks passed
@dom96 dom96 deleted the dominik/update-to-use-default-entrypoint branch August 14, 2025 16:04
thomasgauvin pushed a commit that referenced this pull request Aug 15, 2025
@dom96 @thomasgauvin
Update Python Worker docs to use default entrypoint. (#24392)
7c6d467
@hoodmane hoodmane mentioned this pull request Aug 29, 2025
Merged
hoodmane added a commit that referenced this pull request Sep 1, 2025
@hoodmane
Fix uses of env and ctx in Python examples (#24790)
b70c12f 
Since #24392, most of the Python examples use env and ctx incorrectly. This fixes it.

I also replaced all tabs with spaces in signing-requests.mdx.
nevikashah pushed a commit that referenced this pull request Sep 22, 2025
@hoodmane @nevikashah
Fix uses of env and ctx in Python examples (#24790)
de979c8 
Since #24392, most of the Python examples use env and ctx incorrectly. This fixes it.

I also replaced all tabs with spaces in signing-requests.mdx.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@mikenomitch mikenomitch mikenomitch approved these changes

@rozenmd rozenmd rozenmd approved these changes

@hoodmane hoodmane hoodmane approved these changes

@GregBrimble GregBrimble Awaiting requested review from GregBrimble GregBrimble is a code owner

@irvinebroque irvinebroque Awaiting requested review from irvinebroque irvinebroque is a code owner

@korinne korinne Awaiting requested review from korinne korinne is a code owner

@WalshyDev WalshyDev Awaiting requested review from WalshyDev WalshyDev is a code owner

@kodster28 kodster28 Awaiting requested review from kodster28 kodster28 is a code owner

@elithrar elithrar Awaiting requested review from elithrar elithrar is a code owner

@vy-ton vy-ton Awaiting requested review from vy-ton vy-ton is a code owner

@joshthoward joshthoward Awaiting requested review from joshthoward joshthoward is a code owner

@Oxyjun Oxyjun Awaiting requested review from Oxyjun Oxyjun is a code owner

@harshil1712 harshil1712 Awaiting requested review from harshil1712 harshil1712 is a code owner

Assignees

@elithrar elithrar

@pedrosousa pedrosousa

@rozenmd rozenmd

@joshthoward joshthoward

@vy-ton vy-ton

@harshil1712 harshil1712

@dcpena dcpena

@haleycode haleycode

@patriciasantaana patriciasantaana

@Oxyjun Oxyjun

Labels

product:d1 D1: https://developers.cloudflare.com/d1/ product:durable-objects Durable Objects: https://developers.cloudflare.com/workers/learning/using-durable-objects/ product:workers Related to Workers product size/xl

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.