pullshark 2.4.6__py3-none-any.whl

pullshark/__init__.py

@@ -0,0 +1,12 @@
+"""
+PullShark — GitHub Pull Shark Achievement Automator.
+
+Automate pull request creation and merging to unlock the Pull Shark achievement.
+"""
+
+__version__ = "2.4.6"
+__author__ = "Sʜɪɴᴇɪ Nᴏᴜᴢᴇɴ"
+
+from pullshark.core import PullSharkBot
+
+__all__ = ["PullSharkBot"]

pullshark/__main__.py

@@ -0,0 +1,6 @@
+"""Allow running as `python -m pullshark`."""
+
+from pullshark.cli import main
+
+if __name__ == "__main__":
+    main()

pullshark/cli.py

@@ -0,0 +1,161 @@
+"""
+Command-line interface for PullShark.
+
+Usage:
+    pullshark run --token ghp_xxx --repo myrepo
+    pullshark run --token ghp_xxx --repo myrepo --dry-run --log run.log --output report.json
+    pullshark clean --token ghp_xxx --repo myrepo
+"""
+
+from __future__ import annotations
+
+import argparse
+import logging
+import sys
+
+from pullshark.config import Config
+from pullshark.core import PullSharkBot
+
+
+def _setup_logging(log_file: str = "") -> None:
+    """Configure logging for the pullshark package."""
+    logger = logging.getLogger("pullshark")
+    logger.setLevel(logging.DEBUG)
+
+    # Console handler — only warnings and above to stdout
+    console = logging.StreamHandler(sys.stdout)
+    console.setLevel(logging.WARNING)
+    console.setFormatter(logging.Formatter("%(message)s"))
+    logger.addHandler(console)
+
+    # File handler — everything if a log file is specified
+    if log_file:
+        fh = logging.FileHandler(log_file, mode="a", encoding="utf-8")
+        fh.setLevel(logging.DEBUG)
+        fh.setFormatter(
+            logging.Formatter("%(asctime)s [%(levelname)s] %(message)s", datefmt="%Y-%m-%d %H:%M:%S")
+        )
+        logger.addHandler(fh)
+
+
+def _add_common_args(parser: argparse.ArgumentParser) -> None:
+    """Add arguments shared by all subcommands."""
+    parser.add_argument("-t", "--token", required=True, help="GitHub Personal Access Token (with repo scope).")
+    parser.add_argument("-r", "--repo", required=True, help="Target repository name.")
+    parser.add_argument("-u", "--username", required=True, help="Your GitHub username.")
+
+
+def build_parser() -> argparse.ArgumentParser:
+    """Build the CLI argument parser with subcommands."""
+    parser = argparse.ArgumentParser(
+        prog="pullshark",
+        description="🦈 GitHub Pull Shark Achievement Automator — create and merge PRs automatically.",
+    )
+    sub = parser.add_subparsers(dest="command", help="Command to run")
+
+    # --- run ---
+    run_parser = sub.add_parser("run", help="Create and merge pull requests.")
+    _add_common_args(run_parser)
+    run_parser.add_argument("-n", "--prs", type=int, default=4, help="Number of PRs to create (default: 4).")
+    run_parser.add_argument("-b", "--branch", default="main", help="Base branch to target (default: main).")
+    run_parser.add_argument("-d", "--delay", type=int, default=10, help="Delay in seconds between PRs (default: 10).")
+    run_parser.add_argument("--max-retries", type=int, default=3, help="Maximum merge retry attempts (default: 3).")
+    run_parser.add_argument("--merge-method", choices=["merge", "squash", "rebase"], default="merge", help="Merge strategy (default: merge).")
+    run_parser.add_argument("--prefix", default="auto-pr", help="Branch name prefix (default: auto-pr).")
+    run_parser.add_argument("--dry-run", action="store_true", help="Preview what would happen without making changes.")
+    run_parser.add_argument("--check-rate", action="store_true", help="Check API rate limit before running.")
+    run_parser.add_argument("--log", default="", metavar="FILE", help="Save detailed logs to a file.")
+    run_parser.add_argument("--output", default="", metavar="FILE", help="Save run report as JSON.")
+
+    # --- clean ---
+    clean_parser = sub.add_parser("clean", help="Delete auto-created branches from the repo.")
+    _add_common_args(clean_parser)
+    clean_parser.add_argument("--prefix", default="auto-pr", help="Branch prefix to clean (default: auto-pr).")
+    clean_parser.add_argument("--dry-run", action="store_true", help="Show branches that would be deleted without deleting them.")
+    clean_parser.add_argument("--log", default="", metavar="FILE", help="Save detailed logs to a file.")
+
+    return parser
+
+
+def _run(args: argparse.Namespace) -> None:
+    """Handle the 'run' command."""
+    _setup_logging(args.log)
+    logger = logging.getLogger("pullshark")
+    logger.info("Starting PullShark run command")
+
+    config = Config(
+        github_username=args.username,
+        github_token=args.token,
+        repo_name=args.repo,
+        num_prs=args.prs,
+        base_branch=args.branch,
+        delay_seconds=args.delay,
+        max_retries=args.max_retries,
+        dry_run=args.dry_run,
+        merge_method=args.merge_method,
+        branch_prefix=args.prefix,
+        log_file=args.log,
+        output_file=args.output,
+    )
+
+    errors = config.validate()
+    if errors:
+        for err in errors:
+            print(f"❌ {err}", file=sys.stderr)
+        sys.exit(1)
+
+    bot = PullSharkBot(config)
+
+    if args.check_rate:
+        info = bot.check_rate_limit()
+        print(f"📊 API Rate Limit: {info['remaining']}/{info['limit']} remaining (resets {info['reset']})")
+        if not info["enough_for_run"]:
+            print(f"⚠️  May not have enough calls for {config.num_prs} PRs. Consider waiting.\n")
+        else:
+            print("✅ Enough API calls available.\n")
+
+    successful = bot.run()
+    logger.info("Run complete: %d/%d merged", successful, config.num_prs)
+    sys.exit(0 if successful >= 2 else 1)
+
+
+def _clean(args: argparse.Namespace) -> None:
+    """Handle the 'clean' command."""
+    _setup_logging(args.log)
+
+    config = Config(
+        github_username=args.username,
+        github_token=args.token,
+        repo_name=args.repo,
+        branch_prefix=args.prefix,
+    )
+
+    bot = PullSharkBot(config)
+    bot.clean(dry_run=args.dry_run)
+
+
+def main(argv: list[str] | None = None) -> None:
+    """CLI entry point."""
+    parser = build_parser()
+
+    if argv is None:
+        argv = sys.argv[1:]
+
+    # Default to 'run' if no subcommand given
+    if len(argv) > 0 and argv[0] not in ("run", "clean", "--help", "-h"):
+        argv = ["run"] + argv
+
+    args = parser.parse_args(argv)
+
+    if args.command is None:
+        parser.print_help()
+        sys.exit(0)
+
+    if args.command == "run":
+        _run(args)
+    elif args.command == "clean":
+        _clean(args)
+
+
+if __name__ == "__main__":
+    main()

