flatgrep 0.2.0__py3-none-any.whl

flatgrep/main.py

@@ -0,0 +1,117 @@
+#!/usr/bin/env python3
+import sys, subprocess, re, pyperclip
+from pyfzf.pyfzf import FzfPrompt
+from rich.console import Console
+
+console = Console()
+fzf = FzfPrompt()
+
+def run(cmd):
+    return subprocess.run(cmd, text=True, capture_output=True).stdout.splitlines()
+
+def pick(items, header):
+    if not items:
+        console.print("[red]Nothing to Show.[/]")
+        sys.exit(1)
+
+    sel = fzf.prompt(items, fzf_options=f"--header='{header}'")
+    if not sel:
+        console.print("[red]Abort.[/]")
+        sys.exit(1)
+
+    return sel[0]
+
+def search_flatpaks(term, remote=False, skipfzf=False):
+    cmd = (
+        ["flatpak", "search", term, "--columns=application"]
+        if remote
+        else ["flatpak", "list", "--columns=application"]
+    )
+
+    lines = run(cmd)
+    apps = [l.strip() for l in lines if l.strip()]
+    filtered = [a for a in apps if term.lower() in a.lower()]
+
+    if len(filtered) == 1:
+        return filtered[0]
+
+    if skipfzf:
+        raise Exception("Skip fzf")
+
+    return pick(filtered or apps, f"Choose '{term}' application id.")
+
+def install(term):
+    app = search_flatpaks(term, remote=True)
+    try:
+        result = subprocess.run(
+            ["flatpak", "install", "flathub", app],
+            text=True,
+        )
+        if result.returncode == 0:
+            console.print(f"[green]Installed:[/] {app}")
+            copycmd = f"flatpak run {app}"
+            pyperclip.copy(copycmd)
+            console.print(f"[blue]Copied to clipboard:[/] {copycmd}")
+        else:
+            console.print(f"[yellow]Installation cancelled by user[/]")
+            pyperclip.copy(app)
+            console.print(f"[blue]Copied to clipboard:[/] {app}")
+    except Exception as e:
+        console.print(f"[red]Error:[/] {e}")
+
+    return app
+
+def remove(term):
+    app = search_flatpaks(term, remote=False)
+    try:
+        result = subprocess.run(
+            ["flatpak", "remove", "-y", app],
+            text=True,
+        )
+        if result.returncode == 0:
+            console.print(f"[green]Removed:[/] {app}")
+            pyperclip.copy(app)
+            console.print(f"[blue]Copied to clipboard:[/] {app}")
+    except Exception as e:
+        console.print(f"[red]Error:[/] {e}")
+    
+
+
+def copy(term):
+    app = search_flatpaks(term)
+    pyperclip.copy(app)
+    console.print(f"[blue]Copied to clipboard:[/] {app}")
+    return app
+
+def auto(term):
+    try:
+        app = search_flatpaks(term, remote=False, skipfzf=True)
+        pyperclip.copy(app)
+        console.print(f"[blue]Copied to clipboard:[/] {app}")
+        return
+    except Exception:
+        pass
+    app = install(term)
+
+def main():
+    if len(sys.argv) == 2:
+        term = sys.argv[1]
+        auto(term)
+        return
+
+    if len(sys.argv) < 3:
+        console.print("[bold]Uso:[/] flat.py [install|remove|run|copy] app_id")
+        sys.exit(1)
+
+    action, term = sys.argv[1], sys.argv[2]
+
+    if action == "install": install(term)
+    elif action in ("remove", "uninstall"): remove(term)
+    elif action == "run": run_app(term)
+    elif action in ("copy", "search"): copy(term)
+    else:
+        console.print("[red]Invalid action[/]")
+
+if __name__ == "__main__":
+    main()
+

flatgrep-0.2.0.dist-info/METADATA

