Skip to content

Commit 99e9a5f

Browse files
authored
PEP 752: Add more examples (#3912)
1 parent 1f6cac1 commit 99e9a5f

File tree

1 file changed

+28
-6
lines changed

1 file changed

+28
-6
lines changed

peps/pep-0752.rst

+28-6
Original file line numberDiff line numberDiff line change
@@ -403,23 +403,45 @@ Footnotes
403403
404404
.. [2] Some examples of projects that have many packages with a common prefix:
405405
406-
- `MkDocs <https://github.com/mkdocs/mkdocs>`__ is a documentation framework
407-
based on Markdown files. They have the concept of
408-
`plugins <https://www.mkdocs.org/dev-guide/plugins/>`__ which may be
409-
developed by anyone and by convention are prefixed by ``mkdocs-``.
406+
- `Django <https://www.djangoproject.com>`__ is one of the most widely used
407+
frameworks in existence. They have the concept of `middleware`__ which
408+
allows for third-party packages to modify the request/response cycle.
409+
These packages are by convention prefixed by ``django-``.
410410
- `Project Jupyter <https://jupyter.org>`__ is devoted to the development of
411411
tooling for sharing interactive documents. They support `extensions`__
412-
which in most cases (and in all cases for officially maintained extensions)
413-
are prefixed by ``jupyter-``.
412+
which in most cases (and in all cases for officially maintained
413+
extensions) are prefixed by ``jupyter-``.
414+
- `pytest <https://docs.pytest.org>`__ is Python's most popular testing
415+
framework. They have the concept of `plugins`__ which may be developed by
416+
anyone and by convention are prefixed by ``pytest-``.
417+
- `MkDocs <https://www.mkdocs.org>`__ is a documentation framework based on
418+
Markdown files. They also have the concept of
419+
`plugins <https://www.mkdocs.org/dev-guide/plugins/>`__ which may be
420+
developed by anyone and are usually prefixed by ``mkdocs-``.
421+
- `Sphinx <https://www.sphinx-doc.org>`__ is a documentation framework
422+
popular for large technical projects such as
423+
`Swift <https://www.swift.org>`__ and Python itself. They have
424+
the concept of `extensions`__ which are prefixed by ``sphinxcontrib-``,
425+
many of which are maintained within a
426+
`dedicated organization <https://github.com/sphinx-contrib>`__.
414427
- `OpenTelemetry <https://opentelemetry.io>`__ is an open standard for
415428
observability with `official packages`__ for the core APIs and SDK with
416429
`third-party packages`__ to collect data from various sources. All
417430
packages are prefixed by ``opentelemetry-`` with child prefixes in the
418431
form ``opentelemetry-<component>-<name>-``.
432+
- `Apache Airflow <https://airflow.apache.org>`__ is a platform to
433+
programmatically orchestrate tasks as directed acyclic graphs (DAGs).
434+
They have the concept of `plugins`__, and also `providers`__ which are
435+
prefixed by ``apache-airflow-providers-``.
419436
437+
__ https://docs.djangoproject.com/en/5.1/topics/http/middleware/
420438
__ https://jupyterlab.readthedocs.io/en/stable/user/extensions.html
439+
__ https://docs.pytest.org/en/stable/how-to/writing_plugins.html
440+
__ https://www.sphinx-doc.org/en/master/usage/extensions/index.html
421441
__ https://github.com/open-telemetry/opentelemetry-python
422442
__ https://github.com/open-telemetry/opentelemetry-python-contrib
443+
__ https://airflow.apache.org/docs/apache-airflow/stable/authoring-and-scheduling/plugins.html
444+
__ https://airflow.apache.org/docs/apache-airflow-providers/index.html
423445

424446
.. _orgs: https://blog.pypi.org/posts/2023-04-23-introducing-pypi-organizations/
425447
.. _corp-orgs: https://docs.pypi.org/organization-accounts/pricing-and-payments/#corporate-organizations

0 commit comments

Comments
 (0)