pluck-cli 0.1.0__tar.gz → 0.2.1__tar.gz

{pluck_cli-0.1.0/src/pluck_cli.egg-info → pluck_cli-0.2.1}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: pluck-cli
-Version: 0.1.0
+Version: 0.2.1
 Summary: Pluck any git repo from any forge — auto-detect, auto-install, done!
 Author: pluck contributors
-License-Expression: MIT
+License: MIT
 Keywords: git,forge,installer,cli,github,gitlab,codeberg
 Classifier: Development Status :: 3 - Alpha
 Classifier: Environment :: Console
@@ -36,7 +36,9 @@ Dynamic: license-file
   <img src="https://img.shields.io/badge/Dependencies-Zero-brightgreen" alt="Zero dependencies">
   <img src="https://img.shields.io/badge/Tests-111%20passing-brightgreen" alt="111 passing tests">
   <img src="https://img.shields.io/badge/Forges-11%20supported-blue" alt="11 forges supported">
+  <img src="https://img.shields.io/badge/PyPI-pluck--cli-blue?logo=pypi" alt="PyPI: pluck-cli">
   <img src="https://img.shields.io/badge/Code%20style-ruff-EF5552" alt="Code style: ruff">
+  <img src="https://gitlab.com/mabodu/pluck/badges/main/pipeline.svg" alt="GitLab CI">
 </p>
 
 ---
@@ -138,6 +140,10 @@ pluck install https://bitbucket.org/owner/repo
 
 ## 🌐 Supported Forges
 
+<p align="center">
+  <img src="assets/images/pluck_front_baubles.png" alt="All the forges" width="500"/>
+</p>
+
 | Forge | Host | Built-in | Notes |
 |-------|------|----------|-------|
 | **GitHub** | `github.com` | ✅ | Full support including gists |
@@ -169,7 +175,7 @@ Any git hosting platform that follows the standard `host/owner/repo` URL pattern
 | `stats` | Show statistics | `pluck stats` |
 | `doctor` | Check tool availability | `pluck doctor` |
 | `config [key] [val]` | View/set config | `pluck config install_dir ~/Apps` |
-| `search <query>` | Search GitHub repos (other forges coming) | `pluck search python installer` |
+| `search <query> [--forge <name>]` | Search repos (github\|gitlab\|codeberg\|bitbucket) | `pluck search python installer --forge gitlab` |
 | `export <file>` | Export registry | `pluck export ~/backup.json` |
 | `import <file>` | Import registry | `pluck import ~/backup.json` |
 | `completion <shell>` | Generate shell completion | `pluck completion bash` |
@@ -191,6 +197,7 @@ Any git hosting platform that follows the standard `host/owner/repo` URL pattern
 | `--no-color` | Disable colored output |
 | `--timeout <secs>` | Timeout for git clone in seconds |
 | `--retries <n>` | Number of retries for failed git clone |
+| `--verbose` | Show detailed git clone output |
 
 ## 📥 Installation
 
@@ -208,15 +215,12 @@ pip install -e .
 ./src/gh_install.py install https://gitlab.com/user/project
 ```
 
-### Via pip (not yet on PyPI)
+### Via pip
 
 ```bash
-# Once published to PyPI:
 pip install pluck-cli
 ```
 
-> **Note**: `pluck-cli` is not yet published to PyPI. Install from source above, or use the Docker image.
-
 ### Via Docker
 
 ```bash
@@ -261,6 +265,10 @@ Available environment variables:
 
 ## 🖱️ Browser Integration
 
+<p align="center">
+  <img src="assets/images/pluck_stalking2.png" alt="pluck stalking repos in your browser" width="500"/>
+</p>
+
 Pluck includes a **right-click context menu** integration. Install a repo from any
 forge without leaving your browser.
 

{pluck_cli-0.1.0 → pluck_cli-0.2.1}/README.md

@@ -11,7 +11,9 @@
   <img src="https://img.shields.io/badge/Dependencies-Zero-brightgreen" alt="Zero dependencies">
   <img src="https://img.shields.io/badge/Tests-111%20passing-brightgreen" alt="111 passing tests">
   <img src="https://img.shields.io/badge/Forges-11%20supported-blue" alt="11 forges supported">
+  <img src="https://img.shields.io/badge/PyPI-pluck--cli-blue?logo=pypi" alt="PyPI: pluck-cli">
   <img src="https://img.shields.io/badge/Code%20style-ruff-EF5552" alt="Code style: ruff">
