GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — Recommend Never for return types as well by srittau · Pull Request #2322 · python/typing

Conversation

@srittau

@srittau srittau commented Jul 22, 2026

Copy link
Copy Markdown
Collaborator

Per discussion in python/cpython#132941

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.

All reactions
@srittau
Recommend Never for return types as well
4ab2ee9
Per discussion in python/cpython#132941
@srittau srittau mentioned this pull request Jul 22, 2026
typing docs: Use soft deprecation python/cpython#132941
Open
JelleZijlstra
JelleZijlstra approved these changes Jul 22, 2026
View reviewed changes
davidhalter
davidhalter approved these changes Jul 22, 2026
View reviewed changes
@srittau
srittau merged commit 39164cd into python:main Jul 22, 2026
5 checks passed

Uh oh!

There was an error while loading. Please reload this page.

@srittau
srittau deleted the no-return branch July 22, 2026 14:30
@ngnpope

ngnpope commented Aug 3, 2026

Copy link
Copy Markdown
Contributor

This change updated this section, but there are other places that should probably also be reworded:

https://typing.python.org/en/latest/spec/special-types.html#never has the following:

The Never type is equivalent to NoReturn, which is discussed above. The NoReturn type is conventionally used in return annotations of functions, and Never is typically used in other locations, but the two types are completely interchangeable.

https://typing.python.org/en/latest/spec/special-types.html#noreturn should probably also say that Never is preferred.

https://typing.python.org/en/latest/spec/constructors.html has some references to NoReturn that could be changed to Never?

On the https://typing.python.org/en/latest/spec/special-types.html page, perhaps Never should come above NoReturn and the examples for NoReturn should be moved to Never, with NoReturn being a simple statement saying that Never is preferred?

All reactions

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@davidhalter davidhalter davidhalter approved these changes
@JelleZijlstra JelleZijlstra JelleZijlstra approved these changes

Uh oh!

There was an error while loading. Please reload this page.

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Uh oh!

There was an error while loading. Please reload this page.

4 participants

@srittau @ngnpope @davidhalter @JelleZijlstra
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.