libvirt

mirror of https://gitlab.com/libvirt/libvirt.git synced 2024-12-22 21:55:25 +00:00

History

Martin Kletzander 9943276fd2 Cleanup for a return statement in source files Return statements with parameter enclosed in parentheses were modified and parentheses were removed. The whole change was scripted, here is how: List of files was obtained using this command: git grep -l -e '\<return\s([^()]$([^()])[^()]$)\s;' \| \ grep -e '\.[ch]$' -e '\.py$' Found files were modified with this command: sed -i -e \ 's_^$.\<return$\s($\([^()]([^()])[^()]$\))\s$;.$$_\1 \2\4_' \ -e 's_^$.\<return$\s($[^()]$)\s$;.$$_\1 \2\3_' Then checked for nonsense. The whole command looks like this: git grep -l -e '\<return\s([^()]$([^()])[^()]$)\s;' \| \ grep -e '\.[ch]$' -e '\.py$' \| xargs sed -i -e \ 's_^$.\<return$\s($\([^()]([^()])[^()]$\))\s$;.$$_\1 \2\4_' \ -e 's_^$.\<return$\s($[^()]$)\s$;.$$_\1 \2\3_'		2012-03-26 14:45:22 -06:00
..
tests	maint: add missing copyright notices	2011-07-28 15:01:17 -06:00
generator.py	Cleanup for a return statement in source files	2012-03-26 14:45:22 -06:00
libvirt-override-api.xml	python: add virDomainGetCPUStats python binding API	2012-03-22 10:55:48 -04:00
libvirt-override-virConnect.py	Add support for the suspend event	2012-03-23 23:12:18 +08:00
libvirt-override-virStream.py	python: correct a copy-paste error	2012-02-01 10:26:57 +01:00
libvirt-override.c	Cleanup for a return statement in source files	2012-03-26 14:45:22 -06:00
libvirt-override.py	Fix two comments related to error handling	2011-10-17 17:21:56 +02:00
libvirt-qemu-override-api.xml	qemu_api: Add override XML and C files for QEMU APIs	2011-09-14 11:38:51 +08:00
libvirt-qemu-override.c	Cleanup for a return statement in source files	2012-03-26 14:45:22 -06:00
Makefile.am	pyhton: Don't link against libvirt_util.la	2012-02-07 13:30:42 +01: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	Cleanup for a return statement in source files	2012-03-26 14:45:22 -06:00
typewrappers.h	python: drop redundant function	2012-02-03 10:41:44 -07:00

README

    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