03.06.21 20:10, Guido van Rossum пише: > This is not a complete thought yet, but it occurred to me that while we > have deprecated APIs (which will eventually go away), and provisional > APIs (which must mature a little before they're declared stable), and > stable APIs (which everyone can rely on), it might be good to also have > something like *unstable* APIs, which will continually change without > ever going away or stabilizing. Examples would be the ast module (since > the AST structure changes every time the grammar changes) and anything > to do with code objects and bytecode (since we sometimes think of better > ways to execute Python). > > So maybe the docs should grow a standard way of saying "this is an > unstable API"?
There is already a way to specify the stable ABI (see Doc/tools/extensions/c_annotations.py). But unfortunately this feature is not is not used in the documentation. It needs just an amount of work to do this, and nobody did this. After marking all stable ABI we can extend this feature to support halftones: provisional API, unstable API for Cython, etc. _______________________________________________ Python-Dev mailing list -- python-dev@python.org To unsubscribe send an email to python-dev-le...@python.org https://mail.python.org/mailman3/lists/python-dev.python.org/ Message archived at https://mail.python.org/archives/list/python-dev@python.org/message/KAOTXYRGZMTNB4TYJBQTQAEEG2PJZBDI/ Code of Conduct: http://python.org/psf/codeofconduct/