desktop-cli 0.1.0__py3-none-any.whl

desktop_cli/main.py

@@ -0,0 +1,132 @@
+#!/usr/bin/env python3
+"""
+desktop-cli — interact with .desktop files from the command line.
+"""
+
+import os
+import sys
+import argparse
+from pathlib import Path
+
+
+def desktop_dirs() -> list[Path]:
+    xdg_home = Path(os.environ.get("XDG_DATA_HOME", Path.home() / ".local/share"))
+    xdg_dirs = os.environ.get("XDG_DATA_DIRS", "/usr/share:/usr/local/share")
+    return [xdg_home / "applications"] + [
+        Path(d) / "applications" for d in xdg_dirs.split(":")
+    ]
+
+
+def find_desktop_file(name: str) -> Path | None:
+    """Find a .desktop file by name, searching XDG dirs in order."""
+    if not name.endswith(".desktop"):
+        name += ".desktop"
+    for d in desktop_dirs():
+        candidate = d / name
+        if candidate.exists():
+            return candidate
+    return None
+
+
+def find_all_desktop_files() -> list[Path]:
+    seen = set()
+    results = []
+    for d in desktop_dirs():
+        if not d.exists():
+            continue
+        for f in sorted(d.glob("*.desktop")):
+            if f.name not in seen:
+                seen.add(f.name)
+                results.append(f)
+    return results
+
+
+# ── Commands ──────────────────────────────────────────────────────────────────
+
+def cmd_cat(args):
+    """Print the contents of a desktop file."""
+    path = find_desktop_file(args.name)
+    if not path:
+        print(f"desktop: not found: {args.name}", file=sys.stderr)
+        sys.exit(1)
+    print(path.read_text(), end="")
+
+
+def cmd_path(args):
+    """Print the full path of a desktop file."""
+    path = find_desktop_file(args.name)
+    if not path:
+        print(f"desktop: not found: {args.name}", file=sys.stderr)
+        sys.exit(1)
+    print(path)
+
+
+def cmd_list(args):
+    """List all available desktop files."""
+    for f in find_all_desktop_files():
+        if args.full:
+            print(f)
+        else:
+            print(f.stem if args.no_extension else f.name)
+
+
+def cmd_exec(args):
+    """Print the Exec= line of a desktop file."""
+    path = find_desktop_file(args.name)
+    if not path:
+        print(f"desktop: not found: {args.name}", file=sys.stderr)
+        sys.exit(1)
+    for line in path.read_text().splitlines():
+        if line.startswith("Exec="):
+            cmd = line[5:].strip()
+            if not args.raw:
+                for code in ["%u", "%U", "%f", "%F", "%i", "%c", "%k"]:
+                    cmd = cmd.replace(code, "")
+                cmd = cmd.strip()
+            print(cmd)
+            return
+    print(f"desktop: no Exec= found in {args.name}", file=sys.stderr)
+    sys.exit(1)
+
+
+def cmd_dirs(args):
+    """Print the directories searched for desktop files."""
+    for d in desktop_dirs():
+        print(d)
+
+
+# ── Entry point ───────────────────────────────────────────────────────────────
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="desktop",
+        description="Interact with .desktop files from the command line.")
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    p_cat = sub.add_parser("cat", help="Print contents of a desktop file")
+    p_cat.add_argument("name", help="Desktop file name (with or without .desktop)")
+    p_cat.set_defaults(func=cmd_cat)
+
+    p_path = sub.add_parser("path", help="Print full path of a desktop file")
+    p_path.add_argument("name")
+    p_path.set_defaults(func=cmd_path)
+
+    p_list = sub.add_parser("list", help="List available desktop files")
+    p_list.add_argument("--full", action="store_true", help="Print full paths")
+    p_list.add_argument("--no-extension", action="store_true", help="Strip .desktop suffix")
+    p_list.set_defaults(func=cmd_list)
+
+    p_exec = sub.add_parser("exec", help="Print the Exec= command of a desktop file")
+    p_exec.add_argument("name")
+    p_exec.add_argument("--raw", action="store_true", help="Don't strip %u/%f/etc placeholders")
+    p_exec.set_defaults(func=cmd_exec)
+
+    p_dirs = sub.add_parser("dirs", help="Print directories searched for desktop files")
+    p_dirs.set_defaults(func=cmd_dirs)
+
+    args = parser.parse_args()
+    args.func(args)
+
+
+if __name__ == "__main__":
+    main()

desktop_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,35 @@
+Metadata-Version: 2.4
+Name: desktop-cli
+Version: 0.1.0
+Summary: A CLI for interacting with .desktop files
+Author: readwithai
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/readwithai/desktop-cli
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Desktop Environment
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# desktop-cli
+A cli for interacting with desktop files.
+
+Desktop files are the executable files of desktop environments on Linux. [Read my blog post on the topic](https://readwithai.substack.com/p/a-primer-on-linux-desktop-files).
+
+This is unreviewed AI-generated code.
+
+## Alternatives and prior work
+You could try using `locate` or similar to find desktop files. Desktop files often live in knowns locations and addition files are added to the `XDG_DATA_DIRS` environment variable. You could use this to write a shell one-liner. `gtk-launch` can be used to start desktop files (and will find them on the "desktop path").
+
+## Installation
+pipx instal desktop-cli
+
+## Usage
+`desktop list`
+
+`desktop cat obsidian.desktop`
+
+`desktop path obsidian.destop`
+

desktop_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+desktop_cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+desktop_cli/main.py,sha256=MgMHVYnQd1XkXbQfHqt2kwul9qshbJgdzCQZ95X0qM4,4340
+desktop_cli-0.1.0.dist-info/METADATA,sha256=fbLXtGLJn6G2C30uf1Qnj_YnO82oMNtMA9pic7ntIKQ,1247
+desktop_cli-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+desktop_cli-0.1.0.dist-info/entry_points.txt,sha256=e2IKBRnDmrDGquaGMzAPyOJID6jZJoDtg9zH4KQcf3U,50
+desktop_cli-0.1.0.dist-info/top_level.txt,sha256=x41vOt1pr0UOuJBAavmjZ_1AF2KLi_SxQYrx8tJU8P0,12
+desktop_cli-0.1.0.dist-info/RECORD,,

desktop_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

desktop_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+desktop = desktop_cli.main:main

desktop_cli-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+desktop_cli