codefetch-cli 1.2.0__tar.gz

codefetch_cli-1.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Reaver101
+
+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 without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+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.

codefetch_cli-1.2.0/PKG-INFO

@@ -0,0 +1,182 @@
+Metadata-Version: 2.4
+Name: codefetch-cli
+Version: 1.2.0
+Summary: Quickly fetch code files from GitHub repositories with simple commands
+Home-page: https://github.com/InzamamulQureshi/Codefetch
+Author: Inzamamul Qureshi
+Author-email: Inzamamul Qureshi <inzamamulqureshi@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/InzamamulQureshi/Codefetch
+Project-URL: Repository, https://github.com/InzamamulQureshi/Codefetch
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Environment :: Console
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# CodeFetch
+
+Quickly fetch code files from GitHub repositories with simple commands.
+
+CodeFetch is a lightweight command-line utility designed to quickly inspect, preview, and download individual source code files directly from any GitHub repository without needing to clone full repositories.
+
+---
+
+## Features
+
+- **Any User & Repository**: Fetch files from any public GitHub repository using intuitive syntax (`codefetch <user>/<repo> <filename>`).
+- **Terminal Preview**: Inspect code directly in your console with `--show` without saving it to disk.
+- **Automatic Path & Case Resolution**: Automatically resolves case mismatches (e.g., `exp1.c` -> `EXP1.c`) 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`.
+- **Persistent Defaults**: Configure your preferred default repository and user with `--set-default` and `--set-default-user`.
+- **No Dependencies**: Built using the Python standard library with zero third-party runtime dependencies.
+
+---
+
+## Installation
+
+### From PyPI
+
+```bash
+pip install codefetch-cli
+```
+
+### From GitHub
+
+```bash
+pip install git+https://github.com/InzamamulQureshi/Codefetch.git
+```
+
+### From Local Source
+
+Clone the repository and install locally:
+
+```bash
+git clone https://github.com/InzamamulQureshi/Codefetch.git
+cd Codefetch
+pip install .
+```
+
+---
+
+## Quick Start & Usage
+
+### 1. Download Files
+
+Fetch a file from any GitHub repository:
+
+```bash
+# Fetch from a specific user and repository
+codefetch InzamamulQureshi/Codefetch setup.py
+
+# Fetch using explicit flags
+codefetch -u InzamamulQureshi -r Codefetch setup.py
+
+# Fetch from a repository under the default user
+codefetch DS EXP1.c
+codefetch -r DS EXP1.c
+
+# Shorthand path syntax
+codefetch DS/EXP1.c
+
+# Fetch from the default repository
+codefetch 8.1.py
+```
+
+Save to a custom filename or directory using `-o` / `--output`:
+
+```bash
+codefetch -r DS EXP1.c -o my_experiment.c
+```
+
+### 2. Preview in Terminal (Without Downloading)
+
+Display the contents of a file directly in stdout:
+
+```bash
+# Preview file from default repository
+codefetch --show 8.1.py
+
+# Preview file from another repository
+codefetch --show DS/EXP1.c
+
+# Preview file from any user repository
+codefetch --show InzamamulQureshi/Codefetch setup.py
+```
+
+### 3. Explore Repositories and Files
+
+```bash
+# List all public repositories for default user
+codefetch --repos
+
+# List all public repositories for a specific user
+codefetch --repos -u InzamamulQureshi
+codefetch --repos torvalds
+
+# List code files in the default repository
+codefetch --list
+
+# List code files in another repository
+codefetch -r DS --list
+codefetch --list InzamamulQureshi/Codefetch
+```
+
+### 4. Configuration and Defaults
+
+Set persistent default preferences stored in `~/.codefetch.json`:
+
+```bash
+# Set default repository
+codefetch --set-default DS
+
+# Set default user
+codefetch --set-default-user InzamamulQureshi
+
+# View current configuration
+codefetch --config
+
+# Reset configuration back to factory defaults
+codefetch --reset-config
+```
+
+---
+
+## Command Reference
+
+| Flag | Description | Example |
+|---|---|---|
+| `-r`, `--repo` | Target repository name or URL | `codefetch -r DS EXP1.c` |
+| `-u`, `--user` | Target GitHub user or organization | `codefetch -u octocat -r Spoon-Knife --list` |
+| `-b`, `--branch` | Branch name (default: `main`) | `codefetch -b main DS EXP1.c` |
+| `-s`, `--show` | Print file contents to terminal | `codefetch --show 8.1.py` |
+| `-l`, `--list` | List available code files | `codefetch --list DS` |
+| `-R`, `--repos` | List public repositories for user | `codefetch --repos -u InzamamulQureshi` |
+| `-o`, `--output` | Specify destination output filename | `codefetch -r DS EXP1.c -o local.c` |
+| `--set-default` | Set persistent default repository | `codefetch --set-default DS` |
+| `--set-default-user` | Set persistent default user | `codefetch --set-default-user InzamamulQureshi` |
+| `--config` | Display active configuration | `codefetch --config` |
+| `--reset-config` | Reset configuration to defaults | `codefetch --reset-config` |
+| `-v`, `--version` | Display version information | `codefetch --version` |
+| `-h`, `--help` | Display help and usage message | `codefetch --help` |
+
+---
+
+## Supported File Extensions
+
+CodeFetch recognizes and lists common source and document files:
+
+`.py`, `.c`, `.cpp`, `.h`, `.hpp`, `.java`, `.js`, `.ts`, `.sql`, `.html`, `.css`, `.txt`, `.asm`, `.s`, `.hex`, `.json`, `.sh`, `.rs`, `.go`, `.cs`, `.ipynb`, `.md`
+
+---
+
+## License
+
+This project is licensed under the [MIT License](LICENSE).

codefetch_cli-1.2.0/README.md

@@ -0,0 +1,160 @@
+# CodeFetch
+
+Quickly fetch code files from GitHub repositories with simple commands.
+
+CodeFetch is a lightweight command-line utility designed to quickly inspect, preview, and download individual source code files directly from any GitHub repository without needing to clone full repositories.
+
+---
+
+## Features
+
+- **Any User & Repository**: Fetch files from any public GitHub repository using intuitive syntax (`codefetch <user>/<repo> <filename>`).
+- **Terminal Preview**: Inspect code directly in your console with `--show` without saving it to disk.
+- **Automatic Path & Case Resolution**: Automatically resolves case mismatches (e.g., `exp1.c` -> `EXP1.c`) 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`.
+- **Persistent Defaults**: Configure your preferred default repository and user with `--set-default` and `--set-default-user`.
+- **No Dependencies**: Built using the Python standard library with zero third-party runtime dependencies.
+
+---
+
+## Installation
+
+### From PyPI
+
+```bash
+pip install codefetch-cli
+```
+
+### From GitHub
+
+```bash
+pip install git+https://github.com/InzamamulQureshi/Codefetch.git
+```
+
+### From Local Source
+
+Clone the repository and install locally:
+
+```bash
+git clone https://github.com/InzamamulQureshi/Codefetch.git
+cd Codefetch
+pip install .
+```
+
+---
+
+## Quick Start & Usage
+
+### 1. Download Files
+
+Fetch a file from any GitHub repository:
+
+```bash
+# Fetch from a specific user and repository
+codefetch InzamamulQureshi/Codefetch setup.py
+
+# Fetch using explicit flags
+codefetch -u InzamamulQureshi -r Codefetch setup.py
+
+# Fetch from a repository under the default user
+codefetch DS EXP1.c
+codefetch -r DS EXP1.c
+
+# Shorthand path syntax
+codefetch DS/EXP1.c
+
+# Fetch from the default repository
+codefetch 8.1.py
+```
+
+Save to a custom filename or directory using `-o` / `--output`:
+
+```bash
+codefetch -r DS EXP1.c -o my_experiment.c
+```
+
+### 2. Preview in Terminal (Without Downloading)
+
+Display the contents of a file directly in stdout:
+
+```bash
+# Preview file from default repository
+codefetch --show 8.1.py
+
+# Preview file from another repository
+codefetch --show DS/EXP1.c
+
+# Preview file from any user repository
+codefetch --show InzamamulQureshi/Codefetch setup.py
+```
+
+### 3. Explore Repositories and Files
+
+```bash
+# List all public repositories for default user
+codefetch --repos
+
+# List all public repositories for a specific user
+codefetch --repos -u InzamamulQureshi
+codefetch --repos torvalds
+
+# List code files in the default repository
+codefetch --list
+
+# List code files in another repository
+codefetch -r DS --list
+codefetch --list InzamamulQureshi/Codefetch
+```
+
+### 4. Configuration and Defaults
+
+Set persistent default preferences stored in `~/.codefetch.json`:
+
+```bash
+# Set default repository
+codefetch --set-default DS
+
+# Set default user
+codefetch --set-default-user InzamamulQureshi
+
+# View current configuration
+codefetch --config
+
+# Reset configuration back to factory defaults
+codefetch --reset-config
+```
+
+---
+
+## Command Reference
+
+| Flag | Description | Example |
+|---|---|---|
+| `-r`, `--repo` | Target repository name or URL | `codefetch -r DS EXP1.c` |
+| `-u`, `--user` | Target GitHub user or organization | `codefetch -u octocat -r Spoon-Knife --list` |
+| `-b`, `--branch` | Branch name (default: `main`) | `codefetch -b main DS EXP1.c` |
+| `-s`, `--show` | Print file contents to terminal | `codefetch --show 8.1.py` |
+| `-l`, `--list` | List available code files | `codefetch --list DS` |
+| `-R`, `--repos` | List public repositories for user | `codefetch --repos -u InzamamulQureshi` |
+| `-o`, `--output` | Specify destination output filename | `codefetch -r DS EXP1.c -o local.c` |
+| `--set-default` | Set persistent default repository | `codefetch --set-default DS` |
+| `--set-default-user` | Set persistent default user | `codefetch --set-default-user InzamamulQureshi` |
+| `--config` | Display active configuration | `codefetch --config` |
+| `--reset-config` | Reset configuration to defaults | `codefetch --reset-config` |
+| `-v`, `--version` | Display version information | `codefetch --version` |
+| `-h`, `--help` | Display help and usage message | `codefetch --help` |
+
+---
+
+## Supported File Extensions
+
+CodeFetch recognizes and lists common source and document files:
+
+`.py`, `.c`, `.cpp`, `.h`, `.hpp`, `.java`, `.js`, `.ts`, `.sql`, `.html`, `.css`, `.txt`, `.asm`, `.s`, `.hex`, `.json`, `.sh`, `.rs`, `.go`, `.cs`, `.ipynb`, `.md`
+
+---
+
+## License
+
+This project is licensed under the [MIT License](LICENSE).

