gitraze 0.0.2__tar.gz → 0.2.0__tar.gz

gitraze-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AK Pandey (akpandey-dev)
+
+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.

{gitraze-0.0.2 → gitraze-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitraze
-Version: 0.0.2
+Version: 0.2.0
 Summary: A CLI and Python library for GitHub reconnaissance, search, and analysis
 Author: AK Pandey
 License: MIT
@@ -10,8 +10,11 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
+License-File: LICENSE
 Requires-Dist: requests
 Requires-Dist: colorama
+Requires-Dist: re
+Dynamic: license-file
 
 # Gitraze
 
@@ -62,8 +65,9 @@ Example:
 ```bash
 gitraze --help
 gitraze user octocat
-gitraze repo torvalds/linux       # Coming soon!
-gitraze search "machine learning" # Not implemented yet
+gitraze repo torvalds/linux       
+gitraze search "machine learning" 
+gitraze analyze github # Coming soon!
 ```
 
 Example output:

{gitraze-0.0.2 → gitraze-0.2.0}/README.md

@@ -47,8 +47,9 @@ Example:
 ```bash
 gitraze --help
 gitraze user octocat
-gitraze repo torvalds/linux       # Coming soon!
-gitraze search "machine learning" # Not implemented yet
+gitraze repo torvalds/linux       
+gitraze search "machine learning" 
+gitraze analyze github # Coming soon!
 ```
 
 Example output:

gitraze-0.2.0/gitraze/cli.py

@@ -0,0 +1,109 @@
+import argparse
+from gitraze.utils.helpers import pretty_print
+from gitraze.modules.user import get_user_rest
+from gitraze.modules.repo import get_repo_rest
+from gitraze.modules.search import get_search_rest
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="gitraze",
+        description="GitRaze CLI Tool"
+    )
+
+    # Global flag
+    parser.add_argument(
+        "--version",
+        action="version",
+        version="gitraze 0.2.0"
+    )
+
+    subparsers = parser.add_subparsers(dest="command", required=True)
+
+    # --- USER ---
+    user_parser = subparsers.add_parser("user", help="Fetch user info (GitHub username)")
+    user_parser.add_argument("username", help="Format: username")
+
+    # --- REPO ---
+    repo_parser = subparsers.add_parser("repo", help="Fetch repo info (Repository in owner/repo format)")
+    repo_parser.add_argument("repo", help="Format: owner/repo")
+
+    # --- SEARCH ---
+    search_parser = subparsers.add_parser("search", help="Search GitHub")
+    search_parser.add_argument("category",choices=["repos", "users", "issues", "prs", "topics"],help="repos | users | issues | prs | topics")
+    search_parser.add_argument("query", nargs="+", help="Search category (repos, users, issues, topics)")
+    search_parser.add_argument("-n", "--limit", type=int, default=1, help="Number of results to show")
+
+    # --- ANALYZE ---
+    analyze_parser = subparsers.add_parser("analyze", help="Analyze target")
+    analyze_parser.add_argument("target", nargs="+")
+
+    args = parser.parse_args()
+
+    # --- ROUTING ---
+    if args.command == "user":
+        handle_user(args)
+    elif args.command == "repo":
+        handle_repo(args)
+    elif args.command == "search":
+        handle_search(args)
+    elif args.command == "analyze":
+        handle_analysis(args)
+    else:
+        parser.print_help()
+
+
+# --- HANDLERS  ---
+
+def handle_user(args):
+    print("[+] Fetching user data...")
+    data = get_user_rest(args.username)
+
+    if "error" in data:
+        print(data["error"])
+        return
+
+    print("[✓] Done")
+    pretty_print(data, title=f"User: {args.username}")
+
+
+def handle_repo(args):
+    print("[+] Fetching repository data...")
+    parts = args.repo.split("/")
+    
+    if len(parts) != 2:
+        print("Invalid format. Use: owner/repo")
+        return
+    owner, repo = parts
+    data = get_repo_rest(owner, repo)
+
+    if "error" in data:
+        print(data["error"])
+        return
+
+    print("[✓] Done")
+    pretty_print(data, title=f"User: {owner}, Repository: {repo}")
+
+
+def handle_search(args):
+    category = args.category
+    query = " ".join(args.query)
+    print(f"[+] Searching {category} for '{query}'...")
+
+    data = get_search_rest(args.category, args.query, args.limit)
+    if "error" in data:
+        print(data["error"])
+        return
+
+    print("[✓] Done")
+    if isinstance(data, list):
+        for i, item in enumerate(data, 1):
+            pretty_print(item, title=f"{category} [{i}] -> {query}")
+    else:
+        pretty_print(data, title=f"Search: {category} -> {query}")
+
+
+def handle_analysis(args):
+    target = " ".join(args.target)
+    print(f"[ANALYZE] Analyzing '{target}'")
+    print("Not implemented yet")

