apihunterx 0.1.0__tar.gz

apihunterx-0.1.0/LICENSE

@@ -0,0 +1 @@
+TODO: Choose a license for this project.

apihunterx-0.1.0/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: apihunterx
+Version: 0.1.0
+Summary: Scan projects for APIs, URLs and environment variables
+Requires-Python: >=3.8
+License-File: LICENSE
+Dynamic: license-file

apihunterx-0.1.0/README.md

@@ -0,0 +1,205 @@
+# API Hunter
+
+A lightweight Python CLI tool that scans projects and generates an inventory of APIs, SDKs, URLs, and environment variables used throughout the codebase.
+
+Perfect for:
+
+* Developers onboarding to new projects
+* DevOps engineers auditing dependencies
+* Security reviews
+* Documentation generation
+* API discovery and inventory management
+
+---
+
+## Features
+
+✅ Detect API SDKs
+
+* OpenAI
+* AWS (boto3)
+* Anthropic
+* Stripe
+* Discord
+* Tweepy
+* Google Gemini
+* HTTP clients (Requests, HTTPX)
+
+✅ Detect API URLs
+
+* REST endpoints
+* External service URLs
+* Webhook URLs
+
+✅ Detect Environment Variables
+
+* `os.getenv()`
+* `os.environ[]`
+
+✅ Generate Reports
+
+* Human-readable TXT reports
+* Fast project scanning
+* Recursive file discovery
+
+---
+
+## Installation
+
+```bash
+pip install api-hunter
+```
+
+For local development:
+
+```bash
+git clone https://github.com/yourusername/api-hunter.git
+
+cd api-hunter
+
+pip install -e .
+```
+
+---
+
+## Usage
+
+Scan a project:
+
+```bash
+api-hunter scan .
+```
+
+Scan another directory:
+
+```bash
+api-hunter scan D:\projects\my-app
+```
+
+Alternative execution:
+
+```bash
+python -m api_hunter scan .
+```
+
+---
+
+## Example Output
+
+```text
+==================================================
+API HUNTER REPORT
+==================================================
+
+DETECTED SERVICES
+------------------------------
+- OpenAI
+- AWS
+
+API URLS
+------------------------------
+- https://api.openai.com/v1/chat/completions
+- https://api.github.com/repos
+
+ENVIRONMENT VARIABLES
+------------------------------
+- OPENAI_API_KEY
+- AWS_SECRET_ACCESS_KEY
+
+FILES SCANNED: 42
+```
+
+---
+
+## Supported Detection
+
+### SDK Imports
+
+```python
+import openai
+import boto3
+import stripe
+from anthropic import Anthropic
+```
+
+### URLs
+
+```python
+url = "https://api.openai.com/v1/chat/completions"
+```
+
+### Environment Variables
+
+```python
+os.getenv("OPENAI_API_KEY")
+
+os.environ["AWS_SECRET_ACCESS_KEY"]
+```
+
+---
+
+## Roadmap
+
+### Version 0.2
+
+* JSON reports
+* Markdown reports
+* Requirements.txt analysis
+* pyproject.toml analysis
+
+### Version 0.3
+
+* FastAPI route discovery
+* Flask route discovery
+* OpenAPI detection
+* Swagger detection
+
+### Version 0.4
+
+* Security auditing
+* Hardcoded API key detection
+* Secret exposure warnings
+
+### Version 1.0
+
+* Multi-language support
+* JavaScript support
+* TypeScript support
+* Dependency graph generation
+* HTML reports
+
+---
+
+## Why API Hunter?
+
+Many projects rely on dozens of external APIs and services but lack proper documentation.
+
+API Hunter helps teams quickly understand:
+
+* Which APIs are used
+* Which environment variables are required
+* Which external services are connected
+* What dependencies a project relies on
+
+---
+
+## Contributing
+
+Contributions, bug reports, and feature requests are welcome.
+
+1. Fork the repository
+2. Create a feature branch
+3. Commit your changes
+4. Submit a pull request
+
+---
+
+## License
+
+MIT License
+
+---
+
+## Author
+
+Samarth Patil

apihunterx-0.1.0/api_hunter/__init__.py

@@ -0,0 +1,3 @@
+"""api-hunter package."""
+
+__version__ = "0.1.0"

apihunterx-0.1.0/api_hunter/cli.py

@@ -0,0 +1,54 @@
+import argparse
+
+from .scanner import scan_project
+from .report import generate_txt_report
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="api-hunter",
+        description="Scan projects for APIs, URLs and env vars"
+    )
+
+    subparsers = parser.add_subparsers(
+        dest="command"
+    )
+
+    scan_parser = subparsers.add_parser(
+        "scan",
+        help="Scan project"
+    )
+
+    scan_parser.add_argument(
+        "path",
+        help="Project path"
+    )
+
+    args = parser.parse_args()
+
+    if args.command == "scan":
+        results = scan_project(args.path)
+
+        report = generate_txt_report(results)
+
+        print()
+        print("Scan Complete")
+        print(f"Report saved to: {report}")
+        print()
+
+        print(
+            f"Services Found: {len(results['services'])}"
+        )
+        print(
+            f"URLs Found: {len(results['urls'])}"
+        )
+        print(
+            f"Env Vars Found: {len(results['env_vars'])}"
+        )
+
+    else:
+        parser.print_help()
+
+
+if __name__ == "__main__":
+    main()

apihunterx-0.1.0/api_hunter/detector.py

