{"author":null,"author_email":"Michael Jones ","bugtrack_url":null,"classifiers":["Development Status :: 5 - Production/Stable","Environment :: Console","Environment :: Web Environment","Framework :: Sphinx","Framework :: Sphinx :: Extension","Intended Audience :: Developers","Intended Audience :: Education","License :: OSI Approved :: BSD License","Operating System :: OS Independent","Programming Language :: Python","Programming Language :: Python :: 3","Programming Language :: Python :: 3 :: Only","Programming Language :: Python :: 3.10","Programming Language :: Python :: 3.11","Programming Language :: Python :: 3.12","Programming Language :: Python :: 3.13","Programming Language :: Python :: 3.9","Topic :: Documentation","Topic :: Documentation :: Sphinx","Topic :: Software Development","Topic :: Software Development :: Documentation","Topic :: Text Processing","Topic :: Utilities"],"description":".. image:: https://www.breathe-doc.org/img/logo.svg\n :align: center\n :alt: Breathe logo\n :width: 200\n :height: 200\n :target: https://www.breathe-doc.org\n\nBreathe\n=======\n\n**Your technical docs, beautifully integrated**\n\n.. image:: https://github.com/breathe-doc/breathe/actions/workflows/unit_tests.yml/badge.svg\n :target: https://github.com/breathe-doc/breathe/actions/workflows/unit_tests.yml\n :alt: Build Status\n\nWebsite_ • Documentation_ • Sponsor_\n\n**Sponsor**: If you benefit from using Breathe as a company or an individual, you\ncan financially support the Breathe project with recurring or one off\ncontributions via `Open Collective `_.\n\n.. _Website: https://www.breathe-doc.org/\n.. _Documentation: https://breathe.readthedocs.io/en/latest/\n.. _Sponsor: https://opencollective.com/breathe\n\n----\n\nBreathe is a Sphinx plugin providing beautifully integrated Doxygen output in\nyour user-facing documentation. It allows you to combine Doxygen's excellent\ntechnical understanding of your code base with the superb long form\ndocumentation output of the Sphinx system.\n\nFor Packagers\n-------------\n\n- Breathe packages on PyPI are PGP signed for Breathe >= v4.28.0.\n- Breathe tarballs on GitHub are PGP signed for Breathe >= v4.29.0.\n\nDownload\n--------\n\nBreathe is available from github and `PyPI, the Python Package Index\n`_. It can be installed with::\n\n pip install breathe\n\nDocumentation\n-------------\n\nThe documentation is available `here `__. Thank\nyou to the people running `Read the Docs `_ for such an\nexcellent service.\n\nThe source for the documentation is in the ``documentation`` folder if you want\nto built it and read it locally.\n\nTesting\n-------\n\nThe testsuite can be run with::\n\n make dev-test\n\nThe documentation also does a good effort of covering the available\nfunctionality with different examples. To build the documentation, run::\n\n make\n\nThis will run doxygen over the example code and then run the Breathe\ndocumentation. View the results at::\n\n documentation/build/html/index.html\n\nFurther to this if you want to compare the current documentation output against\na previous state in order to check for regressions there is a ``compare`` script\nin the ``documentation`` folder. It takes two arguments which are two commit\nreferences that you'd like to compare. This means that all your changes have to\nbe committed first. Also the script does not resolve state dependent references\nlike ``HEAD`` so provide concrete commit references like sha1s or branch names.\nA typical example is to compare your current branch output to master::\n\n # Make sure all your changes are committed first\n cd documentation\n ./compare master my-branch\n\nThis will do a checkout and build at each commit and then run ``meld`` against\nthe resulting directories so you can see the differences introduced by your\nbranch.\n\nRequirements\n------------\n\nBreathe requires Python 3.9+, Sphinx 7.2+, and Doxygen 1.9.2+.\n\nMailing List Archives\n---------------------\n\nThe archive for the Google groups list can be found\n`here `__.\n\nThe previous mailing list was on `librelist.com `__ and the\narchives are available `here `__.\n\nPlease post new questions as GitHub issues.\n\nProjects Using Breathe\n----------------------\n\nExamples of projects that use Breathe:\n\n- `PyTorch `_\n- `OpenPilot `_\n- `XGBoost `_\n- `NumPy `_\n- `Mozilla's DeepSpeech `_\n- `Microsoft's LightGBM `_\n- `PyBind11 `_\n- `Ceph `_\n- `Apache Arrow `_\n- `LVGL `_\n- `Espressif IoT Development Framework `_\n- `Zephyr Project `_\n- `Plaid ML `_\n- `Sony's Neural Network Libraries `_\n- `fmt `_\n\nRelease\n-------\n\n1. Update `CHANGELOG.rst` and create the git tag (`vX.Y.Z`).\n2. Push the tag to GitHub.\n3. The `create-release.yml` workflow will publish the release to PyPI.\n4. Go to https://github.com/breathe-doc/breathe/tags, select the new tag,\n and click the \"Create release from tag\" button to publish a GitHub release.\n\nMaintainers\n-----------\n\nBreathe is currently maintained by `vermeeren `_ & `jakobandersen `_\nand was formerly maintained by `michaeljones `_\n& `vitaut `_.\n\nSee `CONTRIBUTORS `_ for the full list.\n\nAcknowledgements\n----------------\n\n- Dimitri van Heesch for `Doxygen `_.\n- Georg Brandl for `Sphinx `_.\n- David Goodger for `Docutils `_ and reStructuredText.\n\nChangelog\n---------\n\nSee the `CHANGELOG.rst\n`_\n\n","description_content_type":"text/x-rst","docs_url":null,"download_url":null,"downloads":{"last_day":-1,"last_month":-1,"last_week":-1},"dynamic":null,"home_page":null,"keywords":null,"license":null,"license_expression":null,"license_files":["LICENSE"],"maintainer":null,"maintainer_email":null,"name":"breathe","package_url":"https://pypi.org/project/breathe/","platform":null,"project_url":"https://pypi.org/project/breathe/","project_urls":{"Changelog":"https://github.com/breathe-doc/breathe/blob/main/CHANGELOG.rst","Code":"https://github.com/breathe-doc/breathe/","Documentation":"https://breathe.readthedocs.io/","Download":"https://pypi.org/project/breathe/","Homepage":"https://www.breathe-doc.org/","Issue tracker":"https://github.com/breathe-doc/breathe/issues"},"provides_extra":["docs","lint","test"],"release_url":"https://pypi.org/project/breathe/4.36.0/","requires_dist":["Sphinx>=7.2","furo; extra == \"docs\"","sphinx-copybutton; extra == \"docs\"","sphinxcontrib-spelling; extra == \"docs\"","ruff==0.9.2; extra == \"lint\"","mypy>=1; extra == \"lint\"","types-docutils; extra == \"lint\"","types-Pygments; extra == \"lint\"","pytest>=8.0; extra == \"lint\"","sphinxcontrib-phpdomain; extra == \"lint\"","sphinx-csharp; extra == \"lint\"","pytest>=8.0; extra == \"test\""],"requires_python":">=3.9","summary":"Sphinx Doxygen renderer","version":"4.36.0","yanked":false,"yanked_reason":null}

Dependency	Optional
Sphinx	false
furo	true
mypy	true
pytest	true
ruff	true
sphinx-copybutton	true
sphinx-csharp	true
sphinxcontrib-phpdomain	true
sphinxcontrib-spelling	true
types-docutils	true
types-Pygments	true

Package search

breathe

project_urls

Dependencies

All package metadata

Releases