Deform form generation framework demo application
Python CSS HTML Other
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
deformdemo
.bzrignore Commit forgotten .bzrignore. Apr 10, 2010
.gitignore Python 2 yippee Nov 19, 2016
.hgignore
.travis.yml Make deformdemo packag also run tests using Flaky. Nov 19, 2016
CHANGES.txt render Jul 2, 2011
CONTRIBUTING.txt Added contribution instructions. Jun 5, 2016
CONTRIBUTORS.txt Add myself to contributors Oct 22, 2016
COPYRIGHT.txt first cut at separating deformdemo from deform itself Jul 2, 2011
LICENSE.txt first cut at separating deformdemo from deform itself Jul 2, 2011
MANIFEST.in
README.rst Add travis status Oct 22, 2016
bootstrap.py add buildout for running on bahia Oct 5, 2013
buildout.cfg pin to 2.35.0 Oct 25, 2013
demo.ini Use a fixed renderer set up Feb 11, 2017
i18n.sh add i18n.sh script Feb 8, 2017
mini.ini add logging setup to ini files Feb 8, 2017
setup.cfg get rid of duplicate aliases section as per issue #27 Oct 9, 2013
setup.py More coverage to select widget tests. Nov 14, 2016

README.rst

Deform Demo

https://travis-ci.org/Pylons/deformdemo.png?branch=master

Demonstration application for the Deform Python HTML form library. Please see http://deformdemo.repoze.org for a running version of this application.

Running the Demo

  • Create a virtualenv:

    $ virtualenv2.7 --no-site-packages /path/to/my/venv
    

    Hereafter /path/to/my/venv will be referred to as $VENV in steps below.

  • Get a checkout of deformdemo:

    $ git clone git://github.com/Pylons/deformdemo.git
    
  • cd to the newly checked out deformdemo package:

    $ cd deformdemo
    
  • Run setup.py dev using the virtualenv's python command:

    $ $VENV/bin/python setup.py dev
    
  • While your working directory is still deformdemo, start the demo application:

    $ $VENV/bin/pserve demo.ini
    
  • Visit http://localhost:8522 in a browser to see the demo.

Running the Demo's Selenium Tests

The deformdemo application serves as a target for functional testing during Deform's development. A suite of Selenium tests may be run against a local instance of the demonstration application. It is wise to run these tests before submitting a patch. Here's how:

  • Start the deformdemo application as described above in "Running the Demo". Leave the terminal window running this application open, and open another terminal window to perform the below steps.

  • In the other terminal window, cd to the "deformdemo" checkout directory you created above in "Running the Demo":

    $ cd /path/to/my/deformdemo/checkout
    
  • Run the tests:

    $ $VENV/bin/nosetests
    

    $VENV is defined as it was in "Running the Demo" above.

  • You will (hopefully) see Firefox pop up and it will begin to display in quick succession the loading of pages in the bottom window and some test output in the top window. The tests will run for five or ten minutes.

  • Test success means that the console window on which you ran nosetests shows a bunch of dots, a test summary, then OK. If it shows a traceback, FAILED, or anything other than a straight line of dots, it means there was an error.

  • Fix any errors by modifying your code or by modifying the tests to expect the changes you've made.

Testing an Alternate Renderer Implementation

  • Copy the demo.ini file from this demo package to your renderer's package.
  • Change the deform.renderer key in the demo.ini copy to point at your renderer (it's a Python dotted name).
  • Run pserve /path/to/your/copy/of/demo.ini.
  • Run the selenium tests as above.