Skip to content

PEP 812: Imaginary type and IEC 60559-compatible complex arithmetic - #4681

Open
skirpichev wants to merge 41 commits into
python:mainfrom
skirpichev:imaginary
Open

PEP 812: Imaginary type and IEC 60559-compatible complex arithmetic#4681
skirpichev wants to merge 41 commits into
python:mainfrom
skirpichev:imaginary

Conversation

@skirpichev

@skirpichev skirpichev commented Oct 31, 2025

Copy link
Copy Markdown
Member

Basic requirements (all PEP Types)

  • Read and followed PEP 1 & PEP 12
  • File created from the latest PEP template
  • PEP has next available number, & set in filename (pep-NNNN.rst), PR title (PEP 123: <Title of PEP>) and PEP header
  • Title clearly, accurately and concisely describes the content in 79 characters or less
  • Core dev/PEP editor listed as Author or Sponsor, and formally confirmed their approval
  • Author, Status (Draft), Type and Created headers filled out correctly
  • PEP-Delegate, Topic, Requires and Replaces headers completed if appropriate
  • Required sections included
    • Abstract (first section)
    • Copyright (last section; exact wording from template required)
  • Code is well-formatted (PEP 7/PEP 8) and is in code blocks, with the right lexer names if non-Python
  • PEP builds with no warnings, pre-commit checks pass and content displays as intended in the rendered HTML
  • Authors/sponsor added to .github/CODEOWNERS for the PEP

Standards Track requirements

  • PEP topic discussed in a suitable venue with general agreement that a PEP is appropriate
  • Suggested sections included (unless not applicable)
    • Motivation
    • Rationale
    • Specification
    • Backwards Compatibility
    • Security Implications
    • How to Teach This
    • Reference Implementation
    • Rejected Ideas
    • Open Issues
  • Python-Version set to valid (pre-beta) future Python version, if relevant
  • Any project stated in the PEP as supporting/endorsing/benefiting from the PEP formally confirmed such
  • Right before or after initial merging, PEP discussion thread created and linked to in Discussions-To and Post-History

📚 Documentation preview 📚: https://pep-previews--4681.org.readthedocs.build/

https://pep-previews--4681.org.readthedocs.build/pep-0812/

@hugovk hugovk changed the title PEP 812: Imaginary type and IEC 60559-compatible complex arithmetic PEP 9999: Imaginary type and IEC 60559-compatible complex arithmetic Oct 31, 2025
@skirpichev

skirpichev commented Oct 31, 2025

Copy link
Copy Markdown
Member Author

Based on feedback from the latest discussion thread, I hope @serhiy-storchaka might sponsor this.

CC @serhiy-storchaka
CC @mdickinson

(Alternative formatting with mathjax)

N.B. I did local builds with the default sphinx config and it seems, that "math" directives are rendered odd with the "maths_to_html". In particular, equation numbering is lost (though, references to equations are kept). Any way to fixing this without replacing "math" with something else? CC @AA-Turner
Locally I've something like this:
Screenshot from 2025-10-31 09-18-03

@skirpichev skirpichev added the new-pep A new draft PEP submitted for initial review label Oct 31, 2025
@hugovk

hugovk commented Oct 31, 2025

Copy link
Copy Markdown
Member

Please review PEP 1.

The general order of things:

  1. Open a discussion to see if there is consensus for this idea. This is also to save you time in case the idea is rejected.
  2. During the discussion, find a sponsor.
  3. Work with your sponsor, and when they think the PEP is ready for submission, then open the PR.
  4. A PEP number is assigned by a PEP editor after the sponsor has confirmed their sponsorship.

Therefore please don't write and submit a PEP with just a hope someone will sponsor. This should be arranged beforehand.

@skirpichev

This comment was marked as outdated.

@skirpichev skirpichev closed this Oct 31, 2025
@skirpichev
skirpichev deleted the imaginary branch October 31, 2025 06:51
@skirpichev
skirpichev restored the imaginary branch October 31, 2025 06:58
@skirpichev skirpichev reopened this Oct 31, 2025
@skirpichev

This comment was marked as resolved.

@skirpichev

This comment was marked as resolved.

@skirpichev
skirpichev marked this pull request as ready for review November 1, 2025 03:00
@skirpichev
skirpichev requested a review from a team as a code owner November 1, 2025 03:00
@hugovk

hugovk commented Nov 1, 2025

Copy link
Copy Markdown
Member

@hugovk, may I reserve some number and set CODEOWNERS?

Yes, you may use 812. Thanks!

@hugovk hugovk changed the title PEP 9999: Imaginary type and IEC 60559-compatible complex arithmetic PEP 812: Imaginary type and IEC 60559-compatible complex arithmetic Nov 1, 2025
Comment thread peps/pep-0812.rst Outdated
Comment thread peps/pep-0812.rst Outdated
Comment thread peps/pep-0812.rst Outdated
Comment thread peps/pep-0812.rst Outdated
Comment thread peps/pep-0812.rst Outdated
Comment thread peps/pep-0812.rst Outdated
Comment thread peps/pep-0812.rst Outdated
Comment thread peps/pep-0812.rst Outdated
Comment thread peps/pep-0812.rst Outdated
Comment thread peps/pep-0812.rst Outdated

@hugovk hugovk left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Mostly grammar nits.

@skirpichev

Copy link
Copy Markdown
Member Author

@serhiy-storchaka, have you changed your mind on support of this PEP?

If not, what's left here to do?

@skirpichev

Copy link
Copy Markdown
Member Author

OK, I'm closing this. I guess, @serhiy-storchaka not willing to support this proposal anymore.

@hugovk, thanks for review.

@skirpichev skirpichev closed this Mar 1, 2026
@skirpichev
skirpichev deleted the imaginary branch March 1, 2026 02:31
@skirpichev
skirpichev restored the imaginary branch March 2, 2026 00:37
@skirpichev skirpichev reopened this Aug 30, 2026
@read-the-docs-community

Copy link
Copy Markdown

Documentation build overview

📚 pep-previews | 🛠️ Build #34297266 | 📁 Comparing d0ccd48 against latest (fa5792c)

  🔍 Preview build  

4 files changed
+ pep-0812/index.html
± index.html
± numerical/index.html
± pep-0000/index.html

@skirpichev

Copy link
Copy Markdown
Member Author

I'm reopened this, as sponsorship wasn't revoked.

Lets wait for Serhiy replay. If he changed his mind on supporting this, we could recycle 812 to the free pool of PEP numbers.

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

Labels

new-pep A new draft PEP submitted for initial review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants