{"id":13506222,"url":"https://github.com/breathe-doc/breathe","last_synced_at":"2026-02-21T11:32:15.363Z","repository":{"id":494315,"uuid":"120894","full_name":"breathe-doc/breathe","owner":"breathe-doc","description":"ReStructuredText and Sphinx bridge to Doxygen","archived":false,"fork":false,"pushed_at":"2026-01-01T08:13:42.000Z","size":3255,"stargazers_count":804,"open_issues_count":206,"forks_count":209,"subscribers_count":14,"default_branch":"main","last_synced_at":"2026-02-19T14:34:01.370Z","etag":null,"topics":["doxygen","sphinx"],"latest_commit_sha":null,"homepage":"https://breathe-doc.org","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/breathe-doc.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGELOG.rst","contributing":"CONTRIBUTING.rst","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"breathe-doc","patreon":null,"open_collective":"breathe","ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2009-02-03T18:52:25.000Z","updated_at":"2026-02-10T02:47:24.000Z","dependencies_parsed_at":"2023-12-07T18:51:21.178Z","dependency_job_id":"75c5a63e-0c20-4859-a8d5-b03f7154332d","html_url":"https://github.com/breathe-doc/breathe","commit_stats":{"total_commits":1431,"total_committers":118,"mean_commits":"12.127118644067796","dds":0.684136967155835,"last_synced_commit":"62695c7e3eaf1190f7bb02ba7b396daf78da66f4"},"previous_names":["michaeljones/breathe"],"tags_count":72,"template":false,"template_full_name":null,"purl":"pkg:github/breathe-doc/breathe","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/breathe-doc%2Fbreathe","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/breathe-doc%2Fbreathe/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/breathe-doc%2Fbreathe/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/breathe-doc%2Fbreathe/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/breathe-doc","download_url":"https://codeload.github.com/breathe-doc/breathe/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/breathe-doc%2Fbreathe/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29655175,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-20T09:27:29.698Z","status":"ssl_error","status_checked_at":"2026-02-20T09:26:12.373Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["doxygen","sphinx"],"created_at":"2024-08-01T01:00:38.926Z","updated_at":"2026-02-21T11:32:15.337Z","avatar_url":"https://github.com/breathe-doc.png","language":"Python","funding_links":["https://github.com/sponsors/breathe-doc","https://opencollective.com/breathe"],"categories":["Uncategorized","Python","Documentation"],"sub_categories":["Uncategorized"],"readme":".. 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 \u003chttps://opencollective.com/breathe\u003e`_.\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 \u003e= v4.28.0.\n- Breathe tarballs on GitHub are PGP signed for Breathe \u003e= v4.29.0.\n\nDownload\n--------\n\nBreathe is available from github and `PyPI, the Python Package Index\n\u003chttps://pypi.org/project/breathe/\u003e`_. It can be installed with::\n\n    pip install breathe\n\nDocumentation\n-------------\n\nThe documentation is available `here \u003chttps://breathe.readthedocs.io/\u003e`__. Thank\nyou to the people running `Read the Docs \u003chttps://readthedocs.org\u003e`_ 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 \u003chttps://groups.google.com/forum/#!forum/sphinx-breathe\u003e`__.\n\nThe previous mailing list was on `librelist.com \u003chttps://librelist.com\u003e`__ and the\narchives are available `here \u003chttps://librelist.com/browser/breathe/\u003e`__.\n\nPlease post new questions as GitHub issues.\n\nProjects Using Breathe\n----------------------\n\nExamples of projects that use Breathe:\n\n- `PyTorch \u003chttps://github.com/pytorch/pytorch\u003e`_\n- `OpenPilot \u003chttps://github.com/commaai/openpilot\u003e`_\n- `XGBoost \u003chttps://github.com/dmlc/xgboost\u003e`_\n- `NumPy \u003chttps://github.com/numpy/numpy\u003e`_\n- `Mozilla's DeepSpeech \u003chttps://github.com/mozilla/DeepSpeech\u003e`_\n- `Microsoft's LightGBM \u003chttps://github.com/microsoft/LightGBM\u003e`_\n- `PyBind11 \u003chttps://github.com/pybind/pybind11\u003e`_\n- `Ceph \u003chttps://github.com/ceph/ceph\u003e`_\n- `Apache Arrow \u003chttps://github.com/apache/arrow\u003e`_\n- `LVGL \u003chttps://github.com/lvgl/lvgl\u003e`_\n- `Espressif IoT Development Framework \u003chttps://github.com/espressif/esp-idf\u003e`_\n- `Zephyr Project \u003chttps://github.com/zephyrproject-rtos/zephyr\u003e`_\n- `Plaid ML \u003chttps://github.com/plaidml/plaidml\u003e`_\n- `Sony's Neural Network Libraries \u003chttps://github.com/sony/nnabla\u003e`_\n- `fmt \u003chttps://fmt.dev/latest/\u003e`_\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 \u003chttps://github.com/vermeeren\u003e`_ \u0026 `jakobandersen \u003chttps://github.com/jakobandersen\u003e`_\nand was formerly maintained by `michaeljones \u003chttps://github.com/michaeljones\u003e`_\n\u0026 `vitaut \u003chttps://github.com/vitaut\u003e`_.\n\nSee `CONTRIBUTORS \u003c/CONTRIBUTORS.rst\u003e`_ for the full list.\n\nAcknowledgements\n----------------\n\n- Dimitri van Heesch for `Doxygen \u003chttps://www.doxygen.nl/\u003e`_.\n- Georg Brandl for `Sphinx \u003chttps://www.sphinx-doc.org/\u003e`_.\n- David Goodger for `Docutils \u003chttps://docutils.sourceforge.io/\u003e`_ and reStructuredText.\n\nChangelog\n---------\n\nSee the `CHANGELOG.rst\n\u003chttps://github.com/breathe-doc/breathe/blob/master/CHANGELOG.rst\u003e`_\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbreathe-doc%2Fbreathe","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbreathe-doc%2Fbreathe","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbreathe-doc%2Fbreathe/lists"}