codefetch_cli-1.2.0/codefetch/__init__.py

@@ -0,0 +1,5 @@
+"""
+CodeFetch - CLI tool to fetch code files from GitHub repositories.
+"""
+
+__version__ = "1.2.0"

codefetch_cli-1.2.0/codefetch/cli.py

@@ -0,0 +1,597 @@
+"""
+CodeFetch CLI
+Quickly fetch code files from GitHub repositories with simple commands.
+"""
+
+import argparse
+import json
+import os
+import re
+import sys
+import urllib.error
+import urllib.request
+from pathlib import Path
+
+DEFAULT_OWNER = "Reaver101"
+DEFAULT_REPO = "MPL"
+DEFAULT_BRANCH = "main"
+
+CONFIG_FILE = Path.home() / ".codefetch.json"
+
+# Supported code extensions
+CODE_EXTENSIONS = {
+    ".py", ".c", ".cpp", ".h", ".hpp", ".java", ".js", ".ts",
+    ".sql", ".html", ".css", ".txt", ".asm", ".s", ".hex",
+    ".json", ".sh", ".rs", ".go", ".cs", ".ipynb", ".md"
+}
+
+
+def load_config():
+    """Load configuration from environment variables and local config file."""
+    config = {
+        "owner": os.environ.get("CODEFETCH_USER", DEFAULT_OWNER),
+        "repo": os.environ.get("CODEFETCH_REPO", DEFAULT_REPO),
+        "branch": os.environ.get("CODEFETCH_BRANCH", DEFAULT_BRANCH),
+    }
+    if CONFIG_FILE.exists():
+        try:
+            with open(CONFIG_FILE, "r", encoding="utf-8") as f:
+                saved = json.load(f)
+                if isinstance(saved, dict):
+                    if saved.get("owner"):
+                        config["owner"] = saved["owner"]
+                    if saved.get("repo"):
+                        config["repo"] = saved["repo"]
+                    if saved.get("branch"):
+                        config["branch"] = saved["branch"]
+        except Exception:
+            pass
+    return config
+
+
+def save_config(owner=None, repo=None, branch=None):
+    """Save configuration to ~/.codefetch.json."""
+    config = load_config()
+    if owner:
+        config["owner"] = owner
+    if repo:
+        config["repo"] = repo
+    if branch:
+        config["branch"] = branch
+    try:
+        with open(CONFIG_FILE, "w", encoding="utf-8") as f:
+            json.dump(config, f, indent=2)
+        return True
+    except Exception as e:
+        print(f"Error saving configuration: {e}")
+        return False
+
+
+def get_headers():
+    """Get HTTP headers for GitHub requests."""
+    headers = {
+        "User-Agent": "codefetch",
+        "Accept": "application/vnd.github+json",
+    }
+    token = os.environ.get("GITHUB_TOKEN") or os.environ.get("GH_TOKEN")
+    if token:
+        headers["Authorization"] = f"Bearer {token}"
+    return headers
+
+
+def get_json(url):
+    """Fetch and decode JSON from a URL."""
+    request = urllib.request.Request(url, headers=get_headers())
+    with urllib.request.urlopen(request, timeout=15) as response:
+        return json.loads(response.read().decode("utf-8"))
+
+
+def parse_repo_identifier(repo_str, default_owner=DEFAULT_OWNER):
+    """Extract (owner, repo) from a repository flag, name, or URL."""
+    if not repo_str:
+        return default_owner, None
+    repo_str = repo_str.strip()
+    m = re.match(
+        r"https?://github\.com/([^/]+)/([^/]+?)(?:\.git|/.*)?$",
+        repo_str,
+        re.IGNORECASE,
+    )
+    if m:
+        return m.group(1), m.group(2)
+    if "/" in repo_str:
+        parts = repo_str.split("/", 1)
+        return parts[0], parts[1].removesuffix(".git")
+    return default_owner, repo_str.removesuffix(".git")
+
+
+def get_repo_tree(owner, repo, branch="main"):
+    """Fetch the Git tree for a repository, with fallback to master if main is absent."""
+    url = f"https://api.github.com/repos/{owner}/{repo}/git/trees/{branch}?recursive=1"
+    try:
+        return get_json(url)
+    except urllib.error.HTTPError as e:
+        if e.code == 404 and branch == "main":
+            url_master = f"https://api.github.com/repos/{owner}/{repo}/git/trees/master?recursive=1"
+            try:
+                return get_json(url_master)
+            except Exception:
+                pass
+        raise
+
+
+def get_user_repos(owner):
+    """Fetch public repositories for a given GitHub owner."""
+    url = f"https://api.github.com/users/{owner}/repos?per_page=100&sort=updated"
+    try:
+        return get_json(url)
+    except Exception:
+        return []
+
+
+def list_repos(owner=DEFAULT_OWNER, default_repo=DEFAULT_REPO):
+    """List all public repositories for the owner."""
+    try:
+        repos = get_user_repos(owner)
+        if not repos:
+            print(f"No public repositories found for user '{owner}'.")
+            return
+
+        print(f"Repositories for '{owner}':\n")
+        for r in repos:
+            name = r.get("name", "")
+            desc = r.get("description") or ""
+            is_def = " (default)" if name.lower() == default_repo.lower() else ""
+            marker = "*" if is_def else "-"
+            desc_text = f" - {desc}" if desc else ""
+            print(f"  {marker} {name}{is_def}{desc_text}")
+
+        print("\nCommands:")
+        print(f"  codefetch -u {owner} -r <repo> --list        List files in a repository")
+        print(f"  codefetch -u {owner} -r <repo> <filename>    Download a file from a repository")
+        print(f"  codefetch --set-default <repo>              Set default repository")
+
+    except urllib.error.HTTPError as e:
+        print(f"Could not list repositories: HTTP {e.code}")
+    except urllib.error.URLError:
+        print("Could not connect to GitHub.")
+    except Exception as e:
+        print(f"Could not list repositories: {e}")
+
+
+def list_files(owner, repo, branch="main"):
+    """List code files in a repository."""
+    try:
+        data = get_repo_tree(owner, repo, branch)
+        if data.get("truncated"):
+            print("Warning: GitHub returned a truncated file list.")
+
+        files = []
+        for item in data.get("tree", []):
+            if item.get("type") != "blob":
+                continue
+
+            path = item.get("path", "")
+            suffix = ""
+            if "." in path.rsplit("/", 1)[-1]:
+                suffix = "." + path.rsplit("/", 1)[-1].rsplit(".", 1)[-1].lower()
+
+            if suffix in CODE_EXTENSIONS:
+                files.append(path)
+
+        files.sort(key=str.lower)
+
+        if not files:
+            print(f"No supported code files found in {owner}/{repo}.")
+            return
+
+        print(f"Available files in {owner}/{repo} ({branch}):\n")
+        for i, path in enumerate(files, 1):
+            print(f"{i:>3}. {path}")
+
+        print(f"\nTotal: {len(files)} files")
+
+    except urllib.error.HTTPError as e:
+        print(f"Could not list files for {owner}/{repo}: HTTP {e.code}")
+    except urllib.error.URLError:
+        print("Could not connect to GitHub.")
+    except Exception as e:
+        print(f"Could not list files for {owner}/{repo}: {e}")
+
+
+def get_stem(name):
+    """Extract filename stem by stripping supported code extensions."""
+    name_lower = name.lower()
+    for ext in CODE_EXTENSIONS:
+        if name_lower.endswith(ext):
+            return name[:-len(ext)]
+    return name
+
+
+def resolve_file_in_tree(tree_data, target_filename):
+    """
+    Search tree for target_filename:
+    1. Exact match (case-insensitive) on full path
+    2. Exact match (case-insensitive) on basename
+    3. Match without extension (e.g. 'exp1' -> 'EXP1.c')
+    """
+    blobs = [item["path"] for item in tree_data.get("tree", []) if item.get("type") == "blob"]
+    target_clean = target_filename.strip("/\\").lower()
+    target_base = target_clean.rsplit("/", 1)[-1]
+
+    # 1. Exact match (case-insensitive) on full path
+    for p in blobs:
+        if p.lower() == target_clean:
+            return p
+
+    # 2. Exact match (case-insensitive) on basename
+    for p in blobs:
+        base = p.rsplit("/", 1)[-1].lower()
+        if base == target_base:
+            return p
+
+    # 3. Match without extension
+    target_stem = get_stem(target_base).lower()
+    candidates = []
+    for p in blobs:
+        base = p.rsplit("/", 1)[-1]
+        base_stem = get_stem(base).lower()
+        if base_stem == target_stem:
+            candidates.append(p)
+
+    if len(candidates) == 1:
+        return candidates[0]
+
+    return None
+
+
+def find_file_in_other_repos(owner, current_repo, target_filename):
+    """Search other public repositories of the user for the target file."""
+    try:
+        repos_data = get_user_repos(owner)
+        for r in repos_data:
+            r_name = r.get("name")
+            if not r_name or r_name.lower() == current_repo.lower():
+                continue
+            default_branch = r.get("default_branch", "main")
+            try:
+                tree_data = get_repo_tree(owner, r_name, default_branch)
+                match = resolve_file_in_tree(tree_data, target_filename)
+                if match:
+                    return r_name, match
+            except Exception:
+                continue
+    except Exception:
+        pass
+    return None, None
+
+
+def fetch_file(filename, owner=DEFAULT_OWNER, repo=DEFAULT_REPO, branch=DEFAULT_BRANCH,
+               show=False, output=None):
+    """Fetch or download a file from GitHub."""
+    clean_filename = filename.strip("/\\")
+
+    def download_url(url):
+        req = urllib.request.Request(url, headers={"User-Agent": "codefetch"})
+        with urllib.request.urlopen(req, timeout=15) as resp:
+            return resp.read().decode("utf-8")
+
+    # 1. Direct raw fetch first (fastest, preserves GitHub API rate limit)
+    raw_base = f"https://raw.githubusercontent.com/{owner}/{repo}/{branch}"
+    url = f"{raw_base}/{clean_filename}"
+
+    content = None
+    resolved_path = clean_filename
+
+    try:
+        content = download_url(url)
+    except urllib.error.HTTPError as e:
+        if e.code == 404:
+            # 2. Direct fetch 404ed. Try smart resolution with repo tree
+            try:
+                tree_data = get_repo_tree(owner, repo, branch)
+                matched = resolve_file_in_tree(tree_data, clean_filename)
+                if matched:
+                    resolved_path = matched
+                    content = download_url(f"{raw_base}/{resolved_path}")
+                    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}.")
+                        print(f"\n[Tip] Found '{other_match}' in repository '{other_repo}'!")
+                        print(f"To fetch it, run:\n  codefetch -u {owner} -r {other_repo} {other_match}")
+                        return
+                    else:
+                        print(f"File not found: '{clean_filename}' in {owner}/{repo}.")
+                        print(f"Run 'codefetch -u {owner} -r {repo} --list' to see available files.")
+                        return
+            except Exception:
+                print(f"File not found: '{clean_filename}' in {owner}/{repo}.")
+                return
+        else:
+            print(f"Download failed: HTTP {e.code}")
+            return
+    except urllib.error.URLError:
+        print("Could not connect to GitHub.")
+        return
+    except UnicodeDecodeError:
+        print("The file is not UTF-8 text, so it cannot be displayed or saved as text.")
+        return
+
+    if content is None:
+        return
+
+    if show:
+        print(content)
+    else:
+        out_name = output or resolved_path.rsplit("/", 1)[-1]
+        try:
+            with open(out_name, "w", encoding="utf-8") as f:
+                f.write(content)
+            print(f"Downloaded: {out_name} (from {owner}/{repo})")
+        except Exception as e:
+            print(f"Error saving file '{out_name}': {e}")
+
+
+def build_parser():
+    """Build argument parser with full CLI options."""
+    parser = argparse.ArgumentParser(
+        prog="codefetch",
+        description="Quickly fetch code files from GitHub repositories with simple commands.",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Usage Examples:
+
+  Fetch from default repository:
+    codefetch 8.1.py
+    codefetch --show 8.1.py
+    codefetch --list
+
+  Fetch from other repositories:
+    codefetch -r DS EXP1.c
+    codefetch DS EXP1.c
+    codefetch DS/EXP1.c
+    codefetch -r DS --list
+
+  Fetch from any GitHub user and repository:
+    codefetch InzamamulQureshi/Codefetch setup.py
+    codefetch -u InzamamulQureshi -r Codefetch setup.py
+    codefetch --list InzamamulQureshi/Codefetch
+    codefetch --repos -u InzamamulQureshi
+
+  Configuration:
+    codefetch --set-default DS
+    codefetch --set-default-user InzamamulQureshi
+    codefetch --config
+    codefetch --reset-config
+"""
+    )
+    parser.add_argument(
+        "args",
+        nargs="*",
+        help="Target specification: [user/repo] [filename] or [filename]",
+    )
+    parser.add_argument(
+        "-r", "--repo",
+        default=None,
+        help="Repository name or URL (e.g. DS, Codefetch, or user/repo)",
+    )
+    parser.add_argument(
+        "-u", "--user",
+        default=None,
+        help=f"GitHub user/org (default: {DEFAULT_OWNER})",
+    )
+    parser.add_argument(
+        "-b", "--branch",
+        default=None,
+        help=f"Branch name (default: {DEFAULT_BRANCH})",
+    )
+    parser.add_argument(
+        "-l", "--list",
+        action="store_true",
+        help="List available code files in the repository",
+    )
+    parser.add_argument(
+        "-R", "--repos",
+        action="store_true",
+        help="List all public repositories for the user",
+    )
+    parser.add_argument(
+        "-s", "--show",
+        action="store_true",
+        help="Display file content in terminal without saving to disk",
+    )
+    parser.add_argument(
+        "-o", "--output",
+        default=None,
+        help="Custom destination filename or output path",
+    )
+    parser.add_argument(
+        "--set-default",
+        metavar="REPO",
+        help="Set persistent default repository in local config",
+    )
+    parser.add_argument(
+        "--set-default-user",
+        metavar="USER",
+        help="Set persistent default GitHub user in local config",
+    )
+    parser.add_argument(
+        "--config",
+        action="store_true",
+        help="Display current CodeFetch configuration",
+    )
+    parser.add_argument(
+        "--reset-config",
+        action="store_true",
+        help="Reset configuration back to defaults",
+    )
+    parser.add_argument(
+        "-v", "--version",
+        action="version",
+        version="codefetch 1.2.0",
+    )
+    return parser
+
+
+def resolve_invocation(positional_args, repo_flag, user_flag, branch_flag,
+                       default_owner, default_repo, default_branch, known_repos=None):
+    """
+    Resolve arguments into (owner, repo, branch, filename).
+    """
+    owner = user_flag or default_owner
+    repo = default_repo
+    branch = branch_flag or default_branch
+    filename = None
+
+    if repo_flag:
+        flag_owner, flag_repo = parse_repo_identifier(repo_flag, default_owner=owner)
+        owner = flag_owner
+        repo = flag_repo
+        if positional_args:
+            filename = positional_args[0]
+        return owner, repo, branch, filename
+
+    if not positional_args:
+        return owner, repo, branch, None
+
+    if len(positional_args) >= 2:
+        first, second = positional_args[0], positional_args[1]
+        p_owner, p_repo = parse_repo_identifier(first, default_owner=owner)
+        return p_owner, p_repo, branch, second
+
+    target = positional_args[0].strip()
+
+    # 1. Full GitHub web URL
+    m = re.match(r"https?://github\.com/([^/]+)/([^/]+)/blob/([^/]+)/(.+)$", target, re.IGNORECASE)
+    if m:
+        return m.group(1), m.group(2).removesuffix(".git"), m.group(3), m.group(4)
+
+    # 2. Raw GitHub URL
+    m = re.match(r"https?://raw\.githubusercontent\.com/([^/]+)/([^/]+)/([^/]+)/(.+)$", target, re.IGNORECASE)
+    if m:
+        return m.group(1), m.group(2), m.group(3), m.group(4)
+
+    # 3. Colon syntax: user/repo:filename or repo:filename
+    if ":" in target:
+        repo_part, file_part = target.split(":", 1)
+        p_owner, p_repo = parse_repo_identifier(repo_part, default_owner=owner)
+        return p_owner, p_repo, branch, file_part
+
+    # 4. Multi-part slash syntax: user/repo/filename
+    parts = target.split("/")
+    if len(parts) >= 3:
+        return parts[0], parts[1], branch, "/".join(parts[2:])
+
+    if len(parts) == 2:
+        return owner, parts[0], branch, parts[1]
+
+    # Single filename, e.g. 8.1.py
+    return owner, repo, branch, target
+
+
+def main():
+    parser = build_parser()
+    args = parser.parse_args()
+
+    config = load_config()
+    default_owner = config.get("owner", DEFAULT_OWNER)
+    default_repo = config.get("repo", DEFAULT_REPO)
+    default_branch = config.get("branch", DEFAULT_BRANCH)
+
+    # Handle --reset-config
+    if args.reset_config:
+        if CONFIG_FILE.exists():
+            try:
+                CONFIG_FILE.unlink()
+            except Exception as e:
+                print(f"Error removing config file: {e}")
+                return
+        print(f"Configuration reset to defaults (User: {DEFAULT_OWNER}, Repo: {DEFAULT_REPO}).")
+        return
+
+    # Handle --set-default-user
+    if args.set_default_user:
+        save_config(owner=args.set_default_user)
+        print(f"Default user updated to: '{args.set_default_user}'")
+        print(f"Saved to: {CONFIG_FILE}")
+        return
+
+    # Handle --set-default
+    if args.set_default:
+        owner_to_save = args.user if args.user else None
+        save_config(owner=owner_to_save, repo=args.set_default)
+        print(f"Default repository updated to: '{args.set_default}'")
+        if owner_to_save:
+            print(f"Default user updated to: '{owner_to_save}'")
+        print(f"Saved to: {CONFIG_FILE}")
+        return
+
+    # Handle --config
+    if args.config:
+        print("CodeFetch Configuration:")
+        print(f"  Default User:        {default_owner}")
+        print(f"  Default Repository:  {default_repo}")
+        print(f"  Default Branch:      {default_branch}")
+        print(f"  Config File:         {CONFIG_FILE}")
+        return
+
+    owner = args.user or default_owner
+    branch = args.branch or default_branch
+
+    # Handle --repos (list repositories)
+    if args.repos:
+        target_owner = owner
+        if args.args:
+            target_owner = args.args[0]
+        list_repos(owner=target_owner, default_repo=default_repo)
+        return
+
+    # Handle --list
+    if args.list:
+        target_owner = owner
+        target_repo = default_repo
+        if args.repo:
+            target_owner, target_repo = parse_repo_identifier(args.repo, default_owner=owner)
+        elif args.args:
+            target_owner, target_repo = parse_repo_identifier(args.args[0], default_owner=owner)
+        list_files(owner=target_owner, repo=target_repo, branch=branch)
+        return
+
+    # Handle fetching or viewing file
+    if not args.args and not args.repo:
+        parser.print_help()
+        return
+
+    known_repos = [default_repo, "DS", "MPL", "Discord-Chatbot", "Codefetch"]
+
+    resolved_owner, resolved_repo, resolved_branch, resolved_filename = resolve_invocation(
+        args.args,
+        args.repo,
+        args.user,
+        args.branch,
+        default_owner,
+        default_repo,
+        default_branch,
+        known_repos=known_repos,
+    )
+
+    if not resolved_filename:
+        print("Error: No filename specified.")
+        parser.print_help()
+        return
+
+    fetch_file(
+        filename=resolved_filename,
+        owner=resolved_owner,
+        repo=resolved_repo,
+        branch=resolved_branch,
+        show=args.show,
+        output=args.output,
+    )
+
+
+if __name__ == "__main__":
+    main()

codefetch_cli-1.2.0/codefetch_cli.egg-info/PKG-INFO

@@ -0,0 +1,182 @@
+Metadata-Version: 2.4
+Name: codefetch-cli
+Version: 1.2.0
+Summary: Quickly fetch code files from GitHub repositories with simple commands
+Home-page: https://github.com/InzamamulQureshi/Codefetch
+Author: Inzamamul Qureshi
+Author-email: Inzamamul Qureshi <inzamamulqureshi@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/InzamamulQureshi/Codefetch
+Project-URL: Repository, https://github.com/InzamamulQureshi/Codefetch
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Environment :: Console
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# CodeFetch
+
+Quickly fetch code files from GitHub repositories with simple commands.
+
+CodeFetch is a lightweight command-line utility designed to quickly inspect, preview, and download individual source code files directly from any GitHub repository without needing to clone full repositories.
+
+---
+
+## Features
+
+- **Any User & Repository**: Fetch files from any public GitHub repository using intuitive syntax (`codefetch <user>/<repo> <filename>`).
+- **Terminal Preview**: Inspect code directly in your console with `--show` without saving it to disk.
+- **Automatic Path & Case Resolution**: Automatically resolves case mismatches (e.g., `exp1.c` -> `EXP1.c`) 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`.
+- **Persistent Defaults**: Configure your preferred default repository and user with `--set-default` and `--set-default-user`.
+- **No Dependencies**: Built using the Python standard library with zero third-party runtime dependencies.
+
+---
+
+## Installation
+
+### From PyPI
+
+```bash
+pip install codefetch-cli
+```
+
+### From GitHub
+
+```bash
+pip install git+https://github.com/InzamamulQureshi/Codefetch.git
+```
+
+### From Local Source
+
+Clone the repository and install locally:
+
+```bash
+git clone https://github.com/InzamamulQureshi/Codefetch.git
+cd Codefetch
+pip install .
+```
+
+---
+
+## Quick Start & Usage
+
+### 1. Download Files
+
+Fetch a file from any GitHub repository:
+
+```bash
+# Fetch from a specific user and repository
+codefetch InzamamulQureshi/Codefetch setup.py
+
+# Fetch using explicit flags
+codefetch -u InzamamulQureshi -r Codefetch setup.py
+
+# Fetch from a repository under the default user
+codefetch DS EXP1.c
+codefetch -r DS EXP1.c
+
+# Shorthand path syntax
+codefetch DS/EXP1.c
+
+# Fetch from the default repository
+codefetch 8.1.py
+```
+
+Save to a custom filename or directory using `-o` / `--output`:
+
+```bash
+codefetch -r DS EXP1.c -o my_experiment.c
+```
+
+### 2. Preview in Terminal (Without Downloading)
+
+Display the contents of a file directly in stdout:
+
+```bash
+# Preview file from default repository
+codefetch --show 8.1.py
+
+# Preview file from another repository
+codefetch --show DS/EXP1.c
+
+# Preview file from any user repository
+codefetch --show InzamamulQureshi/Codefetch setup.py
+```
+
+### 3. Explore Repositories and Files
+
+```bash
+# List all public repositories for default user
+codefetch --repos
+
+# List all public repositories for a specific user
+codefetch --repos -u InzamamulQureshi
+codefetch --repos torvalds
+
+# List code files in the default repository
+codefetch --list
+
+# List code files in another repository
+codefetch -r DS --list
+codefetch --list InzamamulQureshi/Codefetch
+```
+
+### 4. Configuration and Defaults
+
+Set persistent default preferences stored in `~/.codefetch.json`:
+
+```bash
+# Set default repository
+codefetch --set-default DS
+
+# Set default user
+codefetch --set-default-user InzamamulQureshi
+
+# View current configuration
+codefetch --config
+
+# Reset configuration back to factory defaults
+codefetch --reset-config
+```
+
+---
+
+## Command Reference
+
+| Flag | Description | Example |
+|---|---|---|
+| `-r`, `--repo` | Target repository name or URL | `codefetch -r DS EXP1.c` |
+| `-u`, `--user` | Target GitHub user or organization | `codefetch -u octocat -r Spoon-Knife --list` |
+| `-b`, `--branch` | Branch name (default: `main`) | `codefetch -b main DS EXP1.c` |
+| `-s`, `--show` | Print file contents to terminal | `codefetch --show 8.1.py` |
+| `-l`, `--list` | List available code files | `codefetch --list DS` |
+| `-R`, `--repos` | List public repositories for user | `codefetch --repos -u InzamamulQureshi` |
+| `-o`, `--output` | Specify destination output filename | `codefetch -r DS EXP1.c -o local.c` |
+| `--set-default` | Set persistent default repository | `codefetch --set-default DS` |
+| `--set-default-user` | Set persistent default user | `codefetch --set-default-user InzamamulQureshi` |
+| `--config` | Display active configuration | `codefetch --config` |
+| `--reset-config` | Reset configuration to defaults | `codefetch --reset-config` |
+| `-v`, `--version` | Display version information | `codefetch --version` |
+| `-h`, `--help` | Display help and usage message | `codefetch --help` |
+
+---
+
+## Supported File Extensions
+
+CodeFetch recognizes and lists common source and document files:
+
+`.py`, `.c`, `.cpp`, `.h`, `.hpp`, `.java`, `.js`, `.ts`, `.sql`, `.html`, `.css`, `.txt`, `.asm`, `.s`, `.hex`, `.json`, `.sh`, `.rs`, `.go`, `.cs`, `.ipynb`, `.md`
+
+---
+
+## License
+
+This project is licensed under the [MIT License](LICENSE).

codefetch_cli-1.2.0/codefetch_cli.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+setup.py
+codefetch/__init__.py
+codefetch/cli.py
+codefetch_cli.egg-info/PKG-INFO
+codefetch_cli.egg-info/SOURCES.txt
+codefetch_cli.egg-info/dependency_links.txt
+codefetch_cli.egg-info/entry_points.txt
+codefetch_cli.egg-info/top_level.txt

codefetch_cli-1.2.0/codefetch_cli.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

codefetch_cli-1.2.0/codefetch_cli.egg-info/entry_points.txt

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

codefetch_cli-1.2.0/codefetch_cli.egg-info/top_level.txt

@@ -0,0 +1 @@
+codefetch

codefetch_cli-1.2.0/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["setuptools>=61", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "codefetch-cli"
+version = "1.2.0"
+description = "Quickly fetch code files from GitHub repositories with simple commands"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    { name = "Inzamamul Qureshi", email = "inzamamulqureshi@gmail.com" }
+]
+requires-python = ">=3.8"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+    "Environment :: Console",
+    "Topic :: Utilities",
+]
+
+[project.urls]
+Homepage = "https://github.com/InzamamulQureshi/Codefetch"
+Repository = "https://github.com/InzamamulQureshi/Codefetch"
+
+[project.scripts]
+codefetch = "codefetch.cli:main"

codefetch_cli-1.2.0/setup.cfg

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

codefetch_cli-1.2.0/setup.py

@@ -0,0 +1,30 @@
+from pathlib import Path
+from setuptools import setup, find_packages
+
+this_directory = Path(__file__).parent
+readme_path = this_directory / "README.md"
+long_description = readme_path.read_text(encoding="utf-8") if readme_path.exists() else ""
+
+setup(
+    name="codefetch-cli",
+    version="1.2.0",
+    description="Quickly fetch code files from GitHub repositories with simple commands",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    author="Inzamamul Qureshi",
+    author_email="inzamamulqureshi@gmail.com",
+    url="https://github.com/InzamamulQureshi/Codefetch",
+    packages=find_packages(),
+    entry_points={
+        "console_scripts": [
+            "codefetch = codefetch.cli:main",
+        ],
+    },
+    python_requires=">=3.8",
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "Operating System :: OS Independent",
+        "Environment :: Console",
+        "Topic :: Utilities",
+    ],
+)