Metadata-Version: 1.1
Name: django-livereload-server
Version: 0.3.2
Summary: LiveReload functionality integrated with your Django development environment
Home-page: https://github.com/tjwalch/django-livereload-server
Author: Tomas Walch
Author-email: tomaswalch@gmail.com
License: BSD License
Description-Content-Type: UNKNOWN
Description: ========================
        django-livereload-server
        ========================
        
        This django app adds a management command that starts a livereload server watching all your static files and templates as well
        as a custom ``runserver`` command that issues livereload requests when the development server is ready after a restart.
        
        Installation
        ------------
        
        Install package: ::
        
          $ pip install django-livereload-server
        
        Add ``'livereload'`` to the ``INSTALLED_APPS``, before ``'django.contrib.staticfiles'`` if this is used::
        
            INSTALLED_APPS = (
                ...
                'livereload',
                ...
            )
        
        Add ``'livereload.middleware.LiveReloadScript'`` to
        ``MIDDLEWARE_CLASSES`` (probably at the end)::
        
            MIDDLEWARE_CLASSES = (
                ...
                'livereload.middleware.LiveReloadScript',
            )
        
        Or to ``MIDDLEWARE`` for Django >= 1.10::
        
            MIDDLEWARE = [
                ...
                'livereload.middleware.LiveReloadScript',
            ]
        
        This will inject the ``livereload.js`` script into your webpages if ``DEBUG`` setting is on.
        
        Configuration
        -------------
        If you need the livereload server to use a different host and port than the default 127.0.0.1 and 35729,
        specify them by setting ``LIVERELOAD_HOST`` and ``LIVERELOAD_PORT`` in ``settings.py``.
        
        Usage
        -----
        Start the livereload server::
        
          $ python manage.py livereload
        
        keep the livereload server running.
        
        Start the django development server as usual (in another console)::
        
          $ python manage.py runserver
        
        In the browser's address bar access your web app by doing:
        
          127.0.0.1:8000 or localhost:8000
        
        now every time you hit save in your editor, the django-development-server/livereload-server automatically updates the staticfiles
        
        Customization
        -------------
        
        By default both template and staticfiles directories are watched.
        
        You can ignore template directories using: ::
        
          $ ./manage.py livereload --ignore-template-dirs
        
        Or staticfiles directories using: ::
        
          $ ./manage.py livereload --ignore-static-dirs
        
        Extra files and/or paths to watch for changes can be added as positional arguments. By default livereload server watches the files that are found by your staticfiles finders and your template loaders. ::
        
          $ python manage.py livereload path/to/my-extra-directory/
        
        This will be excluded from the paths ignored by `--ignore-template-dirs` and
        `--ignore-static-dirs`.
        
        Host and port can be overridden with ``--host`` and ``--port`` options. ::
        
          $ python manage.py livereload --host=myhost.com --port=9090
        
        the runserver command ``python manage.py runserver`` also accepts three additional options::
        
        * ``--nolivereload`` to disable livereload functionality
        * ``--livereload-host`` to override both default and settings file specified host address
        * ``--livereload-port`` to override both default and settings file specified port
        
        Background
        ----------
        This project is based on a merge of `python-livereload <https://github.com/lepture/python-livereload>`_ and
        `django-livereload <https://github.com/Fantomas42/django-livereload>`_, excellent projects both and even better for
        smooth django development when combined.
        
Keywords: django,server,runserver,livereload
Platform: UNKNOWN
Classifier: Framework :: Django
Classifier: Environment :: Web Environment
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: BSD License
Classifier: Topic :: Software Development :: Libraries :: Python Modules
