This release is a pre-release and may not be stable for production use.
A Python package for automating VideoIPath configuration workflows.
⚠️ Attention ⚠️
This Python package, the VideoIPath Automation Tool, is still under development and currently in the beta phase. Features and interfaces may change as development progresses. Feel free to use the module and provide feedback, but be aware that breaking changes may occur in future versions.
Introduction
The VideoIPath Automation Tool is a Python package designed to simplify and optimize interactions with the VideoIPath API. The focus is on providing a user-friendly and efficient way to automate configuration tasks and bulk operations on VideoIPath servers. The package abstracts the complexity of the API and provides a high-level interface. Currently, the package offers methods for managing devices in the Inventory and Topology apps, as well as the configuration of multicast pools and profiles.
The provided methods and data models ensure easy handling, robust validation, comprehensive logging, and enhanced reliability.
Quick Start Guide
Prerequisites
- Access to a VideoIPath Server (version 2023.4.2 or higher, LTS versions recommended)
- Username and Password for a user account with API access
- Python 3.11 or higher
Installation
The package is available via the Python Package Index (PyPI) and can be installed directly using pip.
Install the package using pip
pip install videoipath-automation-tool
Note: By default, the latest Long-Term Support (LTS) version (currently 2024.4.30) is used for schema validation and IntelliSense.
To switch to a specific version, see the Driver Versioning Guide
A Simple Example: Adding a Device to the Inventory
# Import the `VideoIPathApp` class from the videoipath_automation_tool package
from videoipath_automation_tool import VideoIPathApp
# Initialize the VideoIPathApp
app = VideoIPathApp(server_address="10.1.100.10", username="api-user", password="veryStrongPassword", use_https=False, verify_ssl_cert=False)
# Create a device object with NMOS Multidevice driver
staged_device = app.inventory.create_device(driver="com.nevion.NMOS_multidevice-0.1.0")
# Set the device label, description, address, nmos port and disable 'Use indices in IDs' option
staged_device.configuration.label = "Media-Node-1"
staged_device.configuration.description = "Hello World"
staged_device.configuration.address = "10.100.100.1"
staged_device.configuration.custom_settings.port = 8080
staged_device.configuration.custom_settings.indices_in_ids = False
# Add the configured device to the inventory of the VideoIPath server
# This immediately registers the device and returns the assigned device object.
try:
device = app.inventory.add_device(staged_device)
print(f"Device added successfully: {device.device_id}")
#> Device added successfully: device34
except Exception as e:
print(f"Failed to add device: {e}")
Documentation
Feedback & Contributions
Your feedback and contributions are highly appreciated! There are several ways to participate and help improve the VideoIPath Automation Tool:
✅ Report issues & suggest features: Open an issue on GitHub: ➝ GitHub Issues
✅ Contribute via pull requests: If you want to implement a fix or a new feature yourself, feel free to fork the repository and submit a pull request. ➝ Fork the Repository
✅ Discuss & provide feedback: If you have general feedback or ideas that don’t fit into an issue, feel free to reach out via email: 📧 moip@swr.de
Thank you for your support and contributions!
Disclaimer
VideoIPath Automation Tool is an independent software tool that can be used with the VideoIPath media orchestration platform. However, it is not a product or service offered by Nevion, and Nevion is not responsible for its functionality, performance, support, or any unforeseen consequences arising from its use. Nevion's VideoIPath platform is used to manage critical media infrastructure, and special care is advised concerning the use of external tools such as this.
License
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file videoipath_automation_tool-0.9.0.dev418.tar.gz.
File metadata
- Download URL: videoipath_automation_tool-0.9.0.dev418.tar.gz
- Upload date:
- Size: 739.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/2.4.1 CPython/3.14.6 Linux/6.17.0-1020-azure
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6998bf3a43f97c50388fd6787cd2c2946b81d9ce375cc431317606c6ab8f00d0
|
|
| MD5 |
2a45435721baf3fc395c10825f1e9305
|
|
| BLAKE2b-256 |
3e551d5fa21f0c8b8979a4033c3478be1650f06eedbef0cf42c384a8ba11ff01
|
File details
Details for the file videoipath_automation_tool-0.9.0.dev418-py3-none-any.whl.
File metadata
- Download URL: videoipath_automation_tool-0.9.0.dev418-py3-none-any.whl
- Upload date:
- Size: 864.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/2.4.1 CPython/3.14.6 Linux/6.17.0-1020-azure
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
24cbcb26c48b206d4b19175ae69e16a5dfca305caad0188129600d0ad1ff2ab5
|
|
| MD5 |
7b9d6f2c33aa3f4ef71bb101bc9eb41c
|
|
| BLAKE2b-256 |
4bedfb10daf889ab2b350a80b27991359651a73319647c43b9c0d0ee08e781ed
|