gitraze-0.2.0/gitraze/config.py

@@ -0,0 +1,28 @@
+# config.py
+
+'''=============REST=============='''
+
+# --- BASE CONFIGS ---
+REST_BASE_URL = "https://api.github.com"
+GRAPHQL_URL = "https://api.github.com/graphql"
+DEFAULT_TIMEOUT = 10
+DEFAULT_HEADERS = {
+    "Accept": "application/vnd.github+json"
+}
+
+# --- USER CONFIG ---
+
+
+# --- REPO CONFIG ---
+
+
+# --- SEARCH CONFIG ---
+SEARCH_MAP = {
+    "repos": "repositories",
+    "users": "users",
+    "issues": "issues",
+    "topics": "topics",
+    "prs": "issues"
+}
+
+

gitraze-0.2.0/gitraze/core/api_rest.py

@@ -0,0 +1,66 @@
+# api_rest.py
+import requests
+from gitraze.config import REST_BASE_URL, DEFAULT_HEADERS, DEFAULT_TIMEOUT
+from gitraze.config import SEARCH_MAP
+
+def get_user(username):
+    url = f"{REST_BASE_URL}/users/{username}"
+
+    try:
+        response = requests.get(
+            url,
+            headers=DEFAULT_HEADERS,
+            timeout=DEFAULT_TIMEOUT
+        )
+        response.raise_for_status()
+        return response.json()
+
+    except requests.exceptions.Timeout:
+        return {"error": "Request timed out. Check your connection."}
+
+    except requests.exceptions.RequestException as e:
+        return {"error": f"Request failed: {str(e)}"}
+
+
+def get_repo(owner, repo):
+    url = f"{REST_BASE_URL}/repos/{owner}/{repo}"
+    try:
+        response = requests.get(
+            url,
+            headers=DEFAULT_HEADERS,
+            timeout=DEFAULT_TIMEOUT
+        )
+        response.raise_for_status()
+        return response.json()
+
+    except requests.exceptions.Timeout:
+        return {"error": "Request timed out. Check your connection."}
+
+    except requests.exceptions.RequestException as e:
+        return {"error": f"Request failed: {str(e)}"}
+    
+def get_search(category, query):
+    url = f"{REST_BASE_URL}/search/{SEARCH_MAP.get(category)}"
+    if category == "issues":
+        query = query + " type:issue"
+    elif category == "prs":
+        query += " type:pr"
+    
+    params = {
+        "q": query 
+    }
+    try:
+        response = requests.get(
+            url,
+            headers=DEFAULT_HEADERS,
+            params=params,
+            timeout=DEFAULT_TIMEOUT
+        )
+        response.raise_for_status()
+        return response.json()
+
+    except requests.exceptions.Timeout:
+        return {"error": "Request timed out. Check your connection."}
+
+    except requests.exceptions.RequestException as e:
+        return {"error": f"Request failed: {str(e)}"}

gitraze-0.2.0/gitraze/modules/repo.py

