openstack
/
deb-python-xvfbwrapper
Code Issues Proposed changes

updated README

This commit is contained in:
Corey Goldberg 2012-11-18 12:15:32 -05:00
parent fa0a091197
commit 0ba1e22e46
1 changed files with 31 additions and 24 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

37
README.rst
View File

@ -2,22 +2,22 @@
xvfbwrapper
===============
Python wrapper for running display inside X virtual framebuffer (Xvfb)
Python wrapper for running a display inside X virtual framebuffer (Xvfb)
* Home: http://cgoldberg.github.com/xvfbwrapper
* PyPI: http://pypi.python.org/pypi/xvfbwrapper
* Dev: https://github.com/cgoldberg/xvfbwrapper
----
***
*********************************
Install xvfbwrapper from PyPI
*********************************
*****************************
Install xvfbwrapper from PyPI
*****************************
::
pip install xvfbwrapper
****
**************************************
About Xvfb (X Virtual Framebuffer)
@ -25,6 +25,8 @@ Python wrapper for running display inside X virtual framebuffer (Xvfb)
In the X Window System, Xvfb or X virtual framebuffer is an X11 server that performs all graphical operations in memory, not showing any screen output. This virtual server does not require the computer it is running on to even have a screen or any input device. Only a network layer is necessary.
****
***********************
System Requirements
***********************
@ -32,12 +34,13 @@ In the X Window System, Xvfb or X virtual framebuffer is an X11 server that perf
* Xvfb (`sudo apt-get install xvfb`, or similar)
* Python 2
****
************************
Example: Basic Usage
************************
::
from xvfbwrapper import Xvfb
vdisplay = Xvfb()
@ -47,20 +50,19 @@ In the X Window System, Xvfb or X virtual framebuffer is an X11 server that perf
vdisplay.stop()
****************************************************
Example: Headless Selenium WebDriver and Firefox
****************************************************
****
* install selenium bindings: `pip install selenium`
* Firefox will launch inside virtual display (headless)
* browser is not shown while test is run
**********************************************
Example: Headless Selenium WebDriver Tests
**********************************************
::
#!/usr/bin/env python
from selenium import webdriver
from xvfbwrapper import Xvfb
import unittest
from selenium import webdriver
class TestHomepages(unittest.TestCase):
@ -85,5 +87,10 @@ In the X Window System, Xvfb or X virtual framebuffer is an X11 server that perf
if __name__ == '__main__':
unittest.main(verbosity=2)
----
This code uses `selenium` and `xvfbwrapper` to run a test with Firefox inside a Headless display.
* install selenium bindings: `pip install selenium`
* Firefox will launch inside virtual display (headless)
* browser is not shown while tests are run
****