needservice

New in version 0.6.0.

needservice allows the import of data from external services like GitHub:

.. needservice:: <service>
   :option: ...

   Extra content for each new need

In most cases the service fetches requested data from an external server and creates a need object for each found data-element in the returned data.

These need objects can then be used and referenced as all other need objects, e.g. by filtering them via needtable.

Hint

For details about available services and their specific configuration please take a look into Services.

Options

needservice supports all options, which are also available for the need/ req (or any other defined need type) directive. This include also all custom options defined by needs_extra_options.

Beside this, each service can define own options, which may be needed for the service to work correctly. Please take a look into the related service documentation to find out what is needed. For services provided by Sphinx-Needs please take a look into Services.

.. needservice:: <service>
   :option: ...
   :status: open
   :tags: awesome, nice
   :author: me

   Extra content for each new need

Content

The content of needservice is used as content for all created need objects.

A service may deviate from this behavior and define its own usage. For example by awaiting a json-string with a more complex configuration or by just ignoring the content.

Please take a look into the related service documentation for more information.

Example

This example is using the github-issues service. For details please take a look into its specific documentation under GitHub services.

The service queries GitHub for issues in the Sphinx-Needs repository, which have node and latexpdf in their content.

.. needservice:: github-issues
   :query: repo:useblocks/sphinxcontrib-needs node latexpdf
   :max_content_lines: 4
   :id_prefix: EXAMPLE_

Click the small arrow under the need id to see all meta data.

Fails to build PDF when 'req' directive contains nested directives (url)
../_images/33452915.png
danieleades
user: danieleades
created_at: 2021-01-08T12:51:32Z
updated_at: 2021-10-20T04:46:28Z
closed_at: None
service: github-issues
url: Link
type: Issue
status: open
I'm finding that while I can build HTML output (`make html`)
the build fails with an extension error when using the PDF
target (`make latexpdf`)


[...]