Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

Runner-Reloader for development

Project description

===============
Runner-Reloader
===============

Runner for development code.


Usage
=====

.. code:: shell

$ rr --help
usage: rr [-h] [--interval INTERVAL] [--exclude EXCLUDE]
[--loglevel {NOTSET,DEBUG,INFO,WARNING,ERROR,CRITICAL}]
...

Runner-Reloader for development

positional arguments:
command command

optional arguments:
-h, --help show this help message and exit
--interval INTERVAL, -i INTERVAL
interval for check
--exclude EXCLUDE, -e EXCLUDE
exclude pattern
--loglevel {NOTSET,DEBUG,INFO,WARNING,ERROR,CRITICAL}
loglevel for rr

Simple
------

.. code:: shell

$ rr --interval=10 my-app serve --listen=0.0.0.0:8080

This command launch ``my-app serve --listen=0.0.0.0:8080``
and scan current directory for changed files every ten seconds.
If some files was changed, application authomatically restarted.

This is usable for *development* docker containers.


Signal
------

The process rr receives a signal SIGUSR1 for starting reload process.


Installation
============

.. code:: shell

$ pip install rr


Settings
========

File ``.rr`` in current directory parsed for settings.
rr uses the `zini <https://github.com/zzzsochi/zini>`_ library for this.

:command: command for run
:interval: interval between scan directory
:exclude: list of excluded directories for scan
:loglevel: `loglevel <https://docs.python.org/3/howto/logging.html#logging-levels>`_ for rr

Command line arguments has a higher priority than settings.


For example:
~~~~~~~~~~~~

.. code:: ini

[default]
command = 'ping 8.8.8.8'
interval = 5s
loglevel = 'DEBUG'
exclude =
'*/__pycache__'
'.git'
'node_modules'
'build'
'dist'

Project details


Release history Release notifications

This version
History Node

0.2.0

History Node

0.1.0

History Node

0.0.2

History Node

0.0.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
rr-0.2.0-py3-none-any.whl (7.1 kB) Copy SHA256 hash SHA256 Wheel 3.5 Apr 8, 2017
rr-0.2.0.tar.gz (4.5 kB) Copy SHA256 hash SHA256 Source None Apr 8, 2017

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page