jugs 1.0.0__tar.gz

jugs-1.0.0/.github/workflows/publish.yml

@@ -0,0 +1,40 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/jugs
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: |
+          python -m pip install --upgrade pip
+          pip install build twine
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          user: __token__
+          password: ${{ secrets.pypi }}
+          verbose: true

jugs-1.0.0/PKG-INFO

@@ -0,0 +1,10 @@
+Metadata-Version: 2.5
+Name: jugs
+Version: 1.0.0
+Summary: High-performance Python client for jugs.lol
+Requires-Python: >=3.10
+Requires-Dist: httpx[http2]>=0.27.0
+Requires-Dist: orjson>=3.10.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-asyncio; extra == 'dev'

jugs-1.0.0/README.md

@@ -0,0 +1,178 @@
+# jugs
+
+High-performance Python client for [jugs.lol](https://jugs.lol).
+
+Blazing fast. Minimal overhead. Fully typed. Proxy rotation. Session/auth support.
+
+## Install
+
+```bash
+pip install -e .
+```
+
+Requires Python 3.10+.
+
+Dependencies: `httpx[http2]`, `orjson`.
+
+## Quick Start
+
+```python
+from jugs import JugsClient
+
+with JugsClient("c") as client:
+    print(client.view())
+    print(client.status())
+    print(client.comments())
+    print(client.presence("1274550388594311188"))
+```
+
+## Features
+
+- All public `/api/sys/*` endpoints
+- Discord presence
+- Link click tracking
+- Next.js server actions (tips, drops, crates)
+- Email login / signup via Supabase Auth
+- Discord OAuth URL helper
+- Session load / refresh / logout
+- Proxy rotation (round-robin + random)
+- HTTP/2 + orjson for max speed
+- Zero comments / docstrings in source (clean, dense code)
+- Strict type hints + `slots=True` dataclasses
+- Context manager support
+
+## Proxy Rotation
+
+```python
+proxies = [
+    "http://user:pass@ip1:port",
+    "http://user:pass@ip2:port",
+    "socks5://ip3:port",
+]
+
+client = JugsClient("c", proxies=proxies)
+
+# Auto-rotate on view
+client.view(rotate=True)
+```
+
+## Authentication
+
+```python
+client = JugsClient("c")
+
+# Email
+client.login("you@example.com", "password")
+client.signup("you@example.com", "password")
+
+# Load existing tokens
+client.load_session(access_token="...", refresh_token="...")
+
+# Refresh
+client.refresh_session()
+
+# Discord OAuth (open in browser)
+print(client.discord_oauth_url())
+
+# Logout
+client.logout()
+```
+
+## Full API Surface
+
+### Profile / Social
+
+| Method | Description |
+|--------|-------------|
+| `view(username=None, rotate=False)` | Increment view counter |
+| `status(username=None)` | Bookmarks + likes counts |
+| `likes(username=None)` | Alias of status |
+| `click(url, username=None)` | Track link click |
+| `comments(username=None)` | Fetch comments |
+| `post_comment(content, username=None)` | Post comment (auth) |
+
+### Discord
+
+| Method | Description |
+|--------|-------------|
+| `presence(discord_id)` | Live status, activities, roles |
+
+### Server Actions
+
+| Method | Description |
+|--------|-------------|
+| `tip(payload=None)` | Send credits tip (auth) |
+| `claim_drop(drop_id)` | Claim Discord credit drop |
+| `claim_crate(crate_id)` | Claim crate drop |
+| `get_unseen_drops()` | Unseen credit drops |
+| `get_unseen_crates()` | Unseen crate drops |
+| `mark_drops_seen()` | Mark drops seen |
+| `mark_crates_seen()` | Mark crates seen |
+
+### Feedback
+
+| Method | Description |
+|--------|-------------|
+| `bug_check()` | Check bug report eligibility |
+| `bug_report(...)` | Submit bug report (auth) |
+| `suggest_check()` | Check suggest eligibility |
+| `suggest(text, context="")` | Submit suggestion (auth) |
+
+### Auth
+
+| Method | Description |
+|--------|-------------|
+| `login(email, password)` | Email/password login |
+| `signup(email, password)` | Email signup |
+| `load_session(access, refresh=None)` | Inject tokens |
+| `refresh_session()` | Refresh tokens |
+| `logout()` | Clear session |
+| `discord_oauth_url(redirect=None)` | Get Discord OAuth URL |
+
+## Models
+
+All responses are typed dataclasses (`slots=True`, frozen where possible):
+
+- `ViewResult`
+- `StatusResult`
+- `CommentsResult` / `Comment`
+- `PresenceResult` / `DiscordUser` / `DiscordMember`
+- `ClickResult`
+- `ActionResult`
+
+## Architecture
+
+```
+jugs/
+├── __init__.py
+├── client.py          # JugsClient facade
+├── http.py            # HTTPSession + ProxyRotator
+├── auth.py            # AuthManager (Supabase)
+├── constants.py
+├── exceptions.py
+├── models.py
+└── endpoints/
+    ├── sys.py         # /api/sys/*
+    ├── discord.py
+    └── actions.py     # Next.js server actions
+```
+
+## Performance Notes
+
+- `orjson` for all serialization (significantly faster than stdlib json)
+- `httpx` with HTTP/2
+- `__slots__` everywhere to cut memory + attribute lookup cost
+- Frozen dataclasses for response objects
+- No unnecessary abstractions
+- Connection reuse via persistent session
+- Optional per-request proxy rotation
+
+## Reserved Usernames
+
+These cannot be used as profile handles:
+
+`login`, `signup`, `dashboard`, `api`, `admin`, `owner`, `auth`, `about`, `terms`, `privacy`, `leaderboard`, `directory`, `discord`, `shop`, `addons`, `claim`, `premium`, `crates`, `reset-password`, `account-restricted`, `_next`, `static`
+
+## License
+
+Private. All rights reserved.

jugs-1.0.0/examples/auth.py

@@ -0,0 +1,17 @@
+from jugs import JugsClient
+
+
+def main() -> None:
+    client = JugsClient("c")
+
+    print(client.discord_oauth_url())
+
+    # client.login("email@example.com", "password")
+    # client.signup("email@example.com", "password")
+    # client.load_session("access_token_here", "refresh_token_here")
+
+    client.close()
+
+
+if __name__ == "__main__":
+    main()

jugs-1.0.0/examples/basic.py

@@ -0,0 +1,13 @@
+from jugs import JugsClient
+
+
+def main() -> None:
+    with JugsClient("c") as client:
+        print(client.view())
+        print(client.status())
+        print(client.comments())
+        print(client.presence("1274550388594311188"))
+
+
+if __name__ == "__main__":
+    main()

jugs-1.0.0/examples/multi_account_demo.py

@@ -0,0 +1,241 @@
+#!/usr/bin/env python3
+from __future__ import annotations
+
+import random
+import string
+import sys
+import time
+from dataclasses import dataclass
+from typing import Any
+
+from rich import box
+from rich.console import Console
+from rich.panel import Panel
+from rich.table import Table
+from rich.text import Text
+from rich.align import Align
+from rich.rule import Rule
+from rich.progress import Progress, SpinnerColumn, TextColumn, BarColumn
+
+from jugs import JugsClient
+from jugs.exceptions import AuthError, JugsError
+
+
+console = Console()
+
+
+@dataclass(slots=True)
+class AccountResult:
+    email: str
+    password: str
+    ok: bool
+    user_id: str | None = None
+    username_hint: str | None = None
+    access_token: str | None = None
+    error: str | None = None
+    unseen_drops: Any = None
+    unseen_crates: Any = None
+    session_user: dict[str, Any] | None = None
+
+
+def random_string(length: int = 10) -> str:
+    alphabet = string.ascii_lowercase + string.digits
+    return "".join(random.choices(alphabet, k=length))
+
+
+def generate_account() -> tuple[str, str]:
+    user = random_string(8)
+    domain = random.choice(["gmail.com", "outlook.com", "proton.me", "yahoo.com"])
+    email = f"{user}.{random_string(4)}@{domain}"
+    password = random_string(12) + random.choice("!@#$%") + str(random.randint(10, 99))
+    return email, password
+
+
+def create_account(client: JugsClient, email: str, password: str) -> AccountResult:
+    result = AccountResult(email=email, password=password, ok=False)
+
+    try:
+        data = client.signup(email, password)
+        user = data.get("user") or data
+        result.ok = True
+        result.user_id = user.get("id")
+        result.access_token = data.get("access_token")
+        result.session_user = user if isinstance(user, dict) else data
+
+        try:
+            drops = client.get_unseen_drops()
+            result.unseen_drops = drops.data
+        except Exception:
+            result.unseen_drops = None
+
+        try:
+            crates = client.get_unseen_crates()
+            result.unseen_crates = crates.data
+        except Exception:
+            result.unseen_crates = None
+
+        try:
+            session = client.auth.get_session()
+            if session:
+                result.session_user = session
+        except Exception:
+            pass
+
+    except AuthError as e:
+        result.error = e.message
+    except JugsError as e:
+        result.error = e.message
+    except Exception as e:
+        result.error = str(e)
+
+    return result
+
+
+def render_header() -> None:
+    title = Text()
+    title.append("jugs", style="bold magenta")
+    title.append(" multi-account forge", style="bold white")
+
+    console.print()
+    console.print(Panel(
+        Align.center(title),
+        subtitle="[dim]create · inspect · display[/dim]",
+        border_style="magenta",
+        box=box.DOUBLE,
+    ))
+    console.print()
+
+
+def render_account(idx: int, acc: AccountResult) -> None:
+    status = Text("SUCCESS", style="bold green") if acc.ok else Text("FAILED", style="bold red")
+
+    table = Table(
+        show_header=False,
+        box=box.ROUNDED,
+        border_style="cyan" if acc.ok else "red",
+        padding=(0, 1),
+        expand=True,
+    )
+    table.add_column("key", style="bold dim", width=16)
+    table.add_column("value", overflow="fold")
+
+    table.add_row("status", status)
+    table.add_row("email", f"[bold]{acc.email}[/bold]")
+    table.add_row("password", f"[yellow]{acc.password}[/yellow]")
+
+    if acc.user_id:
+        table.add_row("user id", f"[cyan]{acc.user_id}[/cyan]")
+
+    if acc.access_token:
+        token_preview = acc.access_token[:28] + "…" if len(acc.access_token) > 28 else acc.access_token
+        table.add_row("access token", f"[dim]{token_preview}[/dim]")
+
+    if acc.session_user:
+        email_confirmed = acc.session_user.get("email_confirmed_at")
+        created = acc.session_user.get("created_at", "?")
+        table.add_row("created", str(created))
+        table.add_row("email confirmed", "yes" if email_confirmed else "[yellow]pending[/yellow]")
+
+        meta = acc.session_user.get("user_metadata") or {}
+        if meta:
+            table.add_row("metadata", str(meta))
+
+    if acc.unseen_drops is not None:
+        table.add_row("unseen drops", f"[green]{acc.unseen_drops}[/green]")
+
+    if acc.unseen_crates is not None:
+        table.add_row("unseen crates", f"[green]{acc.unseen_crates}[/green]")
+
+    if acc.error:
+        table.add_row("error", f"[red]{acc.error}[/red]")
+
+    console.print(Panel(
+        table,
+        title=f"[bold]Account {idx}[/bold]",
+        border_style="cyan" if acc.ok else "red",
+        box=box.ROUNDED,
+    ))
+    console.print()
+
+
+def render_summary(results: list[AccountResult]) -> None:
+    ok_count = sum(1 for r in results if r.ok)
+    fail_count = len(results) - ok_count
+
+    summary = Table(box=box.SIMPLE_HEAVY, show_header=True, border_style="magenta")
+    summary.add_column("metric", style="bold")
+    summary.add_column("value", justify="right")
+
+    summary.add_row("total", str(len(results)))
+    summary.add_row("success", f"[green]{ok_count}[/green]")
+    summary.add_row("failed", f"[red]{fail_count}[/red]")
+
+    console.print(Rule("[bold magenta]summary[/bold magenta]"))
+    console.print(summary)
+    console.print()
+
+    if ok_count:
+        creds = Table(title="credentials", box=box.MINIMAL_DOUBLE_HEAD, border_style="green")
+        creds.add_column("#", style="dim")
+        creds.add_column("email", style="bold")
+        creds.add_column("password", style="yellow")
+        creds.add_column("user id", style="cyan")
+
+        for i, r in enumerate(results, 1):
+            if r.ok:
+                creds.add_row(str(i), r.email, r.password, r.user_id or "—")
+
+        console.print(creds)
+        console.print()
+
+
+def main() -> None:
+    count = 3
+    if len(sys.argv) > 1:
+        try:
+            count = max(1, int(sys.argv[1]))
+        except ValueError:
+            pass
+
+    render_header()
+
+    results: list[AccountResult] = []
+
+    with Progress(
+        SpinnerColumn(style="magenta"),
+        TextColumn("[progress.description]{task.description}"),
+        BarColumn(bar_width=24, style="cyan", complete_style="green"),
+        console=console,
+        transient=True,
+    ) as progress:
+        task = progress.add_task("forging accounts…", total=count)
+
+        for i in range(count):
+            email, password = generate_account()
+            progress.update(task, description=f"creating [cyan]{email}[/cyan]")
+
+            with JugsClient("c") as client:
+                result = create_account(client, email, password)
+
+            results.append(result)
+            progress.advance(task)
+            time.sleep(0.4)
+
+    console.print()
+    console.print(Rule("[bold]results[/bold]"))
+    console.print()
+
+    for i, acc in enumerate(results, 1):
+        render_account(i, acc)
+
+    render_summary(results)
+
+    console.print(Panel(
+        Align.center("[dim]done — accounts created via Supabase Auth on jugs.lol[/dim]"),
+        border_style="dim",
+        box=box.SIMPLE,
+    ))
+
+
+if __name__ == "__main__":
+    main()

jugs-1.0.0/examples/proxy.py

@@ -0,0 +1,18 @@
+from jugs import JugsClient
+
+
+PROXIES = [
+    "http://user:pass@ip1:port",
+    "http://user:pass@ip2:port",
+]
+
+
+def main() -> None:
+    with JugsClient("c", proxies=PROXIES) as client:
+        for _ in range(5):
+            result = client.view(rotate=True)
+            print(result)
+
+
+if __name__ == "__main__":
+    main()

jugs-1.0.0/examples/requirements-demo.txt

@@ -0,0 +1,2 @@
+rich>=13.7.0
+jugs @ git+https://github.com/lmaohi7181828/jugs.git

jugs-1.0.0/jugs/__init__.py

@@ -0,0 +1,43 @@
+from __future__ import annotations
+
+from jugs.client import JugsClient
+from jugs.exceptions import (
+    AuthError,
+    JugsError,
+    NotFoundError,
+    ProxyError,
+    RateLimitError,
+    ValidationError,
+)
+from jugs.models import (
+    ActionResult,
+    ClickResult,
+    Comment,
+    CommentsResult,
+    DiscordMember,
+    DiscordUser,
+    PresenceResult,
+    StatusResult,
+    ViewResult,
+)
+
+__all__ = (
+    "JugsClient",
+    "JugsError",
+    "AuthError",
+    "RateLimitError",
+    "NotFoundError",
+    "ValidationError",
+    "ProxyError",
+    "ViewResult",
+    "StatusResult",
+    "Comment",
+    "CommentsResult",
+    "DiscordUser",
+    "DiscordMember",
+    "PresenceResult",
+    "ClickResult",
+    "ActionResult",
+)
+
+__version__ = "1.0.0"