hmr 0.5.1__py3-none-any.whl → 0.5.2.1__py3-none-any.whl

hmr-0.5.2.1.dist-info/METADATA

@@ -0,0 +1,36 @@
+Metadata-Version: 2.1
+Name: hmr
+Version: 0.5.2.1
+Summary: Hot Module Reload for Python
+Project-URL: repository, https://github.com/promplate/pyth-on-line/tree/reactivity
+Requires-Python: >=3.12
+Requires-Dist: watchfiles<2,>=0.21; sys_platform != "emscripten"
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+# HMR for Python
+
+<sup> on-demand · fine-grained · pull-push reactivity </sup>
+
+[![PyPI - Version](https://img.shields.io/pypi/v/hmr)](https://pypi.org/project/hmr/)
+[![Supported Python Version](https://img.shields.io/python/required-version-toml?tomlFilePath=https://github.com/promplate/pyth-on-line/raw/refs/heads/reactivity/packages/hmr/pyproject.toml)](https://github.com/promplate/pyth-on-line/blob/reactivity/packages/hmr/pyproject.toml)
+[![PyPI - Downloads](https://img.shields.io/pypi/dm/hmr)](https://pepy.tech/projects/hmr)
+
+</div>
+
+HMR means Hot Module Reload / [Hot Module Replacement](https://webpack.js.org/concepts/hot-module-replacement/). It is a feature that allows part of your app to be updated at runtime without a full rerun.
+
+- The module whose source file **you changed** will rerun
+- The module / function that **depend on** the changed module will rerun
+- Other modules that are unaffected (like third-party libraries) will not rerun
+
+Thus, in contrast to the traditional way of **cold-reloading** Python applications (like [watchfiles CLI](https://watchfiles.helpmanual.io/cli/)), HMR is just more efficient.
+
+Unlike static-analysis tools like [Tach](https://github.com/gauge-sh/tach), HMR works by tracking the dependencies between names and modules **during runtime** through a [reactive system](https://wikipedia.org/wiki/Reactive_programming).
+
+## Usage
+
+If you are running your entry file with `python foo.py bar baz ...`, you can just replace it with `hmr foo.py bar baz ...`.
+
+You can also try it with `uvx` or `pipx`. If you are using a virtual environment, it is recommended to install `hmr` in the virtual environment instead of globally.

{hmr-0.5.1.dist-info → hmr-0.5.2.1.dist-info}/RECORD

@@ -1,14 +1,14 @@
-hmr-0.5.1.dist-info/METADATA,sha256=ad1Eq5-t1QdaHg5SI1N_CIvz_ADraD8FCvPtj5Xvek8,258
-hmr-0.5.1.dist-info/WHEEL,sha256=tSfRZzRHthuv7vxpI4aehrdN9scLjk-dCJkPLzkHxGg,90
-hmr-0.5.1.dist-info/entry_points.txt,sha256=g_T0uJ43WgsdG14kkkdaBQuIL0HO-m1qvtjXMP6d060,59
+hmr-0.5.2.1.dist-info/METADATA,sha256=A-0hVQkuyKNRaNS-opfmUwmULQY6_SZHYxIHn2RMVQE,2001
+hmr-0.5.2.1.dist-info/WHEEL,sha256=tSfRZzRHthuv7vxpI4aehrdN9scLjk-dCJkPLzkHxGg,90
+hmr-0.5.2.1.dist-info/entry_points.txt,sha256=g_T0uJ43WgsdG14kkkdaBQuIL0HO-m1qvtjXMP6d060,59
 reactivity/__init__.py,sha256=pX-RUzkezCC1x4eOWGxNhXbwrbvBLP_3pQuZr9eZz1Y,300
 reactivity/functional.py,sha256=jJLEq88w5ag2cXuD1T118uEjnEg37_mqvWmFkb47KVY,1300
 reactivity/helpers.py,sha256=rcrCXy1mmlei-if_BN4nSgS2IG9kBj-jq1YRwEfcITo,5329
 reactivity/hmr/__init__.py,sha256=S5ZIHqCRpevdzWuhS0aCua_S8F0LkK0YNg6IgeTScFQ,177
 reactivity/hmr/__main__.py,sha256=uIcyjR5gMFIXH_3hS0B3SD00RirVf7GIct-uItx675o,64
-reactivity/hmr/api.py,sha256=Esb1fYiBW0SLxQ0MPXby25ZgIIZhIp-M3b2KiqpffmU,2094
-reactivity/hmr/core.py,sha256=BHtkX5b3MAu-dxiMMuAn-8F6JnTkKZSNbEew7Wk59bc,11571
+reactivity/hmr/api.py,sha256=sKDQV7uKRVoDifTZKrLQGZP-fzgYbdVjfEOC6ki4NKY,2280
+reactivity/hmr/core.py,sha256=LpIZubK8XZLAxVM3ZWcxPT14WjcbZVHiU57AMN_KF8Y,11688
 reactivity/hmr/hooks.py,sha256=jIFpe4CNxfaS9RcR4OIodx_sOZlnJ_IA1T1RtHPXhwU,945
 reactivity/hmr/utils.py,sha256=h9m7iRXlvsLTrHoXV9gEVbhz3XsPK4KgnStYoCAWE5I,1616
 reactivity/primitives.py,sha256=QkiUF8bqLZtyXguWwNJi34HJIc-SzUKqi1M9UgTNuvI,5952
-hmr-0.5.1.dist-info/RECORD,,
+hmr-0.5.2.1.dist-info/RECORD,,

reactivity/hmr/api.py

@@ -1,9 +1,13 @@
+import sys
+
 from .core import AsyncReloader, BaseReloader, SyncReloader, create_effect
 from .hooks import call_post_reload_hooks, call_pre_reload_hooks
 
 
 class LifecycleMixin(BaseReloader):
     def run_with_hooks(self):
+        self._original_main_module = sys.modules["__main__"]
+        sys.modules["__main__"] = self.entry_module
         call_pre_reload_hooks()
         self.effect = create_effect(self.run_entry_file)
         call_post_reload_hooks()
@@ -12,6 +16,7 @@ class LifecycleMixin(BaseReloader):
         self.effect.dispose()
         self.entry_module.load.dispose()
         self.entry_module.load.invalidate()
+        sys.modules["__main__"] = self._original_main_module
 
 
 class SyncReloaderAPI(SyncReloader, LifecycleMixin):

reactivity/hmr/core.py

@@ -331,11 +331,14 @@ def cli():
     if len(sys.argv) < 2:
         print("\n Usage: hmr <entry file>, just like python <entry file>\n")
         exit(1)
-    entry = sys.argv[-1]
+    sys.argv.pop(0)  # this file itself
+    entry = sys.argv[0]
     if not (path := Path(entry)).is_file():
         raise FileNotFoundError(path.resolve())
     sys.path.insert(0, ".")
-    SyncReloader(entry).keep_watching_until_interrupt()
+    reloader = SyncReloader(entry)
+    sys.modules["__main__"] = reloader.entry_module
+    reloader.keep_watching_until_interrupt()
 
 
-__version__ = "0.5.1"
+__version__ = "0.5.2.1"

hmr-0.5.1.dist-info/METADATA

@@ -1,8 +0,0 @@
-Metadata-Version: 2.1
-Name: hmr
-Version: 0.5.1
-Summary: Hot Module Reload for Python
-Project-URL: repository, https://github.com/promplate/pyth-on-line/tree/reactivity
-Requires-Python: >=3.12
-Requires-Dist: watchfiles<2,>=0.21; sys_platform != "emscripten"
-