Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

django-janitor allows you to use bleach to clean HTML stored in a Model's field.

Project Description
Overview
========

django-janitor allows you to use [bleach](https://bleach.readthedocs.io/)
to clean HTML stored in arbitrary Models.

This is useful when you've got HTML content stored in a 3rd-party app, but
you'd like to use a whitelist for allowed HTML tags.

## Features

* django-janitor listens for a Models' `pre_save` signal, and runs it's content
through bleach.
* Allowed HTML tags, attributes, and css are specified in a whitelist
* Whitelists are managed in Django's Admin
* There are (sensible) default whitelists included

## Requirements

* Requires Bleach
* Works with Django 1.11

**NOTE on upgrading to version 0.5.0**: This version officially supports
Python 3 and Django 1.11. Prior versions of this app included south migrations
and only supported something like Django 1.4. If you're previously used this,
you'll have to figure out how to upgrade your existing models (sorry).

## Installation

To install the most recent release:

pip install django-janitor

Or to install from the current repository:

pip install git+https://github.com/bradmontgomery/django-janitor

Then, add `janitor` to your installed apps, and run the migrations.

python manage.py migrate


## Usage

Visit the Janitor app in Django's Admin, and create a new *Field sanitizer*.
Then select the Model and specify the fieldname which should be cleaned. After
you set up the whitelists for Tags, Attributes, etc, save the Field sanitizer.

From now on, when the Model is saved, it's content in will be cleaned using `bleach`.

![screensho](https://raw.githubusercontent.com/bradmontgomery/django-janitor/master/screenshot.png)


## Tests

There are a few tests in `janitor/tests`. You can run these with:

python manage.py tests janitor


## Management Commands

There are a few managment commands avaialable to make it easier to use
django-janitor. The first is `clean_all` which will look at all of the models
that have a related Field Sanitizer, calling the models' `save` method to
trigger the `pre_save` signal (which forces the fields
to be cleaned):

python manage.py clean_all

This is useful if you've created a `FieldSanitizer` for a model with
existing content.

The second management command is `clean_model`, which works in a similar
fashion, but allows you to specify an app and a model::

python manage.py clean_model myapp.MyModel

Finally, `list_html_elements` and `list_html_elements_for_model` exist to
help you discover what HTML tags are being used in existing content. While
these commands do require that a `FieldSanitizer` be configured for existing
Models, they may be used to help you decide which tags to include in a
whitelist.

You should run these commands before using `clean_all` or `clean_model` to
see what sort of data exists before it's cleaned:

python manage.py list_html_elements

Or:

python manage.py list_html_elements_for_model myapp.MyModel
Release History

Release History

This version
History Node

0.5.1

History Node

0.5.0

History Node

0.4.0

History Node

0.3.0

History Node

0.2.0

History Node

0.1.2

History Node

0.1.1

History Node

0.1.0

History Node

0.0.3

History Node

0.0.2

History Node

0.0.1

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
django-janitor-0.5.1.tar.gz (11.1 kB) Copy SHA256 Checksum SHA256 Source Oct 30, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting