Skip to main content

Sphinx extension to embed Robot Framework test cases and and user keywords into Sphinx documents

Project description

Introduction

This package provides a new Sphinx extension to embed Robot Framework test cases and and user keywords into Sphinx documents.

The extension is not a much past proof-of-concept yet. Rendering of generated documentation may still change in the future, but API should remain backwards compatible.

Usage

Add sphinxcontrib_robotdoc into the extensions list of your Sphinx configuration (conf.py):

extensions = [
    "sphinxcontrib_robotdoc",
]

Embed test cases and user keywords into your documentation with the following custom Docutils-directives:

.. robot_tests:: Test case title or RegExp.*
   :source: ../src/my_package/tests/acceptance/my_suite.txt
   :tags: bugs, new

.. robot_keywords:: Keyword title or RegExp.*
   :source: ../src/my_package/tests/acceptance/my_suite.txt

Both directives (robot_tests and robot_keywords) take a regular expression as their main option (or content in Docutils’ terms) to filter the embeded test cases or keywords found from the given source-file. If no regular expression is given, all found tests or keywords will be embedded (like having .* as the default).

Path given to the mandatory source-option must be a relative path from the current document. (There’s no support for package module paths yet.)

The test case directive (robot_tests) accepts also an option tags, which is optional. It should inclue a comma separated list of the tags to be used when filtering the tests to be embedded.

Please, note that he documentation found from the embedded test is parsed using Docutils, as a part of the target document. This differs from Robot Framework’s own documentation tools, which expect a custom markup.

Changelog

0.3.4 (2012-10-21)

  • Fixed to use correct title style for test case and keyword titles.

0.3.3 (2012-10-21)

  • Fixed a bug where an empty/missing tags option is not parsed correctly.

0.3.2 (2012-10-20)

  • Refactored to use Docutils’ nested_parse instead of publish_string (no more lxml and some support for inter-linking).

0.3.1 (2012-10-18)

  • Refactored to parse test/keyword documentation with docutils.core.publish_string (and append them as raw nodes) instead of trying to parse them into sphinx document tree.

0.3.0 (2012-10-18)

  • Added support for inline rst in test and keyword documentations.

  • Added support for tags.

  • Added alternative source option as an alias for suite option in tests.

  • Added alternative source and resource options as an alias for suite option in keywords.

  • Fixed to filter comment lines from steps.

0.2.0 (2012-10-14)

  • Fixed node adapters to return section instead of topics.

0.1.1 (2012-10-14)

  • Fixed parsing of resource-only files for keywords.

0.1.0 (2012-10-14)

  • Proof of concept.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sphinxcontrib-robotdoc-0.3.4.zip (9.1 kB view details)

Uploaded Source

File details

Details for the file sphinxcontrib-robotdoc-0.3.4.zip.

File metadata

File hashes

Hashes for sphinxcontrib-robotdoc-0.3.4.zip
Algorithm Hash digest
SHA256 8930959d318cb011d4133479277edcbf605a5f42724d86f4ea587fef8369092c
MD5 cf76e0a13a3b30aa7f063255fd141dcf
BLAKE2b-256 6183d5620dbf5bc8dd279d6ebf9bd1cd8f49ed13d1f4363332eab2330826202c

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page