|
@@ -1,45 +1,48 @@
|
|
|
-# web2py Benchmark Test
|
|
|
+# [web2py](http://www.web2py.com/) Benchmarking Test
|
|
|
|
|
|
-Main controller found [here](web2py/applications/app/controllers/default.py)
|
|
|
+This is the web2py portion of a [benchmarking tests suite](../../)
|
|
|
+comparing a variety of web development platforms.
|
|
|
|
|
|
-Database model found [here](web2py/applications/app/models/db.py)
|
|
|
+The information below is specific to web2py. For further guidance,
|
|
|
+review the [documentation](http://frameworkbenchmarks.readthedocs.org/en/latest/).
|
|
|
+Also note that there is additional information provided in
|
|
|
+the [Python README](../).
|
|
|
|
|
|
-Fortunes template found [here](web2py/applications/app/views/default/fortune.html)
|
|
|
+There are two sets of web2py tests, "web2py-standard" (the default) and "web2py-optimized". The former set is implemented via standard web2py production code. The latter involves several special optimizations that would not be typical of a web2py application but could be implemented in cases were performance is critical.
|
|
|
|
|
|
-## Description
|
|
|
+## Web Server and Database Client Software
|
|
|
|
|
|
-web2py framework (http://www.web2py.com/)
|
|
|
+* [Meinheld](http://meinheld.org/) 0.5.9
|
|
|
+* [Gunicorn](http://gunicorn.org/) 19.4.5
|
|
|
+* [greenlet](http://greenlet.readthedocs.io/en/latest/) 0.4.9
|
|
|
+* [MySQLdb](https://mysqlclient.readthedocs.io/en/latest/) 1.3.7
|
|
|
|
|
|
-### Database
|
|
|
+## Test Paths
|
|
|
|
|
|
-MySQL
|
|
|
+"web2py-standard" and "web2py-optimized" tests are accessed via the "/standard" and "/optimized" paths, respectively.
|
|
|
|
|
|
-### Server
|
|
|
+* JSON Serialization: "/standard/json", "/optimized/json"
|
|
|
+* Single Database Query: "/standard/db", "/optimized/db"
|
|
|
+* Multiple Database Queries: "/standard/dbs?queries=#", "/optimized/dbs?queries=#"*
|
|
|
+* Fortunes: "/standard/fortunes", "/optimized/fortunes"
|
|
|
+* Database Updates: "/standard/update?queries=#", "/optimized/update?queries=#"*
|
|
|
+* Plaintext: "/standard/plaintext", "/optimized/plaintext"
|
|
|
|
|
|
-* Rocket (default web2py server)
|
|
|
+*Replace # with an actual number.
|
|
|
|
|
|
-## Test URLs
|
|
|
-### JSON Encoding
|
|
|
+## Source Code
|
|
|
|
|
|
-http://localhost:8080/json
|
|
|
+* [Database connection and models](app/standard/modules/database.py)
|
|
|
+* [Controller](app/standard/modules/controller.py)
|
|
|
+* [Fortunes template](app/standard/views/fortune.html)
|
|
|
|
|
|
-### Plaintext
|
|
|
+## Get Help
|
|
|
|
|
|
-http://localhost:8080/plaintext
|
|
|
+### [Community](http://web2py.com/init/default/documentation)
|
|
|
|
|
|
-### DB
|
|
|
+* [web2py-users Google Group](https://groups.google.com/forum/#!forum/web2py)
|
|
|
+* [web2py-developers Google Group](https://groups.google.com/forum/#!forum/web2py-developers)
|
|
|
|
|
|
-http://localhost:8080/db
|
|
|
-
|
|
|
-### Query
|
|
|
-
|
|
|
-http://localhost:8080/queries?queries=2
|
|
|
-
|
|
|
-### Update
|
|
|
-
|
|
|
-http://localhost:8080/updates?queries=2
|
|
|
-
|
|
|
-### Fortune
|
|
|
-
|
|
|
-http://localhost:8080/fortune
|
|
|
+### [Resources](http://web2py.com/init/default/documentation)
|
|
|
|
|
|
+* [*web2py: Complete Reference Manual*](http://web2py.com/book)
|