Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/skorokithakis/django-cloudflare-push
A piece of middleware that uses Cloudflare's HTTP/2 Push to push static media to the clients. ⛺
https://github.com/skorokithakis/django-cloudflare-push
Last synced: 7 days ago
JSON representation
A piece of middleware that uses Cloudflare's HTTP/2 Push to push static media to the clients. ⛺
- Host: GitHub
- URL: https://github.com/skorokithakis/django-cloudflare-push
- Owner: skorokithakis
- License: bsd-3-clause
- Created: 2017-07-08T00:19:53.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2022-08-08T13:20:36.000Z (about 2 years ago)
- Last Synced: 2024-10-14T13:01:48.953Z (20 days ago)
- Language: Python
- Size: 28.3 KB
- Stars: 74
- Watchers: 4
- Forks: 7
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG
- License: LICENSE
Awesome Lists containing this project
- starred-awesome - django-cloudflare-push - A piece of middleware that uses Cloudflare's HTTP/2 Push to push static media to the clients. (Python)
README
django-cloudflare-push
======================
About
-----
django-cloudflare-push is a small piece of middleware that looks at the list of
static files in each page that is requested (you need to be using some sort of
static files processor, like Django's built-in one), and [adds a Link
header](https://www.cloudflare.com/website-optimization/http2/serverpush/) that
CloudFlare uses to push the static files to the browser before the latter
requests them, using HTTP/2 Push.
Somewhat counter-intuitively, django-cloudflare-push is compatible with *any*
provider that supports HTTP/2 Push using Link headers, which is pretty much
most of them. For example, the Caddy webserver supports this with the `push`
directive, and this library will work just fine with that.
[](https://pypi.python.org/pypi/django-cloudflare-push)
Installing django-cloudflare-push
---------------------------------
* Install django-cloudflare-push using pip: `pip install django-cloudflare-push`
* Add the middleware to your MIDDLEWARE setting:
```python
MIDDLEWARE = (
'django_cloudflare_push.middleware.push_middleware',
...
)
```
Done! Your static media will be pushed. You can test the middleware by looking
for the `Link` header.
Settings
--------
```python
CLOUDFLARE_PUSH_FILTER = lambda file: True
```
Allows you to customize what files will be sent to the client to be preloaded.
This setting should be set to a callable, which accepts a single parameter
(the name of the file to preload). By default, `django-cloudflare-push` pushes
all static files.
For instance, to push _only_ static CSS and JavaScript files:
```python
CLOUDFLARE_PUSH_FILTER = lambda x: x.endswith('.css') or x.endswith('.js')
```
Webserver configuration
-----------------------
Here's how to configure various webservers to work well with
`django-cloudflare-push`:
### nginx
If you're running nginx v1.13.9 or later, you can just include the
`http2_push_preload on` directive in your configuration:
```
server {
...
http2_push_preload on;
...
}
```
### Caddy
With Caddy, you can use the [`push` directive](https://caddyserver.com/docs/push):
```
push
```
...I know.
License
-------
This software is distributed under the BSD license.