@@ -0,0 +1,159 @@
+Metadata-Version: 2.4
+Name: flatgrep
+Version: 0.2.0
+Summary: Quicky interact with flatpak cli
+Author-email: Rodolfo Franca <souzafrodolfo@gmail.com>
+License: Copyright (c) 2025 Rodolfo Souza
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software with restriction for profit activities. 
+        User can use, copy, modify, merge, publish, distribute, copies of the Software, 
+        and to permit persons to whom the Software is furnished to do so, subject to 
+        the following conditions:
+        
+        * Do not profit with this software, it is created to be free in all sense of libre.
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Requires-Python: >=3.13
+Requires-Dist: pyfzf==0.3.1
+Requires-Dist: pyperclip==1.9.0
+Requires-Dist: rich==14.1.0
+Requires-Dist: setuptools==80.9.0
+Description-Content-Type: text/markdown
+
+# Flatgrep ⚡*Alpha v0.1.3*
+> Automated searches for boring CLI tools.
+
+Tired of typing by hand `flatpak run com.something.veryobnoxious`?  
+Try **Flatgrep** for fuzzy search and grep what you want in just seconds. 
+
+* **Quick test :** 
+```bash
+flatgrep run mpv
+```
+
+* **Fast and easy install apps from Flathub:**
+```bash
+flatgrep install firefox
+```
+
+## What is Flatgrep?
+
+**Flatgrep** is a smart, fuzzy-finding command-line wrapper for Flatpak that makes searching, installing, and managing your applications a breeze. It enhances the standard `flatpak` commands with an interactive `fzf` interface, ensuring you find and select the right application quickly, even with typos or partial names.
+
+## Why Flatgrep?
+
+Tired of trying to guess the exact application ID for a Flatpak? The default `flatpak search` can be cumbersome. Flatgrep solves this by providing a powerful and intuitive search layer on top of Flatpak.
+
+* **Typo-proof Searching**: Can't remember if it's `Discord` or `discord`? Just type `disc` and let the fuzzy finder show you the options.
+* **Interactive Selection**: No more manually copying and pasting long app IDs like `org.gimp.GIMP`. Just search, select from the list, and let Flatgrep handle the rest. The selected ID is copied to your clipboard automatically.
+* **Unified Workflow**: Use one consistent and powerful search tool to find, install, run, and uninstall your Flatpak apps.
+
+## Features
+
+* ✅ **Smart Interactive Search**: Uses `fzf` to provide a fuzzy search interface for both locally installed apps and the entire Flathub repository.
+* 🧠 **Intelligent Filtering**:
+    * If there's one perfect match, it's selected automatically.
+    * If there are multiple matches, you can choose from an interactive list using `fzf`.
+    * If no initial match is found, it falls back to a fuzzy search over the entire list of apps.
+* 📋 **Clipboard Integration**: The selected application ID is automatically copied to your clipboard for convenience.
+* 🎨 **Rich Terminal Output**: Utilizes the `rich` library for clean, modern, and colorful command-line feedback.
+* 🚀 **Full Management Suite**: Provides intuitive commands for `search`, `install`, `run`, and `uninstall`.
+
+## Command Table 
+
+| Action                          | Linux Command                          |
+|---------------------------------|----------------------------------------|
+| **Search on Flathub**           | `flatgrep search "app name" --flathub` |
+| **List locally installed apps** | `flatgrep search "app name"`           |
+| **Install an app from Flathub** | `flatgrep install "app name"`          |
+| **Run an app**                  | `flatgrep run "app name"`              |
+| **Uninstall an app**            | `flatgrep uninstall "app name"`        |
+
+---
+
+## Building Instructions 
+
+#### Prerequisites
+
+Before you begin, make sure you have the following installed on your system:
+* Python 3.8+
+* Flatpak
+* `fzf` (a command-line fuzzy finder)
+
+You can install `fzf` using your system's package manager:
+```bash
+# Debian/Ubuntu
+sudo apt install fzf
+
+# Fedora
+sudo dnf install fzf
+
+# Arch Linux
+sudo pacman -S fzf
+```
+
+#### Clone Git Repository
+```bash
+git clone git@github.com:rodhfr/flatgrep.git
+cd flatgrep/src
+```
+
+#### Setup Python Virtual Environment 
+```bash
+# Create python virtual environment (isolated dependencies)
+python -m venv .venv
+
+# Activate the virtual python shell
+source .venv/bin/activate # also works for zsh
+#source .venv/bin/activate.fish # uncomment this line for fish shell
+
+# Install python library requeriments
+pip install -r requirements.txt
+```
+
+#### Install
+```bash
+# installation is just a binary in $HOME/.local/bin
+sh build_and_install.sh
+```
+
+#### Uninstall
+```bash
+# Or just remove the binary located in $HOME/.local/bin
+sh uninstall.sh
+```
+
+---
+
+## Management
+
+### Released Features ✅
+- [x] Search installed Flatpak app IDs.
+- [x] Copy app IDs to the clipboard.
+- [x] Install Flatpaks via fuzzy search with `--flathub` flag.
+- [x] Rich-text console.
+- [x] Run Flatpaks with `run` mode 'feature: 2025-09-15.v0.1.1'
+- [x] Write building instructions and program description. 'feature: 2025-09-16.v0.1.3'
+
+### Planned 🛠️
+- [ ] Write installation guide.
+- [ ] Release in some package manager.
+- [ ] Write documentation.
+- [ ] Search mode also searches by app names not only app ids.
+- [ ] Run mode update: Auto install app if not available.
+- [ ] Proper sanitize search command.
+
+### Potential Features 🤔
+- [ ] Other package managers like dnf/pacman/aur helpers.

flatgrep-0.2.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+flatgrep/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+flatgrep/main.py,sha256=zLHOTkMWeWv_ViNCFVvMMrIh9aAEBeGQilF9IucuQDs,3183
+flatgrep-0.2.0.dist-info/METADATA,sha256=dgDtviszM6Fcbsv569glhp3b2MegwHSqggu16RjBQ7c,6157
+flatgrep-0.2.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+flatgrep-0.2.0.dist-info/entry_points.txt,sha256=H-Jyn_ahGMElboMMu6JU0xyFzJwl_XuMqP83U37nkxU,48
+flatgrep-0.2.0.dist-info/licenses/LICENSE,sha256=zIuJtH5CImTT2Ho9HCb1N44xKbCeROyLdYZfdZAyMzM,1106
+flatgrep-0.2.0.dist-info/RECORD,,

flatgrep-0.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

flatgrep-0.2.0.dist-info/entry_points.txt

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

flatgrep-0.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) 2025 Rodolfo Souza
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software with restriction for profit activities. 
+User can use, copy, modify, merge, publish, distribute, copies of the Software, 
+and to permit persons to whom the Software is furnished to do so, subject to 
+the following conditions:
+
+* Do not profit with this software, it is created to be free in all sense of libre.
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.