+  <img src="https://gitlab.com/mabodu/pluck/badges/main/pipeline.svg" alt="GitLab CI">
 </p>
 
 ---
@@ -113,6 +115,10 @@ pluck install https://bitbucket.org/owner/repo
 
 ## 🌐 Supported Forges
 
+<p align="center">
+  <img src="assets/images/pluck_front_baubles.png" alt="All the forges" width="500"/>
+</p>
+
 | Forge | Host | Built-in | Notes |
 |-------|------|----------|-------|
 | **GitHub** | `github.com` | ✅ | Full support including gists |
@@ -144,7 +150,7 @@ Any git hosting platform that follows the standard `host/owner/repo` URL pattern
 | `stats` | Show statistics | `pluck stats` |
 | `doctor` | Check tool availability | `pluck doctor` |
 | `config [key] [val]` | View/set config | `pluck config install_dir ~/Apps` |
-| `search <query>` | Search GitHub repos (other forges coming) | `pluck search python installer` |
+| `search <query> [--forge <name>]` | Search repos (github\|gitlab\|codeberg\|bitbucket) | `pluck search python installer --forge gitlab` |
 | `export <file>` | Export registry | `pluck export ~/backup.json` |
 | `import <file>` | Import registry | `pluck import ~/backup.json` |
 | `completion <shell>` | Generate shell completion | `pluck completion bash` |
@@ -166,6 +172,7 @@ Any git hosting platform that follows the standard `host/owner/repo` URL pattern
 | `--no-color` | Disable colored output |
 | `--timeout <secs>` | Timeout for git clone in seconds |
 | `--retries <n>` | Number of retries for failed git clone |
+| `--verbose` | Show detailed git clone output |
 
 ## 📥 Installation
 
@@ -183,15 +190,12 @@ pip install -e .
 ./src/gh_install.py install https://gitlab.com/user/project
 ```
 
-### Via pip (not yet on PyPI)
+### Via pip
 
 ```bash
-# Once published to PyPI:
 pip install pluck-cli
 ```
 
-> **Note**: `pluck-cli` is not yet published to PyPI. Install from source above, or use the Docker image.
-
 ### Via Docker
 
 ```bash
@@ -236,6 +240,10 @@ Available environment variables:
 
 ## 🖱️ Browser Integration
 
+<p align="center">
+  <img src="assets/images/pluck_stalking2.png" alt="pluck stalking repos in your browser" width="500"/>
+</p>
+
 Pluck includes a **right-click context menu** integration. Install a repo from any
 forge without leaving your browser.
 

{pluck_cli-0.1.0 → pluck_cli-0.2.1}/pyproject.toml

@@ -4,10 +4,10 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pluck-cli"
-version = "0.1.0"
+version = "0.2.1"
 description = "Pluck any git repo from any forge — auto-detect, auto-install, done!"
 readme = "README.md"
-license = "MIT"
+license = {text = "MIT"}
 requires-python = ">=3.6"
 authors = [
     {name = "pluck contributors"}

{pluck_cli-0.1.0 → pluck_cli-0.2.1}/src/gh_install.py

@@ -18,7 +18,7 @@ import urllib.request
 from datetime import datetime
 from pathlib import Path
 
-__version__ = "0.1.0"
+__version__ = "0.2.1"
 
 # Configuration
 DEFAULT_INSTALL_DIR_MACOS = Path.home() / "Applications"
@@ -88,7 +88,7 @@ def print_usage():
         ("stats", "Show installation statistics"),
         ("doctor", "Check tool availability"),
         ("config [key] [value]", "View/set config"),
-        ("search <query> [--forge <name>]", "Search repos (github|gitlab|codeberg)"),
+        ("search <query> [--forge <name>]", "Search repos (github|gitlab|codeberg|bitbucket)"),
         ("export <file>", "Export registry"),
         ("import <file>", "Import registry"),
         ("completion <shell>", "Generate shell completion"),
@@ -107,6 +107,7 @@ def print_usage():
         ("--no-color", "Disable colored output"),
         ("--timeout <secs>", "Timeout for git clone in seconds"),
         ("--retries <n>", "Number of retries for failed git clone"),
+        ("--verbose", "Show detailed git clone output"),
     ]
 
     print("Usage:")
@@ -632,6 +633,7 @@ def download_and_install(
     shallow=False,
     ref=None,
     method_override=None,
+    verbose=False,
     timeout=None,
     retries=0,
 ):
