vocalize-cli 0.5.0__tar.gz → 0.6.0__tar.gz

{vocalize_cli-0.5.0 → vocalize_cli-0.6.0}/CHANGELOG.md

@@ -3,6 +3,17 @@
 All notable changes to this project are documented here. Format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## 0.6.0 - 2026-08-31
+
+### Added
+
+- `vocalize settings` — prints the resolved settings, one key=value per
+  line, so wrapper scripts (like the /speak slash command) can read the
+  effective `overflow` and `max_chars` instead of hardcoding them.
+- `--print-length` on the Stop hook: prints the response's character count
+  instead of speaking, so a wrapper can decide to ask about truncation
+  interactively before any audio is spent.
+
 ## 0.5.0 - 2026-08-31
 
 ### Added

{vocalize_cli-0.5.0 → vocalize_cli-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: vocalize-cli
-Version: 0.5.0
+Version: 0.6.0
 Summary: A CLI that turns text, markdown, or piped stdin into speech via the ElevenLabs API, with markdown-table-aware preprocessing.
 Project-URL: Homepage, https://github.com/matthager12-collab/vocalize
 Project-URL: Repository, https://github.com/matthager12-collab/vocalize
@@ -225,6 +225,10 @@ regardless. With no cap set anywhere there is no overflow, so the mode
 never fires. Hook-triggered speech still lives under the hook's 15-minute
 watchdog described below, whatever the mode.
 
+`vocalize settings` prints the resolved values (one `key=value` per
+line, env and config applied) — handy for wrapper scripts and for checking
+which source won.
+
 Not having a config file is normal and silent. A file that isn't valid TOML
 is an error naming the file; a key that isn't recognised is a warning on
 stderr, so a typo doesn't pass unnoticed but doesn't stop the run either.

{vocalize_cli-0.5.0 → vocalize_cli-0.6.0}/README.md

@@ -191,6 +191,10 @@ regardless. With no cap set anywhere there is no overflow, so the mode
 never fires. Hook-triggered speech still lives under the hook's 15-minute
 watchdog described below, whatever the mode.
 
+`vocalize settings` prints the resolved values (one `key=value` per
+line, env and config applied) — handy for wrapper scripts and for checking
+which source won.
+
 Not having a config file is normal and silent. A file that isn't valid TOML
 is an error naming the file; a key that isn't recognised is a warning on
 stderr, so a typo doesn't pass unnoticed but doesn't stop the run either.

{vocalize_cli-0.5.0 → vocalize_cli-0.6.0}/hooks/claude_stop_hook.py

@@ -9,6 +9,10 @@
    that response. Run it when you want speech instead of installing the
    hook and getting it after every turn.
 
+Add `--print-length` to either mode to print the response's character
+count instead of speaking — for wrappers deciding whether to ask about
+truncation before committing to audio.
+
 Either way it pulls the most recent assistant text message out of the
 transcript and pipes it through the `vocalize` CLI (the same one used
 directly from the command line), so there's exactly one code path for
@@ -125,6 +129,15 @@ def main() -> int:
 
     text = _extract_last_assistant_text(transcript_path)
     if not text.strip():
+        if "--print-length" in sys.argv[1:]:
+            print(0)
+        return 0
+
+    if "--print-length" in sys.argv[1:]:
+        # Report the response's size without speaking — the /speak command
+        # uses this to decide whether to ask about truncation in-app. Raw
+        # (pre-flattening) length: close enough for an ask threshold.
+        print(len(text))
         return 0
 
     # VOCALIZE_BIN wins over PATH so a venv install still resolves when the

{vocalize_cli-0.5.0 → vocalize_cli-0.6.0}/tests/test_claude_stop_hook.py

@@ -172,6 +172,26 @@ def test_env_max_chars_is_left_for_the_cli_to_resolve(monkeypatch, tmp_path):
     assert calls[0][2:4] == ["--default-max-chars", "500"]
 
 
+def test_print_length_reports_count_without_speaking(monkeypatch, tmp_path, capsys):
+    path = _write_transcript(tmp_path, [_assistant([_text("hello there")])])
+    calls = _patch_main(monkeypatch, {"transcript_path": path})
+    monkeypatch.setattr(hook.sys, "argv", ["claude_stop_hook.py", "--print-length"])
+
+    assert hook.main() == 0
+    assert capsys.readouterr().out.strip() == "11"
+    assert calls == []  # nothing was spoken
+
+
+def test_print_length_reports_zero_for_an_empty_response(monkeypatch, tmp_path, capsys):
+    path = _write_transcript(tmp_path, ['{"type":"user"}'])
+    calls = _patch_main(monkeypatch, {"transcript_path": path})
+    monkeypatch.setattr(hook.sys, "argv", ["claude_stop_hook.py", "--print-length"])
+
+    assert hook.main() == 0
+    assert capsys.readouterr().out.strip() == "0"
+    assert calls == []
+
+
 def test_speech_timeout_scales_with_text_and_is_capped():
     assert hook._speech_timeout("") == 60
     assert hook._speech_timeout("x" * 1200) == 60 + 100

{vocalize_cli-0.5.0 → vocalize_cli-0.6.0}/tests/test_cli.py

@@ -583,6 +583,34 @@ def test_ask_to_truncate_returns_none_on_tty_eof(monkeypatch):
     assert cli_module._ask_to_truncate(5000, 100) is None
 
 
+def test_settings_prints_resolved_config_values(monkeypatch, tmp_path):
+    _isolate_overflow_env(monkeypatch, tmp_path)
+    for var in ("VOCALIZE_VOICE", "VOCALIZE_MODEL", "VOCALIZE_SPEED"):
+        monkeypatch.delenv(var, raising=False)
+    cfg = tmp_path / "vocalize" / "config.toml"
+    cfg.parent.mkdir(parents=True, exist_ok=True)
+    cfg.write_text('max_chars = 1000\noverflow = "ask"\n', encoding="utf-8")
+
+    result = CliRunner().invoke(main, ["settings"])
+
+    assert result.exit_code == 0, result.output
+    assert "max_chars=1000" in result.output
+    assert "overflow=ask" in result.output
+
+
+def test_settings_prints_defaults_when_nothing_is_configured(monkeypatch, tmp_path):
+    _isolate_overflow_env(monkeypatch, tmp_path)
+    for var in ("VOCALIZE_VOICE", "VOCALIZE_MODEL", "VOCALIZE_SPEED"):
+        monkeypatch.delenv(var, raising=False)
+
+    result = CliRunner().invoke(main, ["settings"])
+
+    assert result.exit_code == 0, result.output
+    assert "max_chars=unset" in result.output
+    assert "overflow=truncate" in result.output
+    assert "speed=unset" in result.output
+
+
 def test_stop_command_reports_a_stopped_player(monkeypatch):
     monkeypatch.setattr(cli_module, "stop_playback", lambda: True)
     result = CliRunner().invoke(main, ["stop"])

{vocalize_cli-0.5.0 → vocalize_cli-0.6.0}/vocalize/__init__.py

@@ -7,4 +7,4 @@ formatting into something that actually sounds good spoken aloud
 which is close to useless).
 """
 
-__version__ = "0.5.0"
+__version__ = "0.6.0"

{vocalize_cli-0.5.0 → vocalize_cli-0.6.0}/vocalize/cli.py

@@ -4,6 +4,7 @@
     vocalize speak-file report.md --play
     cat notes.md | vocalize speak-file - --play
     vocalize stop
+    vocalize settings
     vocalize voices
     vocalize usage
     vocalize config
@@ -181,6 +182,24 @@ def speak_file(path, api_key, voice_id, model_id, speed, output_path, play, raw,
               chunk_chars=chunk_chars, overflow=overflow, default_max_chars=default_max_chars)
 
 
+@main.command()
+def settings() -> None:
+    """Print the resolved settings, env and config precedence applied.
+
+    One key=value per line, made for wrapper scripts (the /speak slash
+    command reads overflow and max_chars from here) — no API call, no key
+    needed.
+    """
+    file_config = load_config_file()
+    resolved = resolve_settings(file_config=file_config)
+    mode, cap = resolve_overflow(file_config=file_config)
+    click.echo(f"voice={resolved.voice_id}")
+    click.echo(f"model={resolved.model_id}")
+    click.echo(f"speed={resolved.speed if resolved.speed is not None else 'unset'}")
+    click.echo(f"max_chars={cap if cap is not None else 'unset'}")
+    click.echo(f"overflow={mode}")
+
+
 @main.command()
 def stop() -> None:
     """Stop any audio vocalize is currently playing."""