gitraze 0.2.3__tar.gz → 0.2.5__tar.gz

{gitraze-0.2.3 → gitraze-0.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitraze
-Version: 0.2.3
+Version: 0.2.5
 Summary: A CLI and Python library for GitHub reconnaissance, search, and analysis
 Author: AK Pandey
 License-Expression: MIT
@@ -65,7 +65,7 @@ pip install gitraze
 
 ## Usage
 
-Run directly from your terminal:
+### Run directly from your terminal:
 
 Example: 
 ```bash
@@ -103,14 +103,79 @@ Email            : None
 Twitter_username : None
 
 ```
-> 💡 Commands prefixed with `$` should be run in your terminal.
+> Commands prefixed with `$` should be run in your terminal.
 
-You can also use it inside Python:
+### Gitraze can also be used as a lightweight Python SDK.
 
+#### User:
 ```python
-import gitraze
+import gitraze as gz
+
+user = gz.user("octocat")
+
+print(user["name"])
+print(user["followers"])
+```
+
+#### Search: 
+
+```python
+results = gz.search(gz.REPOS, "machine learning", 3)
+
+for repo in results:
+    print(repo["full_name"])
+```
+
+### Pretty-print results in terminal style:
+
+```python
+from gitraze import *
+
+display(user("octocat"))
 ```
 
+Example output:
+
+```bash
+Name             : The Octocat
+Login            : octocat
+Id               : 583231
+Node_id          : MDQ6VXNlcjU4MzIzMQ==
+Type             : User
+User_view_type   : public
+Bio              : None
+Followers        : 22578
+Following        : 9
+Public_repos     : 8
+Public_gists     : 8
+Location         : San Francisco
+Profile_url      : https://github.com/octocat
+Created_at       : 25 Jan 2011
+Email            : None
+Twitter_username : None
+```
+
+> Note: **`import gitraze as gz`** is the recommended import.
+
+## Available exports:
+
+### Functions: 
+
+- `user()`
+- `repo()`
+- `search()`
+- `display()`
+
+### Constants:
+
+- `USERS`
+- `REPOS`
+- `PRS`
+- `ISSUES`
+- `TOPICS`
+
+
+
 ⚠️ CLI commands are still evolving and may change.
 
 ## Philosophy
@@ -143,6 +208,18 @@ Gitraze is in active development:
 
 If you're here early — you're basically a beta tester 😈
 
+## Contributing
+
+PRs, ideas, bug reports, and feature suggestions are welcome.
+If you want to improve or modify Gitraze, go ahead.
+
+```bash
+git checkout -b feature/cool-thing
+```
+
+Just keep the code clean and the terminal fast.
+
+
 ## License
 
 MIT License — do whatever you want, just don’t blame me if you break stuff.

{gitraze-0.2.3 → gitraze-0.2.5}/README.md

@@ -48,7 +48,7 @@ pip install gitraze
 
 ## Usage
 
-Run directly from your terminal:
+### Run directly from your terminal:
 
 Example: 
 ```bash
@@ -86,14 +86,79 @@ Email            : None
 Twitter_username : None
 
 ```
-> 💡 Commands prefixed with `$` should be run in your terminal.
+> Commands prefixed with `$` should be run in your terminal.
 
-You can also use it inside Python:
+### Gitraze can also be used as a lightweight Python SDK.
 
+#### User:
 ```python
-import gitraze
+import gitraze as gz
+
+user = gz.user("octocat")
+
+print(user["name"])
+print(user["followers"])
+```
+
+#### Search: 
+
+```python
+results = gz.search(gz.REPOS, "machine learning", 3)
+
+for repo in results:
+    print(repo["full_name"])
+```
+
+### Pretty-print results in terminal style:
+
+```python
+from gitraze import *
+
+display(user("octocat"))
 ```
 
+Example output:
+
+```bash
+Name             : The Octocat
+Login            : octocat
+Id               : 583231
+Node_id          : MDQ6VXNlcjU4MzIzMQ==
+Type             : User
+User_view_type   : public
+Bio              : None
+Followers        : 22578
+Following        : 9
+Public_repos     : 8
+Public_gists     : 8
+Location         : San Francisco
+Profile_url      : https://github.com/octocat
+Created_at       : 25 Jan 2011
+Email            : None
+Twitter_username : None
+```
+
+> Note: **`import gitraze as gz`** is the recommended import.
+
+## Available exports:
+
+### Functions: 
+
+- `user()`
+- `repo()`
+- `search()`
+- `display()`
+
+### Constants:
+
+- `USERS`
+- `REPOS`
+- `PRS`
+- `ISSUES`
+- `TOPICS`
+
+
+
 ⚠️ CLI commands are still evolving and may change.
 
 ## Philosophy
@@ -126,6 +191,18 @@ Gitraze is in active development:
 
 If you're here early — you're basically a beta tester 😈
 
+## Contributing
+
+PRs, ideas, bug reports, and feature suggestions are welcome.
+If you want to improve or modify Gitraze, go ahead.
+
+```bash
+git checkout -b feature/cool-thing
+```
+
+Just keep the code clean and the terminal fast.
+
+
 ## License
 
 MIT License — do whatever you want, just don’t blame me if you break stuff.

gitraze-0.2.5/gitraze/__init__.py

@@ -0,0 +1,25 @@
+from .modules.user import get_user_rest as user
+from .modules.repo import get_repo_rest as repo
+from .modules.search import get_search_rest as search
+
+from .utils.helpers import pretty_print as display
+
+__version__ = "0.2.5"
+
+USERS = "users"
+REPOS = "repos"
+PRS = "prs"
+ISSUES = "issues"
+TOPICS = "topics"
+
+__all__ = [
+    "display",
+    "user",
+    "repo",
+    "search",
+    "USERS",
+    "REPOS",
+    "PRS",
+    "ISSUES",
+    "TOPICS",
+]

gitraze-0.2.5/gitraze/cli.py

@@ -0,0 +1,61 @@
+import argparse
+from gitraze.handlers.user import handle_user
+from gitraze.handlers.repo import handle_repo
+from gitraze.handlers.search import handle_search
+from gitraze.handlers.analyze import handle_analysis
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="gitraze",
+        description="GitRaze CLI Tool"
+    )
+
+    # Global flag
+    parser.add_argument(
+        "--version",
+        action="version",
+        version="gitraze 0.2.5"
+    )
+
+    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")
+    user_parser.set_defaults(func=handle_user)
+
+
+    # --- 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")
+    repo_parser.set_defaults(func=handle_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")
+    search_parser.set_defaults(func=handle_search)
+
+
+    # --- ANALYZE ---
+    analyze_parser = subparsers.add_parser("analyze", help="Analyze target")
+    analyze_parser.add_argument("target", nargs="+")
+    analyze_parser.set_defaults(func=handle_analysis)
+
+    args = parser.parse_args()
+    args.func(args)
+
+
+
+
+if __name__ == "__main__":
+    main()
+
+
+
+
+
+

{gitraze-0.2.3 → gitraze-0.2.5}/gitraze/config.py

@@ -7,16 +7,9 @@ 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 ---
-
+    "Accept": "application/vnd.github+json"}
 
