tgext.minify /

Filename Size Date modified Message
tgext
37 B
658 B
2.7 KB
11 B
1.2 KB

About tgext.minify

tgext.minify is a Turbogears 2 middleware that automatically minifies your javascript and CSS and cache it. It's able to obfuscate your js too. CSS minifier based on rCSSmin by André Malo. JS minifier/obfuscator based on SlimIt by Ruslan Spivak The middleware is based on tgext.scss by Alessandro Molina

Installing

tgext.scss can be installed both from pypi or from bitbucket:

easy_install tgext.minify

should just work for most of the users

Enabling tgext.minify

If tgext.pluggable is available enabling tgext.minify is just a matter of appending to your config/app_cfg.py:

from tgext.pluggable import plug
plug(base_config, 'tgext.minify')

Otherwise manually using tgext.minify is really simple, you edit your config/middeware.py and just after the #Wrap your base TurboGears 2 application with custom middleware here comment wrap app with MinifyMiddleware:

from tgext.minify import MinifyMiddleware

make_base_app = base_config.setup_tg_wsgi_app(load_environment)

def make_app(global_conf, full_stack=True, **app_conf):
    app = make_base_app(global_conf, full_stack=True, **app_conf)

    # Wrap your base TurboGears 2 application with custom middleware here
    app = MinifyMiddleware(app)

    return app

Now you just have to put your beautiful .css and .js files inside public/ and they will be served as minified.

JS obfuscation

If you need to obfuscate your javascript, just add mangle_js = true to your development.ini. If you want to obfuscate also the global scope, add mangle_js_toplevel = true. Keep in mind that if you obfuscate your js, you have to join js files that depends on each other, or the namespace will be messed up.

Performance boost

Here is the report of a benchmark made on paster serving bootstrap.css with and without the middleware and then bootstrap.min.js already minified (without using the middleware):

$ /usr/sbin/ab -n 1000 http://localhost:8080/css/bootstrap.css
Requests per second:    1135.50 [#/sec] (mean)

$ /usr/sbin/ab -n 1000 http://localhost:8080/css/bootstrap.css
Requests per second:    714.99 [#/sec] (mean)

$ /usr/sbin/ab -n 1000 http://localhost:8080/css/bootstrap.min.css
Requests per second:    806.26 [#/sec] (mean)

In these case serving the unminified css using tgext.minify is even faster than directly serving the same css file as it is served from memory (due to caching performed by tgext.minify).

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.