[python] add support for module entrypoints for cron services by nsidnev · Pull Request #15393 · vercel/vercel

nsidnev · 2026-03-05T17:11:16Z

Adds support new way to define an entrypoint for Python cron services. With this it would be possible to define a cron service as follows:

{
  "experimentalServices": {
    "cleanup": {
      "type": "cron",
      "entrypoint": "jobs.cleanup:run_cleanup",
      "schedule": "0 0 * * *"
    }
  }
}

Note

Low Risk Change

This PR adds a new optional configuration field and parsing logic for Python cron service entrypoints, representing a feature addition with no security-sensitive changes, auth modifications, or schema/migration impacts.

Adds optional handlerFunction field to Service type for cron module:callable entrypoints
New regex-based parsing for Python module:attr entrypoint format in fs-detectors
Extensive test coverage added for new entrypoint resolution and validation

^{Risk assessment for commit 87f4f0c.}

changeset-bot · 2026-03-05T17:11:29Z

🦋 Changeset detected

Latest commit: 87f4f0c

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 19 packages

Name	Type
@vercel/python-analysis	Minor
@vercel/fs-detectors	Minor
@vercel/python-runtime	Minor
@vercel/build-utils	Minor
@vercel/python	Minor
vercel	Patch
@vercel/static-build	Patch
@vercel/backends	Patch
@vercel/client	Patch
@vercel/elysia	Patch
@vercel/express	Patch
@vercel/fastify	Patch
@vercel/gatsby-plugin-vercel-builder	Patch
@vercel/h3	Patch
@vercel/hono	Patch
@vercel/koa	Patch
@vercel/nestjs	Patch
@vercel/node	Patch
@vercel/cervel	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

github-actions · 2026-03-05T17:38:24Z

📦 CLI Tarball Ready

The Vercel CLI tarball for this PR is now available!

Quick Test

You can test this PR's CLI directly by running:

npx https://vercel-avytl6tmd.vercel.sh/tarballs/vercel.tgz --help

Use in vercel.json

To use this CLI version in your project builds, add to your vercel.json:

{
  "build": {
    "env": {
      "VERCEL_CLI_VERSION": "vercel@https://vercel-avytl6tmd.vercel.sh/tarballs/vercel.tgz"
    }
  }
}

Python Runtime Wheel

A vercel-runtime wheel was also built for this PR.
To use in your Python project builds, also set this environment variable:

VERCEL_RUNTIME_PYTHON="vercel-runtime @ https://vercel-avytl6tmd.vercel.sh/tarballs/vercel_runtime-0.6.0.dev1772747312+87f4f0c-py3-none-any.whl"

Python Workers Wheel

A vercel-workers wheel was also built for this PR.
To use in your Python project builds, also set this environment variable:

VERCEL_WORKERS_PYTHON="vercel-workers @ https://vercel-avytl6tmd.vercel.sh/tarballs/vercel_workers-0.1.0.dev1772747312+87f4f0c-py3-none-any.whl"

github-actions · 2026-03-05T17:41:49Z

🧪 Unit Test Strategy

Comparing: 62463f7 → 87f4f0c (view diff)

Strategy: Code changed outside of a package - running all unit tests

⚠️ All unit tests will run because global code changes could impact all packages.

Affected packages - 40 (100%)

@vercel-internals/get-package-json
@vercel/backends
@vercel/build-utils
@vercel/cervel
@vercel/cli-auth
@vercel/client
@vercel/config
@vercel/detect-agent
@vercel/edge
@vercel/elysia
@vercel/error-utils
@vercel/express
@vercel/fastify
@vercel/firewall
@vercel/frameworks
@vercel/fs-detectors
@vercel/functions
@vercel/gatsby-plugin-vercel-builder
@vercel/go
@vercel/h3
@vercel/hono
@vercel/hydrogen
@vercel/koa
@vercel/nestjs
@vercel/next
@vercel/node
@vercel/oidc
@vercel/oidc-aws-credentials-provider
@vercel/python
@vercel/python-analysis
@vercel/redwood
@vercel/related-projects
@vercel/remix-builder
@vercel/routing-utils
@vercel/ruby
@vercel/rust
@vercel/static-build
@vercel/static-config
examples
vercel

Results

Unit tests: All affected packages will run unit tests
E2E tests: Running in parallel via E2E Tests workflow
Type checks: All affected packages will run type checks

This comment is automatically generated based on the affected testing strategy

…odule-based-entrypoints

