НАЗВА

       guestfs-python — як використовувати libguestfs з Python

КОРОТКИЙ ОПИС

        import guestfs
        g = guestfs.GuestFS(python_return_dict=True)
        g.add_drive_opts("disk.img", format="raw", readonly=1)
        g.launch()

ОПИС

       На цій сторінці підручника наведено документацію щодо викликів libguestfs з коду мовою
       програмування Python. На сторінці задокументовано відмінності від програмного інтерфейсу C
       та подано декілька прикладів. Якщо ви не дуже знайомі із користуванням libguestfs, вам
       також слід прочитати підручник з guestfs(3).

   python_return_dict=True
       Увесь новий код має будувати дескриптор за допомогою такого:

        g = guestfs.GuestFS(python_return_dict=True)

       Це вказує на те, що ваша програма потребує отримання словників Python для методів у
       програмному інтерфейсі, які повертають таблиці хешів.

       У майбутніх версіях libguestfs цей спосіб має стати типовим.

   ВИНЯТКИ
       Помилки від функцій libguestfs пов'язуються із "RuntimeException" з єдиним рядковим
       аргументом, яким є текст повідомлення про помилку.

   ДОДАТКОВА ДОКУМЕНТАЦІЯ
       Тип:

        $ python
        >>> import guestfs
        >>> help(guestfs)

   КОРИСТУВАННЯ ПРИВ'ЯЗКАМИ ДО PYTHON У ВІРТУАЛЬНОМУ СЕРЕДОВИЩІ
       Ці прив'язки недоступні у pypi через проблеми із ліцензуванням. За станом розв'язання
       проблем можна слідкувати тут: https://bugzilla.redhat.com/1075594.

       Втім, ми оприлюднюємо дистрибутив Python для вибраних стабільних версій libguestfs на
       http://libguestfs.org/download/python. Ви можете скористатися ним за допомогою такої
       команди:

        pip install http://libguestfs.org/download/python/guestfs-1.XX.YY.tar.gz

ПРИКЛАД 1. СТВОРЕННЯ ОБРАЗУ ДИСКА

       @EXAMPLE1@

ПРИКЛАД 2. ПЕРЕВІРКА ОБРАЗУ ДИСКА ВІРТУАЛЬНОЇ МАШИНИ

       @EXAMPLE2@

ТАКОЖ ПЕРЕГЛЯНЬТЕ

       guestfs(3), guestfs-examples(3), guestfs-erlang(3), guestfs-gobject(3), guestfs-golang(3),
       guestfs-java(3), guestfs-lua(3), guestfs-ocaml(3), guestfs-perl(3), guestfs-recipes(1),
       guestfs-ruby(3), http://libguestfs.org/.

АВТОРИ

       Richard W.M. Jones ("rjones at redhat dot com")

АВТОРСЬКІ ПРАВА

       © Red Hat Inc., 2010–2012

LICENSE

BUGS

       To get a list of bugs against libguestfs, use this link:
       https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools

       To report a new bug against libguestfs, use this link:
       https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools

       When reporting a bug, please supply:

       •   The version of libguestfs.

       •   Where you got libguestfs (eg. which Linux distro, compiled from source, etc)

       •   Describe the bug accurately and give a way to reproduce it.

       •   Run libguestfs-test-tool(1) and paste the complete, unedited output into the bug
           report.