Skip to content
A meta test framework
Python Shell
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.


Type Name Latest commit message Commit time
Failed to load latest commit information.

Lift Integration-Functional Testing - A meta test framework

Build Status Code style: black

Usually, there is not much to discuss when writing unit tests.
They have to use the same programming language as the code they are testing and most languages have a set of dedicated test frameworks that you may chose from.

However, functional and integration tests are more often a bunch of scripts/executables written in different languages.
For example, you may prefer to use shell scripts to test a web-service (eg. via curl) and a Python program to interact with Python modules.
And if C/Ruby/Perl/PHP/whatever is more suited to some of your test cases, you want to use these languages too without having to write the full test suite with it.

Currently, most projects seem to have either multiple functional/integration test suites (re-using different unit testing frameworks) or internal solutions to group all the tests executable together in a more or less clean way.

Lift provides an integration/functional test platform which handles executable tests easily and generically.


  • Lift only deals with executables and their return code
    → A particular test can be written in the language that fit it the most
  • Test declaration in a simple YAML syntax
    → No need to learn a programming language to integrate a test in a suite
  • Easily declare a test as running locally or on a remote machine
  • Remote tests: upload needed assets automatically and cleanup afterward
  • Naturally organize a test suite in multiple sub-folders/sub-test suites
  • Easily run a sub-test suite or specific tests from the command line
  • Pass environment variables to tests
  • Inheritance of remotes and environment across sub-test suites
    → For example, remotes can be defined in the top folder and used below
  • Only one command to run all or specific tests: lift
  • Export XUnit reports, for easy integration with Jenkins & friends


The doc folder contains man pages.


For a fully commented example of a lift test suite (which can also be seen as a functional test suite for Lift itself), see the example folder.


Use sudo python3 install

  • Python 3 (>= 3.4)
  • python3-yaml
  • python3-paramiko
  • python3-docutils (for man pages)
  • python3-junit.xml

Home page


GNU General Public License (GPL) version 2+
Please refer to the COPYING file.

You can’t perform that action at this time.