Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

django-jackfrost

Package Overview
Dependencies
Maintainers
1
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

django-jackfrost

A static site generator for Django views

  • 0.4.0
  • PyPI
  • Socket score

Maintainers
1

django-jackfrost 0.4.0

Convert your Django views into a collection of static HTML files. Or, put another way, a Django based static-site-generator with few opinions.

This is my attempt at a different type of static site renderer, instead leveraging the availability of Django's staticfiles_ functionality to leave specifics to someone else :) The theory is thus that you could choose a third party storage from, say, django-storages_ and plug it into jackfrost and have things Just Work.

I don't actually know if that's true though.

.. |travis_stable| image:: https://travis-ci.org/kezabelle/django-jackfrost.svg?branch=0.4.0 :target: https://travis-ci.org/kezabelle/django-jackfrost

.. |travis_master| image:: https://travis-ci.org/kezabelle/django-jackfrost.svg?branch=master :target: https://travis-ci.org/kezabelle/django-jackfrost

============== ====== Release Status ============== ====== stable (0.4.0) |travis_stable| master |travis_master| ============== ======

Alternatives

  • There's django-medusa_, though it doesn't appear to be active anymore.
  • also django-bakery_, which takes a different approach whereby one must extend specific views or models.

Differences

  • Unlike django-medusa_ there is no autodiscovery, and no requirement that renderers go in a specific place.
  • Unlike django-bakery, existing views and models ought to be usable unchanged, because of the renderer approach I've taken, which is more similar to django-medusa or Django RSS Feeds_.

Dependencies

  • Django_
  • pytest_

Installing

pip_ installing the latest release via PyPI::

pip install django-jackfrost==0.4.0

If you want to get the latest, unstable version, you can use something like this (again with pip_) I think::

pip install git+https://github.com/kezabelle/django-jackfrost.git#egg=django-jackfrost

Put jackfrost into your INSTALLED_APPS::

INSTALLED_APPS = (
    'django.contrib.auth',
    # ...
    'jackfrost',
    # ...
)

which will enable the management command::

python manage.py collectstaticsite --processes=N

Configuration & usage

Set JACKFROST_STORAGE to whatever storage backend you'd like to use, in your project's settings. By default, a subclass of django.contrib.staticfiles.storage.StaticFilesStorage which puts output into a jackfrost directory will be used.

If your storage backend needs any arguments that can't be gleaned from individual settings, you can set JACKFROST_STORAGE_KWARGS to a dictionary of arguments to be used when instantiating the JACKFROST_STORAGE

Selecting renderers ^^^^^^^^^^^^^^^^^^^

Add a JACKFROST_RENDERERS setting, which should be a list or tuple of dotted paths to python classes or functions, much like MIDDLEWARE_CLASSES, TEMPLATE_CONTEXT_PROCESSORS etc::

JACKFROST_RENDERERS = (
    'myapp.renderers.MyModelRenderer',
    'my_other_app.utils.SomeOtherRenderer',
)

In theory, I don't care whether your JACKFROST_RENDERERS are functions or classes; if it's a class it must implement __call__. Either way, it should, when called, return a number of URL paths to be consumed.

Renderers for models ^^^^^^^^^^^^^^^^^^^^

If you have a model which has a get_absolute_url method, your renderer can be as simple as::

from jackfrost.models import ModelRenderer

class MyModelRenderer(ModelRenderer):
    def get_model(self):
        return MyModel

If you need to customise the queryset, there is a get_queryset method which can be replaced. There is also a get_urls method, if you need to go totally off-reservation.

Reading from sitemaps_ ^^^^^^^^^^^^^^^^^^^^^^^^

Giving jackfrost the dotted path to a standard Django sitemap_ as one of the JACKFROST_RENDERERS should do the right thing, and get the URLs out of the sitemap itself without you needing to do anything or write a new renderer.

Reading from django-medusa_ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

In theory, giving jackfrost the dotted path to a subclass of the django-medusa_ BaseStaticSiteRenderer_ should do the right thing, and get the URLs out of the medusa renderer itself, without you doing anything. It will avoid going through the medusa rendering process, instead it'll go through mine.

Reading from Django RSS Feeds_ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Giving jackfrost the dotted path to a subclass of a Feed_ should do the right thing, and get the URLs out by asking the Feed_ for the item_link for everything in items, without you doing anything.

Writing a renderer ^^^^^^^^^^^^^^^^^^

The most basic renderer would be::

def myrenderer_yielding():
    yield reverse('app:name')

or::

