editor/libeditor/html/tests/browserscope/lib/richtext2/README@7e26c7da4463 (annotated)
editor/libeditor/html/tests/browserscope/lib/richtext2/README
Wed, 31 Dec 2014 06:55:50 +0100
- author
- Michael Schloh von Bennewitz <michael@schloh.com>
- date
- Wed, 31 Dec 2014 06:55:50 +0100
- changeset 2
- 7e26c7da4463
- permissions
- -rw-r--r--
Added tag UPSTREAM_283F7C6 for changeset ca08bd8f51b2
| michael@0 | 1 | README FOR BROWSERSCOPE |
| michael@0 | 2 | ----------------------- |
| michael@0 | 3 | |
| michael@0 | 4 | Hey there - thanks for downloading the code. This file has instructions |
| michael@0 | 5 | for getting setup so that you can run the codebase locally. |
| michael@0 | 6 | |
| michael@0 | 7 | This project is built on Google App Engine using the |
| michael@0 | 8 | Django web application framework and written in Python. |
| michael@0 | 9 | |
| michael@0 | 10 | To get started, you'll need to first download the App Engine SDK at: |
| michael@0 | 11 | http://code.google.com/appengine/downloads.html |
| michael@0 | 12 | |
| michael@0 | 13 | For local development, just startup the server: |
| michael@0 | 14 | ./pathto/google_appengine/dev_appserver.py --port=8080 browserscope |
| michael@0 | 15 | |
| michael@0 | 16 | You should then be able to access the local application at: |
| michael@0 | 17 | http://localhost:8080/ |
| michael@0 | 18 | |
| michael@0 | 19 | Note: the first time you hit the homepage it may take a little |
| michael@0 | 20 | while - that's because it's trying to read out median times for all |
| michael@0 | 21 | of the tests from a nonexistent datastore and write to memcache. |
| michael@0 | 22 | Just be a lil patient. |
| michael@0 | 23 | |
| michael@0 | 24 | You can run the unit tests at: |
| michael@0 | 25 | http://localhost:8080/test |
| michael@0 | 26 | |
| michael@0 | 27 | |
| michael@0 | 28 | CONTRIBUTING |
| michael@0 | 29 | ------------------ |
| michael@0 | 30 | |
| michael@0 | 31 | Most likely you are interested in adding new tests or creating |
| michael@0 | 32 | a new test category. If you are interested in adding tests to an existing |
| michael@0 | 33 | "category" you may want to get in touch with the maintainer for that |
| michael@0 | 34 | branch of the tree. We are really looking forward to receiving your |
| michael@0 | 35 | code in patch format. Currently the category maintainers are: |
| michael@0 | 36 | Network: Steve Souders <souders@gmail.com> |
| michael@0 | 37 | Reflow: Lindsey Simon <elsigh@gmail.com> |
| michael@0 | 38 | Security: Adam Barth <adam@adambarth.com> and Collin Jackson <collin@collinjackson.com> |
| michael@0 | 39 | |
| michael@0 | 40 | |
| michael@0 | 41 | To create a completely new test category: |
| michael@0 | 42 | * Copy one of the existing directories in categories/ |
| michael@0 | 43 | * Edit your test_set.py, handlers.py |
| michael@0 | 44 | * Add your files in templates/ and static/ |
| michael@0 | 45 | * Update urls.py and settings.CATEGORIES |
| michael@0 | 46 | * Follow the examples of other tests re: |
| michael@0 | 47 | * beaconing using/testdriver_base |
| michael@0 | 48 | * your GetScoreAndDisplayValue method |
| michael@0 | 49 | * your GetRowScoreAndDisplayValue method |
| michael@0 | 50 | |
| michael@0 | 51 | References: |
| michael@0 | 52 | * App Engine Docs - http://code.google.com/appengine/docs/python/overview.html |
| michael@0 | 53 | * App Engine Group - http://groups.google.com/group/google-appengine |
| michael@0 | 54 | * Python Docs - http://www.python.org/doc/ |
| michael@0 | 55 | * Django - http://www.djangoproject.com/ |
| michael@0 | 56 | |
| michael@0 | 57 | |
| michael@0 | 58 |
