codefetch-cli 1.2.0__py3-none-any.whl → 1.2.1__py3-none-any.whl

codefetch/__init__.py

@@ -2,4 +2,4 @@
 CodeFetch - CLI tool to fetch code files from GitHub repositories.
 """
 
-__version__ = "1.2.0"
+__version__ = "1.2.1"

codefetch/cli.py

@@ -18,13 +18,84 @@ DEFAULT_BRANCH = "main"
 
 CONFIG_FILE = Path.home() / ".codefetch.json"
 
-# Supported code extensions
+# Supported code, data, and config 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"
+    # Data & Tables
+    ".csv", ".tsv", ".json", ".jsonl", ".yaml", ".yml", ".toml",
+    ".xml", ".ini", ".cfg", ".conf", ".env", ".properties",
+    # Python & Data Science
+    ".py", ".pyw", ".ipynb", ".r", ".rmd", ".m",
+    # C / C++ / Systems
+    ".c", ".cpp", ".cc", ".cxx", ".h", ".hpp", ".hxx", ".rs", ".go",
+    # JVM & .NET
+    ".java", ".kt", ".kts", ".scala", ".cs", ".fs", ".vb",
+    # Web & Frontend
+    ".html", ".htm", ".css", ".scss", ".sass", ".less",
+    ".js", ".jsx", ".mjs", ".cjs", ".ts", ".tsx", ".vue", ".svelte", ".php",
+    # Mobile & Apple
+    ".swift", ".dart",
+    # Scripts & Shells
+    ".sh", ".bash", ".zsh", ".fish", ".bat", ".cmd", ".ps1", ".psm1",
+    ".lua", ".rb", ".pl", ".pm",
+    # Assembly & Hardware
+    ".asm", ".s", ".hex", ".v", ".sv", ".vhdl", ".vhd",
+    # Database & Schema
+    ".sql", ".graphql", ".gql", ".proto",
+    # Documents & Text
+    ".txt", ".text", ".md", ".markdown", ".rst", ".tex", ".log"
 }
 
+# Recognized extensionless or special build files
+NAMED_FILES = {
+    "dockerfile", "makefile", "gemfile", "procfile", "vagrantfile",
+    "cmakelists.txt", "jenkinsfile", "license"
+}
+
+HELP_MESSAGE = """\
+CodeFetch - Download single code files from GitHub without cloning entire repos.
+
+USAGE:
+  codefetch <filename>                  Download a file from default repo (MPL)
+  codefetch <repo> <filename>           Download from another repo (e.g. DS EXP1.c)
+  codefetch <user>/<repo> <filename>    Download from any GitHub user/repo
+
+QUICK EXAMPLES:
+  Download a file:
+    codefetch 8.1.py                    Save 8.1.py to current directory
+    codefetch data.csv                  Save data.csv to current directory
+    codefetch DS EXP1.c                 Save EXP1.c from repo 'DS'
+    codefetch DS EXP1.c -o my_code.c    Save with a custom output filename
+    codefetch InzamamulQureshi/Codefetch setup.py
+
+  View code in terminal (without downloading):
+    codefetch -s 8.1.py                 Display 8.1.py in terminal
+    codefetch -s DS EXP1.c              Display EXP1.c in terminal
+
+  Browse files and repositories:
+    codefetch -l                        List all code files in default repo (MPL)
+    codefetch -l DS                     List all code files in repo 'DS'
+    codefetch -l user/repo              List code files in any user repository
+    codefetch -R                        List all repositories of default user (Reaver101)
+    codefetch -R -u <username>          List all repositories of any GitHub user
+
+SETTINGS & DEFAULTS:
+  codefetch --set-default <repo>        Set permanent default repo (e.g. DS)
+  codefetch --set-default-user <user>   Set permanent default GitHub user
+  codefetch --config                    View current active settings
+  codefetch --reset-config              Reset all settings back to default
+
+OPTIONS:
+  -s, --show             View file contents in terminal instead of saving
+  -o, --output <file>    Custom filename or path to save the downloaded file
+  -l, --list             List available code files in the repository
+  -R, --repos            List all public repositories for the user
+  -r, --repo <name>      Specify repository name or URL
+  -u, --user <name>      Specify GitHub username (default: Reaver101)
+  -b, --branch <name>    Specify branch name (default: main)
+  -v, --version          Show version number
+  -h, --help             Show this help guide
+"""
+
 
 def load_config():
     """Load configuration from environment variables and local config file."""
@@ -171,11 +242,12 @@ def list_files(owner, repo, branch="main"):
                 continue
 
             path = item.get("path", "")
+            base_name = path.rsplit("/", 1)[-1].lower()
             suffix = ""
-            if "." in path.rsplit("/", 1)[-1]:
-                suffix = "." + path.rsplit("/", 1)[-1].rsplit(".", 1)[-1].lower()
+            if "." in base_name:
+                suffix = "." + base_name.rsplit(".", 1)[-1]
 
-            if suffix in CODE_EXTENSIONS:
+            if suffix in CODE_EXTENSIONS or base_name in NAMED_FILES:
                 files.append(path)
 
         files.sort(key=str.lower)
@@ -335,38 +407,22 @@ def fetch_file(filename, owner=DEFAULT_OWNER, repo=DEFAULT_REPO, branch=DEFAULT_
             print(f"Error saving file '{out_name}': {e}")
 
 
+class CodefetchParser(argparse.ArgumentParser):
+    """Custom parser providing clean, intuitive help formatting."""
+
+    def format_help(self):
+        return HELP_MESSAGE
+
+    def error(self, message):
+        sys.stderr.write(f"Error: {message}\n\nRun 'codefetch --help' for usage instructions.\n")
+        sys.exit(2)
+
+
 def build_parser():
     """Build argument parser with full CLI options."""
-    parser = argparse.ArgumentParser(
+    parser = CodefetchParser(
         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
-"""
+        add_help=True,
     )
     parser.add_argument(
         "args",
@@ -431,7 +487,7 @@ Usage Examples:
     parser.add_argument(
         "-v", "--version",
         action="version",
-        version="codefetch 1.2.0",
+        version="codefetch 1.2.1",
     )
     return parser
 
@@ -560,7 +616,7 @@ def main():
         list_files(owner=target_owner, repo=target_repo, branch=branch)
         return
 
-    # Handle fetching or viewing file
+    # If no action and no files provided, print the clean help guide
     if not args.args and not args.repo:
         parser.print_help()
         return
@@ -579,8 +635,11 @@ def main():
     )
 
     if not resolved_filename:
