Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
livereload server in python
branch: master

This branch is 228 commits behind lepture:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
docs
example
livereload
tests
.gitignore
.gitmodules
LICENSE
MANIFEST.in
Makefile
README.rst
setup.py

README.rst

Python LiveReload

LiveReload Server in Python Version.

Web Developers need to refresh a browser everytime when he saved a file (css, javascript, html), it is really boring. LiveReload will take care of that for you. When you saved a file, your browser will refresh itself. And what's more, it can do some tasks like compiling less to css before the browser refreshing.

Installation

Python LiveReload is designed for web developers who know Python.

Install python-livereload

Install Python LiveReload with pip:

$ pip install livereload

If you don't have pip installed, try easy_install:

$ easy_install livereload

Install Browser Extensions

Get Browser Extensions From LiveReload.com

  • Chrome Extension
  • Safari Extension
  • Firefox Extension

Visit: http://help.livereload.com/kb/general-use/browser-extensions

Get Notification

If you are on Mac, and you are a Growl user:

$ pip install gntp

If you are on Ubuntu, you don't need to do anything. Notification just works.

Working with file protocal

Enable file protocal on Chrome:

http://i.imgur.com/qGpJI.png

Quickstart

LiveReload is designed for more complex tasks, not just for refreshing a browser. But you can still do the simple task.

Assume you have livereload and its extension installed, and now you are in your working directory. With command:

$ livereload

your browser will reload, if any file in the working directory changed.

Guardfile

More complex tasks can be done by Guardfile. Write a Guardfile in your working directory, the basic syntax:

#!/usr/bin/env python
from livereload.task import Task

Task.add('static/style.css')
Task.add('*.html')

Now livereload will only guard static/style.css and html in your workding directory.

But python-livereload is more than that, you can specify a task before refreshing the browser:

#!/usr/bin/env python
from livereload.task import Task
from livereload.compiler import lessc

Task.add('style.less', lessc('style.less', 'style.css'))

And it will compile less css before refreshing the browser now.

Others

If you are on a Mac, you can buy LiveReload2.

If you are a rubist, you can get guard-livereload.

Something went wrong with that request. Please try again.