## Tempest Testing Project

updated: December 08, 2017

# Tempest Testing Project

## Overview

- Team and repository tags
  - Tempest - The OpenStack Integration Test Suite

## Field Guides

Tempest contains tests of many different types, the field guides attempt to explain these in a way that makes it easy to understand where your test contributions should go.

- Tempest Field Guide Overview
- Tempest Field Guide to API tests
- Tempest Field Guide to Scenario tests
- Tempest Field Guide to Unit tests

## Users Guide

### Tempest Configuration Guide

- Tempest Configuration Guide
  - Test Credentials
  - Compute
  - Networking
  - Configuring Available Services
  - Service Feature Configuration
- Sample Configuration File

### Command Documentation

- Tempest Test-Account Generator Utility
- Post Tempest Run Cleanup Utility
- Subunit Describe Calls Utility
- Tempest Workspace
- Tempest Run

## Developers Guide

### Development

- Tempest Coding Guide
  - Tempest Specific Commandments
  - Test Data/Configuration
  - Exception Handling
  - Test cases are independent
  - Service Tagging
  - Test fixtures and resources
  - Skipping Tests
  - Negative Tests
  - Test skips because of Known Bugs
  - Guidelines
  - Parallel Test Execution
  - Sample Configuration File
  - Unit Tests
  - Test Documentation
  - Test Identification with Idempotent ID
  - Branchless Tempest Considerations
  - API Stability
- Reviewing Tempest Code
  - Ensuring code is executed
  - Execution time
  - Unit Tests
  - API Stability
  - Reject Copy and Paste Test Code
  - Tests overlap
  - Being explicit
  - Configuration Options
  - Test Documentation
  - Release Notes
  - Deprecated Code
  - When to approve
- Microversion Testing With Tempest
  - Tempest Scope For Microversion Testing
  - Project Scope For Microversion Testing
  - Configuration options for Microversion
  - How To Implement Microversion Tests
  - Notes about Compute Microversion Tests
  - Microversion tests implemented in Tempest
- Tempest Test Removal Procedure
  - Proposing a test removal
  - Exceptions to this procedure
- Tempest Test Writing Guide
  - Adding a New TestCase
  - Interacting with Credentials and Clients

### Plugins

- Tempest Test Plugin Interface
  - Creating a plugin
  - Plugin Class
  - Plugin Structure
  - Using Plugins

### Library

- Tempest Library Documentation
  - Stability
  - Current Library APIs

## Indices and tables

- Search Page

updated: December 08, 2017

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.

found an error? report a bug questions?