@@ -0,0 +1,32 @@
+# repo.py
+from gitraze.utils.helpers import format_date 
+from gitraze.core.api_rest import get_repo as rest_get_repo
+
+def get_repo_rest(owner, repo):
+    data = rest_get_repo(owner, repo)
+
+    if "error" in data:
+        return data
+    
+    return {
+        "name": data.get("name"),
+        "full_name": data.get("full_name"),
+        "owner": data.get("owner", {}).get("login"),
+        "description": data.get("description"),
+        "private": data.get("private"),
+        "fork": data.get("fork"),
+        "language": data.get("language"),
+        "topics": data.get("topics"),
+        "stars": data.get("stargazers_count"),
+        "forks": data.get("forks_count"),
+        "watchers": data.get("watchers_count"),
+        "open_issues": data.get("open_issues_count"),
+        "size": data.get("size"),
+        "default_branch": data.get("default_branch"),
+        "repo_url": data.get("html_url"),
+        "clone_url": data.get("clone_url"),
+        "created_at": format_date(data.get("created_at")),
+        "updated_at": format_date(data.get("updated_at")),
+        "pushed_at": format_date(data.get("pushed_at")),
+        "license": data.get("license", {}).get("name") if data.get("license") else None,
+    }

gitraze-0.2.0/gitraze/modules/search.py

@@ -0,0 +1,107 @@
+# search.py
+from gitraze.utils.helpers import format_date 
+from gitraze.utils.helpers import clean_html
+from gitraze.core.api_rest import get_search
+
+
+def get_search_rest(category, query,  limit=1):
+    data = get_search(category, query)
+    if "error" in data:
+        return data
+    items = data.get("items", [])
+    
+    if category == "issues":
+        items = [i for i in items if "pull_request" not in i]
+    elif category == "prs":
+        items = [i for i in items if "pull_request" in i]
+        
+    if category not in ["repos", "users", "issues", "prs", "topics"]:
+        return {"error": "Invalid category"}
+    if not items:
+        return {"error": "No results found"}
+    items = items[:limit]
+    results = []
+
+    for item in items:
+        match(category):
+            case "repos":
+                results.append({
+                "full_name": item.get("full_name"),
+                "html_url": item.get("html_url"),
+                "description": clean_html(item.get("description")),
+                "stargazers_count": item.get("stargazers_count"),
+                "watchers_count": item.get("watchers_count"),
+                "forks_count": item.get("forks_count"),
+                "open_issues_count": item.get("open_issues_count"),
+                "archived": item.get("archived"),
+                "disabled": item.get("disabled"),
+                "updated_at": format_date(item.get("updated_at")),
+                "pushed_at": format_date(item.get("pushed_at")),
+                "language": item.get("language"),
+                "visibility": item.get("visibility"),
+                "default_branch": item.get("default_branch"),
+                "owner": item.get("owner", {}).get("login"),
+                "For More, use": "$ gitraze repo <owner/repo>"
+            })
+
+            case "users":
+                results.append({
+                "login": item.get("login"),
+                "html_url": item.get("html_url"),
+                "type": item.get("type"),
+                "score": item.get("score"),
+                "site_admin": item.get("site_admin"),
+                "repos_url": item.get("repos_url"),
+                "followers_url": item.get("followers_url"),
+                "following_url": item.get("following_url"),
+                "organizations_url": item.get("organizations_url"),
+                "For More, use": "$ gitraze user <username>"
+            })
+
+            case "issues":
+                results.append({
+                "title": item.get("title"),
+                "html_url": item.get("html_url"),
+                "state": item.get("state"),
+                "number": item.get("number"),
+                "comments": item.get("comments"),
+                "created_at": format_date(item.get("created_at")),
+                "updated_at": format_date(item.get("updated_at")),
+                "closed_at": format_date(item.get("closed_at")),
+                "user": item.get("user", {}).get("login"),
+                "repository_url": item.get("repository_url"),
+                "labels": [label.get("name") for label in item.get("labels", [])]
+            })
+            case "prs":
+                 results.append({
+                "title": item.get("title"),
+                "html_url": item.get("html_url"),
+                "state": item.get("state"),
+                "number": item.get("number"),
+                "comments": item.get("comments"),
+                "created_at": format_date(item.get("created_at")),
+                "updated_at": format_date(item.get("updated_at")),
+                "closed_at": format_date(item.get("closed_at")),
+                "merged_at": format_date(item.get("pull_request", {}).get("merged_at")),
+                "user": item.get("user", {}).get("login"),
+                "repository_url": item.get("repository_url"),
+                "labels": [label.get("name") for label in item.get("labels", [])],
+                "draft": item.get("draft"),
+                "pr_url": item.get("pull_request", {}).get("html_url")
+            })
+        
+            case "topics":
+                 results.append({
+                "name": item.get("name"),
+                "display_name": item.get("display_name"),
+                "short_description": clean_html(item.get("short_description")),
+                "description": clean_html(item.get("description")),
+                "score": item.get("score"),
+                "created_by": item.get("created_by"),
+                "released": item.get("released"),
+                "created_at": format_date(item.get("created_at")),
+                "featured": item.get("featured")
+            })
+
+    return results
+

