needlist

Added in version 0.2.0.

needlist creates a list of elements based on the result of given filters.

Example 1

.. needlist::
   :tags: main_example

No needs passed the filters

Options

Note

needlist supports the full filtering possibilities of Sphinx-Needs. Please see Filtering needs for more information.

show_status

Flag for adding status information to the needs list results filtered.

If a filtered need has no status information, we write no status output for the need.

Example 2

.. needlist::
   :show_status:
   :status: done; implemented

show_tags

Flag for adding tag information to the needs list results filtered.

If a filtered need has no tag information, we write no tag output for the need.

Example 3

.. needlist::
   :show_tags:
   :status: done; implemented

show_filters

If set, we add the used filter below the needlist results:

Example 4

.. needlist::
   :show_filters:
   :status: done; implemented

Used filter: status(done OR implemented)

common filters