Libdoc2TestBench

Robot Framework Libdoc Extension that generates imbus TestBench Enterprise Library import formats.

Installation:

To install this package you can use pip:

pip install robotframework-libdoc2testbench

Notice: This extension requires Robot Framework 4.0.0 or later and does not work with earlier versions.

Usage:

The basic usage just needs the Libdoc2TestBench command and a Robot Framework Library as input and saves a zip-file named project-dump.zip in the current working directory containing the needed information for the import.

Libdoc2TestBench <LIBRARY or RESOURCE>

By using a second positional argument you can additionally specify the output filename:

Libdoc2TestBench <LIBRARY or RESOURCE> <output.zip>

There are several optional arguments, that follow the structure of the robot.libdoc module. When generating imports from a RF library, these values should already be set up correctly. You may overwrite the docformat and other meta data by setting the associated arguments written below.

Import in imbus TestBench

First create a zip-file from a Robot Framework library via the Libdoc2TestBench command. Afterwards the generated zip-file can be imported via the Import Project... command in the Project Management view of the imbus TestBench:

In the Test Elements view you can now see your imported RF library as different interactions and datatypes:

Change log

• 1.0rc2
  • ADDED optional arguments for:
    • xml-file output (instead of zip-file)
    • custom temporary directory
    • changing the repository id in the xml-header
    • custom primary key enumeration start
    • info command for printing Libdoc2TestBench/Robot Framework/Python version to console
    • support for resource-files (attachment support coming soon)
  • FIX:
    • only create _Datatype subdivison in libraries when data types are present
    • Resource subdivison is now in the correct parent subdivision
    • Updated README.md / package help-messages to reflect changes
• 1.0rc1
  • first release candidate

License

Distributed under the Apache-2.0 license. See LICENSE for more information.

Dependencies

• python >= 3.7
• robotframework >= 4.0.0

Contributing

For consistent code formatting, please use Black - The Uncompromising Code Formatter with the following arguments in the root directory:

black -l 100 -S .