moved package to the root of the repository for easier setup

Also included a new QtBot method, stopForInteraction

Author: nicoddemus

.gitignore

@@ -1,3 +1,8 @@
 *.pyc
 __pycache__
 *.log
+/distribute-0.6.35.tar.gz
+/distribute-0.6.35-py2.7.egg
+/pytest_qt.egg-info
+/build
+/dist

.pydevproject

@@ -3,6 +3,6 @@
 <pydev_property name="org.python.pydev.PYTHON_PROJECT_INTERPRETER">Default</pydev_property>
 <pydev_property name="org.python.pydev.PYTHON_PROJECT_VERSION">python 2.7</pydev_property>
 <pydev_pathproperty name="org.python.pydev.PROJECT_SOURCE_PATH">
-<path>/pytest-qt/src</path>
+<path>/pytest-qt</path>
 </pydev_pathproperty>
 </pydev_project>

docs/conf.py

@@ -16,7 +16,7 @@
 # If extensions (or modules to document with autodoc) are in another directory,
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
-sys.path.insert(0, os.path.abspath('../src'))
+sys.path.insert(0, os.path.abspath('..'))
 
 # -- General configuration -----------------------------------------------------
 
@@ -47,10 +47,11 @@
 # |version| and |release|, also used in various other places throughout the
 # built documents.
 #
+import pytestqt
 # The short X.Y version.
-version = '0.2.0'
+version = pytestqt.version
 # The full version, including alpha/beta/rc tags.
-release = '0.2.0'
+release = pytestqt.release
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

src/pytestqt/__init__.py renamed to pytestqt/__init__.py

@@ -20,4 +20,9 @@ def test_hello(qtbot):
 .. _PySide: https://pypi.python.org/pypi/PySide
 .. _PyQt: http://www.riverbankcomputing.com/software/pyqt
 
-'''
+'''
+
+# The short X.Y version.
+version = '0.3'
+# The full version, including alpha/beta/rc tags.
+release = '0.3'

src/pytestqt/_tests/__init__.py renamed to pytestqt/_tests/__init__.py

@@ -17,10 +17,12 @@ class QtBot(object):
     
     .. automethod:: addWidget
     .. automethod:: waitForWindowShown
+    .. automethod:: stopForInteraction
 
-    **QTest API**
+    **Raw QTest API**
     
-    Methods below are forwarded directly to the `QTest API`_. Consult documentation for more
+    Methods below provide very low level functions, as sending a single mouse click or a key event.
+    Thos methods are just forwarded directly to the `QTest API`_. Consult the documentation for more
     information.
     
     ---
@@ -87,7 +89,7 @@ class QtBot(object):
             * ``Qt.LeftButton``: The left button is pressed, or an event refers to the left button. (The left button may be the right button on left-handed mice.)
             * ``Qt.RightButton``: The right button.
             * ``Qt.MidButton``: The middle button.
-            * ``Qt.MiddleButton``: he middle button.
+            * ``Qt.MiddleButton``: The middle button.
             * ``Qt.XButton1``: The first X button.
             * ``Qt.XButton2``: The second X button.
             
@@ -114,7 +116,7 @@ def __init__(self, app):
 
     def _close(self):
         '''
-        Clear up method. Called at the end of each test that uses a qtbot fixture.
+        Clear up method. Called at the end of each test that uses a ``qtbot`` fixture.
         '''
         for w in self._widgets:
             w.close()
@@ -142,6 +144,25 @@ def waitForWindowShown(self, widget):
             Widget to wait on.
         '''
         QtTest.QTest.qWaitForWindowShown(widget)
+        
+        
+    def stopForInteraction(self):
+        '''
+        Stops the current test flow, letting the user interact with any visible widget.
+        
+        This is mainly useful so that you can verify the current state of the program while writing
+        tests.
+        
+        Closing the windows should resume the test run, with ``qtbot`` attempting to restore visibility
+        of the widgets as they were before this call.        
+        '''
+        widget_visibility = [widget.isVisible() for widget in self._widgets]
+        
+        self._app.exec_()    
+
+        for index, visible in enumerate(widget_visibility):
+            widget = self._widgets[index]
+            widget.setVisible(visible)
 
 
 #===================================================================================================