classification
Title: Update extending/embedding docs to new way to build modules in C
Type: enhancement Stage: patch review
Components: Documentation Versions: Python 3.8, Python 3.7, Python 3.6
process
Status: open Resolution:
Dependencies: Superseder:
Assigned To: docs@python Nosy List: berker.peksag, brett.cannon, docs@python, eric.snow, ncoghlan, petr.viktorin
Priority: normal Keywords: patch

Created on 2016-03-09 02:43 by brett.cannon, last changed 2019-05-16 20:05 by petr.viktorin.

Pull Requests
URL Status Linked Edit
PR 8682 open berker.peksag, 2018-08-06 02:57
Messages (2)
msg261398 - (view) Author: Brett Cannon (brett.cannon) * (Python committer) Date: 2016-03-09 02:43
https://docs.python.org/3/extending/extending.html#a-simple-example uses PyModule_Create() instead of PyModuleDef_Init().
msg342668 - (view) Author: Petr Viktorin (petr.viktorin) * (Python committer) Date: 2019-05-16 20:05
Correct usage of multi-phase init might now get users stuck when they start needing per-module state. See PEP 573 "Module State Access from C Extension Methods" for the (hopefully) last thing that prevents me from generally recommending multi-phase init.

That PEP is on my list for after PRP 590 is done.
Before it's implemented, I'm happy leaving PyModuleDef_Init to experts -- that is, have it in the reference docs only.
History
Date User Action Args
2019-05-16 20:05:17petr.viktorinsetmessages: + msg342668
2019-05-15 02:32:57vstinnersetnosy: + petr.viktorin
2018-08-06 03:05:47berker.peksagsetnosy: + berker.peksag

type: enhancement
versions: + Python 3.7, Python 3.8, - Python 3.5
2018-08-06 02:57:34berker.peksagsetkeywords: + patch
stage: needs patch -> patch review
pull_requests: + pull_request8177
2016-03-09 02:43:41brett.cannoncreate