History

Andreas Jaeger 70a95e3370 Update links for RST CLI Reference Update all links to new location. Change-Id: Idbeb70df359c05b37aabbe276c4aa34d05d5dab4		2016-01-15 13:24:10 +01:00
..
samples	Fix public IP variable	2016-01-04 14:53:58 -06:00
source	Update links for RST CLI Reference	2016-01-15 13:24:10 +01:00
README.rst	faafo repository moved from stackforge to openstack namespace	2015-10-20 12:54:47 +02:00
setup.cfg	Add Python versions for classifier in setup.cfg	2015-12-11 14:07:44 +05:30
setup.py	FirstApp: Move source directory up, rename top-level dir	2015-05-01 17:22:46 +02:00

Writing Your First OpenStack Application

This directory contains the "Writing Your First OpenStack Application" tutorial.

The tutorials work with an application that can be found in the openstack/faafo repository.

Prerequisites

To build the documentation, you must install the Graphviz package.

The /source directory contains the tutorial documentation as reStructuredText (RST).

To build the documentation, you must install Sphinx and the OpenStack docs.openstack.org Sphinx theme (openstackdocstheme). When you invoke tox, these dependencies are automatically pulled in from the top-level test-requirements.txt.

You must also install Graphviz on your build system.

The RST source includes conditional output logic. The following command invokes sphinx-build with -t libcloud:

tox -e firstapp-libcloud

Only the sections marked .. only:: libcloud in the RST are built.

The code samples in this guide are located in this directory. The code samples for each SDK are located in separate subdirectories.

The HTML documentation is built in this directory. The .gitignore file for the project specifies this directory.