Sat, 03 Jan 2015 20:18:00 +0100
Conditionally enable double key logic according to:
private browsing mode or privacy.thirdparty.isolate preference and
implement in GetCookieStringCommon and FindCookie where it counts...
With some reservations of how to convince FindCookie users to test
condition and pass a nullptr when disabling double key logic.
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 |