{gitraze-0.0.2 → gitraze-0.2.0}/gitraze/modules/user.py

@@ -2,7 +2,7 @@
 from gitraze.utils.helpers import format_date 
 from gitraze.core.api_rest import get_user as rest_get_user
 
-def get_user(username):
+def get_user_rest(username):
     data = rest_get_user(username)
 
     if "error" in data:

{gitraze-0.0.2 → gitraze-0.2.0}/gitraze/utils/helpers.py

@@ -1,6 +1,7 @@
 # helpers.py
 from datetime import datetime
 from colorama import Fore, Style, init
+import re
 
 init(autoreset=True)
 
@@ -32,4 +33,11 @@ def pretty_print(data, title=None):
 def format_date(date_str):
     if not date_str:
         return None
-    return datetime.strptime(date_str, "%Y-%m-%dT%H:%M:%SZ").strftime("%d %b %Y")
+
+    try:
+        return datetime.strptime(date_str, "%Y-%m-%dT%H:%M:%SZ").strftime("%d %b %Y")
+    except ValueError:
+        return date_str  # fallback (don’t crash)
+
+def clean_html(text):
+    return re.sub(r"<.*?>", "", text) if text else text

{gitraze-0.0.2 → gitraze-0.2.0}/gitraze.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitraze
-Version: 0.0.2
+Version: 0.2.0
 Summary: A CLI and Python library for GitHub reconnaissance, search, and analysis
 Author: AK Pandey
 License: MIT
@@ -10,8 +10,11 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
+License-File: LICENSE
 Requires-Dist: requests
 Requires-Dist: colorama
+Requires-Dist: re
+Dynamic: license-file
 
 # Gitraze
 
@@ -62,8 +65,9 @@ Example:
 ```bash
 gitraze --help
 gitraze user octocat
-gitraze repo torvalds/linux       # Coming soon!
-gitraze search "machine learning" # Not implemented yet
+gitraze repo torvalds/linux       
+gitraze search "machine learning" 
+gitraze analyze github # Coming soon!
 ```
 
 Example output:

{gitraze-0.0.2 → gitraze-0.2.0}/gitraze.egg-info/SOURCES.txt

@@ -1,3 +1,4 @@
+LICENSE
 README.md
 pyproject.toml
 gitraze/__init__.py

{gitraze-0.0.2 → gitraze-0.2.0}/gitraze.egg-info/requires.txt

@@ -1,2 +1,3 @@
 requests
 colorama
+re

{gitraze-0.0.2 → gitraze-0.2.0}/pyproject.toml

@@ -1,9 +1,9 @@
 [project]
 name = "gitraze"
-version = "0.0.2"
+version = "0.2.0"
 description = "A CLI and Python library for GitHub reconnaissance, search, and analysis"
 authors = [{ name = "AK Pandey" }]
-dependencies = ["requests", "colorama"]
+dependencies = ["requests", "colorama", "re"]
 readme = "README.md"
 requires-python = ">=3.8"
 license = { text = "MIT" }

gitraze-0.0.2/gitraze/cli.py

