Ocata Series Release Notes¶
Introduced neutron_lib.plugins.directory.is_loaded(). This can be used in lieu of len(plugins()) or bool(plugins()) or plugins() alone.
Neutron agent extension abstract classes are moved from
CONTRACT_BRANCHare now available in
neutron_lib.db.constants. They should be used instead of the ones in
contextmodule has been made public. For example:
from neutron_lib import context ctx = context.get_admin_context()
For more examples, see: https://review.openstack.org/#/c/388157/
Introduced neutron_lib.fixture, and added fixture for plugin directory
PluginDirectoryFixture. An example below:
from neutron_lib.plugins import directory from neutron_lib import fixture def setup_test_directory_instance(self): """Give a private copy of the directory to each test.""" self._plugin_directory = directory._PluginDirectory() self.useFixture(fixture.PluginDirectoryFixture( plugin_directory=self._plugin_directory))
Neutron’s callback API found in
neutron.callbacks.*is now exposed in
neutron_lib.callbacks.*. In addition, a set of event payload objects are now available for use in transporting event payload data in a standardized way.
A test fixture is provided for isolating the global callback manager in
neutron_lib.callbacks.registry. For more details see the comments in
Adds neutron-fwaas API definitions to neutron-lib.
Added the converter
Added the converter
Added the validator
convert_ip_to_canonical_formathas been added to neutron-lib which allows IPv6 addresses to be stored and displayed in canonical format.
routerAPI definitions from
neutron.extensions.l3have been rehomed to
neutron_lib.api.definitionsas the module
get_random_macutility function from
neutron.common.utilsis now in
neutron_lib.utils.netwith the same name,
The API definition and associated constants have been rehomed from
Provider networkextension API definition has been added as
The hacking check factory
incubating_factoryhas been added to
neutron_lib.hacking.checksallowing adopters to test compliance on incubating hacking checks. See the usage documentation for additional details.
neutron.services.service_base.ServicePluginBaseis now available as
Added validator validate_ip_or_subnet_or_none
neutron_lib.api.utils.populate_project_infohas moved to
neutron_lib.api.attributes.populate_project_info. It will be removed from the old location in the future.
The use of
neutron_lib.callbacks.manager.CallbacksManager.notify()is deprecated in favor of their
publish()counterparts and will be removed in the “Queens” release time-frame.
policy.reset()have been removed. The library policy module is not meant for public consumption, and it should be considered in practice a private component of the library. If you use it, you will do so at your own risk, as it has been marked as a private module.
OpenStack dev hacking check
H904is now enabled in
enable-extensionsconfiguration property. Neutron-lib adopters should also enable this hacking check in their
The ExtensionDescriptor class moved from neutron.api.extensions to neutron_lib.api.extensions.
Introduced neutron_lib.plugins.directory to get references for loaded plugins in a neutron server process. For example:
from neutron_lib import constants from neutron_lib.plugins import directory core_plugin = directory.get_plugin() l3_plugin = directory.get_plugin(constants.L3)
For more examples, see: https://review.openstack.org/#/c/386845/
API reference for the trunk extension.
Provide API definition framework for Neutron Stadium APIs to be consolidated into neutron-lib. For more details see review https://review.openstack.org/#/c/353131/.