From 99e9a5f4b22bd69792c442bacc326477296d2ca3 Mon Sep 17 00:00:00 2001 From: Ofek Lev Date: Mon, 19 Aug 2024 20:58:32 -0400 Subject: [PATCH] PEP 752: Add more examples (#3912) --- peps/pep-0752.rst | 34 ++++++++++++++++++++++++++++------ 1 file changed, 28 insertions(+), 6 deletions(-) diff --git a/peps/pep-0752.rst b/peps/pep-0752.rst index 30528fde1..f2d2cfaa5 100644 --- a/peps/pep-0752.rst +++ b/peps/pep-0752.rst @@ -403,23 +403,45 @@ Footnotes .. [2] Some examples of projects that have many packages with a common prefix: - - `MkDocs `__ is a documentation framework - based on Markdown files. They have the concept of - `plugins `__ which may be - developed by anyone and by convention are prefixed by ``mkdocs-``. + - `Django `__ is one of the most widely used + frameworks in existence. They have the concept of `middleware`__ which + allows for third-party packages to modify the request/response cycle. + These packages are by convention prefixed by ``django-``. - `Project Jupyter `__ is devoted to the development of tooling for sharing interactive documents. They support `extensions`__ - which in most cases (and in all cases for officially maintained extensions) - are prefixed by ``jupyter-``. + which in most cases (and in all cases for officially maintained + extensions) are prefixed by ``jupyter-``. + - `pytest `__ is Python's most popular testing + framework. They have the concept of `plugins`__ which may be developed by + anyone and by convention are prefixed by ``pytest-``. + - `MkDocs `__ is a documentation framework based on + Markdown files. They also have the concept of + `plugins `__ which may be + developed by anyone and are usually prefixed by ``mkdocs-``. + - `Sphinx `__ is a documentation framework + popular for large technical projects such as + `Swift `__ and Python itself. They have + the concept of `extensions`__ which are prefixed by ``sphinxcontrib-``, + many of which are maintained within a + `dedicated organization `__. - `OpenTelemetry `__ is an open standard for observability with `official packages`__ for the core APIs and SDK with `third-party packages`__ to collect data from various sources. All packages are prefixed by ``opentelemetry-`` with child prefixes in the form ``opentelemetry---``. + - `Apache Airflow `__ is a platform to + programmatically orchestrate tasks as directed acyclic graphs (DAGs). + They have the concept of `plugins`__, and also `providers`__ which are + prefixed by ``apache-airflow-providers-``. +__ https://docs.djangoproject.com/en/5.1/topics/http/middleware/ __ https://jupyterlab.readthedocs.io/en/stable/user/extensions.html +__ https://docs.pytest.org/en/stable/how-to/writing_plugins.html +__ https://www.sphinx-doc.org/en/master/usage/extensions/index.html __ https://github.com/open-telemetry/opentelemetry-python __ https://github.com/open-telemetry/opentelemetry-python-contrib +__ https://airflow.apache.org/docs/apache-airflow/stable/authoring-and-scheduling/plugins.html +__ https://airflow.apache.org/docs/apache-airflow-providers/index.html .. _orgs: https://blog.pypi.org/posts/2023-04-23-introducing-pypi-organizations/ .. _corp-orgs: https://docs.pypi.org/organization-accounts/pricing-and-payments/#corporate-organizations