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

114 lines
2.6 KiB
Markdown

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
```
Install test dependencies
-------------------------
```
$ zypper install python3-behave diffstat diffutils obs-service-replace_using_env python3 python3-cryptography python3-pip python3-rpm python3-setuptools python3-urllib3 build obs-service-set_version
```
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``