Metadata-Version: 1.1
Name: robotframework-expects
Version: 0.2.0
Summary: Train and use expectation detector in Robot Framework tests.
Home-page: https://github.com/mkorpela/robotframework-expects
Author: Mikko Korpela
Author-email: mikko.korpela@gmail.com
License: Apache License, Version 2.0
Description: *************************
        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. 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.
        
Keywords: testing
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
