libvirt-python 12.5.0__tar.gz → 12.7.0__tar.gz

{libvirt_python-12.5.0 → libvirt_python-12.7.0}/AUTHORS

@@ -43,6 +43,7 @@ The individual contributors are
    Guido Günther <agx@sigxcpu.org>
    Han Han <hhan@redhat.com>
    Hu Tao <hutao@cn.fujitsu.com>
+   Jaehoon Kim <jhkim@linux.ibm.com>
    Jason Andryuk <andryuk@aero.org>
    Jelle van der Waa <jvanderwaa@redhat.com>
    Jim Fehlig <jfehlig@suse.com>
@@ -87,6 +88,7 @@ The individual contributors are
    Prabodh Agarwal <prabodh1194@users.noreply.github.com>
    Pradipta Kr. Banerjee <pradipta.banerjee@gmail.com>
    Qiaowei Ren <qiaowei.ren@intel.com>
+   Radoslaw Smigielski <rsmigiel@redhat.com>
    Radostin Stoyanov <rstoyanov@fedoraproject.org>
    renlei4 <ren.lei4@zte.com.cn>
    Richard W.M. Jones <rjones@redhat.com>

{libvirt_python-12.5.0 → libvirt_python-12.7.0}/ChangeLog

@@ -1,3 +1,299 @@
+ 2026- 8- 25 Jaehoon Kim <jhkim@linux.ibm.com>
+    
+    Add VIR_DOMAIN_IOTHREAD_POLL_WEIGHT macro
+    The VIR_DOMAIN_IOTHREAD_POLL_WEIGHT typed param is being introduced
+    in libvirt v12.7.0. Add the correct VIR_TYPED_PARAM_UINT entry to
+    virPyDomainSetIOThreadParams[] so that the parameter is parsed with
+    the correct type.
+    
+    
+    
+ 2026- 8- 20 Radoslaw Smigielski <rsmigiel@redhat.com>
+    
+    tests: add migration API tests for migrate, migrate2, and migrate3
+    Add a new test file test_domain_migration.py to cover the VM migration API,
+    using mocked C-level calls and test driver.
+    
+    
+    
+ 2026- 8- 6 Radoslaw Smigielski <rsmigiel@redhat.com>
+    
+    tests: expand connection tests in test_conn.py
+    Add functional tests for read-write and read-only connections using
+    the test:///default driver.
+    
+    
+    
+ 2026- 8- 6 Daniel P. Berrangé <berrange@redhat.com>
+    
+    rpm: convert to new pyproject macros
+    The currently used macros are deprecated:
+    
+    https://fedoraproject.org/wiki/Changes/DeprecateSetuppyMacros
+    
+    and print a warning that they will be removed in Fedora 45 so we
+    are overdue to port to the new macros.
+    
+    The new macros appear to be compatible with CentOS Stream 9, so
+    we don't need conditional use of the old macros.
+    
+    
+    
+ 2026- 8- 6 Daniel P. Berrangé <berrange@redhat.com>
+    
+    ci: add pyproject-rpm-macros
+    This is needed for the forthcoming change to the RPM packaging
+    
+    
+    
+ 2026- 8- 6 Daniel P. Berrangé <berrange@redhat.com>
+    
+    rpm: update to RHEL-9 / Fedora 43 as min versions
+    This lets us assume newer Python packaging macros
+    
+    
+    
+ 2026- 8- 5 Radoslaw Smigielski <rsmigiel@redhat.com>
+    
+    docs: simplyfy steps to build docs with Sphinx
+    Encapsulate all requirements in Python virtual environment,
+    do not depend on installing them at the system level.
+    
+    
+    
+ 2026- 8- 5 Radoslaw Smigielski <rsmigiel@redhat.com>
+    
+    docs: document Sphinx building steps
+    Added a "Building API Documentation" section to HACKING file
+    with the step of building docs with sphinx.
+    
+    
+    
+ 2026- 8- 5 Radoslaw Smigielski <rsmigiel@redhat.com>
+    
+    docs: publish libvirt-python API docs via GitLab pages
+    Add jobs:
+    - website_job
+    - pages
+    to build libvirt-python API docs using Sphinx.
+    
+    Created base on libvirt-php/libvirt-java/libvirt-ruby examples.
+    
+    
+    
+ 2026- 8- 5 Radoslaw Smigielski <rsmigiel@redhat.com>
+    
+    docs: add Sphinx configuration to generate Python API documentation
+    The libvirt-python bindings lack official API documentation despite
+    all the infrastructure for it already existing: the libvirt C project
+    ships XML API descriptions (libvirt-api.xml) with detailed function
+    documentation, and generator.py already extracts these descriptions
+    into Python docstrings in the generated code. However, there was no
+    tooling to render these docstrings into browsable documentation.
+    
+    Add a basic Sphinx setup with autodoc to generate HTML API reference
+    from the existing docstrings for all four modules: libvirt (main API),
+    libvirt_qemu, libvirt_lxc, and libvirtaio.
+    
+    
+    
+ 2026- 8- 3 Daniel P. Berrangé <berrange@redhat.com>
+    
+    Declare python 3.9 as min required
+    This is a side effect of the mypy type annotations changed in
+    
+    https://gitlab.com/libvirt/libvirt-python/-/merge_requests/208
+    
+    
+    
+ 2026- 8- 3 Jiri Denemark <jdenemar@redhat.com>
+    
+    Post-release version bump to 12.7.0
+    
+    
+ 2026- 7- 28 Daniel P. Berrangé <berrange@redhat.com>
+    
+    Use lowercase types for collection types
+    The uppercase aliases were deprecated since Py 3.9
+    
+    https://docs.python.org/3/library/typing.html#deprecated-aliases
+    
+    
+    
+ 2026- 7- 28 Daniel P. Berrangé <berrange@redhat.com>
+    
+    ci: refresh with lcitool manifest
+    This replaces OpenSUSE 15 with 16, since 15.6 is now end of life
+    
+    
+    
+ 2026- 7- 28 Daniel P. Berrangé <berrange@redhat.com>
+    
+    Remove redundant return type annotation
+    The _timer() method does not return any value, so declaring its
+    return type is incorrect.
+    
+    
+    
+ 2026- 7- 28 Daniel P. Berrangé <berrange@redhat.com>
+    
+    Use qualified classname for types in libvirt_qemu/libvirt_lxc
+    We must use "libvirt.virDomain" in the type annotation, not a plain
+    "virDomain".
+    
+    
+    
+ 2026- 7- 28 Daniel P. Berrangé <berrange@redhat.com>
+    
+    Check for stream 'cb' attribute existance
+    Instead of accessing self.cb and catching the exception when it does not
+    exist, check for it upfront, which makes mypy happier.
+    
+    
+    
+ 2026- 7- 28 Daniel P. Berrangé <berrange@redhat.com>
+    
+    Fix type for multi-valued return
+    
+    
+ 2026- 7- 28 Daniel P. Berrangé <berrange@redhat.com>
+    
+    Stop scoping the domain event callback type
+    This leads to incompatible types between the register and deregister
+    methods:
+    
+    "Callable[[virConnect, virDomain, int, int, _T@domainEventDeregister], int | None]"
+    "Callable[[virConnect, virDomain, int, int, _T@domainEventRegister], int | None]"
+    
+    
+    
+ 2026- 7- 28 Daniel P. Berrangé <berrange@redhat.com>
+    
+    Use Optiona[..] type annotation for all params with default values
+    If a parameter has a default value assigned then by definition it is
+    an optional parameter, and the type must reflect that.
+    
+    
+    
+ 2026- 7- 28 Daniel P. Berrangé <berrange@redhat.com>
+    
+    Use 'bytes' not 'str' for 'unsigned char *' parameters
+    Such parameters are all byte arrays, not NUL terminated C strings.
+    
+    
+    
+ 2026- 7- 28 Daniel P. Berrangé <berrange@redhat.com>
+    
+    Fix override type for virNodeListDevices 'caps' parameter
+    The 'caps' parameter is a string capability name, not a set of
+    bytes.
+    
+    
+    
+ 2026- 7- 20 Radoslaw Smigielski <rsmigiel@redhat.com>
+    
+    tests: add comprehensive domain configuration tests
+    Add few new tests in test_domain_config.py covering domain attributes,
+    autostart, scheduler parameters, memory, vCPUs, block/network stats,
+    CPU stats, suspend/resume, metadata, blkio and NUMA parameters.
+    
+    
+    
+ 2026- 7- 10 Radoslaw Smigielski <rsmigiel@redhat.com>
+    
+    tests: add few new tests for domain lifecycle operations
+    Add new test file test_domain_lifecycle.py with 30 functional tests
+    covering domain lifecycle operations. This significantly expands test
+    coverage beyond the existing 2 basic tests in test_domain.py.
+    
+    All new tests use the test:///default driver.
+    
+    These tests verify that Python bindings work correctly with various
+    parameters and edge cases, not only that the bindings exist.
+    
+    
+    
+ 2026- 7- 9 Radoslaw Smigielski <rsmigiel@redhat.com>
+    
+    tests: run tox tests in parallel
+    Use `tox run-parallel` instead of `tox` in the test target so all
+    Python versions are exercised concurrently.
+    And significantly reduces tox execution time.
+    
+    
+    
+ 2026- 7- 8 Radoslaw Smigielski <rsmigiel@redhat.com>
+    
+    docs: add explicit install instructions for pytest and tox in README
+    Add dnf and pip install commands for both pytest and tox to the testing
+    section of the README, making it clear how to obtain the required tools
+    before running the test suite.
+    
+    
+    
+ 2026- 7- 8 Jiri Denemark <jdenemar@redhat.com>
+    
+    Post-release version bump to 12.6.0
+    
+    
+ 2026- 7- 8 Radoslaw Smigielski <rsmigiel@redhat.com>
+    
+    python: Add support for free-threaded no-GIL CPython
+    This is an initial commit to add support for:
+    - Python 3.13 (python3.13t)
+    - Python 3.14 (python3.14t)
+    
+    Both python3.13t and python3.14t do not support the Stable C API,
+    so the only way to get libvirt-python working with no-GIL Python
+    is to fall back to the Python Unstable C API. This is the approach
+    taken in this change.
+    
+    As the Python community plans to add Stable C API support in Python
+    3.15+, we can switch back to it from 3.15 onwards. However, for
+    3.13 and 3.14, we must use the Unstable C API.
+    (Ref: https://docs.python.org/3/c-api/unstable.html)
+    
+    Following PEP 703 (https://peps.python.org/pep-0703/):
+    
+    1. Add dedicated tox envs: py313t, py314t.
+    2. Create dedicated env configurations for new environments.
+    This forces no-GIL execution in case any dependency tries to
+    silently turn the GIL back on.
+    
+    [testenv:py313t] with basepython = python3.13t
+    [testenv:py314t] with basepython = python3.14t
+    
+    3. Explicitly use the free-threaded interpreters and only set
+    PYTHON_GIL=0 inside the virtualenv.
+    4. Add documentation warning against exporting PYTHON_GIL=0 in the
+    shell before running tox. Doing so affects the Python instance
+    that launches tox itself, not just the test venv.
+    
+    Fixes: https://gitlab.com/libvirt/libvirt-python/-/work_items/22
+    
+    
+ 2026- 7- 3 Radoslaw Smigielski <rsmigiel@redhat.com>
+    
+    tests: add Python 3.14 to tox test environments
+    Add py314 to the envlist to support testing with Python 3.14.
+    
+    
+    
+ 2026- 7- 2 Radoslaw Smigielski <rsmigiel@redhat.com>
+    
+    docs: clarify build and test dependencies in README
+    Add missing installation instructions for required dependencies:
+    
+    - Document that the Python 'build' module must be installed before
+    running 'python3 -m build', with examples using both dnf and pip
+    - Add instruction to install test dependencies from requirements-test.txt
+    before running pytest or tox
+    
+    These additions help new contributors avoid common setup errors when
+    building and testing the libvirt Python bindings.
+    
+    
+    
  2026- 6- 9 Michal Privoznik <mprivozn@redhat.com>
     
     Add support for virDomainAnnounceInterface() API

{libvirt_python-12.5.0 → libvirt_python-12.7.0}/HACKING

@@ -36,3 +36,23 @@ hand written source files
    the virStoragePool class
  - libvirt-override-virStream.py - high level overrides in
    the virStream class
+
+
+
+    Building API Documentation
+    ==========================
+
+The Python API reference is built with Sphinx using the autodoc
+extension. Since the Python modules are generated at build time
+from XML API descriptions, the package must be compiled before
+Sphinx can import anything.
+
+  $ python -m venv docs-venv --system-site-packages --symlinks
+  $ source docs-venv/bin/activate
+  $ python -m pip install setuptools build
+  $ python -m pip install -r requirements-docs.txt
+  $ python -m build -n -x
+  $ python -m pip install dist/libvirt_python*.whl
+  $ python -m sphinx -b html docs/ py_api_docs
+
+The rendered HTML will be in the py_api_docs/ directory.

{libvirt_python-12.5.0 → libvirt_python-12.7.0}/Makefile

@@ -16,7 +16,7 @@ check: all
 	tox -e py$(VERSION)
 
 test: all
-	tox
+	tox run-parallel
 
 rpm: all
 	rpmbuild -ta dist/libvirt[-_]python-$(shell tr -d '\n' < VERSION).tar.gz

{libvirt_python-12.5.0 → libvirt_python-12.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: libvirt-python
-Version: 12.5.0
+Version: 12.7.0
 Summary: The libvirt virtualization API python binding
 Home-page: http://www.libvirt.org
 Maintainer: Libvirt Maintainers
@@ -9,7 +9,7 @@ License: LGPL-v2.0-or-later
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3 :: Only
-Requires-Python: >=3.6
+Requires-Python: >=3.9
 Description-Content-Type: text/x-rst
 License-File: COPYING
 Dynamic: license-file
@@ -36,6 +36,14 @@ Requirements
 To build the libvirt python binary requires the GCC and pkg-config
 tools, and development headers for the libvirt and python libraries.
 
+Additionally, the Python build module is required and can be installed via:
+
+  $ dnf install python3-build
+
+or
+
+  $ python3 -m pip install --user build
+
 Building and installing
 -----------------------
 
@@ -54,8 +62,29 @@ without explicit building.
 In order to test the package, you'll need either tox or at least pytest,
 depending on whether you want to test an already installed package in which
 case the latter is sufficient or if you wish to test in a virtual
-environment you'd need tox. Depending on your preferred setup, you can run the
-tests either as
+environment you'd need tox.
+
+To install pytest, use one of:
+
+  $ dnf install python3-pytest
+
+or
+
+  $ python3 -m pip install --user pytest
+
+To install tox, use one of:
+
+  $ dnf install python3-tox
+
+or
+
+  $ python3 -m pip install --user tox
+
+Additionally, install the remaining test dependencies:
+
+  $ python3 -m pip install -r requirements-test.txt
+
+Depending on your preferred setup, you can run the tests either as
 
   $ python3 -m pytest
 
@@ -63,6 +92,10 @@ or as
 
   $ tox
 
+Free-threaded Python (py313t, py314t) test environments require tox>=4.26
+and the corresponding free-threaded interpreters (python3.13t, python3.14t)
+to be installed.
+
 A makefile shim is also provided for your convenience, so that you don't have
 to care about the exact operations mentioned above and instead you simply do
 

{libvirt_python-12.5.0 → libvirt_python-12.7.0}/README

@@ -20,6 +20,14 @@ Requirements
 To build the libvirt python binary requires the GCC and pkg-config
 tools, and development headers for the libvirt and python libraries.
 
+Additionally, the Python build module is required and can be installed via:
+
+  $ dnf install python3-build
+
+or
+
+  $ python3 -m pip install --user build
+
 Building and installing
 -----------------------
 
@@ -38,8 +46,29 @@ without explicit building.
 In order to test the package, you'll need either tox or at least pytest,
 depending on whether you want to test an already installed package in which
 case the latter is sufficient or if you wish to test in a virtual
-environment you'd need tox. Depending on your preferred setup, you can run the
-tests either as
+environment you'd need tox.
+
+To install pytest, use one of:
+
+  $ dnf install python3-pytest
+
+or
+
+  $ python3 -m pip install --user pytest
+
+To install tox, use one of:
+
+  $ dnf install python3-tox
+
+or
+
+  $ python3 -m pip install --user tox
+
+Additionally, install the remaining test dependencies:
+
+  $ python3 -m pip install -r requirements-test.txt
+
+Depending on your preferred setup, you can run the tests either as
 
   $ python3 -m pytest
 
@@ -47,6 +76,10 @@ or as
 
   $ tox
 
+Free-threaded Python (py313t, py314t) test environments require tox>=4.26
+and the corresponding free-threaded interpreters (python3.13t, python3.14t)
+to be installed.
+
 A makefile shim is also provided for your convenience, so that you don't have
 to care about the exact operations mentioned above and instead you simply do
 

libvirt_python-12.7.0/VERSION

@@ -0,0 +1 @@
+12.7.0

{libvirt_python-12.5.0 → libvirt_python-12.7.0}/build/libvirt_python.egg-info/SOURCES.txt

@@ -55,6 +55,9 @@ tests/test_api_coverage.py
 tests/test_conn.py
 tests/test_domain.py
 tests/test_domain_checkpoint.py
+tests/test_domain_config.py
+tests/test_domain_lifecycle.py
+tests/test_domain_migration.py
 tests/test_domain_snapshot.py
 tests/test_interface.py
 tests/test_network.py

{libvirt_python-12.5.0 → libvirt_python-12.7.0}/examples/domstart.py

@@ -7,13 +7,12 @@ If the domain is not running, create it.
 import libvirt
 import libxml2
 from argparse import ArgumentParser
-from typing import Tuple
 
 
 # Parse the XML description of domU from FNAME
 # and return a tuple (name, xmldesc) where NAME
 # is the name of the domain, and xmldesc is the contetn of FNAME
-def read_domain(fname: str) -> Tuple[str, str]:
+def read_domain(fname: str) -> tuple[str, str]:
     fp = open(fname, "r")
     xmldesc = fp.read()
     fp.close()

{libvirt_python-12.5.0 → libvirt_python-12.7.0}/examples/esxlist.py

@@ -8,7 +8,7 @@ import libvirt
 import libxml2
 import getpass
 from argparse import ArgumentParser
-from typing import Any, List
+from typing import Any
 
 
 # This is the callback method passed to libvirt.openAuth() (see below).
@@ -25,7 +25,7 @@ from typing import Any, List
 #
 # The user_data argument is the user data item of the auth argument (see below)
 # passed to libvirt.openAuth().
-def request_credentials(credentials: List[List], user_data: Any) -> int:
+def request_credentials(credentials: list[list], user_data: Any) -> int:
     for credential in credentials:
         if credential[0] == libvirt.VIR_CRED_AUTHNAME:
             # prompt the user to input a authname. display the provided message

{libvirt_python-12.5.0 → libvirt_python-12.7.0}/examples/event-test.py

@@ -14,7 +14,7 @@ import errno
 import time
 import threading
 from argparse import ArgumentParser
-from typing import Any, Callable, Dict, List, Optional, TypeVar  # noqa F401
+from typing import Any, Callable, Optional, TypeVar  # noqa F401
 _T = TypeVar("_T")
 _EventCallback = Callable[[int, int, int, _T], None]
 _TimerCallback = Callable[[int, _T], None]
@@ -114,8 +114,8 @@ class virEventLoopPoll:
         self.runningPoll = False
         self.nextHandleID = 1
         self.nextTimerID = 1
-        self.handles = []  # type: List[virEventLoopPollHandle]
-        self.timers = []  # type: List[virEventLoopPollTimer]
+        self.handles = []  # type: list[virEventLoopPollHandle]
+        self.timers = []  # type: list[virEventLoopPollTimer]
         self.cleanup = []
         self.quit = False
 
@@ -603,7 +603,7 @@ def myDomainEventBlockJob2Callback(conn: libvirt.virConnect, dom: libvirt.virDom
         dom.name(), dom.ID(), BLOCK_JOB_TYPES[type], disk, BLOCK_JOB_STATUS[status]))
 
 
-def myDomainEventTunableCallback(conn: libvirt.virConnect, dom: libvirt.virDomain, params: Dict[str, Any], opaque: _T) -> None:
+def myDomainEventTunableCallback(conn: libvirt.virConnect, dom: libvirt.virDomain, params: dict[str, Any], opaque: _T) -> None:
     print("myDomainEventTunableCallback: Domain %s(%s) %s" % (
         dom.name(), dom.ID(), params))
 
@@ -623,7 +623,7 @@ def myDomainEventMigrationIteration(conn: libvirt.virConnect, dom: libvirt.virDo
         dom.name(), dom.ID(), iteration))
 
 
-def myDomainEventJobCompletedCallback(conn: libvirt.virConnect, dom: libvirt.virDomain, params: Dict[str, Any], opaque: _T) -> None:
+def myDomainEventJobCompletedCallback(conn: libvirt.virConnect, dom: libvirt.virDomain, params: dict[str, Any], opaque: _T) -> None:
     print("myDomainEventJobCompletedCallback: Domain %s(%s) %s" % (
         dom.name(), dom.ID(), params))
 

{libvirt_python-12.5.0 → libvirt_python-12.7.0}/examples/nodestats.py

@@ -7,7 +7,7 @@
 import libvirt
 from xml.dom import minidom
 import libxml2
-from typing import Any, Dict  # noqa F401
+from typing import Any  # noqa F401
 
 
 def xpath_eval(ctxt, path: str) -> str:
@@ -52,7 +52,7 @@ domsStrict = [
     if proc.numaParameters()["numa_mode"] == libvirt.VIR_DOMAIN_NUMATUNE_MEM_STRICT
 ]
 
-domsStrictCfg = {}  # type: Dict[libvirt.virDomain, Dict[str, Dict[str, Any]]]
+domsStrictCfg = {}  # type: dict[libvirt.virDomain, dict[str, dict[str, Any]]]
 for dom in domsStrict:
     xmlStr = dom.XMLDesc()
     doc = libxml2.parseDoc(xmlStr)