semvec/pypi-packages huggingface dataset:
robotframework-expects 0.4.0
Train and use expectation detector in Robot Framework tests.
License: Apache License, Version 2.0
Keywords: testing

*************************
Robot Framework - Expects
*************************

*NOTE: This is currently an alpha version! Use with CURIOSITY and caution :D*

Library to train computers to validate expected results based on examples. Validate something big and volatile with ease. Make your testing smarter with applying machine learning.

This library exposes only one robot framework keyword: ``Should be as expected  ${VALUE}``.
It checks expectations of what a ``${VALUE}`` should be against generated expectations json file.
Expectation file is in human readable format and can be edited manually. System will generate expectations automatically.

How to use this:
================

1. Install from PyPI ``pip install robotframework-expects``
2. Add library to RF test suite in training mode ``Library  Expects  TRAINING``
3. Catch a value  ``${VALUE}= ..`` from your SUT in your test
4. Add expect block to the test ``Should be as expected  ${VALUE}``
5. Run your test ``robot yoursuite.robot`` -> generates a file ``yoursuite_expects.json``
6. Change library to normal mode ``Library  Expects`` (remove ``TRAINING``)
7. Run your tests

Improving expectations
======================

There are three ways to improve expectations:

1. Run a test multiple times in ``TRAINING`` mode to gain better validation model from multiple example runs.
2. Run a test in ``INTERACTIVE`` mode to stop execution on failing ``Should be as expected``. Then explore and make a better validation model.
3. Modifying ``_expects.json`` by hand.

When expectations change
========================

If your system changes in a way that old expectations should not be used, just remove ``_expects.json`` file and switch library to ``TRAINING`` mode. Then run your test to record new expectations.