diff options
| author | Michael Merickel <michael@merickel.org> | 2016-11-19 15:49:19 -0600 |
|---|---|---|
| committer | Michael Merickel <michael@merickel.org> | 2016-11-20 17:20:15 -0600 |
| commit | 1644efffa25dcc70c9e01f709fbd203351e2f6ba (patch) | |
| tree | 6731211902ad399d29424a6faa1c10aa0d7e2901 /docs | |
| parent | 38fc72ca66f718414b66782518c3698d7a5d8f2f (diff) | |
| download | pyramid-1644efffa25dcc70c9e01f709fbd203351e2f6ba.tar.gz pyramid-1644efffa25dcc70c9e01f709fbd203351e2f6ba.tar.bz2 pyramid-1644efffa25dcc70c9e01f709fbd203351e2f6ba.zip | |
link to documentation on hupper
fixes #2806
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/narr/project.rst | 20 | ||||
| -rw-r--r-- | docs/tutorials/wiki/installation.rst | 3 | ||||
| -rw-r--r-- | docs/tutorials/wiki2/installation.rst | 3 |
3 files changed, 24 insertions, 2 deletions
diff --git a/docs/narr/project.rst b/docs/narr/project.rst index 71bd176f6..6c42881f4 100644 --- a/docs/narr/project.rst +++ b/docs/narr/project.rst @@ -1045,3 +1045,23 @@ Another good production alternative is :term:`Green Unicorn` (aka mod_wsgi, although it depends, in its default configuration, on having a buffering HTTP proxy in front of it. It does not, as of this writing, work on Windows. + +Automatically Reloading Your Code +--------------------------------- + +During development, it can be really useful to automatically have the +webserver restart when you make changes. ``pserve`` has a ``--reload`` switch +to enable this. It uses the +`hupper <http://docs.pylonsproject.org/projects/hupper/en/latest/>` package +to enable this behavior. When your code crashes, ``hupper`` will wait for +another change or the ``SIGHUP`` signal before restarting again. + +inotify support +~~~~~~~~~~~~~~~ + +By default, ``hupper`` will poll the filesystem for changes to all python +code. This can be pretty inefficient in larger projects. To be nicer to your +hard drive, you should install the +`watchdog <http://pythonhosted.org/watchdog/>` package in development. +``hupper`` will automatically use ``watchdog`` to more efficiently poll the +filesystem. diff --git a/docs/tutorials/wiki/installation.rst b/docs/tutorials/wiki/installation.rst index 6172b122b..03e183739 100644 --- a/docs/tutorials/wiki/installation.rst +++ b/docs/tutorials/wiki/installation.rst @@ -370,7 +370,8 @@ coverage. Start the application --------------------- -Start the application. +Start the application. See :ref:`what_is_this_pserve_thing` for more +information on ``pserve``. On UNIX ^^^^^^^ diff --git a/docs/tutorials/wiki2/installation.rst b/docs/tutorials/wiki2/installation.rst index 0440c2d1d..75d5d4abd 100644 --- a/docs/tutorials/wiki2/installation.rst +++ b/docs/tutorials/wiki2/installation.rst @@ -457,7 +457,8 @@ working directory. This is an SQLite database with a single table defined in it Start the application --------------------- -Start the application. +Start the application. See :ref:`what_is_this_pserve_thing` for more +information on ``pserve``. On UNIX ^^^^^^^ |