pelican-precompress 1.1.2

Installation

There are three steps required to start using static compression:

1. Install the plugin and any supporting Python packages you want.

2. Configure Pelican to use the pelican_precompress plugin.

3. Configure your web server to use static, pre-compressed files.

$ pip install pelican_precompress
$ pip install zopfli  # This produces smaller gzip'd files. Use it!
$ pip install brotli  # This requires extra work in step 3.

import pelican_precompress

PLUGINS = [pelican_precompress]

# PRECOMPRESS_GZIP = True or False
# PRECOMPRESS_ZOPFLI = True or False
# PRECOMPRESS_BROTLI = True or False
# PRECOMPRESS_OVERWRITE = False
# PRECOMPRESS_MIN_SIZE = 20
# PRECOMPRESS_TEXT_EXTENSIONS = {
#     '.atom',
#     '.css',
#     '.html',
#     '.but-the-default-extensions-are-pretty-comprehensive',
# }

http {
    gzip_static on;
    gzip_vary on;
}

load_module /usr/lib/nginx/modules/ngx_http_brotli_static_module.so;

http {
    brotli_static on;
}

Configuration

There are a small number of configuration options available. You set them in your Pelican configuration file.

• PRECOMPRESS_GZIP (bool, default is True)

  This is always True unless you set this to False. For example, you might turn this off during development.

• PRECOMPRESS_ZOPFLI (bool, default is True if zopfli is installed)

  If the zopfli module is installed this will default to True. You might set this to False during development. Note that if you try to enable zopfli compression but the module isn’t installed then nothing will happen.

• PRECOMPRESS_BROTLI (bool, default is True if brotli is installed)

  If the brotli module is installed this will default to True. You might set this to False during development. Like PRECOMPRESS_ZOPFLI, if you set this to True when the brotli module isn’t installed then nothing will happen.

• PRECOMPRESS_OVERWRITE (bool, default is False)

  When pelican_precompress encounters an existing compressed file it will refuse to overwrite it. If you want the plugin to overwrite files you can set this to True.

• PRECOMPRESS_TEXT_EXTENSIONS (Set[str])

  This setting controls which file extensions will be pre-compressed.

  If you modify this setting in the Pelican configuration file it will completely replace the default extensions!

• PRECOMPRESS_MIN_SIZE (int, default is 20)

  Small files tend to result in a larger file size when compressed, and any improvement is likely to be marginal. The default setting is chosen to avoid speculatively compressing files that are likely to result in a larger file size after compression.

  To try compressing every file regardless of size, set this to 0.

Testing

pelican_precompress has 100% test coverage. If you’d like to test the code yourself, clone the git repository and run these commands:

$ python3 -m venv venv
$ source venv/bin/activate
(venv) $ python -m pip install tox
(venv) $ tox

The test suite uses tox to setup multiple environments with varying dependencies using multiple Python interpreters; pytest allows the test suite to have parametrized tests; pyfakefs creates a fake filesystem that the tests can run against; and coverage keeps track of which lines of code (and which branches) have been run.

Further reading: tox, venv, pytest, pyfakefs, coverage