-        print("Error: No filename specified.")
-        parser.print_help()
+        print("Error: No filename specified.\n")
+        print("Usage:")
+        print("  codefetch <filename>                  Download a file")
+        print("  codefetch <repo> <filename>           Download from a repository")
+        print("  codefetch --help                      View full guide and examples")
         return
 
     fetch_file(

{codefetch_cli-1.2.0.dist-info → codefetch_cli-1.2.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codefetch-cli
-Version: 1.2.0
+Version: 1.2.1
 Summary: Quickly fetch code files from GitHub repositories with simple commands
 Home-page: https://github.com/InzamamulQureshi/Codefetch
 Author: Inzamamul Qureshi
@@ -171,9 +171,14 @@ codefetch --reset-config
 
 ## 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`
+- **Data & Tables**: `.csv`, `.tsv`, `.json`, `.jsonl`, `.yaml`, `.yml`, `.toml`, `.xml`, `.ini`, `.cfg`, `.conf`, `.env`
+- **Data Science**: `.ipynb`, `.py`, `.r`, `.rmd`, `.m`
+- **Languages**: `.c`, `.cpp`, `.h`, `.hpp`, `.rs`, `.go`, `.java`, `.kt`, `.cs`, `.swift`, `.dart`, `.php`
+- **Web**: `.html`, `.css`, `.scss`, `.js`, `.jsx`, `.ts`, `.tsx`, `.vue`, `.svelte`
+- **Scripts & Systems**: `.sh`, `.bash`, `.zsh`, `.fish`, `.bat`, `.cmd`, `.ps1`, `.lua`, `.rb`, `.asm`, `.s`, `.hex`
+- **Database & Schemas**: `.sql`, `.graphql`, `.gql`, `.proto`
+- **Documentation**: `.md`, `.markdown`, `.rst`, `.txt`, `.tex`, `.log`
+- **Build Files**: `Dockerfile`, `Makefile`, `CMakeLists.txt`, `Gemfile`, `Procfile`
 
 ---
 

codefetch_cli-1.2.1.dist-info/RECORD

@@ -0,0 +1,8 @@
+codefetch/__init__.py,sha256=hbpjJJOuxVjNlJ4ZVpsQEyhLAepknLr6ugsa01sVVCU,98
+codefetch/cli.py,sha256=-Eg3K81jid2uXQ-sGA943HWHL92-WYNi3-Q6putdlEQ,22588
+codefetch_cli-1.2.1.dist-info/licenses/LICENSE,sha256=eztogQOJbUv4rWzTBEaVeMVQYzoaP1Ehs_vg-CqlpsM,1066
+codefetch_cli-1.2.1.dist-info/METADATA,sha256=LMZvjcTMWpMb6B3Qciy4hEoZXAFhAHJJ-Shxev11nrs,6117
+codefetch_cli-1.2.1.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+codefetch_cli-1.2.1.dist-info/entry_points.txt,sha256=jFLRsBB_USeSdqjewcXZfnOzY56s0PZat7mnYkYdrXg,49
+codefetch_cli-1.2.1.dist-info/top_level.txt,sha256=kHrftHbyqugb8LQXjW1dR9uI-JFjZQJ0sUReIa45yXQ,10
+codefetch_cli-1.2.1.dist-info/RECORD,,

codefetch_cli-1.2.0.dist-info/RECORD

@@ -1,8 +0,0 @@
-codefetch/__init__.py,sha256=moQvfngOVj4i_LyONh3xRINv728-UvtH5LtTK5VVRcE,98
-codefetch/cli.py,sha256=pSaTPdqH0CwV5L2XipbeuL54q5AcmmLp9S6yrqno_TQ,19543
-codefetch_cli-1.2.0.dist-info/licenses/LICENSE,sha256=eztogQOJbUv4rWzTBEaVeMVQYzoaP1Ehs_vg-CqlpsM,1066
-codefetch_cli-1.2.0.dist-info/METADATA,sha256=iQlUxKlaagL3N79ycXo5TgSwt_rACGok8vnmBDm-MWE,5635
-codefetch_cli-1.2.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-codefetch_cli-1.2.0.dist-info/entry_points.txt,sha256=jFLRsBB_USeSdqjewcXZfnOzY56s0PZat7mnYkYdrXg,49
-codefetch_cli-1.2.0.dist-info/top_level.txt,sha256=kHrftHbyqugb8LQXjW1dR9uI-JFjZQJ0sUReIa45yXQ,10
-codefetch_cli-1.2.0.dist-info/RECORD,,