django-livereload icon indicating copy to clipboard operation
django-livereload copied to clipboard

Livereload with the Django developement server

trafficstars

================= Django-livereload

Application performing a LiveReload_ with tiny-lr_ once the development server is ready.

Why this project ?

I recently started using Gulp_ and LiveReload_ to automatize some tasks. Everytime an HTML, CSS or JS file changes, a livereload is performed in the browser to reflect those changes, and I was pretty happy with that.

But I found one limitation, I cannot perform a livereload of the current page when editing Python files because the development server provided by Django is not necessary ready as soon as the livereload request is emitted.

That's why I created this application.

Installation

  • First install the package on your system: ::

    $ pip install django-livereload

  • Then register the 'livereload' application in your INSTALLED_APPS setting, before the 'django.contrib.staticfiles' application if used.

Usage

If the livereload server provided by tiny-lr is launched (via Gulp, Grunt or whatever), the runserver command will do a livereload on your browser whenever the Django development server is ready.

The script

If you want to livereload-js_ script injected into your pages because you don't want to deal with a plug-in, simply register this middleware in your project: 'livereload.middleware.LiveReloadScript'.

.. _LiveReload: http://livereload.com/ .. _tiny-lr: https://github.com/mklabs/tiny-lr .. _Gulp: http://gulpjs.com/ .. _Grunt: http://gruntjs.com/ .. _livereload-js: https://github.com/livereload/livereload-js