mdbub 0.3.7__py3-none-any.whl

mdbub/__init__.py

@@ -0,0 +1,63 @@
+"""
+mdbub - Terminal-first interactive mindmap CLI tool with extended markdown support
+"""
+
+import os
+import subprocess
+from datetime import datetime
+from importlib.metadata import PackageNotFoundError, version
+
+__version__ = "0.3.0"
+
+
+def get_version() -> str:
+    try:
+        __version__ = version("mdbub")
+    except PackageNotFoundError:
+        __version__ = "unknown"
+    return __version__
+
+
+def _get_build_info() -> str:
+    """Get comprehensive build information."""
+    info_parts = []
+
+    # Git commit hash
+    try:
+        commit = (
+            subprocess.check_output(
+                ["git", "rev-parse", "--short", "HEAD"], stderr=subprocess.DEVNULL
+            )
+            .decode("ascii")
+            .strip()
+        )
+        info_parts.append(f"git:{commit}")
+    except Exception:
+        info_parts.append("git:unknown")
+
+    # Build date (from environment variable if available, otherwise current time)
+    build_date = os.environ.get("BUILD_DATE")
+    if not build_date:
+        try:
+            # Try to get git commit date
+            build_date = (
+                subprocess.check_output(
+                    ["git", "log", "-1", "--format=%ci"], stderr=subprocess.DEVNULL
+                )
+                .decode("ascii")
+                .strip()
+                .split()[0]  # Just the date part
+            )
+        except Exception:
+            build_date = datetime.now().strftime("%Y-%m-%d")
+
+    info_parts.append(f"date:{build_date}")
+
+    # Build environment
+    build_env = os.environ.get("BUILD_ENV", "dev")
+    info_parts.append(f"env:{build_env}")
+
+    return " ".join(info_parts)
+
+
+BUILD_INFO = _get_build_info()

mdbub/cli.py

@@ -0,0 +1,122 @@
+import typer
+
+from mdbub import BUILD_INFO
+from mdbub import __version__ as VERSION
+from mdbub.commands import about, version
+from mdbub.commands.quick import main as quick_main
+
+app = typer.Typer(
+    help="""
+    mdbub: Interactive mindmap CLI tool.
+
+    Usage examples:
+      poetry run mdbub FILE.md
+      poetry run mdbub --print-tags FILE.md
+      poetry run mdbub --version
+      poetry run mdbub --about
+
+    [bold yellow]Note:[/bold yellow] Options like --print-tags must come before the filename.
+    If you do not provide a filename, the last session will be restored (if available).
+    """,
+    add_completion=False,
+    invoke_without_command=True,
+)
+
+
+@app.callback(invoke_without_command=True)  # type: ignore
+def main(
+    ctx: typer.Context,
+    file: str = typer.Argument(
+        None,
+        help="""
+        Markdown mindmap file to open or create (append #path to open to a node with [id:path]).
+        [bold yellow]Options like --print-tags must come before the filename.[/bold yellow]
+        """,
+    ),
+    print_tags: bool = typer.Option(
+        False, "--print-tags", help="Print all #tags in the [FILE] as a table and exit."
+    ),
+    print_kv: bool = typer.Option(
+        False,
+        "--print-kv",
+        help="Print all @key:value metadata in the [FILE] as a table and exit.",
+    ),
+    print_links: bool = typer.Option(
+        False,
+        "--print-links",
+        help="Print all [id:...] anchors in the [FILE] as a table and exit.",
+    ),
+    version_flag: bool = typer.Option(
+        False, "--version", help="Show version, build info, and config path."
+    ),
+    about_flag: bool = typer.Option(False, "--about", help="Show about info."),
+) -> None:
+    """
+    Quick mode: mini interactive shell (default).
+    Use --version for version info, --config for config management.
+    """
+    if version_flag:
+        version.main()
+        raise typer.Exit()
+    if about_flag:
+        about.main()
+        raise typer.Exit()
+    if print_links:
+        from mdbub.commands.print_links import main as print_links_main
+
+        print_links_main(file)
+        raise typer.Exit()
+
+    if print_tags:
+        from mdbub.commands.print_tags import main as print_tags_main
+
+        print_tags_main(file)
+        raise typer.Exit()
+
+    if print_kv:
+        from mdbub.commands.print_kv import main as print_kv_main
+
+        print_kv_main(file)
+        raise typer.Exit()
+
+    if ctx.invoked_subcommand is None:
+        try:
+            # Support deep links: filename.md#path/to/node
+            if file is not None and "#" in file:
+                filename, deep_link = file.split("#", 1)
+                deep_link_path = deep_link.strip("/") if deep_link.strip("/") else None
+                file = filename
+            else:
+                deep_link_path = None
+            if file is not None:
+                file_obj = open(file, "r+")
+            else:
+                file_obj = None
+            if print_tags:
+                from mdbub.commands.print_tags import main as print_tags_main
+
+                print_tags_main(file)
+                raise typer.Exit()
+            if print_kv:
+                from mdbub.commands.print_kv import main as print_kv_main
+
+                print_kv_main(file)
+                raise typer.Exit()
+            if print_links:
+                from mdbub.commands.links import main as links_main
+
+                links_main(file)
+                raise typer.Exit()
+            quick_main(
+                file_obj,
+                VERSION,
+                BUILD_INFO,
+                deep_link_path=deep_link_path,
+            )
+        except Exception as e:
+            typer.echo(f"Error: {e}")
+            raise typer.Exit(1)
+
+
+if __name__ == "__main__":
+    app()

mdbub/commands/about.py

@@ -0,0 +1,99 @@
+from rich.console import Console
+
+
+def main() -> None:
+    """Print about info."""
+    console = Console()
+    console.print("mdbub: Interactive mindmap CLI tool", style="bold yellow")
+    console.print(
+        "It’s built for fast thinkers who love their keyboard. Whether you're capturing a flurry of ideas, organizing research, or mapping out your next big project, `mdbub` is your expressive outlet. It's not just functional, it should feel *fluid*.",
+        style="cyan",
+    )
+    console.print(
+        "Designed to be delightful to use entirely from the keyboard, this ecosystem lets you think at the speed of thought. And because it’s CLI-native, it’s composable in the best UNIX spirit—ready to interoperate with everything else you do in the shell.",
+        style="cyan",
+    )
+    console.print(
+        "This is for the chaos-to-clarity thinkers. We’re building it because no other tool feels this good under your fingers.",
+        style="cyan",
+    )
+    console.print("")
+
+    # Usage Section
+    console.print("[b]USAGE[/b]", style="bold yellow")
+    console.print(
+        "[b cyan]Basic:[/b cyan]  [dim]mdbub <file.md>[/dim]  — Open or create a mindmap from a Markdown file."
+    )
+    console.print(
+        "[b cyan]Deeplinks:[/b cyan]  [dim]mdbub <file.md>#<nodeid>[/dim]  — Jump directly to a specific node by its link ID."
+    )
+    console.print(
+        "[b cyan]  --> Link IDs: Add \[id:something] for referencing or deep linking.",
+        style="dim",
+    )
+    console.print(
+        "[b cyan]Session Restore:[/b cyan]  [dim]mdbub[/dim]  — No file? Your last session is auto-restored (file & node)."
+    )
+    console.print(
+        "[b cyan]Tags:[/b cyan]  Add #tags to node text for fast filtering and organizing."
+    )
+    console.print(
+        "[b cyan]  --> See tag metrics with:[/b cyan] mdbub --print-tags <file.md>.",
+        style="dim",
+    )
+    console.print(
+        "[b cyan]KV Metadata:[/b cyan]  Add @key:value to node text for structured metadata."
+    )
+    console.print(
+        "[b cyan]  --> See all metadata with:[/b cyan] mdbub --print-kv <file.md>.",
+        style="dim",
+    )
+    console.print(
+        "[b cyan]Search:[/b cyan]  Press [b]/[/b] to search instantly by text or tag. Navigate results with "
+        "arrows, Enter to jump."
+    )
+    console.print(
+        "[b cyan]Keyboard-First:[/b cyan]  Navigate, edit, and manage your mindmap without ever leaving the "
+        "keyboard."
+    )
+    console.print("")
+    console.print(
+        "Note: Options like --print-tags and --print-kv must come before the filename."
+    )
+    console.print("")
+    console.print("[yellow]EXAMPLES[/yellow]")
+    console.print(
+        "mdbub --print-tags FILE.md  |  mdbub --print-kv FILE.md  |  mdbub FILE.md"
+    )
+
+    console.print("---", style="dim white")
+    console.print(
+        "This app was ideated with help from [ChatGPT-4o](https://chatgpt.com/),\n and then vibe coded with a "
+        "mix of [Claude 4](https://www.anthropic.com/claude) and [GPT-4.1](https://openai.com/blog/gpt-4-1)",
+        style="dim white",
+    )
+    console.print("---", style="dim white")
+
+    console.print("[bold blue]Version:[/bold blue] 0.3.0", style="dim white")
+    console.print("[bold blue]Author:[/bold blue] Collabinator Team", style="dim white")
+    console.print("[bold blue]License:[/bold blue] Apache 2.0", style="dim white")
+    console.print(
+        "[bold blue]Repository:[/bold blue] https://github.com/collabinator/mdbubbles",
+        style="dim white",
+    )
+    console.print(
+        "[bold blue]Documentation:[/bold blue] https://collabinator.github.io/mdbubbles/",
+        style="dim white",
+    )
+    console.print(
+        "[bold blue]PyPI:[/bold blue] https://pypi.org/project/mdbub/",
+        style="dim white",
+    )
+    console.print(
+        "[bold blue]Homebrew Tap:[/bold blue] https://github.com/collabinator/homebrew-tap",
+        style="dim white",
+    )
+    console.print(
+        "[bold blue]Changelog:[/bold blue] https://github.com/collabinator/mdbubbles/blob/main/CHANGELOG.md",
+        style="dim white",
+    )

mdbub/commands/export.py

@@ -0,0 +1,9 @@
+import typer
+
+app = typer.Typer()
+
+
+@app.command()  # type: ignore
+def main(filename: str, out: str = "-") -> None:
+    """Export mindmap to various formats (stub)."""
+    typer.echo(f"[export] Would export {filename} as {out} (stub)")

mdbub/commands/print_kv.py

@@ -0,0 +1,59 @@
+import re
+from collections import defaultdict
+from typing import Dict, Tuple
+
+from rich.console import Console
+from rich.table import Table
+
+
+def extract_kv_metadata_from_file(
+    filename: str,
+) -> Tuple[list[dict[str, object]], set[str], Dict[str, Dict[str, int]]]:
+    kv_pattern = re.compile(r"@(\w+):([^\s]+)")
+    node_kvs = []  # List of dicts: {line, label, kvs: {k:v}}
+    all_keys = set()
+    value_counts: Dict[str, Dict[str, int]] = defaultdict(
+        lambda: defaultdict(int)
+    )  # key -> value -> count
+    with open(filename, "r", encoding="utf-8") as f:
+        for lineno, line in enumerate(f, 1):
+            kvs = {}
+            for match in kv_pattern.finditer(line):
+                key = match.group(1)
+                value = match.group(2)
+                kvs[key] = value
+                all_keys.add(key)
+                value_counts[key][value] += 1
+            if kvs:
+                label = line.strip().split("@", 1)[0].strip()
+                node_kvs.append({"line": lineno, "label": label, "kvs": kvs})
+    return node_kvs, set(all_keys), value_counts
+
+
+def main(filename: str) -> None:
+    console = Console()
+    node_kvs, all_keys, value_counts = extract_kv_metadata_from_file(filename)
+    if not node_kvs:
+        console.print(
+            f"[yellow]No @key:value metadata found in:[/yellow] [italic]{filename}[/italic]"
+        )
+        return
+    table = Table(title=f"@key:value metadata in {filename}", show_lines=True)
+    table.add_column("Line", style="dim", justify="right")
+    table.add_column("Node Label", style="cyan")
+    for key in all_keys:
+        table.add_column(f"@{key}", style="magenta")
+    for node in node_kvs:
+        row = [str(node["line"]), node["label"]]
+        for key in all_keys:
+            row.append(node["kvs"].get(key, "") if hasattr(node["kvs"], "get") else "")
+        table.add_row(*row)
+    console.print(table)
+    # Print summary
+    console.print("\n[bold yellow]Summary of value counts per key:[/bold yellow]")
+    for key in all_keys:
+        vc = value_counts[key]
+        summary = ", ".join(
+            f"{v} ({c})" for v, c in sorted(vc.items(), key=lambda x: (-x[1], x[0]))
+        )
+        console.print(f"  [cyan]@{key}[/cyan]: {summary}")

mdbub/commands/print_links.py

@@ -0,0 +1,24 @@
+import re
+
+from rich.console import Console
+from rich.table import Table
+
+
+def main(filename: str) -> None:
+    console = Console()
+    anchor_pattern = re.compile(r"\[id:([^]]+)\]")
+    rows = []
+    with open(filename, "r", encoding="utf-8") as f:
+        for lineno, line in enumerate(f, 1):
+            m = anchor_pattern.search(line)
+            if m:
+                anchor = m.group(1)
+                label = line.strip().split("[id:", 1)[0].strip()
+                rows.append((lineno, label, anchor))
+    table = Table(title=f"[id:...] anchors in {filename}")
+    table.add_column("Line", justify="right")
+    table.add_column("Node Label")
+    table.add_column("Anchor")
+    for row in rows:
+        table.add_row(str(row[0]), row[1], row[2])
+    console.print(table)

mdbub/commands/print_tags.py

@@ -0,0 +1,40 @@
+import re
+from collections import defaultdict
+from typing import Dict, Tuple
+
+from rich.console import Console
+from rich.table import Table
+
+
+def extract_tags_from_file(
+    filename: str,
+) -> Tuple[Dict[str, int], Dict[str, list[int]]]:
+    tag_pattern = re.compile(r"#(\w+)")
+    tag_counts: Dict[str, int] = defaultdict(int)
+    tag_lines = defaultdict(list)
+    with open(filename, "r", encoding="utf-8") as f:
+        for lineno, line in enumerate(f, 1):
+            for match in tag_pattern.finditer(line):
+                tag = match.group(1)
+                tag_counts[tag] += 1
+                tag_lines[tag].append(lineno)
+    return tag_counts, tag_lines
+
+
+def main(filename: str) -> None:
+    console = Console()
+    tag_counts, tag_lines = extract_tags_from_file(filename)
+    if not tag_counts:
+        console.print(
+            f"[bold red]No tags found in:[/bold red] [italic]{filename}[/italic]"
+        )
+        return
+    table = Table(title=f"Tags in {filename}", show_lines=True)
+    table.add_column("Tag", style="cyan", no_wrap=True)
+    table.add_column("Count", style="magenta", justify="right")
+    table.add_column("Lines", style="dim")
+    for tag in sorted(tag_counts):
+        unique_lines = sorted(set(tag_lines[tag]))
+        lines = ", ".join(str(n) for n in unique_lines)
+        table.add_row(f"#{tag}", str(tag_counts[tag]), lines)
+    console.print(table)