django-livereload
django-livereload copied to clipboard
Livereload with the Django developement server
================= 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 yourINSTALLED_APPSsetting, 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