The Common Automation Framework Engine
( ( ) ) ......... | |___ | |_ | | :-) |_| | | |___| |_______| === CAFE Core ===
OpenCAFE, the Open Common Automation Framework Engine, is designed to be used as the base for building an automated testing framework for API and other (non-UI) testing. It is designed to support all kinds of testing methodologies, such as unit, functional and integration testing, using a model-based approach. Although the engine is not designed with performance or load testing in mind, as it prioritizes repeatability and (verbose) logging over performance, it can be used to that end.
Source code is available at https://github.com/openstack/opencafe
Open CAFE Core has been developed primarily on and for Linux, but supports installation and execution on BSD and other *nix’s, as well as OS X and modern Windows. It can be installed from pypi via pip or from source.
It is recommended that you install OpenCAFE in a python virtualenv.
From pypi via pip
$ pip install opencafe
$ git clone https://github.com/openstack/opencafe.git $ cd opencafe $ python setup.py install
Post-install, the cafe-config cli tool will become available. It is used for installing plugins and initializing the engine’s default .opencafe directory.
OpenCAFE uses a set of default locations for logging, storing test configurations, test data, statistics, and the like; all of which are set in, and read from, the engine.config file (in order to make it easy for the end user to override the default behavior). The engine.config file, and the directories it references, can be created on demand by running:
This will create a directory named .opencafe in the user’s home directory, or in the case of a python virtualenv, in the virtualenv root folder.
The cafe-config plugins command is used to list and install plugins.
$ cafe-config plugins list ================================= * Available Plugins ... elasticsearch ... http ... mongo ... pathos_multiprocess ... rsyslog ... skip_on_issue ... soap ... ssh ... sshv2 ... subunit ... winrm ================================= $ cafe-config plugins install http ================================= * Installing Plugins ... http =================================
Provides tools for logging and reporting. This namespace should be used by plugins to add logging and reporting features.
Used by the cafe-config cli tool for setting up new installations of opencafe.
Houses various test runner wrappers and supporting tools. This namespace should be used by plugins to add new test runner support.
Includes the base classes that OpenCAFE implementations will use to create behaviors, configs, clients and models. This namespace should be used by plugins to add new clients.
Deprecated. Historically contained all modules that reference external resources to OpenCAFE. Currently acts only as a namespace for backward compatability with some plugins.
Following are some notes on Open CAFE lingo and concepts.