pycodedj 0.6.0__tar.gz → 0.6.1__tar.gz

{pycodedj-0.6.0 → pycodedj-0.6.1}/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## [0.6.1] - 2026-05-09
+
+### Improvements
+
+- `pycodedj watch` が保存時に変更されたループだけを再評価するように変更。未変更のループは OSC 再送信されず、パターンの不要な再起動感を抑える
+
+### Docs
+
+- watch モードの説明を、起動時は全ループ評価・保存時は変更ループのみ再評価する仕様に更新
+
 ## [0.6.0] - 2026-05-08
 
 ### Features

{pycodedj-0.6.0 → pycodedj-0.6.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pycodedj
-Version: 0.6.0
+Version: 0.6.1
 Summary: A live-coding performance tool that turns Python code structure into music via SuperCollider.
 License: MIT License with Commons Clause
         

{pycodedj-0.6.0 → pycodedj-0.6.1}/README.ja.md

@@ -118,7 +118,7 @@ def pad(volume=0.1):
 pycodedj watch demo.py
 ```
 
-あとはエディタでコードを書いて保存するだけです。保存のたびに全ループが再評価されます。
+あとはエディタでコードを書いて保存するだけです。保存のたびに変更されたループだけが再評価されます。
 
 **4. 緊急停止**
 

pycodedj-0.6.1/docs/favicon.svg

@@ -0,0 +1,17 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="PyCodeDJ">
+  <defs>
+    <linearGradient id="bg" x1="10" y1="8" x2="54" y2="58" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#16161f"/>
+      <stop offset="1" stop-color="#08080e"/>
+    </linearGradient>
+    <linearGradient id="wave" x1="14" y1="32" x2="50" y2="32" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#a6e3a1"/>
+      <stop offset="0.52" stop-color="#89b4fa"/>
+      <stop offset="1" stop-color="#cba6f7"/>
+    </linearGradient>
+  </defs>
+  <rect width="64" height="64" rx="14" fill="url(#bg)"/>
+  <rect x="8" y="8" width="48" height="48" rx="10" fill="none" stroke="#1e1e2e" stroke-width="2"/>
+  <path d="M15 32c4-12 8-12 12 0s8 12 12 0 8-12 12 0" fill="none" stroke="url(#wave)" stroke-width="5" stroke-linecap="round"/>
+  <circle cx="48" cy="18" r="4" fill="#f38ba8"/>
+</svg>

{pycodedj-0.6.0 → pycodedj-0.6.1}/docs/index.html

@@ -4,6 +4,16 @@
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title>PyCodeDJ — Code is the Instrument</title>
+  <link rel="icon" href="favicon.svg" type="image/svg+xml">
+  <!-- Google tag (gtag.js) -->
+  <script async src="https://www.googletagmanager.com/gtag/js?id=G-J87606964E"></script>
+  <script>
+    window.dataLayer = window.dataLayer || [];
+    function gtag(){dataLayer.push(arguments);}
+    gtag('js', new Date());
+
+    gtag('config', 'G-J87606964E');
+  </script>
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
   <link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:ital,wght@0,300;0,400;0,600;1,400&family=Inter:wght@300;400;600;700&display=swap" rel="stylesheet">
@@ -533,7 +543,7 @@
 
 <!-- Hero -->
 <section class="hero">
-  <div class="hero-badge">v0.1.1 — now on PyPI</div>
+  <div class="hero-badge">v0.6.0 — now on PyPI</div>
   <h1>
     <span class="accent-green">Code</span> is<br>
     the <span class="accent-mauve">instrument</span>

{pycodedj-0.6.0 → pycodedj-0.6.1}/docs/manual.html

@@ -4,6 +4,16 @@
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title>PyCodeDJ Manual</title>
+  <link rel="icon" href="favicon.svg" type="image/svg+xml">
+  <!-- Google tag (gtag.js) -->
+  <script async src="https://www.googletagmanager.com/gtag/js?id=G-J87606964E"></script>
+  <script>
+    window.dataLayer = window.dataLayer || [];
+    function gtag(){dataLayer.push(arguments);}
+    gtag('js', new Date());
+
+    gtag('config', 'G-J87606964E');
+  </script>
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
   <link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:ital,wght@0,300;0,400;0,600;1,400&family=Inter:wght@300;400;600;700&display=swap" rel="stylesheet">
@@ -503,12 +513,12 @@ def bass(volume=0.4):
 <hr>
 </section>
 <section id="s5"><h2>5. Watch mode &mdash; save to reload</h2>
-<p>Running <code>pycodedj eval</code> manually each time gets tedious. The <code>watch</code> command evaluates all loops at startup and then <strong>re-evaluates automatically on every save</strong>.</p>
+<p>Running <code>pycodedj eval</code> manually each time gets tedious. The <code>watch</code> command evaluates all loops at startup and then <strong>re-evaluates only changed loops on every save</strong>.</p>
 <h3>Start watching</h3>
 <pre data-lang="bash"><code>pycodedj watch examples/demo.py</code></pre>
 <pre data-lang="text"><code>[pycodedj] watching demo.py — save to reload (Ctrl+C to stop)
 [pycodedj] reloaded demo.py (3 loop(s))</code></pre>
-<p>All loops play immediately. From here, just write code and save. Every save shows:</p>
+<p>All loops play immediately. From here, just write code and save. Unchanged loops keep running without being resent. Every save shows:</p>
 <pre data-lang="text"><code>[pycodedj] reloaded demo.py (3 loop(s))</code></pre>
 <p><strong>Write code → Save → Sound changes.</strong> That&#x27;s the live-coding workflow.</p>
 <h3>Stop watching</h3>
@@ -1349,7 +1359,7 @@ s.boot;</code></pre>
 pycodedj eval demo.py::melody --sc-host 192.168.1.10
 pycodedj eval demo.py::pad --sc-port 57200</code></pre>
 <h3><code>pycodedj watch</code></h3>
-<p>Watch a file and re-evaluate all loops at startup and on every save. Stop with Ctrl+C.</p>
+<p>Watch a file, evaluate all loops at startup, and re-evaluate changed loops on every save. Stop with Ctrl+C.</p>
 <pre data-lang="text"><code>pycodedj watch FILE [--sc-host HOST] [--sc-port PORT] [--debounce SECS]</code></pre>
 <table>
 <thead><tr>

{pycodedj-0.6.0 → pycodedj-0.6.1}/docs/manual.ja.html

@@ -4,6 +4,16 @@
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title>PyCodeDJ マニュアル</title>
+  <link rel="icon" href="favicon.svg" type="image/svg+xml">
+  <!-- Google tag (gtag.js) -->
+  <script async src="https://www.googletagmanager.com/gtag/js?id=G-J87606964E"></script>
+  <script>
+    window.dataLayer = window.dataLayer || [];
+    function gtag(){dataLayer.push(arguments);}
+    gtag('js', new Date());
+
+    gtag('config', 'G-J87606964E');
+  </script>
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
   <link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:ital,wght@0,300;0,400;0,600;1,400&family=Inter:wght@300;400;600;700&display=swap" rel="stylesheet">
@@ -601,7 +611,7 @@ def bass(volume=0.7):   # ← 大きくする
       <section id="s5">
         <h2>5. 保存するだけで音が変わる — watch モード</h2>
 
-        <p>毎回 <code>pycodedj eval</code> を打つのは面倒です。<code>watch</code> コマンドを使うと、起動時に一度すべてのループを評価し、その後は<strong>ファイルを保存するだけで自動的に全ループが再評価されます</strong>。</p>
+        <p>毎回 <code>pycodedj eval</code> を打つのは面倒です。<code>watch</code> コマンドを使うと、起動時に一度すべてのループを評価し、その後は<strong>ファイルを保存するだけで変更されたループだけが再評価されます</strong>。</p>
 
         <h3>起動方法</h3>
 
@@ -610,7 +620,7 @@ def bass(volume=0.7):   # ← 大きくする
         <pre data-lang="text"><code>[pycodedj] watching demo.py — save to reload (Ctrl+C to stop)
 [pycodedj] reloaded demo.py (3 loop(s))</code></pre>
 
-        <p>起動直後に一度音が鳴ります。あとはエディタでコードを書いて保存するだけです。保存のたびに次のように出力されます。</p>
+        <p>起動直後に一度音が鳴ります。あとはエディタでコードを書いて保存するだけです。変更していないループは再送信されず、そのまま鳴り続けます。保存のたびに次のように出力されます。</p>
 
         <pre data-lang="text"><code>[pycodedj] reloaded demo.py (3 loop(s))</code></pre>
 

{pycodedj-0.6.0 → pycodedj-0.6.1}/docs/manual.ja.md

@@ -318,7 +318,7 @@ def bass(volume=0.7):   # 大きくする
 
 ## 5. watch モード — 保存するだけで音が変わる
 
-毎回 `pycodedj eval` を打つのは手間です。`watch` コマンドを使うと、起動時に全ループをまとめて評価し、その後は**ファイルを保存するだけで自動的に全ループが再評価**されます。
+毎回 `pycodedj eval` を打つのは手間です。`watch` コマンドを使うと、起動時に全ループをまとめて評価し、その後は**ファイルを保存するだけで変更されたループだけが再評価**されます。
 
 ### 起動する
 
@@ -331,7 +331,7 @@ pycodedj watch examples/demo.py
 [pycodedj] reloaded demo.py (3 loop(s))
 ```
 
-起動直後に一度すべてのループが評価されて音が鳴ります。あとはエディタでコードを書いて保存するだけです。
+起動直後に一度すべてのループが評価されて音が鳴ります。あとはエディタでコードを書いて保存するだけです。変更していないループは再送信されず、そのまま鳴り続けます。
 
 ```
 [pycodedj] reloaded demo.py (3 loop(s))

{pycodedj-0.6.0 → pycodedj-0.6.1}/docs/manual.md

@@ -301,7 +301,7 @@ The filter opened up and the modulation got faster. Deeper nesting = brighter so
 
 ## 5. Watch mode — save to reload
 
-Running `pycodedj eval` manually each time gets tedious. The `watch` command evaluates all loops at startup and then **re-evaluates automatically on every save**.
+Running `pycodedj eval` manually each time gets tedious. The `watch` command evaluates all loops at startup and then **re-evaluates only changed loops on every save**.
 
 ### Start watching
 
@@ -314,7 +314,7 @@ pycodedj watch examples/demo.py
 [pycodedj] reloaded demo.py (3 loop(s))
 ```
 
-All loops play immediately. From here, just write code and save. Every save shows:
+All loops play immediately. From here, just write code and save. Unchanged loops keep running without being resent. Every save shows:
 
 ```
 [pycodedj] reloaded demo.py (3 loop(s))
@@ -1081,7 +1081,7 @@ pycodedj eval demo.py::pad --sc-port 57200
 
 ### `pycodedj watch`
 
-Watch a file and re-evaluate all loops at startup and on every save. Stop with Ctrl+C.
+Watch a file, evaluate all loops at startup, and re-evaluate changed loops on every save. Stop with Ctrl+C.
 
 ```
 pycodedj watch FILE [--sc-host HOST] [--sc-port PORT] [--debounce SECS]

{pycodedj-0.6.0 → pycodedj-0.6.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "pycodedj"
-version = "0.6.0"
+version = "0.6.1"
 description = "A live-coding performance tool that turns Python code structure into music via SuperCollider."
 requires-python = ">=3.10"
 readme = "README.md"

{pycodedj-0.6.0 → pycodedj-0.6.1}/src/pycodedj/__init__.py

@@ -2,5 +2,5 @@
 
 from ._loop import loop, pattern
 
-__version__ = "0.6.0"
+__version__ = "0.6.1"
 __all__ = ["loop", "pattern"]

{pycodedj-0.6.0 → pycodedj-0.6.1}/src/pycodedj/__main__.py

@@ -24,7 +24,7 @@ def _build_parser() -> argparse.ArgumentParser:
     eval_p.add_argument("--sc-host", default="127.0.0.1", help="SuperCollider host")
     eval_p.add_argument("--sc-port", default=57120, type=int, help="SuperCollider port")
 
-    watch_p = sub.add_parser("watch", help="Watch a file and re-eval all loops on save")
+    watch_p = sub.add_parser("watch", help="Watch a file and re-eval changed loops on save")
     watch_p.add_argument("file", metavar="FILE", help="Source file to watch")
     watch_p.add_argument("--sc-host", default="127.0.0.1", help="SuperCollider host")
     watch_p.add_argument("--sc-port", default=57120, type=int, help="SuperCollider port")

{pycodedj-0.6.0 → pycodedj-0.6.1}/src/pycodedj/watcher.py

@@ -6,13 +6,13 @@ import threading
 from pathlib import Path
 from typing import Callable
 
-from .block_parser import parse_blocks
+from .block_parser import LoopBlock, parse_blocks
 from .engine import Engine
 from .osc_bridge import OscError
 
 
 class _LoopFileHandler:
-    """ファイル変更イベントを受け取り、デバウンス後に全ループを再評価する。"""
+    """ファイル変更イベントを受け取り、デバウンス後に変更ループを再評価する。"""
 
     def __init__(
         self,
@@ -27,6 +27,7 @@ class _LoopFileHandler:
         self._debounce = debounce
         self._timer: threading.Timer | None = None
         self._active_names: set[str] = set()
+        self._blocks_by_name: dict[str, LoopBlock] = {}
 
     def dispatch(self, src_path: str) -> None:
         """watchdog の on_modified から呼ぶ。対象ファイル以外は無視する。"""
@@ -50,17 +51,23 @@ class _LoopFileHandler:
         if not result.ok:
             sys.stderr.write(f"[pycodedj] syntax error in {self._path}: {result.error}\n")
             return  # _active_names を維持してループを継続する
-        current_names = {b.name for b in result.blocks}
+        current_blocks = {b.name: b for b in result.blocks}
+        current_names = set(current_blocks)
 
         for name in self._active_names - current_names:
             try:
                 self._engine.stop_loop(name)
             except OscError:
                 pass
+            self._blocks_by_name.pop(name, None)
         self._active_names = current_names
 
         for block in result.blocks:
-            self._engine.eval_block(block)
+            if self._blocks_by_name.get(block.name) == block:
+                continue
+            params = self._engine.eval_block(block)
+            if params is not None:
+                self._blocks_by_name[block.name] = block
         if self._on_eval is not None:
             self._on_eval(self._path, len(result.blocks))
 
@@ -71,7 +78,7 @@ def watch(
     debounce: float = 0.3,
     on_eval: Callable[[str, int], None] | None = None,
 ) -> None:
-    """ファイルを監視し、変更のたびに全ループを再評価する。Ctrl+C で停止。
+    """ファイルを監視し、変更のたびに変更されたループを再評価する。Ctrl+C で停止。
 
     Args:
         path: 監視するファイルのパス

{pycodedj-0.6.0 → pycodedj-0.6.1}/tests/test_watcher.py

@@ -19,6 +19,10 @@ def _make_handler(
 
 _BASS_BLOCK = '@loop("bass")\ndef f(): pass\n'
 _BASS_PAD_BLOCK = '@loop("bass")\ndef bass(): pass\n@loop("pad")\ndef pad(): pass\n'
+_BASS_PAD_CHANGED_BLOCK = (
+    '@loop("bass")\ndef bass(): pass\n'
+    '@loop("pad")\ndef pad(volume=0.5): pass\n'
+)
 _BASS_MELODY_BLOCK = '@loop("bass")\ndef bass(): pass\n@loop("melody")\ndef melody(): pass\n'
 
 
@@ -69,6 +73,36 @@ def test_eval_all_loops_in_file(tmp_path: Path) -> None:
     assert engine.eval_block.call_count == 2
 
 
+def test_eval_only_changed_loop_on_reload(tmp_path: Path) -> None:
+    target = tmp_path / "demo.py"
+    target.write_text(_BASS_PAD_BLOCK)
+    handler, engine = _make_handler(path=str(target), debounce=0.0)
+
+    handler.eval_now()
+    engine.eval_block.reset_mock()
+
+    target.write_text(_BASS_PAD_CHANGED_BLOCK)
+    handler.dispatch(str(target))
+    time.sleep(0.05)
+
+    assert engine.eval_block.call_count == 1
+    assert engine.eval_block.call_args.args[0].name == "pad"
+
+
+def test_eval_skips_unchanged_loops_on_reload(tmp_path: Path) -> None:
+    target = tmp_path / "demo.py"
+    target.write_text(_BASS_PAD_BLOCK)
+    handler, engine = _make_handler(path=str(target), debounce=0.0)
+
+    handler.eval_now()
+    engine.eval_block.reset_mock()
+
+    handler.dispatch(str(target))
+    time.sleep(0.05)
+
+    engine.eval_block.assert_not_called()
+
+
 def test_eval_now_evaluates_without_file_event(tmp_path: Path) -> None:
     target = tmp_path / "demo.py"
     target.write_text(_BASS_BLOCK)
@@ -150,6 +184,7 @@ def test_adapter_on_moved_fires_eval(tmp_path: Path) -> None:
     adapter = _make_watchdog_adapter(str(target), engine)
     engine.reset_mock()
 
+    target.write_text('@loop("bass")\ndef bass(volume=0.5): pass\n')
     event = MagicMock()
     event.dest_path = str(target)
     adapter.on_moved(event)
@@ -166,6 +201,7 @@ def test_adapter_on_created_fires_eval(tmp_path: Path) -> None:
     adapter = _make_watchdog_adapter(str(target), engine)
     engine.reset_mock()
 
+    target.write_text('@loop("bass")\ndef bass(volume=0.5): pass\n')
     event = MagicMock()
     event.src_path = str(target)
     adapter.on_created(event)