05a83963f7
This was removed a few years ago. Change-Id: I8011d652c1f3527b6c5e75b3c3cb1051cfe9bbbe Signed-off-by: Stephen Finucane <stephenfin@redhat.com>
114 lines
3.0 KiB
ReStructuredText
114 lines
3.0 KiB
ReStructuredText
=================================
|
|
Contributing to the OpenStack SDK
|
|
=================================
|
|
|
|
This section of documentation pertains to those who wish to contribute to the
|
|
development of this SDK. If you're looking for documentation on how to use
|
|
the SDK to build applications, refer to the `user <../user>`_ section.
|
|
|
|
About the Project
|
|
-----------------
|
|
|
|
The OpenStack SDK is a OpenStack project aimed at providing a complete
|
|
software development kit for the programs which make up the OpenStack
|
|
community. It is a Python library with corresponding documentation,
|
|
examples, and tools released under the Apache 2 license.
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
|
|
history
|
|
|
|
Contribution Mechanics
|
|
----------------------
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
|
|
contributing
|
|
|
|
Contacting the Developers
|
|
-------------------------
|
|
|
|
IRC
|
|
~~~
|
|
|
|
The developers of this project are available in the `#openstack-sdks`__ channel
|
|
on OFTC IRC. This channel includes conversation on SDKs and tools within the
|
|
general OpenStack community, including OpenStackClient as well as occasional
|
|
talk about SDKs created for languages outside of Python.
|
|
|
|
.. __: http://webchat.oftc.net?channels=%23openstack-sdks
|
|
|
|
Email
|
|
~~~~~
|
|
|
|
The `openstack-discuss`__ mailing list fields questions of all types on
|
|
OpenStack. Using the ``[sdk]`` filter to begin your email subject will ensure
|
|
that the message gets to SDK developers.
|
|
|
|
.. __: mailto:openstack-discuss@openstack.org?subject=[sdk]%20Question%20about%20openstacksdk
|
|
|
|
Coding Standards
|
|
----------------
|
|
|
|
We are a bit stricter than usual in the coding standards department. It's a
|
|
good idea to read through the :doc:`coding <coding>` section.
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
|
|
coding
|
|
|
|
Development Environment
|
|
-----------------------
|
|
|
|
The first step towards contributing code and documentation is to setup your
|
|
development environment. We use a pretty standard setup, but it is fully
|
|
documented in our :doc:`setup <setup>` section.
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
|
|
setup
|
|
|
|
Testing
|
|
-------
|
|
|
|
The project contains two test packages, one for unit tests and one for
|
|
functional tests. The ``openstack.tests.unit`` package tests the SDK's features
|
|
in isolation. The ``openstack.tests.functional`` package tests the SDK's
|
|
features and examples against an OpenStack cloud.
|
|
|
|
.. toctree::
|
|
|
|
testing
|
|
|
|
Project Layout
|
|
--------------
|
|
|
|
The project contains a top-level ``openstack`` package, which houses several
|
|
modules that form the foundation upon which each service's API is built on.
|
|
Under the ``openstack`` package are packages for each of those services,
|
|
such as ``openstack.compute``.
|
|
|
|
.. toctree::
|
|
|
|
layout
|
|
|
|
Adding Features
|
|
---------------
|
|
|
|
Does this SDK not do what you need it to do? Is it missing a service? Are you
|
|
a developer on another project who wants to add their service? You're in the
|
|
right place. Below are examples of how to add new features to the
|
|
OpenStack SDK.
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
|
|
create/resource
|
|
|
|
.. TODO(briancurtin): document how to create a proxy
|
|
.. TODO(briancurtin): document how to create auth plugins
|