PEP 667: Mark as Final

[hugovk]

• Final implementation has been merged (including tests and docs)
• PEP matches the final implementation
• Any substantial changes since the accepted version approved by the SC/PEP delegate
• Pull request title in appropriate format (PEP 123: Mark Final)
• Status changed to Final (and Python-Version is correct)
• Canonical docs/spec linked with a canonical-doc directive
  (or canonical-pypa-spec for packaging PEPs,
  or canonical-typing-spec for typing PEPs)

Helps #3781.

@markshannon @gaogaotiantian:

• Is this PEP ready to be marked Final?

• Is https://docs.python.org/3.13/library/functions.html#locals the right place to link to as canonical documentation?

---

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

[ncoghlan]

#3845 is still open, along with the corresponding SC ticket at python/steering-council#245 so I don't believe it's quite there yet (specifically missing the second point in the checklist).

For the canonical docs, there are a few relevant canonical links:

• Python builtin API: https://docs.python.org/3.13/library/functions.html#locals
• Python frame API: https://docs.python.org/3.13/reference/datamodel.html#frame-objects
• C reflection API: https://docs.python.org/3.13/c-api/reflection.html
• C frame API: https://docs.python.org/3.13/c-api/frame.html

[hugovk]

Thanks, let's move this to draft until it's ready.

[ncoghlan]

#3845 has been approved and merged, so I think this is genuinely Final now.

[ncoghlan]

With the PEP status resolved, that just leaves the question of whether or not we should expand on the canonical docs reference (since the PEP affected multiple things that are documented in different places).

[JelleZijlstra]

While we're here:

Suggested change

	Resolution: https://discuss.python.org/t/pep-667-consistent-views-of-namespaces/46631/25
	Resolution: `25-Apr-2024 <https://discuss.python.org/t/pep-667-consistent-views-of-namespaces/46631/25>`__