-# --- SEARCH CONFIG ---
+# --- SEARCH CATEGORIES CONFIG  ---
 SEARCH_MAP = {
     "repos": "repositories",
     "users": "users",

gitraze-0.2.5/gitraze/handlers/analyze.py

@@ -0,0 +1,7 @@
+from gitraze.utils.helpers import pretty_print
+
+
+def handle_analysis(args):
+    target = " ".join(args.target)
+    print(f"[ANALYZE] Analyzing '{target}'")
+    print("Not implemented yet")

gitraze-0.2.5/gitraze/handlers/repo.py

@@ -0,0 +1,19 @@
+from gitraze.utils.helpers import pretty_print
+from gitraze.modules.repo import get_repo_rest
+
+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}")

gitraze-0.2.5/gitraze/handlers/search.py

@@ -0,0 +1,26 @@
+from gitraze.utils.helpers import pretty_print
+from gitraze.modules.search import get_search_rest
+
+def handle_search(args):
+    category = args.category
+
+    raw_query = " ".join(args.query)
+    clean_query = raw_query.replace('"', '')
+    query = f'"{clean_query}"'
+
+    print(f"[+] Searching {category} for {query}...")
+
+
+    data = get_search_rest(category, 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}")

gitraze-0.2.5/gitraze/handlers/user.py

