33 Commits

Author SHA1 Message Date
Balazs Gibizer
8279b1ea2e Handle multiple samples per versioned notification
The notification_sample decorator is changed to handle
attaching multiple sample files to a notification object.

Change-Id: I4c3df17d93282f6946221da65d26d0ca3194d3df
2016-06-21 09:39:54 +02:00
Balazs Gibizer
520ee65a55 Do not register notification objects
Only registering the notification objects during unit test.
Notification objects are never used in the Nova RPC interface
and shall not be mixed with such objects.

Change-Id: Iba9079bb204e6ef1302529ac159199ab9fa6272b
2016-06-08 11:32:53 +02:00
Balazs Gibizer
5e074a59d2 Move notification related code to separate package
To be able to separate the versioned notification related
object model from the nova internal object model a new
nova.notification.object package is introduced.

As nova had nova/notifications.py already in the tree
the code from that file is moved into the new nova.notification
package as a first step.

Implements: bp versioned-notification-transformation-newton
Change-Id: I315f548180c260c22a2ebcf7b7cb56d284b6e580
2016-06-08 11:32:53 +02:00
Andrey Volkov
9053a4685b Make available to build docs with python3
On Ubuntu 16.04 a tox package is for python3 by default
and this causes errors in building docs in tox enviroment.

In these changes iterators are replaced with lists where it's needed.
Also external command calls result are decoded from bytes to unicode.

Change-Id: I88ef54405b4bc13c269bdda55ae8289676311ee1
2016-05-23 15:30:20 +03:00
Jenkins
ab4a5f8a55 Merge "Refactor _load_support_matrix" 2016-02-02 15:05:49 +00:00
Jenkins
e5256c32a7 Merge "Add argument to support-matrix sphinx extension" 2016-02-01 14:36:10 +00:00
Balazs Gibizer
05adc8d006 Generate doc for versioned notifications
This commit adds a new sphinx extension that inspects the nova code
and adds information about the existing versioned notifications to
the nofitications devref. This way the devref is automatically kept
up to date with relevant information.

Partially-Implements: bp versioned-notification-api
Change-Id: If65d5d81e26cb2b4a9f57a8c7d37d3de310ebe00
2016-01-28 15:33:06 +01:00
John Garbutt
fbbe1cf316 Refactor _load_support_matrix
In the Sphinx extension, split up the _load_support_matrix method, so
its easier to understand the additions for the feature_classification
table.

Change-Id: Ic3654017f63dda2c2505057b0063acbc6d5f83c2
2016-01-07 11:18:51 +00:00
John Garbutt
b583604f05 Add argument to support-matrix sphinx extension
Make it easier to add additional support-matrix entries by making the
filename of the ini file a required argument of the directive.

As a side effect, its clearer in the rst file where the data is stored.

Change-Id: I05bd30b64152368b53c030a32754d0ed4a35bf88
2016-01-06 11:32:30 +00:00
En
313f60778f formely is not correct
message:
I change "formely" to "formerly".

Change-Id: I77366aa1d84c31e5ffdfaa0a5fd5c99a77e3a19c
Closes-Bug: #1481271
2015-08-04 17:58:16 +08:00
Maxim Nestratov
bc3b6cca47 libvirt: rename parallels driver to virtuozzo
As Parallels Cloud Server product was renamed within Parallels company rebranding
we need to change its reference in feature support matrix and documents accordingly.
A parameter 'virt_type' in libvirt section of nova.conf will remain 'parallels'.

Since libvirt version that supports 'vz' starts to report it as a hypervisor type,
we add a new hv_type 'vz' in the list of known hypervisors.

DocImpact.

Change-Id: I536e4284927508a813edd05f185f7ba0ed76d38c
implements: blueprint rename-pcs-to-virtuozzo
2015-07-29 18:40:12 +03:00
Markus Zoeller
6a6059a9a6 hypervisor support matrix: add CLI commands to features
Some features could be made clearer if the CLI commands which are
related to that feature are listed. This patch set allows to set
CLI commands per feature.
This is an interim solution until the new feature classification
system is established.

Change-Id: If599627187080a8349811f50f6561e9efbc35138
2015-06-26 08:11:18 +00:00
Markus Zoeller
36f7451c33 hypervisor support matrix: add status "unknown"
When a new feature gets added to the hypervisor support matrix it
was not possible to state that the hypervisor did not make a support
statement yet. You had to choose between "complete", "partial" and
"missing" wich could be missleading.
This change set adds the status "unknown" which could make the
statements more precise.

Change-Id: If94fc772796742de88af5893839945834b9d3eb6
2015-06-15 10:18:37 +02:00
Jenkins
2108a66572 Merge "Use six.moves.range for Python 3" 2015-05-22 18:04:43 +00:00
Jenkins
98f7e8dae3 Merge "Replace unicode with six.text_type" 2015-05-21 00:47:36 +00:00
Victor Stinner
b259659a22 Use six.moves.range for Python 3
The function xrange() was renamed to range() in Python 3.

Use "from six.moves import range" to get xrange() on Python 2 and range() on
Python 3 as the name "range", and replace "xrange()" with "range()".

The import is omitted for small ranges (1024 items or less).

This patch was generated by the following tool (revision 0c1d096b3903)
with the "xrange" operation:
https://bitbucket.org/haypo/misc/src/tip/python/sixer.py

Manual change:

* Replace range(n) with list(range(n)) in a loop of
  nova/virt/libvirt/driver.py which uses list.pop()

Blueprint nova-python3
Change-Id: Iceda35cace04cc8ddc6adbd59df4613b22b39793
2015-05-20 15:19:51 -07:00
Victor Stinner
67eedf4fa0 Replace unicode with six.text_type
The Unicode type is 'unicode' in Python 2 and 'str' on Python 3: replace
unicode with six.text_type to make Nova compatible with Python 2 and
Python 3.

