libvirt/python
Guannan Ren 2832663f59 python: cleanup vcpu related binding APIs
libvirt_virDomainGetVcpus: add error handling, return -1 instead of None
libvirt_virDomainPinVcpu and libvirt_virDomainPinVcpuFlags:
  check the type of argument
  make use of libvirt_boolUnwrap

  Set bitmap according to these values which are contained in given
  argument of vcpu tuple and turn off these bit corresponding to
  missing vcpus in argument tuple

  The original way ignored the error info from PyTuple_GetItem
  if index is out of range.
  "IndexError: tuple index out of range"
  The error message will only be raised on next command in interactive mode.
2012-10-08 21:53:58 +08:00
..
tests python: Fix doc directory name for stable releases 2012-04-27 12:41:05 -04:00
generator.py node_memory: Define the APIs to get/set memory parameters 2012-09-17 13:49:44 +08:00
libvirt-override-api.xml node_memory: Expose the APIs to Python bindings 2012-09-17 13:55:46 +08:00
libvirt-override-virConnect.py list: Expose virConnectListAllSecrets to Python binding 2012-09-17 13:18:51 +08:00
libvirt-override-virDomain.py list: provide python bindings for snapshots 2012-06-19 13:50:03 -06:00
libvirt-override-virDomainSnapshot.py list: provide python bindings for snapshots 2012-06-19 13:50:03 -06:00
libvirt-override-virStoragePool.py list: Expose virStoragePoolListAllVolumes to Python binding 2012-09-10 10:41:18 +08:00
libvirt-override-virStream.py python: correct a copy-paste error 2012-02-01 10:26:57 +01:00
libvirt-override.c python: cleanup vcpu related binding APIs 2012-10-08 21:53:58 +08:00
libvirt-override.py Fix two comments related to error handling 2011-10-17 17:21:56 +02:00
libvirt-qemu-override-api.xml agent: add python module support 2012-08-23 19:07:53 +08:00
libvirt-qemu-override.c agent: add python module support 2012-08-23 19:07:53 +08:00
Makefile.am list: provide python bindings for snapshots 2012-06-19 13:50:03 -06:00
README Re-arrange python generator to make it clear what's auto-generated 2009-09-21 14:41:46 +01:00
TODO syntax-check: enforce the no-cvs-keywords prohibition 2008-12-15 10:24:54 +00:00
typewrappers.c python: return error if PyObject obj is NULL for unwrapper helper functions 2012-09-28 16:43:12 +08:00
typewrappers.h python: Add new helper functions for python to C integral conversion 2012-03-28 08:42:40 -06:00

    libvirt Python Bindings README
    ==============================

Most of the libvirt python binding code is automatically generated
using the script  generator.py, and the API description from
docs/libvirt-api.xml


Manually written files:

 - libvirt-override.c: methods where the C binding needs to be hand crafted
 - libvirt-override.py: global methods where the C and python bindings have different args
 - libvirt-override-api.xml: methods where the auto-extracted API docs are not
   suitable for python auto-generator. Overriding this if the method is going
   into libvirt-override.c, but we still want auto-generated libvirt-override.py
 - libvirt-override-virConnect.py: virConnect class methods
 - typewrappers.h,.c: Python object wrappers for each libvirt C object


Auto-generated files:

  - libvirt.py: The main python binding. Comprises auto-generated code, along
    with contents from libvirt-override.py and libvirt-override-virConnect.py
  - libvirt.c, libvirt.h: The C glue layer for the python binding. Comprises
    auto-generated code, along with libvirt-override.c
  - libvirt-export.c: List of auto-generated C methods, included into
    the libvirt-override.c method table