@@ -689,7 +691,9 @@ def download_and_install(
             print("  Downloading...")
 
         try:
-            subprocess.run(clone_cmd, check=True, timeout=timeout)
+            subprocess.run(clone_cmd, check=True, timeout=timeout,
+                           stdout=None if verbose else subprocess.DEVNULL,
+                           stderr=None if verbose else subprocess.DEVNULL)
             break
         except subprocess.TimeoutExpired:
             print_error(f"Clone timed out after {timeout}s")
@@ -1037,31 +1041,31 @@ def search_codeberg(query, limit=10):
             repo.get("html_url", ""),
         )
 
-    url = f"https://api.github.com/search/repositories?q={urllib.parse.quote(query)}&sort=stars&order=desc&per_page={limit}"
+
+def search_bitbucket(query, limit=10):
+    """Search repositories using the Bitbucket Cloud API."""
+    print(f"  Searching Bitbucket for '{query}'...")
+    url = f"https://api.bitbucket.org/2.0/repositories?q=name~\"{urllib.parse.quote(query)}\"&sort=-updated_on"
     try:
-        req = urllib.request.Request(url, headers={"Accept": "application/vnd.github.v3+json"})
+        req = urllib.request.Request(url, headers={"Accept": "application/json"})
         with urllib.request.urlopen(req, timeout=10) as resp:
             data = json.loads(resp.read().decode())
     except Exception as e:
         print_error(f"Search failed: {e}")
         return
 
-    items = data.get("items", [])
+    items = data.get("values", [])
     if not items:
         print_warning("No results found")
         return
 
-    print_header(f"Search Results for '{query}' ({len(items)} found)")
+    print_header(f"Bitbucket Results — '{query}' ({len(items)} found)")
     for i, repo in enumerate(items, 1):
-        name = repo["full_name"]
-        stars = repo["stargazers_count"]
+        full_name = repo.get("full_name", "unknown")
         desc = repo.get("description") or "No description"
         lang = repo.get("language") or "Unknown"
-        print(f"  {i}. {Colors.GREEN}{name}{Colors.END}")
-        print(f"     {desc}")
-        print(f"     {Colors.CYAN}★{Colors.END} {stars:,}  |  Language: {lang}")
-        print(f"     URL: {repo['html_url']}")
-        print()
+        url = repo.get("links", {}).get("html", {}).get("href", "")
+        _search_print_result(i, full_name, desc, 0, lang, url, star_char="\u2022")
 
 
 def export_registry(filepath):