@@ -0,0 +1,13 @@
+from gitraze.utils.helpers import pretty_print
+from gitraze.modules.user import get_user_rest
+
+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}")

{gitraze-0.2.3 → gitraze-0.2.5}/gitraze.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitraze
-Version: 0.2.3
+Version: 0.2.5
 Summary: A CLI and Python library for GitHub reconnaissance, search, and analysis
 Author: AK Pandey
 License-Expression: MIT
@@ -65,7 +65,7 @@ pip install gitraze
 
 ## Usage
 
-Run directly from your terminal:
+### Run directly from your terminal:
 
 Example: 
 ```bash
@@ -103,14 +103,79 @@ Email            : None
 Twitter_username : None
 
 ```
-> 💡 Commands prefixed with `$` should be run in your terminal.
+> Commands prefixed with `$` should be run in your terminal.
 
-You can also use it inside Python:
+### Gitraze can also be used as a lightweight Python SDK.
 
+#### User:
 ```python
-import gitraze
+import gitraze as gz
+
+user = gz.user("octocat")
+
+print(user["name"])
+print(user["followers"])
+```
+
+#### Search: 
+
+```python
+results = gz.search(gz.REPOS, "machine learning", 3)
+
+for repo in results:
+    print(repo["full_name"])
+```
+
+### Pretty-print results in terminal style:
+
+```python
+from gitraze import *
+
+display(user("octocat"))
 ```
 
+Example output:
+
+```bash
+Name             : The Octocat
+Login            : octocat
+Id               : 583231
+Node_id          : MDQ6VXNlcjU4MzIzMQ==
+Type             : User
+User_view_type   : public
+Bio              : None
+Followers        : 22578
+Following        : 9
+Public_repos     : 8
+Public_gists     : 8
+Location         : San Francisco
+Profile_url      : https://github.com/octocat
+Created_at       : 25 Jan 2011
+Email            : None
+Twitter_username : None
+```
+
+> Note: **`import gitraze as gz`** is the recommended import.
+
+## Available exports:
+
+### Functions: 
+
+- `user()`
+- `repo()`
+- `search()`
+- `display()`
+
+### Constants:
+
+- `USERS`
+- `REPOS`
+- `PRS`
+- `ISSUES`
+- `TOPICS`
+
+
+
 ⚠️ CLI commands are still evolving and may change.
 
 ## Philosophy
@@ -143,6 +208,18 @@ Gitraze is in active development:
 
 If you're here early — you're basically a beta tester 😈
 
+## Contributing
+
+PRs, ideas, bug reports, and feature suggestions are welcome.
+If you want to improve or modify Gitraze, go ahead.
+
+```bash
+git checkout -b feature/cool-thing
+```
+
+Just keep the code clean and the terminal fast.
+
+
 ## License
 
 MIT License — do whatever you want, just don’t blame me if you break stuff.

{gitraze-0.2.3 → gitraze-0.2.5}/gitraze.egg-info/SOURCES.txt

@@ -13,6 +13,11 @@ gitraze.egg-info/top_level.txt
 gitraze/core/__init__.py
 gitraze/core/api_graphql.py
 gitraze/core/api_rest.py
+gitraze/handlers/__init__.py
+gitraze/handlers/analyze.py
+gitraze/handlers/repo.py
+gitraze/handlers/search.py
+gitraze/handlers/user.py
 gitraze/modules/__init__.py
 gitraze/modules/analytics.py
 gitraze/modules/repo.py

{gitraze-0.2.3 → gitraze-0.2.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "gitraze"
-version = "0.2.3"
+version = "0.2.5"
 description = "A CLI and Python library for GitHub reconnaissance, search, and analysis"
 authors = [{ name = "AK Pandey" }]
 dependencies = ["requests", "colorama"]

gitraze-0.2.3/gitraze/cli.py

@@ -1,116 +0,0 @@
-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.3"
-    )
-
-    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
-
-    raw_query = " ".join(args.query)
-    clean_query = raw_query.replace('"', '')
-    query = f'"{clean_query}"'
-
-    print(f"[+] Searching {category} for {query}...")
-
-
-    data = get_search_rest(category, 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")