pyramid_perfstat / README.txt

tuck cab2241 



tuck 38e0bbd 

tuck e05866b 


tuck 38e0bbd 
tuck e05866b 


tuck 38e0bbd 











tuck 59e05b7 
tuck e05866b 
















tuck 59e05b7 























PYRAMID_PERFSTAT
================

pyramid_perstat application depends on **pyramid** (a light webframework)
see : http://www.pylonsproject.org/ for more information

In fact this application is a pyramid tween
( look at http://docs.pylonsproject.org/projects/pyramid/en/1.3-branch/whatsnew-1.2.html?highlight=tween
for more information). It surrounds your webapp in order to measure performance over time.

Pyramid_debugtoolbar is a very good tween to analyze the code and measure the performance of a view. It's very accurate and
it adds a very unique exposure of youre code. Pyramid perfstat try to record each request and its execution time and some other stuff
(average queries count per request etc ...). Thus it can display averages by view or route. This gives you an overview of your
application in order to quickly determine its points of improvement.

For the moment it's only tested with pyramid route dispatch scaffold.

Please feel free to 

             - test it
             - use it
             - enjoy it
             - improve it :)

it's published under BSD licence.

Note :
======

     if you use a previous version of pyramid_perfstat please
     remove perf_app.db before updating pyramid_perfstat.
     0.2 version is incompatible with the structure of the previous base.

     Look at changes for more information.

Requirement :
=============


     - pyramid 1.2>

Usage :
=======

it's have been tested with pythons dependencies of pyramid.

change your development.ini to add this line

development.ini ::

       pyramid.includes = pyramid_perfstat
                          pyramid_tm

instead of usual .ini file

development.ini ::

       pyramid.includes = pyramid_debugtoolbar
                          pyramid_tm

And that's all.  After a few uses of your favorite application,
thank you go to the following URL to see some statistics :

pyramid_perfstat doesn't filter url so feel free to use localhost
or whatever ip:port you're using :

http://localhost:6543/__perfstat/stat
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.