Skip to content

dictation_history_cmd

dictation_history_cmd

CLI: diapason dictation-history — read back what you dictated.

Functions:

dictation_history 

dictation_history() -> None

Browse the local history of your dictations.

Source code in src/diapason/cli/dictation_history_cmd.py 
10
11
12
@click.group("dictation-history")
def dictation_history() -> None:
    """Browse the local history of your dictations."""

list_entries 

list_entries(limit: int, full: bool) -> None

Show recent dictations, newest first.

Source code in src/diapason/cli/dictation_history_cmd.py 
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
@dictation_history.command("list")
@click.option("--limit", default=20, show_default=True, help="How many to show.")
@click.option("--full", is_flag=True, help="Print whole transcripts, unwrapped.")
def list_entries(limit: int, full: bool) -> None:
    """Show recent dictations, newest first."""
    from diapason.desktop.dictation_history import load_history

    entries = load_history(limit=limit)
    if not entries:
        click.echo("No dictations recorded yet.")
        return

    for e in entries:
        where = f" · {e.app}" if e.app else ""
        head = click.style(f"{_fmt_time(e.timestamp)}{where}", fg="cyan")
        click.echo(f"{head}  ({e.chars} chars, {e.duration_s:.1f}s)")
        text = e.text if full else (e.text[:200] + ("…" if len(e.text) > 200 else ""))
        click.echo(f"  {text}\n")

show_stats 

show_stats() -> None

Summarise what has been dictated.

Source code in src/diapason/cli/dictation_history_cmd.py 
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
@dictation_history.command("stats")
def show_stats() -> None:
    """Summarise what has been dictated."""
    from diapason.desktop.dictation_history import load_history, stats

    entries = load_history()
    s = stats(entries)
    if not s["count"]:
        click.echo("No dictations recorded yet.")
        return
    click.echo(f"Dictations : {s['count']}")
    click.echo(f"Characters : {s['total_chars']}")
    click.echo(f"Speaking   : {s['total_seconds']:.0f}s")
    click.echo(f"Average    : {s['avg_chars']:.0f} chars per dictation")
    by_app: dict[str, int] = {}
    for e in entries:
        if e.app:
            by_app[e.app] = by_app.get(e.app, 0) + 1
    if by_app:
        click.echo("\nWhere you dictate:")
        for app, n in sorted(by_app.items(), key=lambda kv: -kv[1])[:5]:
            click.echo(f"  {n:4d}  {app}")

last_entry 

last_entry() -> None

Print the most recent transcript — for when the paste went astray.

Source code in src/diapason/cli/dictation_history_cmd.py 
63
64
65
66
67
68
69
70
71
72
@dictation_history.command("last")
def last_entry() -> None:
    """Print the most recent transcript — for when the paste went astray."""
    from diapason.desktop.dictation_history import load_history

    entries = load_history(limit=1)
    if not entries:
        click.echo("No dictations recorded yet.")
        return
    click.echo(entries[0].text)

clear 

clear() -> None

Delete every recorded dictation.

Source code in src/diapason/cli/dictation_history_cmd.py 
75
76
77
78
79
80
81
@dictation_history.command("clear")
@click.confirmation_option(prompt="Delete the whole dictation history?")
def clear() -> None:
    """Delete every recorded dictation."""
    from diapason.desktop.dictation_history import clear_history

    click.echo("History deleted." if clear_history() else "Nothing to delete.")