@@ -0,0 +1,58 @@
+import re
+import ast
+
+KNOWN_APIS = {
+    "openai": "OpenAI",
+    "boto3": "AWS",
+    "stripe": "Stripe",
+    "anthropic": "Anthropic",
+    "google.generativeai": "Google Gemini",
+    "discord": "Discord",
+    "tweepy": "Twitter/X",
+    "requests": "HTTP Client",
+    "httpx": "HTTP Client",
+}
+
+URL_REGEX = r"https?://[^\s\"'<>]+"
+
+ENV_REGEXES = [
+    r'os\.getenv\(["\']([^"\']+)["\']\)',
+    r'os\.environ\["([^"]+)"\]',
+    r"os\.environ\['([^']+)'\]"
+]
+
+
+def detect_imports(content):
+    services = set()
+
+    try:
+        tree = ast.parse(content)
+
+        for node in ast.walk(tree):
+            if isinstance(node, ast.Import):
+                for alias in node.names:
+                    if alias.name in KNOWN_APIS:
+                        services.add(KNOWN_APIS[alias.name])
+
+            elif isinstance(node, ast.ImportFrom):
+                if node.module in KNOWN_APIS:
+                    services.add(KNOWN_APIS[node.module])
+
+    except Exception:
+        pass
+
+    return services
+
+
+def detect_urls(content):
+    return set(re.findall(URL_REGEX, content))
+
+
+def detect_env_vars(content):
+    envs = set()
+
+    for pattern in ENV_REGEXES:
+        matches = re.findall(pattern, content)
+        envs.update(matches)
+
+    return envs

apihunterx-0.1.0/api_hunter/report.py

@@ -0,0 +1,49 @@
+from pathlib import Path
+
+
+def generate_txt_report(results, output_file="api_inventory.txt"):
+    lines = []
+
+    lines.append("=" * 50)
+    lines.append("API HUNTER REPORT")
+    lines.append("=" * 50)
+    lines.append("")
+
+    lines.append("DETECTED SERVICES")
+    lines.append("-" * 30)
+
+    if results["services"]:
+        for service in results["services"]:
+            lines.append(f"- {service}")
+    else:
+        lines.append("None Found")
+
+    lines.append("")
+    lines.append("API URLS")
+    lines.append("-" * 30)
+
+    if results["urls"]:
+        for url in results["urls"]:
+            lines.append(f"- {url}")
+    else:
+        lines.append("None Found")
+
+    lines.append("")
+    lines.append("ENVIRONMENT VARIABLES")
+    lines.append("-" * 30)
+
+    if results["env_vars"]:
+        for env in results["env_vars"]:
+            lines.append(f"- {env}")
+    else:
+        lines.append("None Found")
+
+    lines.append("")
+    lines.append(f"FILES SCANNED: {results['files_scanned']}")
+
+    Path(output_file).write_text(
+        "\n".join(lines),
+        encoding="utf-8"
+    )
+
+    return output_file

apihunterx-0.1.0/api_hunter/scanner.py

@@ -0,0 +1,46 @@
+from pathlib import Path
+
+from .detector import (
+    detect_imports,
+    detect_urls,
+    detect_env_vars
+)
+
+
+def scan_project(project_path):
+    services = set()
+    urls = set()
+    env_vars = set()
+
+    files_scanned = 0
+
+    for file in Path(project_path).rglob("*.py"):
+        files_scanned += 1
+
+        try:
+            content = file.read_text(
+                encoding="utf-8",
+                errors="ignore"
+            )
+
+            services.update(
+                detect_imports(content)
+            )
+
+            urls.update(
+                detect_urls(content)
+            )
+
+            env_vars.update(
+                detect_env_vars(content)
+            )
+
+        except Exception:
+            continue
+
+    return {
+        "services": sorted(services),
+        "urls": sorted(urls),
+        "env_vars": sorted(env_vars),
+        "files_scanned": files_scanned
+    }

apihunterx-0.1.0/apihunterx.egg-info/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: apihunterx
+Version: 0.1.0
+Summary: Scan projects for APIs, URLs and environment variables
+Requires-Python: >=3.8
+License-File: LICENSE
+Dynamic: license-file

apihunterx-0.1.0/apihunterx.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+LICENSE
+README.md
+pyproject.toml
+api_hunter/__init__.py
+api_hunter/cli.py
+api_hunter/detector.py
+api_hunter/report.py
+api_hunter/scanner.py
+apihunterx.egg-info/PKG-INFO
+apihunterx.egg-info/SOURCES.txt
+apihunterx.egg-info/dependency_links.txt
+apihunterx.egg-info/entry_points.txt
+apihunterx.egg-info/top_level.txt

apihunterx-0.1.0/apihunterx.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

apihunterx-0.1.0/apihunterx.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+api-hunter = apihunterx.cli:main

apihunterx-0.1.0/apihunterx.egg-info/top_level.txt

@@ -0,0 +1,4 @@
+api_hunter
+data
+dist
+tests

apihunterx-0.1.0/pyproject.toml

@@ -0,0 +1,15 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "apihunterx"
+version = "0.1.0"
+description = "Scan projects for APIs, URLs and environment variables"
+requires-python = ">=3.8"
+
+[tool.setuptools.packages.find]
+where = ["."]
+
+[project.scripts]
+api-hunter = "apihunterx.cli:main"

apihunterx-0.1.0/setup.cfg

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