
As discussed in the Liberty Design Summit "Moving apps to Python 3" cross-project workshop, the way forward in the near future is to switch to the pure-python PyMySQL library as a default. https://etherpad.openstack.org/p/liberty-cross-project-python3 Change-Id: I4fd721d6f27bc0125144d960ee5028ce842a60f8
Writing your First OpenStack Application
This directory contains the "Writing your First OpenStack Application" tutorial.
The tutorials works with an application that can be found at: https://github.com/stackforge/faafo
/source
The /source
directory contains a playground for the
actual tutorial documentation. It's reStructuredText (RST), built with
Sphinx.
The RST source includes conditional output logic, so specifying:
tox -e firstapp-libcloud
will invoke sphinx-build
with -t libcloud
,
meaning sections marked .. only:: libcloud
in the RST will
be built, while others won't.
Sphinx and the OpenStack docs.openstack.org Sphinx Theme (openstackdocstheme) are needed to build the docs.
/samples
The code samples provided in the guide are sourced from files in this directory. There is a sub-directory for each SDK.