pullshark/config.py

@@ -0,0 +1,46 @@
+"""
+Configuration defaults and validation for PullShark.
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+
+@dataclass
+class Config:
+    """PullShark configuration with sensible defaults."""
+
+    github_username: str = ""
+    github_token: str = ""
+    repo_name: str = ""
+    num_prs: int = 4
+    base_branch: str = "main"
+    delay_seconds: int = 10
+    max_retries: int = 3
+    dry_run: bool = False
+    merge_method: str = "merge"
+    branch_prefix: str = "auto-pr"
+    log_file: str = ""
+    output_file: str = ""
+
+    def validate(self) -> list[str]:
+        """Return a list of validation errors (empty = valid)."""
+        errors: list[str] = []
+        if not self.github_username:
+            errors.append("GITHUB_USERNAME is required.")
+        if not self.github_token:
+            errors.append("GITHUB_TOKEN is required.")
+        if not self.repo_name:
+            errors.append("REPO_NAME is required.")
+        if self.num_prs < 1:
+            errors.append("NUM_PRS must be at least 1.")
+        if self.delay_seconds < 0:
+            errors.append("DELAY_SECONDS cannot be negative.")
+        if self.max_retries < 1:
+            errors.append("MAX_RETRIES must be at least 1.")
+        if self.merge_method not in ("merge", "squash", "rebase"):
+            errors.append("MERGE_METHOD must be one of: merge, squash, rebase.")
+        if not self.branch_prefix:
+            errors.append("BRANCH_PREFIX cannot be empty.")
+        return errors

pullshark/core.py

@@ -0,0 +1,291 @@
+"""
+Core automation logic for PullShark.
+"""
+
+from __future__ import annotations
+
+import logging
+import time
+
+from github import Github, GithubException
+from github.Repository import Repository
+
+from pullshark import __version__
+from pullshark.config import Config
+from pullshark.utils import (
+    build_run_report,
+    generate_random_string,
+    merge_with_retry,
+    save_report,
+    wait_for_mergeability,
+)
+
+logger = logging.getLogger("pullshark")
+
+
+class PullSharkBot:
+    """Automates PR creation and merging for the Pull Shark achievement."""
+
+    def __init__(self, config: Config) -> None:
+        self.config = config
+        self._github: Github | None = None
+        self._repo: Repository | None = None
+
+    # -- Properties -----------------------------------------------------------
+
+    @property
+    def github(self) -> Github:
+        if self._github is None:
+            try:
+                import github.Auth
+                self._github = Github(auth=github.Auth.Token(self.config.github_token))
+            except (ImportError, AttributeError):
+                self._github = Github(self.config.github_token)
+        return self._github
+
+    @property
+    def repo(self) -> Repository:
+        if self._repo is None:
+            self._repo = self.github.get_user().get_repo(self.config.repo_name)
+        return self._repo
+
+    # -- Public API -----------------------------------------------------------
+
+    def run(self) -> int:
+        """Execute the full automation loop.
+
+        Returns:
+            Number of successfully merged pull requests.
+        """
+        cfg = self.config
+        successful = 0
+        results: list[dict] = []
+
+        self._print_header()
+
+        if cfg.dry_run:
+            print("🔍 DRY RUN — no branches, commits, or PRs will be created.\n")
+            logger.info("Dry run mode enabled")
+
+        for i in range(cfg.num_prs):
+            print(f"\n--- 📦 PR #{i + 1} of {cfg.num_prs} ---")
+            pr_result: dict = {"index": i + 1, "merged": False}
+
+            if cfg.dry_run:
+                self._dry_run_preview(i + 1)
+                pr_result["merged"] = True
+                pr_result["dry_run"] = True
+                results.append(pr_result)
+                successful += 1
+                continue
+
+            branch_name = self._create_branch()
+            if not branch_name:
+                pr_result["error"] = "Failed to create branch"
+                results.append(pr_result)
+                break
+
+            pr_result["branch"] = branch_name
+            self._make_commit(branch_name)
+
+            pr = self._open_pull_request(i + 1, branch_name)
+            if pr is None:
+                pr_result["error"] = "Failed to create PR"
+                results.append(pr_result)
+                break
+
+            pr_result["pr_number"] = pr.number
+            pr_result["pr_url"] = pr.html_url
+
+            print("  ⏳ Waiting for GitHub to calculate mergeability...")
+            if not wait_for_mergeability(pr):
+                print("  ❌ PR not mergeable after waiting. Stopping.")
+                pr_result["error"] = "Not mergeable"
+                results.append(pr_result)
+                break
+
+            if merge_with_retry(pr, cfg.max_retries, cfg.delay_seconds, cfg.merge_method):
+                print(f"  🎉 Merged PR #{pr.number}")
+                pr_result["merged"] = True
+                successful += 1
+            else:
+                print("  ❌ All merge attempts exhausted. Stopping.")
+                pr_result["error"] = "Merge failed after retries"
+                results.append(pr_result)
+                break
+
+            results.append(pr_result)
+
+            if i < cfg.num_prs - 1:
+                print(f"  ⏸️  Pausing {cfg.delay_seconds}s for GitHub to process...")
+                time.sleep(cfg.delay_seconds)
+
+        # Save JSON report if requested
+        if cfg.output_file:
+            report = build_run_report(results, cfg)
+            save_report(report, cfg.output_file)
+            print(f"\n📄 Report saved to {cfg.output_file}")
+
+        self._print_summary(successful)
+        return successful
+
+    def clean(self, dry_run: bool = False) -> int:
+        """Delete all auto-created branches from the repo.
+
+        Returns:
+            Number of branches deleted (or that would be deleted in dry-run).
+        """
+        prefix = self.config.branch_prefix
+        deleted = 0
+
+        print(f"\n🧹 Scanning for '{prefix}*' branches in {self.config.repo_name}...\n")
+        logger.info("Scanning for '%s*' branches", prefix)
+
+        for branch in self.repo.get_branches():
+            if branch.name.startswith(prefix):
+                if dry_run:
+                    print(f"  🔍 Would delete: {branch.name}")
+                    logger.info("Would delete: %s", branch.name)
+                else:
+                    try:
+                        ref = self.repo.get_git_ref(f"heads/{branch.name}")
+                        ref.delete()
+                        print(f"  🗑️  Deleted: {branch.name}")
+                        logger.info("Deleted: %s", branch.name)
+                    except GithubException as e:
+                        print(f"  ❌ Failed to delete {branch.name}: {e}")
+                        logger.error("Failed to delete %s: %s", branch.name, e)
+                        continue
+                deleted += 1
+
+        if deleted == 0:
+            print("  ✨ No matching branches found. Repo is clean!")
+        else:
+            action = "would be deleted" if dry_run else "deleted"
+            print(f"\n🏁 {deleted} branch(es) {action}.")
+
+        return deleted
+
+    def check_rate_limit(self) -> dict:
+        """Check GitHub API rate limit status.
+
+        Returns:
+            Dict with rate limit info.
+        """
+        rate = self.github.get_rate_limit()
+        core = getattr(rate, "core", None) or rate.rate
+        return {
+            "remaining": core.remaining,
+            "limit": core.limit,
+            "reset": core.reset.strftime("%H:%M:%S"),
+            "enough_for_run": core.remaining >= self.config.num_prs * 4,
+        }
+
+    # -- Internals ------------------------------------------------------------
+
+    def _print_header(self) -> None:
+        cfg = self.config
+        mode = " [DRY RUN]" if cfg.dry_run else ""
+        print(f"\nConfiguration: user='{cfg.github_username}' repo='{cfg.repo_name}'{mode}")
+        print(f"Base branch: {cfg.base_branch}")
+        print(f"Will create {cfg.num_prs} PR(s) with {cfg.delay_seconds}s delay.")
+        print(f"Merge method: {cfg.merge_method}")
+        print(f"Branch prefix: {cfg.branch_prefix}\n")
+
+    def _dry_run_preview(self, index: int) -> None:
+        """Preview what a PR would look like without creating anything."""
+        prefix = self.config.branch_prefix
+        branch_name = f"{prefix}-{generate_random_string(6)}-{int(time.time())}"
+        print(f"  📋 Would create branch: {branch_name}")
+        print("  📝 Would commit to: README.md")
+        print(f"  🔗 Would open PR #{index}: Auto-PR {generate_random_string(4)} #{index}")
+        print(f"  🎉 Would merge via: {self.config.merge_method}")
+
+    def _create_branch(self) -> str | None:
+        """Create a new branch from the latest base commit."""
+        cfg = self.config
+        base = self.repo.get_branch(cfg.base_branch)
+        sha = base.commit.sha
+        print(f"  Latest {cfg.base_branch} commit: {sha[:7]}")
+
+        branch_name = f"{cfg.branch_prefix}-{generate_random_string(6)}-{int(time.time())}"
+        try:
+            self.repo.create_git_ref(f"refs/heads/{branch_name}", sha)
+            print(f"  ✅ Created branch: {branch_name}")
+            logger.info("Created branch: %s", branch_name)
+            return branch_name
+        except GithubException as e:
+            print(f"  ❌ Failed to create branch: {e}")
+            logger.error("Failed to create branch: %s", e)
+            return None
+
+    # Watermark & credits appended to every commit and PR
+    _WATERMARK = (
+        "\n\n---\n"
+        "<div align=\"center\">\n\n"
+        "🦈 **Automated by [PullShark](https://github.com/Shineii86/PullShark)**\n\n"
+        "[![Author](https://img.shields.io/badge/Author-Sʜɪɴᴇɪ%20Nᴏᴜᴢᴇɴ-2ea44f?style=flat-square&logo=github)](https://github.com/Shineii86) "
+        "[![PullShark](https://img.shields.io/badge/PullShark-v{version}-blue?style=flat-square&logo=shark)](https://github.com/Shineii86/PullShark) "
+        "[![Stars](https://img.shields.io/github/stars/Shineii86/PullShark?style=flat-square&logo=github)](https://github.com/Shineii86/PullShark/stargazers)\n\n"
+        "</div>"
+    ).format(version=__version__)
+
+    def _make_commit(self, branch_name: str) -> None:
+        """Append a small change to README.md on the given branch."""
+        try:
+            contents = self.repo.get_contents("README.md", ref=branch_name)
+            new_content = (
+                f"{contents.decoded_content.decode()}\n"
+                f"- 🤖 Auto-update by PullShark: {generate_random_string()}"
+                f"{self._WATERMARK}"
+            )
+            self.repo.update_file(
+                contents.path,
+                f"Automated update in {branch_name}",
+                new_content,
+                contents.sha,
+                branch=branch_name,
+            )
+            print("  📝 Updated README.md")
+            logger.info("Updated README.md on %s", branch_name)
+        except GithubException as e:
+            if e.status != 404:
+                raise
+            self.repo.create_file(
+                "README.md",
+                f"Create README in {branch_name}",
+                f"# {self.config.repo_name}\n\nAuto-generated: {generate_random_string()}{self._WATERMARK}",
+                branch=branch_name,
+            )
+            print("  📄 Created README.md")
+            logger.info("Created README.md on %s", branch_name)
+
+    def _open_pull_request(self, index: int, branch_name: str):
+        """Create a pull request."""
+        try:
+            pr = self.repo.create_pull(
+                title=f"Auto-PR {generate_random_string(4)} #{index}",
+                body=(
+                    "🤖 Automated pull request for the Pull Shark achievement."
+                    f"{self._WATERMARK}"
+                ),
+                head=branch_name,
+                base=self.config.base_branch,
+            )
+            print(f"  🔗 Created PR: {pr.html_url}")
+            logger.info("Created PR #%d: %s", pr.number, pr.html_url)
+            return pr
+        except GithubException as e:
+            print(f"  ❌ Failed to create PR: {e}")
+            logger.error("Failed to create PR: %s", e)
+            return None
+
+    def _print_summary(self, successful: int) -> None:
+        total = self.config.num_prs
+        mode = " (dry run)" if self.config.dry_run else ""
+        print(f"\n🏁 Finished. {successful} out of {total} pull requests {'would be' if self.config.dry_run else ''} merged{mode}.")
+        if not self.config.dry_run:
+            if successful >= 2:
+                print("🦈 Congratulations! You've met the requirements for Pull Shark!")
+            else:
+                print("⚠️  You need at least 2 merged PRs for the achievement.")

pullshark/utils.py

@@ -0,0 +1,132 @@
+"""
+Utility helpers for PullShark.
+"""
+
+from __future__ import annotations
+
+import json
+import logging
+import random
+import string
+import time
+from datetime import datetime, timezone
+
+from github import GithubException
+from github.PullRequest import PullRequest
+
+from pullshark import __version__
+
+logger = logging.getLogger("pullshark")
+
+
+def generate_random_string(length: int = 8) -> str:
+    """Generate a random lowercase string for branch names and commit messages."""
+    return "".join(random.choices(string.ascii_lowercase, k=length))
+
+
+def wait_for_mergeability(pr: PullRequest, max_wait: int = 30) -> bool:
+    """Poll GitHub until the PR is mergeable or timeout is reached.
+
+    Args:
+        pr: The PullRequest object to poll.
+        max_wait: Maximum seconds to wait.
+
+    Returns:
+        True if the PR is mergeable, False on timeout.
+    """
+    waited = 0
+    while waited < max_wait:
+        pr.update()
+        if pr.mergeable is not False:  # True or None (still calculating)
+            return True
+        time.sleep(3)
+        waited += 3
+    return False
+
+
+def merge_with_retry(
+    pr: PullRequest,
+    max_retries: int = 3,
+    delay_seconds: int = 10,
+    merge_method: str = "merge",
+) -> bool:
+    """Attempt to merge a PR with retry logic.
+
+    Args:
+        pr: The PullRequest to merge.
+        max_retries: Number of attempts before giving up.
+        delay_seconds: Wait time between retries.
+        merge_method: One of 'merge', 'squash', 'rebase'.
+
+    Returns:
+        True if merge succeeded, False otherwise.
+    """
+    for attempt in range(1, max_retries + 1):
+        try:
+            pr.merge(merge_method=merge_method)
+            return True
+        except GithubException as e:
+            logger.warning("Merge attempt %d/%d failed: %s", attempt, max_retries, e)
+            if attempt < max_retries:
+                logger.info("Waiting %ds before retry...", delay_seconds)
+                time.sleep(delay_seconds)
+                pr.update()
+    return False
+
+
+def build_run_report(results: list[dict], config) -> dict:
+    """Build a structured JSON report of the run.
+
+    Args:
+        results: List of per-PR result dicts.
+        config: The Config object used for the run.
+
+    Returns:
+        Report dict ready for JSON serialization.
+    """
+    successful = sum(1 for r in results if r.get("merged"))
+    return {
+        "version": __version__,
+        "timestamp": datetime.now(timezone.utc).isoformat(),
+        "config": {
+            "username": config.github_username,
+            "repo": config.repo_name,
+            "base_branch": config.base_branch,
+            "num_prs": config.num_prs,
+            "merge_method": config.merge_method,
+            "branch_prefix": config.branch_prefix,
+            "delay_seconds": config.delay_seconds,
+            "max_retries": config.max_retries,
+        },
+        "summary": {
+            "total": config.num_prs,
+            "successful": successful,
+            "failed": config.num_prs - successful,
+            "pull_shark_tier": _get_tier(successful),
+        },
+        "pull_requests": results,
+    }
+
+
+def _get_tier(count: int) -> str:
+    if count >= 1024:
+        return "Gold"
+    if count >= 128:
+        return "Silver"
+    if count >= 16:
+        return "Bronze"
+    if count >= 2:
+        return "Default"
+    return "None"
+
+
+def save_report(report: dict, filepath: str) -> None:
+    """Save a run report to a JSON file.
+
+    Args:
+        report: The report dict from build_run_report.
+        filepath: Path to write the JSON file.
+    """
+    with open(filepath, "w") as f:
+        json.dump(report, f, indent=2)
+    logger.info("Report saved to %s", filepath)

pullshark-2.4.6.dist-info/METADATA

@@ -0,0 +1,576 @@
+Metadata-Version: 2.4
+Name: pullshark
+Version: 2.4.6
+Summary: Automate pull request creation and merging to unlock GitHub's Pull Shark achievement.
+Author-email: Sʜɪɴᴇɪ Nᴏᴜᴢᴇɴ <ikx7a@hotmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Shineii86/PullShark
+Project-URL: Repository, https://github.com/Shineii86/PullShark
+Project-URL: Issues, https://github.com/Shineii86/PullShark/issues
+Keywords: github,pull-request,automation,achievement,pull-shark
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: PyGithub>=2.1.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: ruff>=0.4.0; extra == "dev"
+Dynamic: license-file
+
+<div align="center">
+
+[![Pull Shark Automator Banner](https://raw.githubusercontent.com/Shineii86/PullShark/refs/heads/main/images/PullShark.png)](https://github.com/Shineii86/PullShark)
+
+[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/Shineii86/PullShark/blob/main/notebooks/PullShark.ipynb)
+[![CI](https://github.com/Shineii86/PullShark/actions/workflows/ci.yml/badge.svg)](https://github.com/Shineii86/PullShark/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/pullshark.svg)](https://pypi.org/project/pullshark/)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+[![GitHub Stars](https://img.shields.io/github/stars/Shineii86/PullShark?style=for-the-badge)](https://github.com/Shineii86/PullShark/stargazers)
+[![GitHub Forks](https://img.shields.io/github/forks/Shineii86/PullShark?style=for-the-badge)](https://github.com/Shineii86/PullShark/fork)
+
+A **fully automated** Python tool that creates and merges multiple pull requests in your GitHub repository — helping you earn the coveted **Pull Shark** achievement. Runs in **Google Colab** or directly from your **terminal**.
+
+</div>
+
+---
+
+> [!WARNING]
+> **This script creates real pull requests on your GitHub account.**
+> - Never share your **Personal Access Token** — treat it like a password.
+> - Use a **dedicated repository** to avoid cluttering important projects.
+> - GitHub may rate‑limit excessive API calls; the built‑in delay helps prevent this.
+
+---
+
+## 📖 Table of Contents
+
+- [What is Pull Shark?](#-what-is-pull-shark)
+- [Features](#-features)
+- [Prerequisites](#-prerequisites)
+- [Project Structure](#-project-structure)
+- [Installation](#-installation)
+- [Usage](#-usage)
+  - [Google Colab](#1️⃣-google-colab)
+  - [Command Line (CLI)](#2️⃣-command-line-cli)
+  - [As a Python Package](#3️⃣-as-a-python-package)
+- [Configuration Options](#-configuration-options)
+- [How It Works](#-how-it-works-technical-overview)
+- [Merge Methods](#-merge-methods)
+- [Testing & Contributing](#-testing--contributing)
+- [Troubleshooting](#-troubleshooting)
+- [Changelog](#-changelog)
+- [License & Disclaimer](#-license--disclaimer)
+
+---
+
+## 🎯 What is Pull Shark?
+
+**Pull Shark** is a GitHub achievement awarded when you have **at least 2 pull requests merged** into any repository. It's one of the most popular achievements and a fun way to show off your open-source contributions.
+
+This script automates the creation and merging of pull requests, so you can unlock the achievement in **under 5 minutes** — from your browser or terminal.
+
+| Base | Bronze | Silver | Gold |
+| :--: | :----: | :----: | :--: |
+| [![Base](https://github.com/Shineii86/PullShark/blob/main/images/pull-shark-default.png)](https://github.com/Shineii86/PullShark) | [![Bronze](https://github.com/Shineii86/PullShark/blob/main/images/pull-shark-bronze.png)](https://github.com/Shineii86/PullShark) | [![Silver](https://github.com/Shineii86/PullShark/blob/main/images/pull-shark-silver.png)](https://github.com/Shineii86/PullShark) | [![Gold](https://github.com/Shineii86/PullShark/blob/main/images/pull-shark-gold.png)](https://github.com/Shineii86/PullShark) |
+
+
+> To earn the "**Pull Shark**" achievement on GitHub, you need to have your pull requests (PRs) merged. The badge has four tiers, each requiring a specific number of merged PRs.
+
+### 🦈 Pull Shark Achievement Tiers
+
+| Tier | Badge Name | Required Merged Pull Requests |
+| :--- | :--- | :--- |
+| 1 | **Default / x1** | **2** merged PRs |
+| 2 | **Bronze / x2** | **16** merged PRs |
+| 3 | **Silver / x3** | **128** merged PRs |
+| 4 | **Gold / x4** | **1024** merged PRs |
+
+> [!IMPORTANT]
+> Only merged PRs count toward this achievement. PRs that are closed without being merged do not contribute to your progress.
+
+---
+
+## ✨ Features
+
+| Feature | Description |
+|:--------|:------------|
+| ☁️ **Google Colab** | One-click notebook with 5-step guided flow — no install needed |
+| 🎨 **Dark Mode** | Colab notebook auto-adapts to light and dark themes |
+| 🖥️ **CLI** | Full terminal interface with `run` and `clean` subcommands |
+| 🔍 **Dry Run** | Preview branches, commits, and PRs without making any changes |
+| 🧹 **Branch Cleanup** | Bulk-delete auto-created branches after a run |
+| 📊 **Rate Limit Check** | View your API quota before starting — prevents mid-run failures |
+| 🔀 **Merge Strategies** | Choose between `merge`, `squash`, or `rebase` methods |
+| 🔄 **Retry Logic** | Automatically retries failed merges with configurable attempts |
+| 📝 **Logging** | `--log file.log` saves timestamped debug output for auditing |
+| 📄 **JSON Reports** | `--output report.json` saves structured run results |
+| 🏷️ **Custom Prefix** | `--prefix mybot` to customize branch names |
+| 📦 **Python Package** | Import into your own scripts for custom workflows |
+| 🐍 **`python -m`** | Run as `python -m pullshark` without installing |
+| ✅ **Validation** | Catches config errors before making any API calls |
+| 🧪 **Tested** | 35+ pytest tests with CI on Python 3.9–3.12 |
+| 📦 **PyPI** | `pip install pullshark` — install from PyPI |
+| 🔧 **Pre-Commit** | Ruff lint/format + pytest hooks for contributors |
+
+---
+
+## 🧰 Prerequisites
+
+Before you begin, make sure you have:
+
+1. **A GitHub account** — obviously 😄  
+2. **A repository** where you have **write access** (you can create a new one just for this).  
+3. **A GitHub Personal Access Token** with `repo` scope.
+
+### 🔐 How to Get a Personal Access Token
+
+<details>
+<summary><b>Classic Token (Recommended for beginners)</b></summary>
+
+1. Go to **Settings** → **Developer settings** → **Personal access tokens** → **Tokens (classic)**.
+2. Click **Generate new token (classic)**.
+3. Give it a name (e.g., `Pull Shark Bot`).
+4. Under **Select scopes**, check **`repo`**.
+5. Click **Generate token** and **copy it immediately**.
+
+</details>
+
+<details>
+<summary><b>Fine-Grained Token (More secure, recommended)</b></summary>
+
+1. Go to **Settings** → **Developer settings** → **Personal access tokens** → **Fine-grained tokens**.
+2. Click **Generate new token**.
+3. Set **Resource owner** to your username.
+4. Under **Repository access**, select **Only select repositories** → pick your target repo.
+5. Under **Permissions** → **Repository permissions**, set:
+   - **Contents**: `Read and write`
+   - **Metadata**: `Read-only`
+   - **Pull requests**: `Read and write`
+6. Click **Generate token** and copy it.
+
+</details>
+
+---
+
+## 📁 Project Structure
+
+```
+PullShark/
+├── pullshark/                  # Python package
+│   ├── __init__.py             # Package init & version
+│   ├── __main__.py             # python -m pullshark support
+│   ├── config.py               # Configuration dataclass with validation
+│   ├── core.py                 # PullSharkBot — main automation logic
+│   ├── utils.py                # Helpers (random strings, mergeability, reports)
+│   └── cli.py                  # Command-line interface (run & clean subcommands)
+├── tests/
+│   └── test_pullshark.py       # pytest test suite (35+ tests)
+├── notebooks/
+│   └── PullShark.ipynb         # Google Colab notebook (5-step guided flow)
+├── .github/
+│   ├── workflows/
+│   │   ├── ci.yml              # CI on push/PR (Python 3.9–3.12)
+│   │   └── publish.yml         # PyPI publish on tag
+│   └── dependabot.yml          # Auto dependency updates
+├── images/                     # Achievement badge images
+├── pyproject.toml              # Python packaging + pytest + ruff config
+├── requirements.txt            # Dependencies
+├── .pre-commit-config.yaml     # Pre-commit hooks (ruff, pytest, linting)
+├── CONTRIBUTING.md             # Contribution guidelines
+├── CHANGELOG.md                # Version history
+├── LICENSE                     # MIT License
+└── README.md                   # This file
+```
+
+---
+
+## 📥 Installation
+
+### From PyPI (Easiest)
+
+```bash
+pip install pullshark
+```
+
+### From Source (Recommended for Contributors)
+
+```bash
+git clone https://github.com/Shineii86/PullShark.git
+cd PullShark
+pip install -e .
+```
+
+This installs the `pullshark` CLI command and makes the package importable.
+
+### With Dev Dependencies (For Contributors)
+
+```bash
+pip install -e ".[dev]"
+pip install pre-commit && pre-commit install
+```
+
+Installs pytest, pytest-cov, ruff, and sets up pre-commit hooks.
+
+### Dependencies Only
+
+```bash
+pip install PyGithub>=2.1.0
+```
+
+---
+
+## 🚀 Usage
+
+### 1️⃣ Google Colab
+
+<a href="https://colab.research.google.com/github/Shineii86/PullShark/blob/main/notebooks/PullShark.ipynb">
+  <img src="https://user-images.githubusercontent.com/125879861/255389999-a0d261cf-893a-46a7-9a3d-2bb52811b997.png" alt="Open In Colab" width="200px">
+</a>
+
+The notebook walks you through **5 steps**:
+
+| Step | Name | What it does |
+|:----:|:-----|:-------------|
+| 1 | 📦 **Install & Load** | Installs PyGithub and loads the package |
+| 2 | 🔌 **Test Connection** | Validates token, repo access, write permissions, API rate limit, and existing branches |
+| 3 | 🔍 **Dry Run** | Preview what the bot will do — no changes made *(auto-fills from Step 2)* |
+| 4 | 🚀 **Run for Real** | Create and merge PRs with full configuration *(auto-fills from Step 3)* |
+| 5 | 🧹 **Cleanup** | Delete all auto-created branches *(auto-fills from Step 4)* |
+
+> 💡 **Tip:** Enter your credentials once in Step 2 — they flow through to Steps 3, 4, and 5 automatically. Run the styling cell first to enable dark/light mode support.
+
+### 2️⃣ Command Line (CLI)
+
+After installing with `pip install -e .`, use the `pullshark` command:
+
+```bash
+# Create and merge PRs
+pullshark run --token ghp_xxx --username YourUsername --repo YourRepo --prs 4
+
+# Preview what would happen (no changes made)
+pullshark run --token ghp_xxx --username YourUsername --repo YourRepo --dry-run
+
+# Check API quota first
+pullshark run --token ghp_xxx --username YourUsername --repo YourRepo --check-rate
+
+# Use squash merge with custom branch prefix
+pullshark run --token ghp_xxx --username YourUsername --repo YourRepo --merge-method squash --prefix mybot
+
+# Save logs and JSON report
+pullshark run --token ghp_xxx --username YourUsername --repo YourRepo --log run.log --output report.json
+
+# Clean up auto-created branches
+pullshark clean --token ghp_xxx --username YourUsername --repo YourRepo
+
+# Preview cleanup without deleting
+pullshark clean --token ghp_xxx --username YourUsername --repo YourRepo --dry-run
+
+# Clean with custom prefix
+pullshark clean --token ghp_xxx --username YourUsername --repo YourRepo --prefix mybot
+
+# Run without installing
+python -m pullshark run --token ghp_xxx --username YourUsername --repo YourRepo
+```
+
+> 💡 The `run` subcommand is optional — `pullshark --token ... --repo ...` still works as a shortcut.
+
+#### CLI Arguments — `run`
+
+| Flag | Short | Required | Default | Description |
+|------|-------|:--------:|---------|-------------|
+| `--token` | `-t` | ✅ | — | GitHub Personal Access Token |
+| `--username` | `-u` | ✅ | — | Your GitHub username |
+| `--repo` | `-r` | ✅ | — | Target repository name |
+| `--prs` | `-n` | | `4` | Number of PRs to create |
+| `--branch` | `-b` | | `main` | Base branch to target |
+| `--delay` | `-d` | | `10` | Delay (seconds) between PRs |
+| `--max-retries` | | | `3` | Max merge retry attempts |
+| `--merge-method` | | | `merge` | Merge strategy: `merge`, `squash`, `rebase` |
+| `--prefix` | | | `auto-pr` | Branch name prefix |
+| `--dry-run` | | | off | Preview mode — no changes made |
+| `--check-rate` | | | off | Show API quota before running |
+| `--log` | | | — | Save detailed logs to a file |
+| `--output` | | | — | Save run report as JSON |
+
+#### CLI Arguments — `clean`
+
+| Flag | Short | Required | Description |
+|------|-------|:--------:|-------------|
+| `--token` | `-t` | ✅ | GitHub Personal Access Token |
+| `--username` | `-u` | ✅ | Your GitHub username |
+| `--repo` | `-r` | ✅ | Target repository name |
+| `--prefix` | | Branch prefix to clean (default: `auto-pr`) |
+| `--dry-run` | | | Show branches that would be deleted without deleting |
+| `--log` | | | Save detailed logs to a file |
+
+#### CLI Output Example
+
+```
+Configuration: user='Shineii86' repo='PullShark'
+Base branch: main
+Will create 4 PR(s) with 10s delay.
+Merge method: squash
+Branch prefix: mybot
+
+--- 📦 PR #1 of 4 ---
+  Latest main commit: a1b2c3d
+  ✅ Created branch: mybot-xyz123-1234567890
+  📝 Updated README.md
+  🔗 Created PR: https://github.com/Shineii86/PullShark/pull/178
+  ⏳ Waiting for GitHub to calculate mergeability...
+  🎉 Merged PR #178
+  ⏸️  Pausing 10s for GitHub to process...
+
+🏁 Finished. 4 out of 4 pull requests merged.
+🦈 Congratulations! You've met the requirements for Pull Shark!
+
+📄 Report saved to report.json
+```
+
+#### JSON Report Format
+
+When using `--output report.json`, the file contains:
+
+```json
+{
+  "version": "2.4.6",
+  "timestamp": "2026-05-09T02:37:00+00:00",
+  "config": {
+    "username": "Shineii86",
+    "repo": "PullShark",
+    "base_branch": "main",
+    "num_prs": 4,
+    "merge_method": "squash",
+    "branch_prefix": "mybot"
+  },
+  "summary": {
+    "total": 4,
+    "successful": 4,
+    "failed": 0,
+    "pull_shark_tier": "Default"
+  },
+  "pull_requests": [
+    {"index": 1, "merged": true, "branch": "mybot-abc123", "pr_number": 178, "pr_url": "..."}
+  ]
+}
+```
+
+### 3️⃣ As a Python Package
+
+Import the bot into your own scripts for custom workflows:
+
+```python
+from pullshark.config import Config
+from pullshark.core import PullSharkBot
+
+config = Config(
+    github_username="YourUsername",
+    github_token="ghp_xxx",
+    repo_name="YourRepo",
+    num_prs=6,
+    delay_seconds=15,
+    merge_method="squash",
+    branch_prefix="mybot",
+    output_file="report.json",  # Save JSON report
+)
+
+bot = PullSharkBot(config)
+merged = bot.run()
+print(f"Merged {merged} PRs")
+
+# Clean up branches when done
+bot.clean()
+
+# Check API quota
+info = bot.check_rate_limit()
+print(f"API: {info['remaining']}/{info['limit']} remaining")
+```
+
+---
+
+## ⚙️ Configuration Options
+
+| Parameter | Default | Description |
+|:----------|:--------|:------------|
+| `num_prs` | `4` | Total number of pull requests to create and merge. Minimum `2` for the badge. |
+| `base_branch` | `"main"` | Target branch for PRs (e.g., `master`, `develop`). |
+| `delay_seconds` | `10` | Wait time (in seconds) between PRs and between merge retries. |
+| `max_retries` | `3` | Number of times to retry a failed merge before stopping. |
+| `merge_method` | `"merge"` | Merge strategy: `"merge"`, `"squash"`, or `"rebase"`. |
+| `branch_prefix` | `"auto-pr"` | Prefix for auto-generated branch names. |
+| `dry_run` | `False` | If `True`, previews actions without making changes. |
+| `log_file` | `""` | Path to save detailed debug logs. |
+| `output_file` | `""` | Path to save JSON run report. |
+
+### Advanced Customization
+
+- **File Modified**: By default, the script updates or creates `README.md`. To change this, edit `_make_commit()` in `pullshark/core.py`.
+- **Repository**: Use any repo you own or have write access to — just update the repo name.
+
+---
+
+## 🔬 How It Works (Technical Overview)
+
+The script performs the following steps for **each** pull request:
+
+1. **Fetch the latest commit SHA** from the specified base branch to ensure we branch from the most up‑to‑date state.  
+2. **Create a new branch** with a unique name (e.g., `auto-pr-abc123-1234567890`).  
+3. **Make a commit** on that branch — either appending a line to `README.md` or creating it if it doesn't exist.  
+4. **Open a pull request** from the new branch to the base branch.  
+5. **Wait for GitHub's mergeability check** (polling the PR status every 3 seconds).  
+6. **Merge the pull request** using the configured merge method.  
+7. **Pause for `DELAY_SECONDS`** to let GitHub fully update the base branch before starting the next iteration.
+
+**Retry Logic**: If a merge fails (e.g., due to a temporary GitHub hiccup), the script will wait `DELAY_SECONDS` and retry up to `MAX_RETRIES` times before giving up.
+
+**Rate Limit Check**: With `--check-rate`, the bot inspects your remaining API quota before starting. Each PR cycle uses ~4 API calls, so the bot estimates whether you have enough.
+
+---
+
+## 🔀 Merge Methods
+
+PullShark supports three merge strategies. Choose based on your preference:
+
+| Method | Flag | What It Does | History |
+|:-------|:-----|:-------------|:--------|
+| **Merge** | `--merge-method merge` | Creates a merge commit joining the branch to base | Preserves all commits |
+| **Squash** | `--merge-method squash` | Combines all branch commits into a single commit | Clean, linear history |
+| **Rebase** | `--merge-method rebase` | Replays branch commits on top of base | Linear, no merge commit |
+
+> 💡 For Pull Shark achievement purposes, all three methods count equally. Use `squash` for cleaner history.
+
+---
+
+## 🧪 Testing & Contributing
+
+### Running Tests
+
+```bash
+# Install dev dependencies
+pip install -e ".[dev]"
+
+# Run all tests
+pytest tests/ -v
+
+# Run with coverage
+pytest tests/ -v --cov=pullshark --cov-report=term-missing
+
+# Lint
+ruff check pullshark/ tests/
+```
+
+### Pre-Commit Hooks
+
+For contributors, pre-commit hooks run automatically before each commit:
+
+```bash
+pip install pre-commit
+pre-commit install
+```
+
+Hooks include:
+- **ruff** — lint and auto-format Python code
+- **trailing-whitespace** — remove trailing spaces
+- **end-of-file-fixer** — ensure files end with newline
+- **check-yaml / check-json** — validate config files
+- **pytest** — run the test suite
+
+### CI Pipeline
+
+Every push and PR triggers the GitHub Actions workflow which:
+- Runs the test suite across Python 3.9, 3.10, 3.11, and 3.12
+- Lints code with ruff
+- Validates notebook JSON structure
+
+### Publishing (Maintainers)
+
+Tag a release to auto-publish to PyPI:
+
+```bash
+git tag v2.4.6
+git push origin v2.4.6
+```
+
+The `publish.yml` workflow builds and publishes automatically via trusted publishing.
+
+### Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, branch naming conventions, and PR guidelines.
+
+---
+
+## 🆘 Troubleshooting
+
+| Issue | Solution |
+|:------|:---------|
+| `BadCredentialsException` | Token is wrong or expired. Generate a new one with `repo` scope. |
+| `405 Not mergeable` | Enable **Allow auto-merge** in repo Settings → General → Pull Requests. |
+| Hangs at "Waiting for mergeability" | PR may have a conflict. Delete the branch manually and retry. |
+| `RateLimitExceededException` | Wait an hour or increase `DELAY_SECONDS`. Use `--check-rate` to check beforehand. |
+| No badge after success | Wait a few minutes and refresh your profile. Achievement updates are not always instant. |
+| Leftover branches | Run `pullshark clean` to delete all auto-created branches. |
+
+---
+
+## 📋 Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for a full history of changes.
+
+---
+
+## 📄 License & Disclaimer
+
+This project is licensed under the **MIT License** – see the [LICENSE](LICENSE) file for details.
+
+> [!WARNING]
+> **This script is intended for educational purposes and to help users unlock a harmless GitHub achievement**. Please use responsibly and do not abuse automation to spam repositories. The author is not responsible for any consequences arising from misuse of this tool.
+
+---
+
+### 🔗 Quick Links
+
+- [PyPI Package](https://pypi.org/project/pullshark/)
+- [Google Colab](https://colab.research.google.com/)
+- [GitHub Personal Access Tokens](https://github.com/settings/tokens)
+- [Fine-Grained Tokens](https://github.com/settings/personal-access-tokens/new)
+- [Pull Shark Achievement Details](https://github.com/Schweinepriester/github-profile-achievements#pull-shark-)
+- [Contributing Guide](CONTRIBUTING.md)
+
+---
+
+## 💕 Loved My Work?
+
+🚨 [Follow me on GitHub](https://github.com/Shineii86)
+
+⭐ [Give a star to this project](https://github.com/Shineii86/PullShark)
+
+<div align="center">
+
+<a href="https://github.com/Shineii86/PullShark">
+<img src="https://github.com/Shineii86/AniPay/blob/main/Source/Banner6.png" alt="Banner">
+</a>
+  
+  *For inquiries or collaborations*
+     
+[![Telegram Badge](https://img.shields.io/badge/-Telegram-2CA5E0?style=flat&logo=Telegram&logoColor=white)](https://telegram.me/Shineii86 "Contact on Telegram")
+[![Instagram Badge](https://img.shields.io/badge/-Instagram-C13584?style=flat&logo=Instagram&logoColor=white)](https://instagram.com/ikx7.a "Follow on Instagram")
+[![Pinterest Badge](https://img.shields.io/badge/-Pinterest-E60023?style=flat&logo=Pinterest&logoColor=white)](https://pinterest.com/ikx7a "Follow on Pinterest")
+[![Gmail Badge](https://img.shields.io/badge/-Gmail-D14836?style=flat&logo=Gmail&logoColor=white)](mailto:ikx7a@hotmail.com "Send an Email")
+
+  <sup><b>Copyright © 2026 <a href="https://telegram.me/Shineii86">Shinei Nouzen</a> All Rights Reserved</b></sup>
+
+![Last Commit](https://img.shields.io/github/last-commit/Shineii86/PullShark?style=for-the-badge)
+
+</div>

pullshark-2.4.6.dist-info/RECORD

@@ -0,0 +1,12 @@
+pullshark/__init__.py,sha256=JXQeEkUcLeUrzm0Mbtg1dS3KvIAws_waU-p7OD1BRqU,281
+pullshark/__main__.py,sha256=xsJtyjvV0ffLzxr9eeJC4p2q--Nsz2wQUhody7x16vQ,117
+pullshark/cli.py,sha256=b89FmJQHB_Q0tGzJ542lFYwkSy-CECSy6tLlMDVYZZY,5966
+pullshark/config.py,sha256=IdKtlBAFi6oBWXZfxx2mH_-QmE4Y5ooYTk0z2mNzvKI,1490
+pullshark/core.py,sha256=yQMiTnEOuKrovQvVPgkbx-yJGwBejtCPgGBQ-tDwPys,11320
+pullshark/utils.py,sha256=_JeHI_lfMD6YFasWYaHn7dhqIfAOgltkx9guNpQ-y8o,3695
+pullshark-2.4.6.dist-info/licenses/LICENSE,sha256=eCBJvwCqBquo4KyGHqgJU0DJx1oLbCu2Qf6paQplLmc,1085
+pullshark-2.4.6.dist-info/METADATA,sha256=4N6Uwv4lYjT4Llv6pemBpqsZ_kX8S-5bUUqs2rsfdww,22624
+pullshark-2.4.6.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+pullshark-2.4.6.dist-info/entry_points.txt,sha256=S3ld0U4igqff8HuBysnCQki8v-Xzz0-efYZtP-iJKSE,49
+pullshark-2.4.6.dist-info/top_level.txt,sha256=whBUtyk3d4NqZVO-Xmk2dpIO0-ORewLXQHwq4C-gL4o,10
+pullshark-2.4.6.dist-info/RECORD,,

pullshark-2.4.6.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

pullshark-2.4.6.dist-info/entry_points.txt

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

pullshark-2.4.6.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sʜɪɴᴇɪ Nᴏᴜᴢᴇɴ
+
+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.

pullshark-2.4.6.dist-info/top_level.txt

@@ -0,0 +1 @@
+pullshark