htminify

A lightweight html minifier for all Python web frameworks and WSGI apps.


Keywords
html, django, flask, wsgi, middleware, python, wsgi-middleware
License
BSD-3-Clause
Install
pip install htminify==0.1.2

Documentation

HTMinify

A lightweight HTML minifier for all Python web frameworks and WSGI apps.

Features

  • Using a web framework, like django, flask, and pyramid? We got you covered.
  • Or you're feeling adventurous and you're building your own wsgi app? We got you covered there too. This will work with any program that complies with the WSGI specification
  • Using an encoding that is not UTF-8? Just pass an argument, and we'll take it from there. 😉
  • Mixing Javascript and html? We'll try to minify that too, without judging you too much. (No promises though😜).
  • No external dependencies.

Installation

With pip

$ pip install htminify

With poetry

$ poetry add htminify

Usage

For Django

The middleware goes in your wsgi.py file. An example wsgi.py will look like this.

# wsgi.py
import os

from django.core.wsgi import get_wsgi_application
from htminify.wsgi import StripWhitespaceMiddleware # add this!
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'website.settings')

application = get_wsgi_application()
application = StripWhitespaceMiddleware(application) # add this too!

For Flask

Flask provides access to its wsgi app, which you can pass as an argument to the middleware. You are essentially wrapping the middleware around the wsgi application. An example flask file would be like this.

# app.py
from flask import Flask
from htminify.wsgi import StripWhitespaceMiddleware # add this!

app = Flask(__name__)
app.wsgi_app = StripWhitespaceMiddleware(app.wsgi_app) # add this too!

@app.route('/')
def hello():
    return "Hello, world."

if __name__=="__main__":
    app.run()

Note that we are wrapping the app.wsgi_app object and not the app object.

For any other WSGI app.

A similar procedure can be followed to integrate the middleware with other wsgi-Python web frameworks. Just wrap the middleware around the wsgi app.

# app.py
from htminify.wsgi import StripWhitespaceMiddleware # add this!
wsgi_app = StripWhitespaceMiddleware(wsgi_app) # wrap around

Configuration

if you don't want to minify when debug is true

You can do something like this

# app.py
if not debug:
    wsgi_app = StripWhitespaceMiddleware(wsgi_app)

If you're using encoding other than UTF-8

Pass the encoding-type to the middleware when wrapping the app.

# app.py
from htminify.wsgi import StripWhitespaceMiddleware # add this!
wsgi_app = StripWhitespaceMiddleware(wsgi_app, "UTF-16") # pass the encoding

TODO

New Features

  1. Minify Json content.
  2. Add ASGI support.

Documentation

  • Generate Documentation and push to read the docs.
  • Add information for contributing.

Testing

  • Improve test suite for wsgi middleware.