dipx 0.1.0__tar.gz

dipx-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 aue.a
+
+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.

dipx-0.1.0/PKG-INFO

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: dipx
+Version: 0.1.0
+Summary: Python client library for dip-x.store marketplace
+Project-URL: Homepage, https://github.com/FreezeRust/dipx
+Project-URL: Issues, https://github.com/FreezeRust/dipx/issues
+Author-email: "aue.a" <aue.a@internet.ru>
+License: MIT
+License-File: LICENSE
+Keywords: api,dip-x,dipx,marketplace
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+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.9
+Requires-Dist: beautifulsoup4>=4.11
+Requires-Dist: requests>=2.28
+Description-Content-Type: text/markdown
+
+# dipx
+
+Python client for the [dip-x.store](https://dip-x.store) marketplace.
+
+```bash
+pip install dipx
+```
+
+```python
+from dipx import DipXClient
+
+client = DipXClient()
+profile = client.login("Lincoln", "your_password")
+
+print(profile.username)  # Lincoln
+print(profile.id)        # 10434
+
+bal = client.get_balance()
+print(f"Total: {bal.total} ₽ (available {bal.available} ₽, frozen {bal.frozen} ₽)")
+
+for p in client.get_my_products():
+    print(f"[{p.id}] {p.title} — {p.price} ₽  ({p.status})")
+
+client.logout()
+```
+
+See [the full method reference](#api-overview) below.
+
+## Features
+
+- 🔐 login / logout / profile / change password
+- 💰 balance, transactions, deposit (lolz, platega, anypay, cryptobot, ...)
+- 📦 products: list / create / update / delete / hide / show / bulk-ops
+- 🚀 bump: free / paid + plugin-based auto-bump
+- 🛒 orders: list, refund, complaint
+- 💬 chat: list conversations, get/send/load older messages, media, pin, delete
+- 🚫 block / mute users + blocklist
+- ❤️ wishlist: check / toggle / add / remove
+- ⭐ reviews: leave / reply / list
+- 🔔 notifications: get / update settings
+- 🔗 integrations: Telegram / VK link & unlink
+- 📊 stats: heatmap, today's earnings, dashboard
+
+## Exception types
+
+```python
+from dipx import (
+    AuthError,
+    NotFoundError,
+    ValidationError,
+    InsufficientBalanceError,
+    RateLimitError,
+    DipXError,
+)
+```
+
+All exceptions carry a `status_code` (HTTP) and optional `payload` (parsed JSON
+body).
+
+## API overview
+
+| Group           | Methods                                                                                                                                         |
+|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------------|
+| Auth            | `login`, `logout`, `me`                                                                                                                         |
+| Profile         | `get_profile`, `update_profile`, `change_password`                                                                                              |
+| Balance         | `get_balance`, `get_transactions`, `create_deposit`, `request_withdrawal`                                                                       |
+| Products        | `get_my_products`, `get_product`, `create_product`, `update_product`, `delete_product`, `hide_product`, `show_product`, `toggle_product_visibility`, `bulk_hide_products`, `bulk_show_products` |
+| Bump            | `get_bump_info`, `bump_product`, `bump_all_free`, `setup_auto_bump`, `cancel_auto_bump`, `resume_auto_bump`, `buy_auto_bump_plugin`             |
+| Orders          | `get_orders`, `get_order`, `request_refund`, `confirm_order`, `cancel_order`, `dispute_order`, `file_complaint`                                 |
+| Chat            | `get_conversations`, `get_unread_count`, `get_messages`, `get_older_messages`, `send_message`, `get_media`, `pin_conversation`, `delete_conversation` |
+| Block / Mute    | `block_user`, `mute_user`, `get_blocked_users`                                                                                                  |
+| Wishlist        | `check_wishlist`, `toggle_wishlist`, `add_to_wishlist`, `remove_from_wishlist`                                                                  |
+| Reviews         | `leave_review`, `reply_to_review`, `delete_review_reply`, `get_user_reviews`                                                                    |
+| Notifications   | `get_notification_settings`, `update_notification_settings`                                                                                     |
+| Integrations    | `link_telegram`, `unlink_telegram`, `unlink_vk`                                                                                                 |
+| Stats           | `get_activity_heatmap`, `get_today_earnings`, `get_stats`                                                                                       |
+
+## License
+
+MIT

dipx-0.1.0/README.md

@@ -0,0 +1,80 @@
+# dipx
+
+Python client for the [dip-x.store](https://dip-x.store) marketplace.
+
+```bash
+pip install dipx
+```
+
+```python
+from dipx import DipXClient
+
+client = DipXClient()
+profile = client.login("Lincoln", "your_password")
+
+print(profile.username)  # Lincoln
+print(profile.id)        # 10434
+
+bal = client.get_balance()
+print(f"Total: {bal.total} ₽ (available {bal.available} ₽, frozen {bal.frozen} ₽)")
+
+for p in client.get_my_products():
+    print(f"[{p.id}] {p.title} — {p.price} ₽  ({p.status})")
+
+client.logout()
+```
+
+See [the full method reference](#api-overview) below.
+
+## Features
+
+- 🔐 login / logout / profile / change password
+- 💰 balance, transactions, deposit (lolz, platega, anypay, cryptobot, ...)
+- 📦 products: list / create / update / delete / hide / show / bulk-ops
+- 🚀 bump: free / paid + plugin-based auto-bump
+- 🛒 orders: list, refund, complaint
+- 💬 chat: list conversations, get/send/load older messages, media, pin, delete
+- 🚫 block / mute users + blocklist
+- ❤️ wishlist: check / toggle / add / remove
+- ⭐ reviews: leave / reply / list
+- 🔔 notifications: get / update settings
+- 🔗 integrations: Telegram / VK link & unlink
+- 📊 stats: heatmap, today's earnings, dashboard
+
+## Exception types
+
+```python
+from dipx import (
+    AuthError,
+    NotFoundError,
+    ValidationError,
+    InsufficientBalanceError,
+    RateLimitError,
+    DipXError,
+)
+```
+
+All exceptions carry a `status_code` (HTTP) and optional `payload` (parsed JSON
+body).
+
+## API overview
+
+| Group           | Methods                                                                                                                                         |
+|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------------|
+| Auth            | `login`, `logout`, `me`                                                                                                                         |
+| Profile         | `get_profile`, `update_profile`, `change_password`                                                                                              |
+| Balance         | `get_balance`, `get_transactions`, `create_deposit`, `request_withdrawal`                                                                       |
+| Products        | `get_my_products`, `get_product`, `create_product`, `update_product`, `delete_product`, `hide_product`, `show_product`, `toggle_product_visibility`, `bulk_hide_products`, `bulk_show_products` |
+| Bump            | `get_bump_info`, `bump_product`, `bump_all_free`, `setup_auto_bump`, `cancel_auto_bump`, `resume_auto_bump`, `buy_auto_bump_plugin`             |
+| Orders          | `get_orders`, `get_order`, `request_refund`, `confirm_order`, `cancel_order`, `dispute_order`, `file_complaint`                                 |
+| Chat            | `get_conversations`, `get_unread_count`, `get_messages`, `get_older_messages`, `send_message`, `get_media`, `pin_conversation`, `delete_conversation` |
+| Block / Mute    | `block_user`, `mute_user`, `get_blocked_users`                                                                                                  |
+| Wishlist        | `check_wishlist`, `toggle_wishlist`, `add_to_wishlist`, `remove_from_wishlist`                                                                  |
+| Reviews         | `leave_review`, `reply_to_review`, `delete_review_reply`, `get_user_reviews`                                                                    |
+| Notifications   | `get_notification_settings`, `update_notification_settings`                                                                                     |
+| Integrations    | `link_telegram`, `unlink_telegram`, `unlink_vk`                                                                                                 |
+| Stats           | `get_activity_heatmap`, `get_today_earnings`, `get_stats`                                                                                       |
+
+## License
+
+MIT

dipx-0.1.0/pyproject.toml

@@ -0,0 +1,44 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "dipx"
+version = "0.1.0"
+description = "Python client library for dip-x.store marketplace"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [
+    { name = "aue.a", email = "aue.a@internet.ru" },
+]
+keywords = ["dipx", "dip-x", "marketplace", "api"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "requests>=2.28",
+    "beautifulsoup4>=4.11",
+]
+
+[project.urls]
+Homepage = "https://github.com/FreezeRust/dipx"
+Issues = "https://github.com/FreezeRust/dipx/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/dipx"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "src/dipx",
+    "README.md",
+    "LICENSE",
+]

dipx-0.1.0/src/dipx/__init__.py

@@ -0,0 +1,61 @@
+"""Python client for the dip-x.store marketplace.
+
+Quick start::
+
+    from dipx import DipXClient
+
+    client = DipXClient()
+    profile = client.login("Lincoln", "password")
+    print(profile.username, profile.id)
+
+    for p in client.get_my_products():
+        print(p.id, p.title, p.price, p.status)
+
+    client.logout()
+"""
+
+from .client import DipXClient
+from .exceptions import (
+    AuthError,
+    DipXError,
+    InsufficientBalanceError,
+    NotFoundError,
+    RateLimitError,
+    ValidationError,
+)
+from .models import (
+    Balance,
+    BumpInfo,
+    Conversation,
+    Message,
+    NotificationSettings,
+    Order,
+    Product,
+    Profile,
+    Review,
+    Transaction,
+    WishlistResult,
+)
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "DipXClient",
+    "AuthError",
+    "DipXError",
+    "InsufficientBalanceError",
+    "NotFoundError",
+    "RateLimitError",
+    "ValidationError",
+    "Balance",
+    "BumpInfo",
+    "Conversation",
+    "Message",
+    "NotificationSettings",
+    "Order",
+    "Product",
+    "Profile",
+    "Review",
+    "Transaction",
+    "WishlistResult",
+]

dipx-0.1.0/src/dipx/_http.py

@@ -0,0 +1,177 @@
+"""Internal HTTP helper: holds a :class:`requests.Session`, manages CSRF.
+
+The marketplace authenticates with cookies (PHPSESSID) and rejects most
+JSON endpoints that don't have an ``X-Requested-With: XMLHttpRequest``
+header and a same-origin ``Referer``. CSRF tokens are required by all
+state-mutating endpoints and refreshed on every full HTML page load.
+"""
+
+from __future__ import annotations
+
+import re
+from typing import Any, Dict, Optional
+
+import requests
+
+from .exceptions import (
+    AuthError,
+    DipXError,
+    InsufficientBalanceError,
+    NotFoundError,
+    RateLimitError,
+    ValidationError,
+)
+
+BASE_URL = "https://dip-x.store"
+
+_CSRF_RE = re.compile(
+    r'name="csrf_token"\s+value="([0-9a-f]{32,128})"', re.IGNORECASE
+)
+
+
+class _Http:
+    def __init__(
+        self,
+        *,
+        base_url: str = BASE_URL,
+        timeout: float = 30.0,
+        user_agent: Optional[str] = None,
+    ) -> None:
+        self.base_url = base_url.rstrip("/")
+        self.timeout = timeout
+        self.csrf_token: Optional[str] = None
+        self.session = requests.Session()
+        self.session.headers.update(
+            {
+                "User-Agent": user_agent
+                or (
+                    "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 "
+                    "(KHTML, like Gecko) Chrome/130.0 Safari/537.36"
+                ),
+                "Accept-Language": "ru,en;q=0.9",
+            }
+        )
+
+    # ── url helpers ──────────────────────────────────────────────
+    def url(self, path: str) -> str:
+        if path.startswith(("http://", "https://")):
+            return path
+        if not path.startswith("/"):
+            path = "/" + path
+        return self.base_url + path
+
+    # ── csrf ────────────────────────────────────────────────────
+    def refresh_csrf(self, html: str) -> Optional[str]:
+        m = _CSRF_RE.search(html)
+        if m:
+            self.csrf_token = m.group(1)
+        return self.csrf_token
+
+    def ensure_csrf(self, page_path: str = "/profile") -> str:
+        """Make sure we have a CSRF token; load ``page_path`` if needed."""
+        if self.csrf_token:
+            return self.csrf_token
+        resp = self.session.get(self.url(page_path), timeout=self.timeout)
+        self.refresh_csrf(resp.text)
+        if not self.csrf_token:
+            raise AuthError(
+                "Не удалось получить csrf_token (вы авторизованы?)",
+                status_code=resp.status_code,
+            )
+        return self.csrf_token
+
+    # ── core request ────────────────────────────────────────────
+    def request(
+        self,
+        method: str,
+        path: str,
+        *,
+        json: Any = None,
+        data: Any = None,
+        files: Any = None,
+        params: Any = None,
+        headers: Optional[Dict[str, str]] = None,
+        referer: Optional[str] = None,
+        allow_redirects: bool = True,
+        as_json: bool = True,
+        raise_status: bool = True,
+    ) -> Any:
+        url = self.url(path)
+        hdrs: Dict[str, str] = {}
+        if as_json:
+            hdrs["X-Requested-With"] = "XMLHttpRequest"
+            hdrs["Accept"] = "application/json, text/plain, */*"
+        if referer:
+            hdrs["Referer"] = self.url(referer)
+        if headers:
+            hdrs.update(headers)
+
+        resp = self.session.request(
+            method,
+            url,
+            json=json,
+            data=data,
+            files=files,
+            params=params,
+            headers=hdrs,
+            timeout=self.timeout,
+            allow_redirects=allow_redirects,
+        )
+
+        if raise_status:
+            _raise_for_status(resp)
+
+        if as_json:
+            ct = resp.headers.get("Content-Type", "")
+            if "application/json" in ct:
+                try:
+                    return resp.json()
+                except Exception:
+                    pass
+        return resp
+
+    def get_json(self, path: str, **kw) -> Any:
+        return self.request("GET", path, **kw)
+
+    def post_json(self, path: str, **kw) -> Any:
+        return self.request("POST", path, **kw)
+
+    def get_html(self, path: str, **kw) -> str:
+        kw.setdefault("as_json", False)
+        resp = self.request("GET", path, **kw)
+        text = resp.text
+        self.refresh_csrf(text)
+        return text
+
+
+# ── helpers ─────────────────────────────────────────────────────
+def _payload(resp: requests.Response) -> Any:
+    ct = resp.headers.get("Content-Type", "")
+    if "application/json" in ct:
+        try:
+            return resp.json()
+        except Exception:
+            return None
+    return None
+
+
+def _raise_for_status(resp: requests.Response) -> None:
+    code = resp.status_code
+    if code < 400:
+        return
+    body = _payload(resp)
+    msg: Any = None
+    if isinstance(body, dict):
+        msg = body.get("error") or body.get("message") or body.get("detail")
+    msg = msg or resp.reason or "HTTP error"
+    if code in (401, 403):
+        raise AuthError(msg, status_code=code, payload=body)
+    if code == 404:
+        raise NotFoundError(msg, status_code=code, payload=body)
+    if code == 429:
+        raise RateLimitError(msg, status_code=code, payload=body)
+    if code == 402:
+        raise InsufficientBalanceError(msg, status_code=code, payload=body)
+    if code in (400, 422):
+        raise ValidationError(msg, status_code=code, payload=body)
+    raise DipXError(msg, status_code=code, payload=body)

dipx-0.1.0/src/dipx/_parse.py

@@ -0,0 +1,157 @@
+"""HTML scraping helpers — used wherever the site does not return JSON.
+
+The marketplace renders many lists (products, orders, conversations) as
+server-side HTML. We parse them with BeautifulSoup. Keep selectors as
+small and tolerant as possible — the site changes its markup.
+"""
+
+from __future__ import annotations
+
+import re
+from typing import List, Optional
+
+from bs4 import BeautifulSoup
+
+from .models import Balance, Order, Product, Profile
+
+
+_NUMBER_RE = re.compile(r"-?\d+(?:[.,]\d+)?")
+
+
+def _to_float(text: Optional[str]) -> float:
+    if not text:
+        return 0.0
+    m = _NUMBER_RE.search(text.replace("\u00a0", "").replace(" ", ""))
+    return float(m.group(0).replace(",", ".")) if m else 0.0
+
+
+def _to_int(text: Optional[str]) -> int:
+    if not text:
+        return 0
+    m = _NUMBER_RE.search(text.replace("\u00a0", "").replace(" ", ""))
+    return int(float(m.group(0).replace(",", "."))) if m else 0
+
+
+def parse_profile_id_from_html(html: str) -> Optional[int]:
+    """Extract user ID from various places it may be embedded."""
+    for pat in (
+        r'data-user-id="(\d+)"',
+        r'"user_id":(\d+)',
+        r'"id":(\d+),"username"',
+        r'/user/[^"]+"[^>]*data-id="(\d+)"',
+    ):
+        m = re.search(pat, html)
+        if m:
+            return int(m.group(1))
+    return None
+
+
+def parse_profile(html: str, *, username: str) -> Profile:
+    soup = BeautifulSoup(html, "html.parser")
+    uid = parse_profile_id_from_html(html) or 0
+    avatar = None
+    img = soup.select_one(".profile-card__avatar img, .user-card__avatar img")
+    if img and img.get("src"):
+        avatar = img["src"]
+    return Profile(id=uid, username=username, avatar=avatar)
+
+
+def parse_balance(html: str) -> Balance:
+    """Parse ``/profile/balance`` page into a :class:`Balance`."""
+    soup = BeautifulSoup(html, "html.parser")
+    total = 0.0
+    available = 0.0
+    frozen = 0.0
+    bv = soup.select_one("#balanceValue, .profile-balance__value")
+    if bv:
+        total = _to_float(bv.get_text())
+    # Some pages expose frozen/available in chips:
+    for chip in soup.select(".balance-chip, .profile-balance__chip, .balance-block"):
+        txt = chip.get_text(" ", strip=True).lower()
+        if "доступ" in txt:
+            available = _to_float(txt) or available
+        elif "заморож" in txt or "холд" in txt:
+            frozen = _to_float(txt) or frozen
+    # Withdrawal form gives a hard upper bound on available
+    inp = soup.select_one('form#withdrawalForm input[name="amount"]')
+    if inp and inp.get("max"):
+        try:
+            available = max(available, float(inp["max"]))
+        except ValueError:
+            pass
+    if available == 0.0 and frozen == 0.0:
+        available = total
+    return Balance(total=total, available=available, frozen=frozen)
+
+
+def parse_products(html: str) -> List[Product]:
+    soup = BeautifulSoup(html, "html.parser")
+    out: List[Product] = []
+    for row in soup.select(".product-row"):
+        pid = row.get("data-id") or row.get("data-product-id") or "0"
+        status = row.get("data-status") or "active"
+        title_el = row.select_one(".product-row__title")
+        price_el = row.select_one(".product-row__price")
+        views_el = row.select_one(".product-row__views")
+        sales_el = row.select_one(".product-row__sales")
+        date_el = row.select_one(".product-row__date")
+        link_el = row.select_one(".product-row__main, a[href*='/product/']")
+        img_el = row.select_one(".product-row__image img")
+        out.append(
+            Product(
+                id=int(pid) if str(pid).isdigit() else 0,
+                title=title_el.get_text(strip=True) if title_el else "",
+                price=_to_float(price_el.get_text() if price_el else ""),
+                status=status,
+                views=_to_int(views_el.get_text() if views_el else ""),
+                sales=_to_int(sales_el.get_text() if sales_el else ""),
+                url=link_el.get("href") if link_el else None,
+                image=img_el.get("src") if img_el else None,
+                created_at=date_el.get_text(strip=True) if date_el else None,
+            )
+        )
+    return out
+
+
+def parse_orders(html: str, *, role: str) -> List[Order]:
+    soup = BeautifulSoup(html, "html.parser")
+    out: List[Order] = []
+    for row in soup.select(".order-row"):
+        link = row.select_one("a[href*='/order/']")
+        oid = 0
+        if link and link.get("href"):
+            m = re.search(r"/order/(\d+)", link["href"])
+            if m:
+                oid = int(m.group(1))
+        title_el = row.select_one(".order-row__title")
+        price_el = row.select_one(".order-row__price")
+        date_el = row.select_one(".order-row__date")
+        user_el = row.select_one(".order-row__user")
+        badge_el = row.select_one(".badge, .order-row__status")
+        status = "unknown"
+        if badge_el:
+            txt = badge_el.get_text(strip=True).lower()
+            if "заверш" in txt or "выпол" in txt:
+                status = "completed"
+            elif "ожид" in txt or "пенд" in txt:
+                status = "pending"
+            elif "отмен" in txt:
+                status = "cancelled"
+            elif "возвр" in txt or "refund" in txt:
+                status = "refunded"
+            elif "спор" in txt or "dispute" in txt:
+                status = "disputed"
+            else:
+                status = txt
+        out.append(
+            Order(
+                id=oid,
+                product_title=title_el.get_text(strip=True) if title_el else "",
+                amount=_to_float(price_el.get_text() if price_el else ""),
+                status=status,
+                role=role,
+                partner=user_el.get_text(strip=True) if user_el else "",
+                date=date_el.get_text(strip=True) if date_el else None,
+            )
+        )
+    return out