Metadata-Version: 1.2
Name: remotevbox
Version: 0.2.0
Summary: Simple client library to work with VirtualBox remotely
Home-page: https://github.com/ilyaglow/remote-virtualbox
Author: Ilya Glotov
Author-email: ilya@ilyaglotov.com
License: LICENSE
Description: Remote VirtualBox
        -----------------------
        
        |Build Status| |Black Indicator|
        
        About
        -----
        
        This package is intended to be simple and useful abstraction based on
        `Zeep <https://github.com/mvantellingen/python-zeep>`__ SOAP client.
        
        It doesn't depend on ancient VirtualBox Python SDK and even more ancient
        ZSI (last updated in 2006) and PyXML (thing from 2007) libraries.
        
        The initial goal was to build an easy to use
        `CuckooSandbox <https://github.com/cuckoosandbox/cuckoo>`__ machinery.
        
        VirtualBox Webservice
        ---------------------
        
        There is an official manual how to start it:
        
        https://www.virtualbox.org/manual/ch09.html#vboxwebsrv-daemon
        
        Install
        -------
        
        ::
        
            pip install remotevbox --user
        
        Development version
        ~~~~~~~~~~~~~~~~~~~
        
        `Pipenv <https://github.com/kennethreitz/pipenv>`__ is used here:
        
        ::
        
            pipenv install
        
        Usage example
        -------------
        
        .. code:: python
        
                >>> import remotevbox
                >>> vbox = remotevbox.connect("https://127.0.0.1:18083", "vbox", "yourpassphrase")
                >>> vbox.get_version()
                '5.1.30'
                >>> machine = vbox.get_machine("Windows10")
                >>> machine.launch()
                >>> machine.save()
                >>> vbox.disconnect()
        
        .. |Build Status| image:: https://travis-ci.org/ilyaglow/remote-virtualbox.svg?branch=master
           :target: https://travis-ci.org/ilyaglow/remote-virtualbox
        .. |Black Indicator| image:: https://img.shields.io/badge/code%20style-black-000000.svg
           :target: https://github.com/ambv/black
        
Keywords: virtualbox soap remote
Platform: UNKNOWN
Requires-Python: >=2.7