def myrenderer():
    return [reverse('app:name')]

Renderers may also be classes::

class MyRenderer(object):
    __slots__ = ()

    def __init__(self):
        pass

    def __call__(self):
        yield reverse('app:name')

Listening for renders ^^^^^^^^^^^^^^^^^^^^^

There are 8 signals in total:

  • build_started is fired when the management command is run.
  • reader_started is fired when a URLReader instance begins working.
  • read_page is fired when a URLReader successfully gets a URL's content.
  • reader_finished is fired when a URLReader instance completes.
  • writer_started is fired when a URLWriter instance begins working.
  • write_page is fired just after the content is written to the storage backend.
  • writer_finished is fired when the URLWriter completes
  • build_finished fires at the end of the management command.

Rendering on model change ^^^^^^^^^^^^^^^^^^^^^^^^^

Additionally, there is a listener, jackfrost.utils.build_page_for_obj which is suitable for being used as a pre_save or post_save receiver for a Model instance, and will attempt to build just the get_absolute_url for that object.

Defining when a model may build ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

If a Model instance implements a jackfrost_can_build method, this is checked before building the static page. If jackfrost_can_build returns False, the page won't get built. Any other value will result in it being built.

Defining different URLs ^^^^^^^^^^^^^^^^^^^^^^^

If a Model instance implements a jackfrost_urls method, this is used instead of the get_absolute_url, and should return an iterable of all the URLs to consider building.

If the Model instance has a get_list_url method, that page will also be built. Useful for updating any ListView pages, etc.

Extras

Where possible, jackfrost will attempt to compensate for redirects (301, 302 etc) by writing an HTML page with a <meta refresh> tag pointing at the final endpoint. The template used is called 301.html.

Additionally, static pages for 401, 403, 404 and 500 errors will be built from their respective templates, if they exist. Useful if you want to wire up Apache ErrorDocument directives or whatever.

Running the tests (87% coverage)

Given a complete clone::

python setup.py test

.. _django-medusa: https://github.com/mtigas/django-medusa .. _staticfiles: https://docs.djangoproject.com/en/stable/ref/contrib/staticfiles/ .. _Django: https://docs.djangoproject.com/en/stable/ .. _pip: https://pip.pypa.io/en/stable/ .. _django-storages: https://django-storages.readthedocs.org/en/latest/ .. _pytest: http://pytest.org/latest/ .. _django-bakery: http://django-bakery.readthedocs.org/en/latest/ .. _they don't: https://github.com/datadesk/django-bakery/issues/15 .. _sitemaps: https://docs.djangoproject.com/en/stable/ref/contrib/sitemaps/ .. _Django sitemap: https://docs.djangoproject.com/en/stable/ref/contrib/sitemaps/ .. _BaseStaticSiteRenderer: https://github.com/mtigas/django-medusa/blob/master/django_medusa/renderers/base.py .. _Django RSS Feeds: https://docs.djangoproject.com/en/stable/ref/contrib/syndication/ .. _Feed: https://docs.djangoproject.com/en/stable/ref/contrib/syndication/#feed-class-reference


License

django-jackfrost 0.4.0 is available under the terms of the Simplified BSD License (alternatively known as the FreeBSD License, or the 2-clause License)::

Copyright (c) 2015, Keryn Knight
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this
   list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice,
   this list of conditions and the following disclaimer in the documentation
   and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

The views and conclusions contained in the software and documentation are those
of the authors and should not be interpreted as representing official policies,
either expressed or implied, of the FreeBSD Project.

Change log

0.4.0 ^^^^^^

  • Added signals.write_page which is fired after the storage backend has written the content.
  • Added utils.eventlog_write for using pinax.eventlog_ and the aforementioned write_page signal to track built items.
  • Added a ModelAdmin action_ for building a selection of model instances into their static counterparts, from the admin changelist.
  • Made the receiver utils.build_page_for_obj actually work.
  • the models module will be compiled using Cython, if installed.

.. _pinax.eventlog: https://github.com/pinax/pinax-eventlog .. _ModelAdmin action: https://docs.djangoproject.com/en/stable/ref/contrib/admin/actions/

0.3.0 ^^^^^^

  • Replaced jackfrost_absolute_url method in ModelRenderer with jackfrost_urls, which allows models to add every URL they want to cause to be visited.

0.2.1 ^^^^^^

  • Added support for Django 1.6
  • Added celery tasks for building both a single URL, and all URLs.

0.2.0 ^^^^^^

  • Initial release.

Keywords

FAQs


Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc