neutron-lib/doc/source
Boden R dd4ffe3721 boilerplate extension descriptor for api-def
Today we have a number of extensions that must provide
boilerplate/redundant code in their extension class to return
basic API definition attributes such as name, description, alias,
etc.. For example [1].

This patch proposes we can provide most of that boilerplate code
right in a base extension descriptor class; just have extension
sub-classes provide their API definition. With this patch, code such
as [1] gets reduced to a class definition with a single class-level attribute
to specify the API definition for the extension.

For sample usage, have a look at [2] that used as a dummy patch
to test PS4/PS7 of this change with neutron master.

[1] https://review.openstack.org/#/c/421562/2/neutron/extensions/providernet.py@36
[2] https://review.openstack.org/#/c/433929/1/neutron/extensions/providernet.py

Change-Id: I25135b39a1d26c11006bc2a7b6080cdd839f0085
2017-02-28 06:19:32 -07:00
..
devref boilerplate extension descriptor for api-def 2017-02-28 06:19:32 -07:00
conf.py Removes unnecessary utf-8 encoding 2016-12-28 17:08:10 +07:00
contributing.rst Explain how to use the latest neutron-lib dashboard 2016-11-30 11:24:01 -08:00
conventions.rst TrivialFix: Fix a bad indentation in a doc file 2016-06-09 16:22:11 -04:00
index.rst Remove README from docs build 2016-11-30 15:07:46 -07:00
installation.rst Initial cookiecutter commit 2015-11-20 17:24:43 -07:00
releasing.rst Remove support for py34 2017-02-09 08:28:56 +07:00
review-guidelines.rst fix broken link in review guidelines 2017-02-10 16:05:28 -07:00
usage.rst Use new checks in hacking 0.12 2016-12-15 07:03:58 -07:00