This patch was generated by the following tool (revision e760664379c3) with the
operation "unicode":
https://bitbucket.org/haypo/misc/src/tip/python/sixer.py

Manual change:

* Replace "isinstance(value, str) or isinstance(value, unicode)"
  with "isinstance(value, six.string_types)" in nova/api/ec2/ec2utils.py

* Revert changes in strings in:

  - nova/compute/api.py
  - nova/hacking/checks.py
  - nova/tests/unit/api/openstack/test_wsgi.py
  - nova/utils.py

* Revert changes in nova/tests/unit/test_hacking.py: tests must use
  "unicode()". The nova.hacking module will probably need other changes
  to support Python 3.

* Reformat nova/tests/unit/objects/test_instance_action.py and
  nova/tests/unit/virt/hyperv/test_hypervapi.py to 80 columns

Blueprint nova-python3
Change-Id: I7ced236b6f8f8b6a5d2e7fee3c4f0ba4d72c21fb
2015-05-12 12:31:20 +02:00
Markus Zoeller
dcc2cc40a6 Hypervisor Support Matrix renders links in notes
The sphinx-extension which renders the support_matrix.ini file into
HTML did not recognize URLs in the notes which have to be written as
an HTML anchor element. This commit changes that. The links are
clickable now.

Closes-Bug: 1451468

Change-Id: Ia05610afb32c7a86536b7f462d3cfc44f9a2ca7d
2015-05-12 11:02:20 +02:00
Daniel P. Berrange
4837c42127 Add formal doc recording hypervisor feature capability matrix
Add document to replace / obsolete the giant table on

  https://wiki.openstack.org/wiki/HypervisorSupportMatrix

This initial draft is a fairly straightforward conversion of
that table. Over time, it needs much work to improve the coverage
of API operations and and coverage of important configuration
information that users will care about.

It is using the .ini file syntax in order to record the data in
an easily machine parsable format, while remaining human friendly
by avoiding the syntax heavy approach of XML / JSON / YAML

An extension is registered with sphinx that can convert the
.ini file content into docutils content that then gets rendered
into the developer docs, linked from the index page

Change-Id: I4d3db4bce5737dba30a026a11083a9ea64459cd4
2015-02-03 15:15:49 +00:00
Boris Pavlovic
2dce8c92f6 Remove usage of locals() for formatting from nova.api.*
Using of locals() for formatting string is a nasty thing because:
1) It is not so clear as using explicit dicts
2) It could produce hidden errors during refactoring
3) Changing name of variable causes change in message
4) Creating a lot of unused variables

fixes bug 1171936
Change-Id: I293d7ebb875f65cce322d4938d1ae323f3aded8d
2013-05-18 00:04:17 +04:00
lrqrun
9ddd714f08 Fix PEP8 issues.
Fix some pep8 issues in doc/ext/nova_todo.py make the code looks pretty.

Change-Id: I026c873b487b507a758a2cdb70b444b64702b7fa
2012-08-28 23:13:11 +08:00
Ray Chen
9424514e6f Fix PEP8 issues
Fix some PEP8 issues in doc/ext/nova_todo.py and doc/source/conf.py
and make the code look more clearly.

Change-Id: I2b0ce1b09a4a707cffaa565747aabd5346eb9f41
2012-08-17 11:35:57 +08:00
Monty Taylor
eb2de037a3 Update common setup code to latest.
This gets us up to date with common/setup.py and replaces custom nova
autodoc generation with the port of that code found in common.

Change-Id: I2a1c5d2c0fdcf40dbea50cc123b537adb068cdc2
2012-07-07 16:32:19 -05:00
Monty Taylor
702a4743f0 Get rid of all of the autodoc import errors.
This hasn't worked right in a bazillion years.

Change-Id: I4db20ce97f920cdb7254d51e18a0630b0283b39d
2012-03-05 20:22:51 -08:00
Doug Hellmann
1ea445c377 blueprint sphinx-doc-cleanup
bug 944381

Add logic to generate_autodoc_index.sh to produce rst underlines to match the heading strings.

Change-Id: Ib0f54a45fcc4ab6dfaa593c756682f1a25fdb420
2012-03-01 17:03:01 -05:00
Vishvananda Ishaya
20b4d89512 Remove a whole bunch of unused imports
Change-Id: I6759e5b6250c48cc0deb4b198b44c948c64c47d1
2012-01-13 13:55:38 -08:00
Lorin Hochstein
d4a3962a2d Fix deprecation warnings
Fixed some warnings like this:

DeprecationWarning: docutils.nodes.Element.set_class deprecated; append to
Element['classes'] list attribute directly
  lists[i].set_class('todo_list')

Change-Id: I94e564f561f95a66e6e98767ccfaa78769b5c0f1
2011-11-24 10:54:21 -05:00
Eric Windisch
5f6a58c7c2 execvp: fix docs 2011-03-09 17:22:54 -05:00
Ed Leafe
68c9c89300 Completed first pass at converting all localized strings with multiple format substitutions. 2011-01-18 21:00:28 -05:00
jaypipes@gmail.com
56856ac110 Fix doc building endpoint for gettext. 2010-12-22 11:12:20 -05:00
root
1a020c2713 notes, and add code to enable sorted "..todo:: P[1-5] xyz" syntax 2010-11-12 09:25:01 -08:00
Todd Willey
a3b6e0f358 Use the autodoc tools in the setup.py build_sphinx toolchain. 2010-11-07 17:53:39 -05:00
root
dd505245c2 add in custom todo, and custom css 2010-11-05 12:49:42 -07:00