@@ -1122,7 +1126,7 @@ def register_app(repo_name, repo_url, install_path, install_method, skip_hook=Fa
 
 def _run_post_install_hook(repo_name, install_path, method):
     """Run user-defined post-install hook if configured."""
-    hook_dir = CONFIG_FILE.parent / "pluck" / "hooks"
+    hook_dir = CONFIG_FILE.parent / "hooks"
     hook_file = hook_dir / "post-install.sh"
 
     if hook_file.exists():
@@ -1296,6 +1300,7 @@ def _parse_args(args):
     method = None
     json_output = False
     no_color = False
+    verbose = False
     timeout = None
     retries = 0
     urls = []
@@ -1326,6 +1331,9 @@ def _parse_args(args):
         elif args[i] == "--json":
             json_output = True
             i += 1
+        elif args[i] == "--verbose":
+            verbose = True
+            i += 1
         elif args[i] == "--no-color":
             no_color = True
             i += 1
@@ -1350,7 +1358,7 @@ def _parse_args(args):
     if no_color:
         _enable_colors(False)
 
-    return install_dir, dry_run, force, shallow, ref, method, json_output, timeout, retries, urls
+    return install_dir, dry_run, force, shallow, ref, method, json_output, verbose, no_color, timeout, retries, urls
 
 
 def verify_apps(json_output=False):
@@ -1525,7 +1533,7 @@ def main():
     command = sys.argv[1]
 
     if command == "install":
-        install_dir, dry_run, force, shallow, ref, method, json_output, timeout, retries, urls = (
+        install_dir, dry_run, force, shallow, ref, method, json_output, verbose, no_color, timeout, retries, urls = (
             _parse_args(sys.argv[2:])
         )
 
@@ -1549,12 +1557,13 @@ def main():
                 shallow=shallow,
                 ref=ref,
                 method_override=method,
+                verbose=verbose,
                 timeout=timeout,
                 retries=retries,
             )
 
     elif command == "update":
-        install_dir, dry_run, force, shallow, ref, method, json_output, timeout, retries, rest = (
+        install_dir, dry_run, force, shallow, ref, method, json_output, verbose, no_color, timeout, retries, rest = (
             _parse_args(sys.argv[2:])
         )
         if not rest:
@@ -1588,7 +1597,7 @@ def main():
         list_installed(json_output=json_output)
 
     elif command in ("uninstall", "remove"):
-        install_dir, dry_run, force, shallow, ref, method, json_output, timeout, retries, rest = (
+        install_dir, dry_run, force, shallow, ref, method, json_output, verbose, no_color, timeout, retries, rest = (
             _parse_args(sys.argv[2:])
         )
         if not rest:
@@ -1603,7 +1612,7 @@ def main():
         verify_apps(json_output=json_output)
 
     elif command == "clean":
-        install_dir, dry_run, force, shallow, ref, method, json_output, timeout, retries, rest = (
+        install_dir, dry_run, force, shallow, ref, method, json_output, verbose, no_color, timeout, retries, rest = (
             _parse_args(sys.argv[2:])
         )
         clean_registry(dry_run=dry_run, force=force, json_output=json_output)
@@ -1642,6 +1651,7 @@ def main():
             "github": search_github,
             "gitlab": search_gitlab,
             "codeberg": search_codeberg,
+            "bitbucket": search_bitbucket,
         }
         searcher = forge_searchers.get(forge)
         if searcher:

{pluck_cli-0.1.0 → pluck_cli-0.2.1/src/pluck_cli.egg-info}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: pluck-cli
-Version: 0.1.0
+Version: 0.2.1
 Summary: Pluck any git repo from any forge — auto-detect, auto-install, done!
 Author: pluck contributors
-License-Expression: MIT
+License: MIT
 Keywords: git,forge,installer,cli,github,gitlab,codeberg
 Classifier: Development Status :: 3 - Alpha
 Classifier: Environment :: Console
@@ -36,7 +36,9 @@ Dynamic: license-file
   <img src="https://img.shields.io/badge/Dependencies-Zero-brightgreen" alt="Zero dependencies">
   <img src="https://img.shields.io/badge/Tests-111%20passing-brightgreen" alt="111 passing tests">
   <img src="https://img.shields.io/badge/Forges-11%20supported-blue" alt="11 forges supported">
+  <img src="https://img.shields.io/badge/PyPI-pluck--cli-blue?logo=pypi" alt="PyPI: pluck-cli">
   <img src="https://img.shields.io/badge/Code%20style-ruff-EF5552" alt="Code style: ruff">
+  <img src="https://gitlab.com/mabodu/pluck/badges/main/pipeline.svg" alt="GitLab CI">
 </p>
 
 ---
@@ -138,6 +140,10 @@ pluck install https://bitbucket.org/owner/repo
 
 ## 🌐 Supported Forges
 
+<p align="center">
+  <img src="assets/images/pluck_front_baubles.png" alt="All the forges" width="500"/>
+</p>
+
 | Forge | Host | Built-in | Notes |
 |-------|------|----------|-------|
 | **GitHub** | `github.com` | ✅ | Full support including gists |
@@ -169,7 +175,7 @@ Any git hosting platform that follows the standard `host/owner/repo` URL pattern
 | `stats` | Show statistics | `pluck stats` |
 | `doctor` | Check tool availability | `pluck doctor` |
 | `config [key] [val]` | View/set config | `pluck config install_dir ~/Apps` |
-| `search <query>` | Search GitHub repos (other forges coming) | `pluck search python installer` |
+| `search <query> [--forge <name>]` | Search repos (github\|gitlab\|codeberg\|bitbucket) | `pluck search python installer --forge gitlab` |
 | `export <file>` | Export registry | `pluck export ~/backup.json` |
 | `import <file>` | Import registry | `pluck import ~/backup.json` |
 | `completion <shell>` | Generate shell completion | `pluck completion bash` |
@@ -191,6 +197,7 @@ Any git hosting platform that follows the standard `host/owner/repo` URL pattern
 | `--no-color` | Disable colored output |
 | `--timeout <secs>` | Timeout for git clone in seconds |
 | `--retries <n>` | Number of retries for failed git clone |
+| `--verbose` | Show detailed git clone output |
 
 ## 📥 Installation
 
@@ -208,15 +215,12 @@ pip install -e .
 ./src/gh_install.py install https://gitlab.com/user/project
 ```
 
-### Via pip (not yet on PyPI)
+### Via pip
 
 ```bash
-# Once published to PyPI:
 pip install pluck-cli
 ```
 
-> **Note**: `pluck-cli` is not yet published to PyPI. Install from source above, or use the Docker image.
-
 ### Via Docker
 
 ```bash
@@ -261,6 +265,10 @@ Available environment variables:
 
 ## 🖱️ Browser Integration
 
+<p align="center">
+  <img src="assets/images/pluck_stalking2.png" alt="pluck stalking repos in your browser" width="500"/>
+</p>
+
 Pluck includes a **right-click context menu** integration. Install a repo from any
 forge without leaving your browser.
 

{pluck_cli-0.1.0 → pluck_cli-0.2.1}/tests/test_gh_install.py

@@ -433,7 +433,7 @@ class TestParseArgs:
     def test_urls_only(self):
         (
             install_dir, dry_run, force, shallow, ref,
-            method, json_output, timeout, retries, urls,
+            method, json_output, verbose, no_color, timeout, retries, urls,
         ) = _parse_args(["https://github.com/a/b"])
         assert install_dir is None
         assert dry_run is False
@@ -446,7 +446,7 @@ class TestParseArgs:
     def test_dir_flag(self):
         (
             install_dir, dry_run, force, shallow, ref,
-            method, json_output, timeout, retries, urls,
+            method, json_output, verbose, no_color, timeout, retries, urls,
         ) = _parse_args(["--dir", "/tmp/test", "https://github.com/a/b"])
         assert install_dir == Path("/tmp/test")
         assert urls == ["https://github.com/a/b"]
@@ -454,49 +454,49 @@ class TestParseArgs:
     def test_dry_run_flag(self):
         (
             install_dir, dry_run, force, shallow, ref,
-            method, json_output, timeout, retries, urls,
+            method, json_output, verbose, no_color, timeout, retries, urls,
         ) = _parse_args(["--dry-run", "https://github.com/a/b"])
         assert dry_run is True
 
     def test_force_flag(self):
         (
             install_dir, dry_run, force, shallow, ref,
-            method, json_output, timeout, retries, urls,
+            method, json_output, verbose, no_color, timeout, retries, urls,
         ) = _parse_args(["--force", "https://github.com/a/b"])
         assert force is True
 
     def test_yes_flag(self):
         (
             install_dir, dry_run, force, shallow, ref,
-            method, json_output, timeout, retries, urls,
+            method, json_output, verbose, no_color, timeout, retries, urls,
         ) = _parse_args(["--yes", "https://github.com/a/b"])
         assert force is True
 
     def test_shallow_flag(self):
         (
             install_dir, dry_run, force, shallow, ref,
-            method, json_output, timeout, retries, urls,
+            method, json_output, verbose, no_color, timeout, retries, urls,
         ) = _parse_args(["--shallow", "https://github.com/a/b"])
         assert shallow is True
 
     def test_ref_flag(self):
         (
             install_dir, dry_run, force, shallow, ref,
-            method, json_output, timeout, retries, urls,
+            method, json_output, verbose, no_color, timeout, retries, urls,
         ) = _parse_args(["--ref", "v2.0", "https://github.com/a/b"])
         assert ref == "v2.0"
 
     def test_method_flag(self):
         (
             install_dir, dry_run, force, shallow, ref,
-            method, json_output, timeout, retries, urls,
+            method, json_output, verbose, no_color, timeout, retries, urls,
         ) = _parse_args(["--method", "python", "https://github.com/a/b"])
         assert method == "python"
 
     def test_combined_flags(self):
         (
             install_dir, dry_run, force, shallow, ref,
-            method, json_output, timeout, retries, urls,
+            method, json_output, verbose, no_color, timeout, retries, urls,
         ) = _parse_args([
             "--dir", "/custom", "--dry-run", "--shallow",
             "--ref", "main", "--method", "python",
@@ -511,7 +511,7 @@ class TestParseArgs:
     def test_flags_between_urls(self):
         (
             install_dir, dry_run, force, shallow, ref,
-            method, json_output, timeout, retries, urls,
+            method, json_output, verbose, no_color, timeout, retries, urls,
         ) = _parse_args([
             "https://github.com/a/b", "--dir", "/opt", "https://github.com/c/d",
         ])