This PR was opened by the [Changesets release](https://github.com/changesets/action) GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to main, this PR will be updated. # Releases ## @vercel/build-utils@13.7.0 ### Minor Changes - [python] add support for module-based entrypoints for cron jobs ([#15393](#15393)) - For the django frontend, dynamically load settings.py instead of parsing it ([#15367](#15367)) ### Patch Changes - Updated dependencies \[[`83e804013528fc54de31082960ae31f58339bd71`](83e8040), [`921314f958c4ec85adb09e020310a5becb7f866c`](921314f)]: - @vercel/python-analysis@0.9.0 ## vercel@50.29.0 ### Minor Changes - Add interactive mode to `webhooks create` and change warning prefix from `WARN!` to `WARNING!` ([#15406](#15406)) ### Patch Changes - Updated dependencies \[[`32e8ba5f593fdeddeb63d241d7806d6c12fffe76`](32e8ba5), [`83e804013528fc54de31082960ae31f58339bd71`](83e8040), [`0f1fa86770a35d0192d64d36cb46d932e1d2a12a`](0f1fa86), [`813f3d324404237e3806530b465625ea33816370`](813f3d3), [`0a78892b1e155eb4b587a8b84c4e6814f750697f`](0a78892), [`9a973a704b7350e19d0c3ac8e110ce55eea795b2`](9a973a7), [`c6f5ac6c11fb7f431b5fb634a7fb321b10c829af`](c6f5ac6), [`921314f958c4ec85adb09e020310a5becb7f866c`](921314f)]: - @vercel/next@4.15.42 - @vercel/build-utils@13.7.0 - @vercel/python@6.21.0 - @vercel/detect-agent@1.1.1 - @vercel/static-build@2.8.46 - @vercel/backends@0.0.42 - @vercel/elysia@0.1.45 - @vercel/express@0.1.54 - @vercel/fastify@0.1.48 - @vercel/go@3.4.3 - @vercel/h3@0.1.54 - @vercel/hono@0.2.48 - @vercel/hydrogen@1.3.5 - @vercel/koa@0.1.28 - @vercel/nestjs@0.2.49 - @vercel/node@5.6.12 - @vercel/redwood@2.4.9 - @vercel/remix-builder@5.6.0 - @vercel/ruby@2.3.2 - @vercel/rust@1.0.5 ## @vercel/fs-detectors@5.9.0 ### Minor Changes - [python] add support for module-based entrypoints for cron jobs ([#15393](#15393)) ### Patch Changes - [python] add support for Python worker services with Django tasks ([#15396](#15396)) ## @vercel/python@6.21.0 ### Minor Changes - [python] add support for module-based entrypoints for cron jobs ([#15393](#15393)) - Avoid doing entry point detection on every request to a python dev server ([#15365](#15365)) - For the django frontend, dynamically load settings.py instead of parsing it ([#15367](#15367)) ### Patch Changes - speed up python entrypoint detection ([#15402](#15402)) - Add Python builder cache preparation for Build Output API v3 cache globs, the builder virtualenv, and the repo-local uv cache. ([#15407](#15407)) - Updated dependencies \[[`83e804013528fc54de31082960ae31f58339bd71`](83e8040), [`921314f958c4ec85adb09e020310a5becb7f866c`](921314f)]: - @vercel/python-analysis@0.9.0 ## @vercel/python-analysis@0.9.0 ### Minor Changes - [python] add support for module-based entrypoints for cron jobs ([#15393](#15393)) - For the django frontend, dynamically load settings.py instead of parsing it ([#15367](#15367)) ## @vercel/backends@0.0.42 ### Patch Changes - Updated dependencies \[[`83e804013528fc54de31082960ae31f58339bd71`](83e8040), [`921314f958c4ec85adb09e020310a5becb7f866c`](921314f)]: - @vercel/build-utils@13.7.0 ## @vercel/cervel@0.0.29 ### Patch Changes - Updated dependencies \[]: - @vercel/backends@0.0.42 ## @vercel/client@17.2.54 ### Patch Changes - Updated dependencies \[[`83e804013528fc54de31082960ae31f58339bd71`](83e8040), [`921314f958c4ec85adb09e020310a5becb7f866c`](921314f)]: - @vercel/build-utils@13.7.0 ## @vercel/config@0.0.38 ### Patch Changes - Fix type generation ([#15386](#15386)) ## @vercel/detect-agent@1.1.1 ### Patch Changes - Add Antigravity agent detection via `ANTIGRAVITY_AGENT` environment variable ([#15413](#15413)) - Detect Codex when `CODEX_CI` or `CODEX_THREAD_ID` is present. ([#15412](#15412)) ## @vercel/elysia@0.1.45 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.6.12 ## @vercel/express@0.1.54 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.6.12 - @vercel/cervel@0.0.29 ## @vercel/fastify@0.1.48 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.6.12 ## @vercel/gatsby-plugin-vercel-builder@2.0.144 ### Patch Changes - Updated dependencies \[[`83e804013528fc54de31082960ae31f58339bd71`](83e8040), [`921314f958c4ec85adb09e020310a5becb7f866c`](921314f)]: - @vercel/build-utils@13.7.0 ## @vercel/h3@0.1.54 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.6.12 ## @vercel/hono@0.2.48 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.6.12 ## @vercel/koa@0.1.28 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.6.12 ## @vercel/nestjs@0.2.49 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.6.12 ## @vercel/next@4.15.42 ### Patch Changes - Revert "[next] vary fallback allowQuery for partial fallback shells" ([#15418](#15418)) ## @vercel/node@5.6.12 ### Patch Changes - Updated dependencies \[[`83e804013528fc54de31082960ae31f58339bd71`](83e8040), [`921314f958c4ec85adb09e020310a5becb7f866c`](921314f)]: - @vercel/build-utils@13.7.0 ## @vercel/static-build@2.8.46 ### Patch Changes - Updated dependencies \[]: - @vercel/gatsby-plugin-vercel-builder@2.0.144 ## @vercel/python-runtime@0.6.0 ### Minor Changes - [python] add support for Python worker services with Django tasks ([#15396](#15396)) - [python] add support for module-based entrypoints for cron jobs ([#15393](#15393))  > [!NOTE] > Low Risk Change > > This PR is an automated Changesets release that only updates version numbers in package.json files, CHANGELOG.md files, and deletes changeset markdown files — no functional code changes. > > - Version bumps across ~30 packages (patch/minor) > - Changelog and changeset file updates only > - Single constant update: VERCEL_RUNTIME_VERSION = '0.6.0' > > <sup>Risk assessment for [commit d3cf7ea](https://github.com/vercel/vercel/commit/d3cf7ea8deab73a058f4228f0346317fcf3e3dbc).</sup>  Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

[python] add support for module entrypoints for cron services

1b7d06e

nsidnev force-pushed the nsidnev/py-137-cron-workers-should-support-module-based-entrypoints branch from 74c70ea to 1b7d06e Compare March 5, 2026 17:57

vercel bot deployed to Preview March 5, 2026 17:58 View deployment

Merge branch 'main' into nsidnev/py-137-cron-workers-should-support-m…

ec2e1fc

…odule-based-entrypoints

vercel bot deployed to Preview March 5, 2026 19:34 View deployment

nsidnev marked this pull request as ready for review March 5, 2026 20:32

nsidnev requested review from a team and agadzik as code owners March 5, 2026 20:32

ricardo-agz approved these changes Mar 5, 2026

View reviewed changes

Merge branch 'main' into nsidnev/py-137-cron-workers-should-support-m…

57d20f7

…odule-based-entrypoints

nsidnev enabled auto-merge (squash) March 5, 2026 21:47

Merge branch 'main' into nsidnev/py-137-cron-workers-should-support-m…

87f4f0c

…odule-based-entrypoints

vercel bot deployed to Preview March 5, 2026 21:51 View deployment

nsidnev merged commit 83e8040 into main Mar 5, 2026
264 of 266 checks passed

nsidnev deleted the nsidnev/py-137-cron-workers-should-support-module-based-entrypoints branch March 5, 2026 22:33

vercel-release-bot mentioned this pull request Mar 5, 2026

Version Packages #15395

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[python] add support for module entrypoints for cron services#15393

[python] add support for module entrypoints for cron services#15393
nsidnev merged 4 commits intomainfrom
nsidnev/py-137-cron-workers-should-support-module-based-entrypoints

nsidnev commented Mar 5, 2026 •

edited by vercel bot

Loading

Uh oh!

changeset-bot bot commented Mar 5, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Mar 5, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Mar 5, 2026 •

edited

Loading

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

nsidnev commented Mar 5, 2026 • edited by vercel bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

changeset-bot bot commented Mar 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

github-actions bot commented Mar 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📦 CLI Tarball Ready

Quick Test

Use in vercel.json

Python Runtime Wheel

Python Workers Wheel

Uh oh!

github-actions bot commented Mar 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🧪 Unit Test Strategy

Results

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

nsidnev commented Mar 5, 2026 •

edited by vercel bot

Loading

changeset-bot bot commented Mar 5, 2026 •

edited

Loading

github-actions bot commented Mar 5, 2026 •

edited

Loading

github-actions bot commented Mar 5, 2026 •

edited

Loading