codefetch-cli 1.2.4__tar.gz → 1.2.6__tar.gz

{codefetch_cli-1.2.4/codefetch_cli.egg-info → codefetch_cli-1.2.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codefetch-cli
-Version: 1.2.4
+Version: 1.2.6
 Summary: Quickly fetch code files from GitHub repositories with simple commands
 Home-page: https://github.com/InzamamulQureshi/Codefetch
 Author: Inzamamul Qureshi
@@ -35,6 +35,8 @@ CodeFetch is a lightweight command-line utility and Python library designed to q
 - **Automatic Path & Case Resolution**: Automatically resolves case mismatches and finds files nested inside subdirectories.
 - **Repository Discovery**: List all public repositories for any GitHub user with `--repos`.
 - **Tree Exploration**: List all supported code files within a repository with `--list`.
+- **Self-Updating**: Keep CodeFetch updated to the latest PyPI release with `codefetch --update`.
+- **Clean Uninstall**: Easily remove CodeFetch and its configuration with `codefetch --uninstall`.
 - **Python Library Support**: Import and use programmatically with `import codefetch as cf`.
 - **Optional Persistent Defaults**: Save a default repository or user with `--set-default` if you frequently work with the same repository.
 - **Zero Runtime Dependencies**: Built using only the Python standard library with zero third-party dependencies.
@@ -129,6 +131,16 @@ codefetch --config
 codefetch --reset-config
 ```
 
+### 5. Package Management
+
+```bash
+# Update CodeFetch to the latest version published on PyPI
+codefetch --update
+
+# Uninstall CodeFetch and remove local configuration
+codefetch --uninstall
+```
+
 ---
 
 ## Python API Usage
@@ -163,11 +175,13 @@ print(f"Found {len(files)} files")
 | `-R`, `--repos` | List public repositories for a user | `codefetch -R -u username` |
 | `-r`, `--repo` | Specify repository name or URL | `codefetch -r repo main.py` |
 | `-u`, `--user` | Specify GitHub username or organization | `codefetch -u username -r repo main.py` |
-| `-b`, `--branch` | Branch name (default: `main`) | `codefetch -b master owner/repo Makefile` |
+| `-b`, `--branch` | Branch name (default: repo default branch) | `codefetch -b master owner/repo Makefile` |
 | `--set-default` | Set persistent default repository | `codefetch --set-default owner/repo` |
 | `--set-default-user` | Set persistent default user | `codefetch --set-default-user username` |
 | `--config` | Display active configuration | `codefetch --config` |
 | `--reset-config` | Reset configuration back to defaults | `codefetch --reset-config` |
+| `-U`, `--update` | Update CodeFetch to latest PyPI release | `codefetch --update` |
+| `--uninstall` | Uninstall CodeFetch from your system | `codefetch --uninstall` |
 | `-v`, `--version` | Display version information | `codefetch --version` |
 | `-h`, `--help` | Display help and usage message | `codefetch --help` |
 

{codefetch_cli-1.2.4 → codefetch_cli-1.2.6}/README.md

@@ -13,6 +13,8 @@ CodeFetch is a lightweight command-line utility and Python library designed to q
 - **Automatic Path & Case Resolution**: Automatically resolves case mismatches and finds files nested inside subdirectories.
 - **Repository Discovery**: List all public repositories for any GitHub user with `--repos`.
 - **Tree Exploration**: List all supported code files within a repository with `--list`.
+- **Self-Updating**: Keep CodeFetch updated to the latest PyPI release with `codefetch --update`.
+- **Clean Uninstall**: Easily remove CodeFetch and its configuration with `codefetch --uninstall`.
 - **Python Library Support**: Import and use programmatically with `import codefetch as cf`.
 - **Optional Persistent Defaults**: Save a default repository or user with `--set-default` if you frequently work with the same repository.
 - **Zero Runtime Dependencies**: Built using only the Python standard library with zero third-party dependencies.
@@ -107,6 +109,16 @@ codefetch --config
 codefetch --reset-config
 ```
 
+### 5. Package Management
+
+```bash
+# Update CodeFetch to the latest version published on PyPI
+codefetch --update
+
+# Uninstall CodeFetch and remove local configuration
+codefetch --uninstall
+```
+
 ---
 
 ## Python API Usage
@@ -141,11 +153,13 @@ print(f"Found {len(files)} files")
 | `-R`, `--repos` | List public repositories for a user | `codefetch -R -u username` |
 | `-r`, `--repo` | Specify repository name or URL | `codefetch -r repo main.py` |
 | `-u`, `--user` | Specify GitHub username or organization | `codefetch -u username -r repo main.py` |
-| `-b`, `--branch` | Branch name (default: `main`) | `codefetch -b master owner/repo Makefile` |
+| `-b`, `--branch` | Branch name (default: repo default branch) | `codefetch -b master owner/repo Makefile` |
 | `--set-default` | Set persistent default repository | `codefetch --set-default owner/repo` |
 | `--set-default-user` | Set persistent default user | `codefetch --set-default-user username` |
 | `--config` | Display active configuration | `codefetch --config` |
 | `--reset-config` | Reset configuration back to defaults | `codefetch --reset-config` |
+| `-U`, `--update` | Update CodeFetch to latest PyPI release | `codefetch --update` |
+| `--uninstall` | Uninstall CodeFetch from your system | `codefetch --uninstall` |
 | `-v`, `--version` | Display version information | `codefetch --version` |
 | `-h`, `--help` | Display help and usage message | `codefetch --help` |
 

{codefetch_cli-1.2.4 → codefetch_cli-1.2.6}/codefetch/__init__.py

@@ -16,7 +16,7 @@ Usage in Python:
     files = cf.list("torvalds/linux")
 """
 
-__version__ = "1.2.4"
+__version__ = "1.2.6"
 
 
 def get(target, filename=None, branch=None):

{codefetch_cli-1.2.4 → codefetch_cli-1.2.6}/codefetch/cli.py

@@ -7,6 +7,7 @@ import argparse
 import json
 import os
 import re
+import subprocess
 import sys
 import urllib.error
 import urllib.request
@@ -14,11 +15,10 @@ from pathlib import Path
 
 DEFAULT_OWNER = None
 DEFAULT_REPO = None
-DEFAULT_BRANCH = None
 
 CONFIG_FILE = Path.home() / ".codefetch.json"
 
-__version__ = "1.2.4"
+__version__ = "1.2.6"
 
 # Supported code, data, and config extensions
 CODE_EXTENSIONS = {
@@ -62,6 +62,8 @@ USAGE:
   codefetch -s <owner>/<repo> <filename>   Preview file in terminal without saving
   codefetch -l <owner>/<repo>              List all code files in a repository
   codefetch -R <username>                  List public repositories for a user
+  codefetch --update                       Update CodeFetch to the latest version
+  codefetch --uninstall                    Uninstall CodeFetch from your system
 
 POPULAR EXAMPLES:
   # Download from any repository:
@@ -79,6 +81,10 @@ POPULAR EXAMPLES:
   codefetch -l torvalds/linux              # list files in a repo
   codefetch -R torvalds                    # list repos belonging to user
 
+  # Package management:
+  codefetch --update                       # update to latest PyPI release
+  codefetch --uninstall                    # uninstall CodeFetch package
+
 SETTING A DEFAULT REPOSITORY (OPTIONAL):
   If you frequently work with the same repo, you can set it as default:
   codefetch --set-default owner/repo       # sets default repo
@@ -98,6 +104,9 @@ FLAGS & OPTIONS:
   --set-default-user <user> Save default user/organization
   --config                  Show current saved configuration
   --reset-config            Reset configuration back to defaults
+  -U, --update              Update CodeFetch to the latest version from PyPI
+  --uninstall               Uninstall CodeFetch from your system
+  -y, --yes                 Confirm uninstall without prompting
   -v, --version             Show version number
   -h, --help                Show this help message
 """
@@ -122,7 +131,7 @@ def load_config():
 
 
 def save_config(owner=None, repo=None):
-    """Save user configuration to ~/.codefetch.json (no branch saved in config)."""
+    """Save user configuration to ~/.codefetch.json."""
     cfg = load_config()
     if owner is not None:
         cfg["owner"] = owner
@@ -478,7 +487,6 @@ def fetch_file(filename, owner=None, repo=None, branch=None,
 
     # Case A: Branch parameter was explicitly entered by the user
     if branch:
-        # First, check if the specified branch exists
         branch_exists = check_branch_exists(owner, repo, branch)
 
         if not branch_exists:
@@ -490,7 +498,6 @@ def fetch_file(filename, owner=None, repo=None, branch=None,
                 print(f"Available branches in {owner}/{repo}: {', '.join(shown)}{extra}")
             print(f"Trying default branch '{default_branch}'...")
 
-            # Fall back to default branch
             actual_branch = default_branch
             try:
                 content = fetch_raw_single(owner, repo, default_branch, clean_filename)
@@ -501,7 +508,6 @@ def fetch_file(filename, owner=None, repo=None, branch=None,
                 pass
 
             if content is None:
-                # Try tree on default branch
                 try:
                     tree_data = get_repo_tree(owner, repo, default_branch)
                     matched = resolve_file_in_tree(tree_data, clean_filename)
@@ -519,7 +525,6 @@ def fetch_file(filename, owner=None, repo=None, branch=None,
                 return
 
         else:
-            # The specified branch exists! First try direct fetch from it
             actual_branch = branch
             try:
                 content = fetch_raw_single(owner, repo, branch, clean_filename)
@@ -530,7 +535,6 @@ def fetch_file(filename, owner=None, repo=None, branch=None,
                 pass
 
             if content is None:
-                # Direct raw 404ed, search tree of the specified branch
                 try:
                     tree_data = get_repo_tree(owner, repo, branch)
                     matched = resolve_file_in_tree(tree_data, clean_filename)
@@ -542,7 +546,6 @@ def fetch_file(filename, owner=None, repo=None, branch=None,
                 except Exception:
                     pass
 
-            # If file not in specified branch, check default branch as well
             if content is None and branch.lower() != default_branch.lower():
                 print(f"Notice: File '{clean_filename}' not found on branch '{branch}'.")
                 available_branches = get_repo_branches(owner, repo)
@@ -593,7 +596,6 @@ def fetch_file(filename, owner=None, repo=None, branch=None,
             return
 
         if content is None:
-            # Tree search on default branch
             try:
                 tree_data = get_repo_tree(owner, repo, default_branch)
                 matched = resolve_file_in_tree(tree_data, clean_filename)
@@ -603,7 +605,6 @@ def fetch_file(filename, owner=None, repo=None, branch=None,
                     if resolved_path != clean_filename:
                         print(f"(Resolved '{clean_filename}' -> '{resolved_path}')")
                 else:
-                    # Check other public repositories for the same user
                     other_repo, other_match = find_file_in_other_repos(owner, repo, clean_filename)
                     if other_repo:
                         print(f"File not found: '{clean_filename}' in {owner}/{repo} ({default_branch}).")
@@ -639,6 +640,91 @@ def fetch_file(filename, owner=None, repo=None, branch=None,
             print(f"Error saving file '{out_name}': {e}")
 
 
+def parse_version_tuple(v_str):
+    """Parse version string like '1.2.6' into a comparable tuple of integers."""
+    try:
+        return tuple(int(x) for x in re.findall(r"\d+", v_str))
+    except Exception:
+        return (0,)
+
+
+def update_codefetch():
+    """Update codefetch-cli to the latest version from PyPI."""
+    print("Checking for updates from PyPI...")
+    package_name = "codefetch-cli"
+    latest_version = None
+
+    try:
+        url = f"https://pypi.org/pypi/{package_name}/json"
+        req = urllib.request.Request(url, headers={"User-Agent": "codefetch"})
+        with urllib.request.urlopen(req, timeout=10) as resp:
+            data = json.loads(resp.read().decode("utf-8"))
+            latest_version = data.get("info", {}).get("version")
+    except Exception as e:
+        print(f"Note: Could not check PyPI metadata ({e}).")
+
+    if latest_version:
+        curr_tuple = parse_version_tuple(__version__)
+        latest_tuple = parse_version_tuple(latest_version)
+
+        if latest_tuple <= curr_tuple:
+            print(f"CodeFetch is already up to date (version {__version__}).")
+            return
+
+        print(f"Update available: v{latest_version} (current: v{__version__})")
+        print(f"Updating {package_name}...")
+    else:
+        print(f"Updating {package_name} to latest version...")
+
+    cmd = [sys.executable, "-m", "pip", "install", "--upgrade", package_name]
+    try:
+        result = subprocess.run(cmd)
+        if result.returncode == 0:
+            target_v = f"v{latest_version}" if latest_version else "the latest version"
+            print(f"\nSuccessfully updated CodeFetch to {target_v}!")
+        else:
+            print(f"\nUpdate failed (exit code {result.returncode}).")
+            print(f"You can manually update with: pip install --upgrade {package_name}")
+    except Exception as e:
+        print(f"\nError running update: {e}")
+        print(f"You can manually update with: pip install --upgrade {package_name}")
+
+
+def uninstall_codefetch(yes=False):
+    """Uninstall codefetch-cli package from system."""
+    if not yes:
+        try:
+            choice = input("Are you sure you want to uninstall CodeFetch? [y/N]: ").strip().lower()
+        except (EOFError, KeyboardInterrupt):
+            print("\nCancelled.")
+            return
+
+        if choice not in ("y", "yes"):
+            print("Uninstall cancelled.")
+            return
+
+    # Clean up ~/.codefetch.json configuration file if present
+    if CONFIG_FILE.exists():
+        try:
+            CONFIG_FILE.unlink()
+            print(f"Removed configuration file: {CONFIG_FILE}")
+        except Exception:
+            pass
+
+    print("Uninstalling codefetch-cli...")
+    cmd = [sys.executable, "-m", "pip", "uninstall", "-y", "codefetch-cli"]
+    try:
+        result = subprocess.run(cmd)
+        if result.returncode == 0:
+            print("\nSuccessfully uninstalled CodeFetch.")
+        else:
+            print(f"\nUninstall failed (exit code {result.returncode}).")
+            print("You can manually uninstall with: pip uninstall codefetch-cli")
+    except Exception as e:
+        print(f"\nError during uninstall: {e}")
+        print("You can manually uninstall with: pip uninstall codefetch-cli")
+
+
 class CodefetchParser(argparse.ArgumentParser):
     """Custom parser providing clean, intuitive help formatting."""
 
@@ -669,6 +755,9 @@ def build_parser():
     parser.add_argument("--set-default-user", type=str, help="Save default GitHub user")
     parser.add_argument("--config", action="store_true", help="Display active configuration")
     parser.add_argument("--reset-config", action="store_true", help="Reset configuration back to defaults")
+    parser.add_argument("-U", "--update", action="store_true", help="Update CodeFetch to the latest version from PyPI")
+    parser.add_argument("--uninstall", action="store_true", help="Uninstall CodeFetch from your system")
+    parser.add_argument("-y", "--yes", action="store_true", help="Confirm uninstall without prompting")
     parser.add_argument("-v", "--version", action="version", version=f"%(prog)s {__version__}")
     parser.add_argument("-h", "--help", action="help", help="Show help message")
 
@@ -738,6 +827,16 @@ def main():
     parser = build_parser()
     args = parser.parse_args()
 
+    # Handle --update
+    if args.update:
+        update_codefetch()
+        return
+
+    # Handle --uninstall
+    if args.uninstall:
+        uninstall_codefetch(yes=args.yes)
+        return
+
     config = load_config()
     default_owner = config.get("owner", DEFAULT_OWNER)
     default_repo = config.get("repo", DEFAULT_REPO)
@@ -776,7 +875,6 @@ def main():
         print("CodeFetch Configuration:")
         print(f"  Default User:        {default_owner or 'None (not set)'}")
         print(f"  Default Repository:  {default_repo or 'None (not set)'}")
-        print("  Default Branch:      None (auto-detect repository default)")
         print(f"  Config File:         {CONFIG_FILE}")
         return
 

{codefetch_cli-1.2.4 → codefetch_cli-1.2.6/codefetch_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codefetch-cli
-Version: 1.2.4
+Version: 1.2.6
 Summary: Quickly fetch code files from GitHub repositories with simple commands
 Home-page: https://github.com/InzamamulQureshi/Codefetch
 Author: Inzamamul Qureshi
@@ -35,6 +35,8 @@ CodeFetch is a lightweight command-line utility and Python library designed to q
 - **Automatic Path & Case Resolution**: Automatically resolves case mismatches and finds files nested inside subdirectories.
 - **Repository Discovery**: List all public repositories for any GitHub user with `--repos`.
 - **Tree Exploration**: List all supported code files within a repository with `--list`.
+- **Self-Updating**: Keep CodeFetch updated to the latest PyPI release with `codefetch --update`.
+- **Clean Uninstall**: Easily remove CodeFetch and its configuration with `codefetch --uninstall`.
 - **Python Library Support**: Import and use programmatically with `import codefetch as cf`.
 - **Optional Persistent Defaults**: Save a default repository or user with `--set-default` if you frequently work with the same repository.
 - **Zero Runtime Dependencies**: Built using only the Python standard library with zero third-party dependencies.
@@ -129,6 +131,16 @@ codefetch --config
 codefetch --reset-config
 ```
 
+### 5. Package Management
+
+```bash
+# Update CodeFetch to the latest version published on PyPI
+codefetch --update
+
+# Uninstall CodeFetch and remove local configuration
+codefetch --uninstall
+```
+
 ---
 
 ## Python API Usage
@@ -163,11 +175,13 @@ print(f"Found {len(files)} files")
 | `-R`, `--repos` | List public repositories for a user | `codefetch -R -u username` |
 | `-r`, `--repo` | Specify repository name or URL | `codefetch -r repo main.py` |
 | `-u`, `--user` | Specify GitHub username or organization | `codefetch -u username -r repo main.py` |
-| `-b`, `--branch` | Branch name (default: `main`) | `codefetch -b master owner/repo Makefile` |
+| `-b`, `--branch` | Branch name (default: repo default branch) | `codefetch -b master owner/repo Makefile` |
 | `--set-default` | Set persistent default repository | `codefetch --set-default owner/repo` |
 | `--set-default-user` | Set persistent default user | `codefetch --set-default-user username` |
 | `--config` | Display active configuration | `codefetch --config` |
 | `--reset-config` | Reset configuration back to defaults | `codefetch --reset-config` |
+| `-U`, `--update` | Update CodeFetch to latest PyPI release | `codefetch --update` |
+| `--uninstall` | Uninstall CodeFetch from your system | `codefetch --uninstall` |
 | `-v`, `--version` | Display version information | `codefetch --version` |
 | `-h`, `--help` | Display help and usage message | `codefetch --help` |
 

{codefetch_cli-1.2.4 → codefetch_cli-1.2.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "codefetch-cli"
-version = "1.2.4"
+version = "1.2.6"
 description = "Quickly fetch code files from GitHub repositories with simple commands"
 readme = "README.md"
 license = "MIT"

{codefetch_cli-1.2.4 → codefetch_cli-1.2.6}/setup.py

@@ -7,7 +7,7 @@ long_description = readme_path.read_text(encoding="utf-8") if readme_path.exists
 
 setup(
     name="codefetch-cli",
-    version="1.2.4",
+    version="1.2.6",
     description="Quickly fetch code files from GitHub repositories with simple commands",
     long_description=long_description,
     long_description_content_type="text/markdown",