@@ -1,80 +0,0 @@
-import argparse
-from gitraze.utils.helpers import pretty_print
-from gitraze.modules.user import get_user
-
-
-def main():
-    parser = argparse.ArgumentParser(
-        prog="gitraze",
-        description="GitRaze CLI Tool"
-    )
-
-    # Global flag
-    parser.add_argument(
-        "--version",
-        action="version",
-        version="gitraze 0.0.2"
-    )
-
-    subparsers = parser.add_subparsers(dest="command", required=True)
-
-    # --- USER ---
-    user_parser = subparsers.add_parser("user", help="Fetch user info (GitHub username)")
-    user_parser.add_argument("username")
-
-    # --- REPO ---
-    repo_parser = subparsers.add_parser("repo", help="Fetch repo info (Repository in owner/repo format)")
-    repo_parser.add_argument("repo")
-
-    # --- SEARCH ---
-    search_parser = subparsers.add_parser("search", help="Search GitHub")
-    search_parser.add_argument("query", nargs="+")
-
-    # --- ANALYZE ---
-    analyze_parser = subparsers.add_parser("analyze", help="Analyze target")
-    analyze_parser.add_argument("target", nargs="+")
-
-    args = parser.parse_args()
-
-    # --- ROUTING ---
-    if args.command == "user":
-        handle_user(args)
-    elif args.command == "repo":
-        handle_repo(args)
-    elif args.command == "search":
-        handle_search(args)
-    elif args.command == "analyze":
-        handle_analysis(args)
-    else:
-        parser.print_help()
-
-
-# --- HANDLERS  ---
-
-def handle_user(args):
-    print("[+] Fetching user data...")
-    data = get_user(args.username)
-
-    if "error" in data:
-        print(data["error"])
-        return
-
-    print("[✓] Done")
-    pretty_print(data, title=f"User: {args.username}")
-
-
-def handle_repo(args):
-    print(f"[REPO] Fetching data for {args.repo}")
-    print("Not implemented yet")
-
-
-def handle_search(args):
-    query = " ".join(args.query)
-    print(f"[SEARCH] Searching for '{query}'")
-    print("Not implemented yet")
-
-
-def handle_analysis(args):
-    target = " ".join(args.target)
-    print(f"[ANALYZE] Analyzing '{target}'")
-    print("Not implemented yet")

gitraze-0.0.2/gitraze/config.py

@@ -1,7 +0,0 @@
-# config.py
-REST_BASE_URL = "https://api.github.com"
-GRAPHQL_URL = "https://api.github.com/graphql"
-DEFAULT_TIMEOUT = 10
-DEFAULT_HEADERS = {
-    "Accept": "application/vnd.github+json"
-}

gitraze-0.0.2/gitraze/core/api_rest.py

@@ -1,34 +0,0 @@
-# api_rest.py
-import requests
-from gitraze.config import REST_BASE_URL, DEFAULT_HEADERS, DEFAULT_TIMEOUT
-
-
-import requests
-
-def get_user(username):
-    url = f"{REST_BASE_URL}/users/{username}"
-
-    try:
-        response = requests.get(
-            url,
-            headers=DEFAULT_HEADERS,
-            timeout=DEFAULT_TIMEOUT
-        )
-        response.raise_for_status()
-        return response.json()
-
-    except requests.exceptions.Timeout:
-        return {"error": "Request timed out. Check your connection."}
-
-    except requests.exceptions.RequestException as e:
-        return {"error": f"Request failed: {str(e)}"}
-
-
-def get_repo(owner, repo):
-    url = f"{REST_BASE_URL}/repos/{owner}/{repo}"
-    response = requests.get(url, headers=DEFAULT_HEADERS, timeout=DEFAULT_TIMEOUT)
-
-    if response.status_code != 200:
-        return {"error": f"Failed to fetch repo: {response.status_code}"}
-
-    return response.json()

gitraze-0.0.2/gitraze/modules/repo.py

@@ -1 +0,0 @@
-# repo.py

gitraze-0.0.2/gitraze/modules/search.py

@@ -1 +0,0 @@
-# search.py