Skip to content

๐Ÿ”„ Hot module reload for python, automatically reload your code when files are modified. No need to modify source code.

License

Notifications You must be signed in to change notification settings

Mr-Milk/python-hmr

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

52 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Python Hot Module Reload

python-hmr logo

Better debugging experience with HMR

Test status pypi license-mit Endpoint Badge

Automatic reload your project when files are modified.

No need to modify your source code. Works in any environment.

reload

Supported Syntax:

  • โœ… import X
  • โœ… from X import Y

Supported Types:

  • โœ… Module
  • โœ… Function
  • โœ… Class

Installation

pip install python-hmr

Quick Start

Caution

From v0.3.0, there is only one API, hmr.reload.

Import your dev packages as usual. And add 2 lines for automatically reloading.

import dev

import hmr
dev = hmr.reload(dev)

If you have multiple modules to reload, you can do it like this.

from dev import run1, run2

import hmr
run1, run2 = hmr.reload(run1, run2)

Now you are ready to go! Try to modify the run1 or run2 and see the magic happen.

Detailed Usage

Function/Class instance

When you try to add HMR for a function or class, remember to pass the name of the function or class instance without parenthesis.

from dev import Runner

import hmr
Runner = hmr.reload(Runner)

a = Runner()
b = Runner()

Important

Here, when both a and b will be updated after reloading. This may be helpful if you have an expansive state store within the class instance.

However, it's suggested to reinitialize the class instance after reloading.

@Decorated Function

Use functools.wraps to preserve signature of your function, or the function information will be replaced by the decorator itself.

import functools

def work(f):
    @functools.wraps(f)
    def args(*arg, **kwargs):
        return f(*arg, **kwargs)

    return args

Stateful application

If your application is stateful, you can exclude the state from being reloaded. For simplicity, you can group all your state variable into the same .py file like state.py and exclude that from being reloaded.

Make sure you know what you are doing. This could lead to unexpected behavior and unreproducible bugs.

import dev

import hmr
dev = hmr.reload(dev, exclude=["dev.state"])

In this way dev/state.py will not be reloaded, the state will persist.

This also apply when reloading a function or class.

from dev import run

import hmr
run = hmr.reload(run, exclude=["dev.state"])

Acknowledgement

Inspired from the following package.

About

๐Ÿ”„ Hot module reload for python, automatically reload your code when files are modified. No need to modify source code.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages