sentence-menu 1.0.0__tar.gz

sentence_menu-1.0.0/PKG-INFO

@@ -0,0 +1,49 @@
+Metadata-Version: 2.4
+Name: sentence-menu
+Version: 1.0.0
+Summary: A command-line fuzzy menu keyed based on full sentences
+Author-email: "@readwithai" <talwrii@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/talwrii/sentence-menu
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# sentence-menu
+A command-line fuzzy command-menu keyed with full sentences which runs command.
+
+This is unreviewed AI-generated code. It will likely become more reviewed if anyone uses it.
+
+## Motivation
+I want to find snippets to do things based on what I have done before. I use the snippet framework I wrote, zshnip, but sometimes I want to be lazy and use full sentences.
+
+## Alternatives
+`navi` is a menuing system with fuzzy search and tags which focuses on commands to run, but focuses on cheat sheet files (supporting several). I dislike editing files and if I have to edit a file to add a command I often won't do it.
+
+`fzf` provides a fuzzy menu but is more a command line tool to build thigns than a complete solution.
+
+`rofi` is another fuzzy menuing system designed for gui environments. It can automatically search your path for commands. Most desktop environments, like KDE or Gnome, provide some sort of fuzzy search.
+
+I also sometimes use Obsidian to keep track of commands related to a topic. This can work well, but not for things I want to run quickly. I have a shortcut to popup Obsidian. You could use emacs org-mode for similar purposes.
+
+You could also use an LLM.
+
+## Installation
+pipx install sentence-menu
+
+## Usage
+Interactively add a command: `sentence-menu add`
+
+Interactively edit an entry: `sentence-menu edit`
+
+Run a command: `sentence-menu`
+
+Print a command to standard out: `sentence-menu echo`
+
+## About me
+I am @readwithai. I make lots of small tools like this. I also make tools for reading with and without AI.

sentence_menu-1.0.0/README.md

@@ -0,0 +1,33 @@
+# sentence-menu
+A command-line fuzzy command-menu keyed with full sentences which runs command.
+
+This is unreviewed AI-generated code. It will likely become more reviewed if anyone uses it.
+
+## Motivation
+I want to find snippets to do things based on what I have done before. I use the snippet framework I wrote, zshnip, but sometimes I want to be lazy and use full sentences.
+
+## Alternatives
+`navi` is a menuing system with fuzzy search and tags which focuses on commands to run, but focuses on cheat sheet files (supporting several). I dislike editing files and if I have to edit a file to add a command I often won't do it.
+
+`fzf` provides a fuzzy menu but is more a command line tool to build thigns than a complete solution.
+
+`rofi` is another fuzzy menuing system designed for gui environments. It can automatically search your path for commands. Most desktop environments, like KDE or Gnome, provide some sort of fuzzy search.
+
+I also sometimes use Obsidian to keep track of commands related to a topic. This can work well, but not for things I want to run quickly. I have a shortcut to popup Obsidian. You could use emacs org-mode for similar purposes.
+
+You could also use an LLM.
+
+## Installation
+pipx install sentence-menu
+
+## Usage
+Interactively add a command: `sentence-menu add`
+
+Interactively edit an entry: `sentence-menu edit`
+
+Run a command: `sentence-menu`
+
+Print a command to standard out: `sentence-menu echo`
+
+## About me
+I am @readwithai. I make lots of small tools like this. I also make tools for reading with and without AI.

sentence_menu-1.0.0/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["setuptools>=68.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "sentence-menu"
+version = "1.0.0"
+description = "A command-line fuzzy menu keyed based on full sentences"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.8"
+authors = [
+    {name = "@readwithai", email = "talwrii@gmail.com"},
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Topic :: Utilities",
+]
+
+[project.scripts]
+sentence-menu = "sentence_menu.main:main"
+
+[project.urls]
+Homepage = "https://github.com/talwrii/sentence-menu"

sentence_menu-1.0.0/sentence_menu/main.py

@@ -0,0 +1,169 @@
+"""sentence-menu: A command-line fuzzy menu keyed based on full sentences."""
+
+import argparse
+import json
+import os
+import subprocess
+import sys
+from pathlib import Path
+
+
+def get_store_path():
+    xdg = os.environ.get("XDG_DATA_HOME", os.path.expanduser("~/.local/share"))
+    path = Path(xdg) / "sentence-menu" / "commands.json"
+    path.parent.mkdir(parents=True, exist_ok=True)
+    return path
+
+
+def load_entries():
+    path = get_store_path()
+    if not path.exists():
+        return []
+    with open(path) as f:
+        return json.load(f)
+
+
+def save_entries(entries):
+    path = get_store_path()
+    with open(path, "w") as f:
+        json.dump(entries, f, indent=2)
+
+
+def fzf_select(entries):
+    if not entries:
+        print("No entries yet. Use 'sentence-menu add' to add one.", file=sys.stderr)
+        sys.exit(1)
+
+    lines = [e["sentence"] for e in entries]
+    input_text = "\n".join(lines)
+
+    try:
+        result = subprocess.run(
+            ["fzf", "--height=40%", "--reverse", "--prompt=  "],
+            input=input_text,
+            stdout=subprocess.PIPE,
+            text=True,
+        )
+    except FileNotFoundError:
+        print("fzf is required but not installed.", file=sys.stderr)
+        print("Install it: https://github.com/junegunn/fzf", file=sys.stderr)
+        sys.exit(1)
+
+    if result.returncode != 0:
+        sys.exit(1)
+
+    selected = result.stdout.strip()
+    for e in entries:
+        if e["sentence"] == selected:
+            return e
+    return None
+
+
+def cmd_add():
+    sentence = input("Sentence: ").strip()
+    if not sentence:
+        print("Aborted.", file=sys.stderr)
+        sys.exit(1)
+
+    command = input("Command: ").strip()
+    if not command:
+        print("Aborted.", file=sys.stderr)
+        sys.exit(1)
+
+    entries = load_entries()
+    entries.append({"sentence": sentence, "command": command})
+    save_entries(entries)
+    print(f"Added: {sentence}")
+
+
+def cmd_edit():
+    import tempfile
+
+    entries = load_entries()
+    entry = fzf_select(entries)
+    if not entry:
+        return
+
+    editor = os.environ.get("VISUAL") or os.environ.get("EDITOR", "vi")
+
+    with tempfile.NamedTemporaryFile(mode="w", suffix=".txt", delete=False) as f:
+        f.write(f"Sentence: {entry['sentence']}\n")
+        f.write(f"Command: {entry['command']}\n")
+        tmppath = f.name
+
+    try:
+        subprocess.run([editor, tmppath])
+
+        with open(tmppath) as f:
+            lines = f.readlines()
+
+        for line in lines:
+            if line.startswith("Sentence:"):
+                new_sentence = line[len("Sentence:"):].strip()
+                if new_sentence:
+                    entry["sentence"] = new_sentence
+            elif line.startswith("Command:"):
+                new_command = line[len("Command:"):].strip()
+                if new_command:
+                    entry["command"] = new_command
+
+        save_entries(entries)
+        print("Updated.")
+    finally:
+        os.unlink(tmppath)
+
+
+def cmd_run():
+    entries = load_entries()
+    entry = fzf_select(entries)
+    if entry:
+        import time
+        print(f"$ {entry['command']}", file=sys.stderr)
+        time.sleep(0.1)
+        os.execvp("sh", ["sh", "-c", entry["command"]])
+
+
+def cmd_echo():
+    entries = load_entries()
+    entry = fzf_select(entries)
+    if entry:
+        print(entry["command"])
+
+
+def cmd_remove():
+    entries = load_entries()
+    entry = fzf_select(entries)
+    if entry:
+        entries.remove(entry)
+        save_entries(entries)
+        print(f"Removed: {entry['sentence']}")
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="sentence-menu",
+        description="A command-line fuzzy menu keyed based on full sentences.",
+    )
+    subparsers = parser.add_subparsers(dest="command")
+
+    subparsers.add_parser("add", help="Interactively add a command")
+    subparsers.add_parser("edit", help="Interactively edit an entry")
+    subparsers.add_parser("echo", help="Print a command to stdout")
+    subparsers.add_parser("remove", help="Remove an entry")
+
+    args = parser.parse_args()
+
+    if args.command == "add":
+        cmd_add()
+    elif args.command == "edit":
+        cmd_edit()
+    elif args.command == "echo":
+        cmd_echo()
+    elif args.command == "remove":
+        cmd_remove()
+    else:
+        cmd_run()
+
+
+if __name__ == "__main__":
+    main()

sentence_menu-1.0.0/sentence_menu.egg-info/PKG-INFO

@@ -0,0 +1,49 @@
+Metadata-Version: 2.4
+Name: sentence-menu
+Version: 1.0.0
+Summary: A command-line fuzzy menu keyed based on full sentences
+Author-email: "@readwithai" <talwrii@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/talwrii/sentence-menu
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# sentence-menu
+A command-line fuzzy command-menu keyed with full sentences which runs command.
+
+This is unreviewed AI-generated code. It will likely become more reviewed if anyone uses it.
+
+## Motivation
+I want to find snippets to do things based on what I have done before. I use the snippet framework I wrote, zshnip, but sometimes I want to be lazy and use full sentences.
+
+## Alternatives
+`navi` is a menuing system with fuzzy search and tags which focuses on commands to run, but focuses on cheat sheet files (supporting several). I dislike editing files and if I have to edit a file to add a command I often won't do it.
+
+`fzf` provides a fuzzy menu but is more a command line tool to build thigns than a complete solution.
+
+`rofi` is another fuzzy menuing system designed for gui environments. It can automatically search your path for commands. Most desktop environments, like KDE or Gnome, provide some sort of fuzzy search.
+
+I also sometimes use Obsidian to keep track of commands related to a topic. This can work well, but not for things I want to run quickly. I have a shortcut to popup Obsidian. You could use emacs org-mode for similar purposes.
+
+You could also use an LLM.
+
+## Installation
+pipx install sentence-menu
+
+## Usage
+Interactively add a command: `sentence-menu add`
+
+Interactively edit an entry: `sentence-menu edit`
+
+Run a command: `sentence-menu`
+
+Print a command to standard out: `sentence-menu echo`
+
+## About me
+I am @readwithai. I make lots of small tools like this. I also make tools for reading with and without AI.

sentence_menu-1.0.0/sentence_menu.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+pyproject.toml
+sentence_menu/__init__.py
+sentence_menu/main.py
+sentence_menu.egg-info/PKG-INFO
+sentence_menu.egg-info/SOURCES.txt
+sentence_menu.egg-info/dependency_links.txt
+sentence_menu.egg-info/entry_points.txt
+sentence_menu.egg-info/top_level.txt

sentence_menu-1.0.0/sentence_menu.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

sentence_menu-1.0.0/sentence_menu.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+sentence-menu = sentence_menu.main:main

sentence_menu-1.0.0/sentence_menu.egg-info/top_level.txt

@@ -0,0 +1 @@
+sentence_menu

sentence_menu-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+