michaelh/zephyr
1
0
Fork 0
Code Releases Activity
zephyr/doc/requirements.txt

24 lines
383 B
Text
Raw Normal View History

scripts/requirements: Split & document requirement.txt Split up requirements.txt into several files so that CI tools can utilize/reference the specific requirements-<FOO>.txt they may need while keep things in sync with the development. This is to reduce both time and amount of work CI actions due to python package install. Create the following groupings: 1. BASE - needed to build or create zephyr images 2. BUILD-TEST - need to run compile/build tests 3. DOC - need to build the docs 4. RUN-TEST - need for runtime testing 5. EXTRAS - optional or useful for development/developers workflow Also tried to add a comment about what or why a given package is being pulled in for. Signed-off-by: Kumar Gala <kumar.gala@linaro.org>
2020-02-07 14:58:00 -06:00
# DOC: used to generate docs
Revert "doc: Update requirements-doc.txt to use docleaf" This reverts commit 30c3ce4a92c7ebcd7885ac5a01ddcfc0334fbad4. Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2023-08-09 17:52:00 +02:00
breathe>=4.34
doc: Relax Sphinx pip dependency As Zephyr now supports Python 3.10 and onwards, we can use more recent versions of Sphinx, i.e 7.3.x at the time of this commit. Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2024-04-30 12:13:25 +02:00
sphinx
doc: Bump to Sphinx 7.1 and RTD theme 2.0 This moves to more recent versions of Sphinx and Read the Docs theme. FWIW Sphinx 7.2.0 dropped support for Python 3.8 so we're stuck with 7.1 for now. Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2023-11-02 10:47:56 +01:00
sphinx_rtd_theme~=2.0
scripts/requirements: Split & document requirement.txt Split up requirements.txt into several files so that CI tools can utilize/reference the specific requirements-<FOO>.txt they may need while keep things in sync with the development. This is to reduce both time and amount of work CI actions due to python package install. Create the following groupings: 1. BASE - needed to build or create zephyr images 2. BUILD-TEST - need to run compile/build tests 3. DOC - need to build the docs 4. RUN-TEST - need for runtime testing 5. EXTRAS - optional or useful for development/developers workflow Also tried to add a comment about what or why a given package is being pulled in for. Signed-off-by: Kumar Gala <kumar.gala@linaro.org>
2020-02-07 14:58:00 -06:00
sphinx-tabs
sphinxcontrib-svg2pdfconverter
doc: update requirements breathe: for simplicity, require versions > 4.30 (lower versions have known issues, so do not take risks). Sphinx: start requiring versions >=4.x. Keep with compatible versions, since Sphinx major updrages can easily break extensions, themes, etc. sphinx_rtd_theme: upgrade to >=1.x. Again, keep with compatible versions since we have style customizations that can likely break on major upgrades. pygments: Allow any version >=2.9 (version that introduced DT support). We do not have strong compatibility requirements here. sphinx-notfound-page: Remove any requirements, we do not have strong requirements for this one. Signed-off-by: Gerard Marull-Paretas <gerard.marull@nordicsemi.no>
2022-01-03 10:46:36 +01:00
pygments>=2.9
sphinx-notfound-page
doc: enable sphinx-copybutton extension The sphinx-copybutton extension adds a button to every code snippet that, when clicked, copies the code to the clipboard. Signed-off-by: Gerard Marull-Paretas <gerard.marull@nordicsemi.no>
2022-03-25 13:29:37 +01:00
sphinx-copybutton
doc: Make code-samples admonition collapsible Use sphinx-toggle to make "Related code samples" collapsible. Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2023-08-30 09:26:48 +02:00
sphinx-togglebutton
doc: generate sitemap.xml Generate a sitemap.xml for the documentation. This aims at helping search engines react faster to the addition/removal of new pages. Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2024-02-26 11:59:57 +01:00
sphinx-sitemap
requirements-doc: add missing pkwalify doc/CMakeLists.txt uses zephyr_module Signed-off-by: Marc Herbert <marc.herbert@intel.com>
2021-01-08 13:43:25 -08:00
requirements-doc: add PyYAML which removes dependency on -base This means a light requirements-doc.txt is enough for doc writers. See previous discussions in PR #31199 and PR #31239 Signed-off-by: Marc Herbert <marc.herbert@intel.com>
2021-01-08 13:43:25 -08:00
# YAML validation. Used by zephyr_module.
scripts: dts: update pyyaml version The currently used PyYaml version has some vulnerabilies as described on the pull request description. It updates to version 6.0, removing these supply chain vulnerabily. The OSSF Scorecard was the tool used for discovering these vulnerabilties. Signed-off-by: Javan lacerda <javanlacerda@google.com>
2024-03-27 14:01:44 +00:00
PyYAML>=6.0
requirements-doc: add missing pkwalify doc/CMakeLists.txt uses zephyr_module Signed-off-by: Marc Herbert <marc.herbert@intel.com>
2021-01-08 13:43:25 -08:00
pykwalify
doc: test: improve pytest documentation Improve documentation about pytest integration with Twister. Add examples of usage, improve description of available options and introduce automatic doc generation of two plugin classes (DeviceAdapter and Shell) basing on their docstrings from source code. Signed-off-by: Piotr Golyzniak <piotr.golyzniak@nordicsemi.no>
2023-11-22 19:57:10 +01:00
doc: requirements: Add pyserial Since 7eaca455faf6ff8d9a92c4392da281dab08d0c2b, pyserial is required for building docs because `DeviceAdapter` from the `pytest-twister-harness` plugin, which is imported by autodoc, now depends on it. Signed-off-by: Stephanos Ioannidis <root@stephanos.io>
2024-05-23 22:08:03 +09:00
# Used by pytest-twister-harness plugin (imported by autodoc)
doc: test: improve pytest documentation Improve documentation about pytest integration with Twister. Add examples of usage, improve description of available options and introduce automatic doc generation of two plugin classes (DeviceAdapter and Shell) basing on their docstrings from source code. Signed-off-by: Piotr Golyzniak <piotr.golyzniak@nordicsemi.no>
2023-11-22 19:57:10 +01:00
pytest
doc: requirements: Add pyserial Since 7eaca455faf6ff8d9a92c4392da281dab08d0c2b, pyserial is required for building docs because `DeviceAdapter` from the `pytest-twister-harness` plugin, which is imported by autodoc, now depends on it. Signed-off-by: Stephanos Ioannidis <root@stephanos.io>
2024-05-23 22:08:03 +09:00
pyserial
doc: Include doxmlparser on requirements.txt It will be necessary to parse the doxygen XML files to extract `since` and `version` from them. Signed-off-by: Ederson de Souza <ederson.desouza@intel.com>
2023-10-31 16:25:14 -07:00
# Doxygen doxmlparser
doxmlparser
Copy permalink