Skip to content

kespindler/python-livereload

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

58 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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:

image

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.

More Examples

$ livereload

Searches for a Guardfile. if exists, execute it, else does a reload every time a file in . changes.

$ livereload foo.rst 

every time foo.rst is modified, reruns rst2html.py foo.rst > foo.html. Can be used for any number of files. Currently only .rst is supported.

Others

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

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

Packages

No packages published

Languages

  • Python 99.4%
  • Ruby 0.6%