os-vif

library5.0.0pypypiunverified

A library for plugging and unplugging virtual interfaces in OpenStack. Current version is 4.3.0, release cadence is aligned with OpenStack releases (approximately every 6 months).

devops

pip install os-vif

package ↗homepage ↗

INSTALL

IMPORT

SIG · OS-VIF

os-vif

devopspythonv5.0.0

Install

10.8s avg

Import

—

Disk

86MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v4.3.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 84.8MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 10.8s · import 0.000s · 83MB

86MB installed

● package 86MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

VIFPlugBase

✓ from os_vif import VIFPlugBase

✗ from os_vif.plug import VIFPlugBase

Direct import from os_vif is the correct root path.

plugin

✓ from os_vif import plugin

✗ import os_vif.plugin

The 'plugin' is an attribute of the os_vif module, not a submodule.

Initialize os-vif and list loaded plugins.

import os_vif from os_vif import plugin # Example: initialize os_vif (no args needed) os_vif.initialize() # List loaded plugins loaded_plugins = plugin.get_loaded_plugins() print(loaded_plugins) # Each plugin can plug/unplug a VIF # Refer to OpenStack nova or neutron code for full usage

Debug

Known issues

breakingIn version 4.0.0, the 'os_vif' module dropped support for Python 2 and moved to namespace packages. Ensure your project is Python 3.9+.

fix

Update your Python environment to >=3.9 and check for deprecated imports.

affects: >=4.0.0

gotchaThe 'initialize()' function must be called before using any plugins or VIF operations. Forgetting this will cause runtime errors about uninitialized plugins.

fix

Always call os_vif.initialize() early in your startup code.

affects: all

gotchaos-vif dynamically loads plugins via setuptools entry points. If plugins are not installed (e.g., os-vif-bridge, os-vif-ovs), no plugins will be available. This often confuses users who expect built-in plugins.

fix

Ensure you install the required plugin packages, e.g., 'pip install os-vif-bridge os-vif-ovs'.

affects: all

Upgrade

Version history

5.0.0latest on PyPI · released May 20, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

2 hits · last 30 days

node

Resources

packagehttps://pypi.org/project/os-vif/ ↗

homepagehttps://docs.openstack.org/os_vif ↗