1
0
mirror of https://github.com/openSUSE/osc.git synced 2024-09-20 09:16:16 +02:00
github.com_openSUSE_osc/behave/README.md

2.3 KiB

Install requirements

On openSUSE:

$ zypper install osc podman python3-behave

On Fedora:

$ dnf install osc podman python3-behave

Build a container with OBS

$ cd behave

# optional: refresh the base image
$ podman pull opensuse/leap:15.5

# build the container image
$ ./container-build.sh [--no-cache]

Use a prebuilt container with OBS

$ cd behave
$ ./container-pull.sh

Use the container

$ cd behave

# run 'obs-server' container on port 1443
# running this command again replaces the current container with a fresh one
$ ./container-run.sh

# shell into the started container
$ ./container-shell.sh

Cleanup

# stop the started container
$ podman stop|kill obs-server

# remove container image
$ podman rmi obs-server

Run tests

Run all tests

$ cd behave
$ behave -Dosc=../osc-wrapper.py

Run selected tests

$ cd behave
$ behave -Dosc=../osc-wrapper.py features/<file>.feature

Run tests being worked on (decorated with @wip)

$ cd behave
behave -Dosc=../osc-wrapper.py --wip -k

Run osc commands

osc -A https://localhost:1443 ...

Filesystem layout

<project topdir>
+- behave
     +- features
        +- *.feature       # tests (that use steps defined in the `steps` directory)
                           #   * https://behave.readthedocs.io/en/stable/tutorial.html#feature-files
        +- environment.py  # code that runs before/after certain events (steps, features, etc.)
                           #   * https://behave.readthedocs.io/en/stable/tutorial.html#environmental-controls
                           #   * frequently used to modify ``context``
        +- steps           # step definitions, support code
                           #   * https://behave.readthedocs.io/en/stable/tutorial.html#python-step-implementations
     +- fixtures           # test data
     +- *                  # additional support files

Good to know

  • context provides state information to the tests; you can think of it as passing self to python methods.
  • context.config.userdata contains values of defines specified on the command-line: -D NAME=VALUE -> context.config.userdata[NAME] = VALUE