PyVirtualDisplay 0.0.3

python wrapper for Xvfb and Xephyr

PyVirtualDisplay is a python wrapper for Xvfb_ and Xephyr_

home: https://github.com/ponty/PyVirtualDisplay

documentation: http://ponty.github.com/PyVirtualDisplay

Possible applications:
* GUI testing
* automatic GUI screenshot

Basic usages
============

Start Xephyr::

from pyvirtualdisplay import Display
xephyr=Display(visible=1, size=(320, 240)).start()

Create screenshot of xmessage with Xvfb::

from easyprocess import EasyProcess
from pyvirtualdisplay.smartdisplay import SmartDisplay
disp = SmartDisplay(visible=0, bgcolor='black').start()
xmessage = EasyProcess('xmessage hello').start()
img = disp.waitgrab()
xmessage.stop()
disp.stop()
img.show()

Installation
============

General
--------

* install Xvfb_ and Xephyr_.
* install setuptools_ or pip_
* optional: pyscreenshot_ and PIL_ should be installed for :mod:`pyvirtualdisplay.smartdisplay`
* install the program:

if you have setuptools_ installed::

# as root
easy_install PyVirtualDisplay

if you have pip_ installed::

# as root
pip install PyVirtualDisplay

Ubuntu
----------
::

sudo apt-get install python-setuptools
sudo apt-get install xvfb
sudo apt-get install xserver-xephyr
sudo easy_install PyVirtualDisplay
# optional
sudo apt-get install python-imaging
sudo apt-get install scrot
sudo easy_install pyscreenshot


Uninstall
----------
::

# as root
pip uninstall PyVirtualDisplay


.. _setuptools: http://peak.telecommunity.com/DevCenter/EasyInstall
.. _pip: http://pip.openplans.org/
.. _Xvfb: http://en.wikipedia.org/wiki/Xvfb
.. _Xephyr: http://en.wikipedia.org/wiki/Xephyr
.. _pyscreenshot: https://github.com/ponty/pyscreenshot
.. _PIL: http://www.pythonware.com/library/pil/