managebetcodes 1.0.0__tar.gz

managebetcodes-1.0.0/LICENSE

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

managebetcodes-1.0.0/PKG-INFO

@@ -0,0 +1,270 @@
+Metadata-Version: 2.4
+Name: managebetcodes
+Version: 1.0.0
+Summary: Official Python SDK for the Manage Bet Codes public API v1
+Author: Manage Bet Codes
+License: MIT
+Project-URL: Documentation, https://managebetcodes.app/developers/sdk/python
+Project-URL: Source, https://github.com/kayceepeece/Viewbetbot
+Keywords: betting,bet-codes,sportybet,1xbet
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Dynamic: license-file
+
+# Manage Bet Codes Python SDK
+
+The official Python SDK for the Manage Bet Codes public API v1.
+
+- Python 3.9 or later.
+- No runtime dependencies. The SDK uses the Python standard library.
+- Synchronous client.
+
+## Install
+
+```bash
+pip install managebetcodes
+```
+
+## Command line
+
+The package installs an `mbc` command with the same client.
+
+```bash
+export MBC_API_KEY=mbc_live_your_key
+mbc convert 7B9A2F --from sportybet --to 1xng
+mbc view 7B9A2F --bookmaker sportybet
+mbc usage
+```
+
+## Quick start
+
+```python
+from managebetcodes import Client
+
+client = Client("mbc_live_your_key")
+
+result = client.convert("7B9A2F", "sportybet", "1xng")
+print(result["target"]["code"])
+```
+
+The client uses this base URL by default:
+
+```text
+https://api.managebetcodes.app/v1
+```
+
+Change the base URL for a test server:
+
+```python
+client = Client("mbc_live_your_key", base_url="http://127.0.0.1:8000/v1")
+```
+
+## Authentication
+
+Pass the API key to the constructor.
+The SDK sends the key in the `X-API-Key` header.
+Keys start with `mbc_live_`.
+Keep the key on the server.
+Do not put the key in browser code.
+
+## Client options
+
+```python
+Client(
+    api_key,
+    base_url="https://api.managebetcodes.app/v1",
+    timeout=30,
+    max_retries=3,
+)
+```
+
+- `timeout` is the socket timeout in seconds.
+- `max_retries` is the number of extra attempts.
+
+## Methods
+
+| Method | Call | Price |
+|---|---|---|
+| `convert(code, source, target)` | `POST /convert` | 2 credits per target |
+| `convert_to_all(code, source, to=...)` | `POST /convert/all` | 2 credits per target |
+| `convert_bulk(codes, to=...)` | `POST /convert/bulk` | 2 credits per pair |
+| `view(code, bookmaker)` | `GET /view` | 1 credit |
+| `view_image(code, bookmaker)` | `GET /view/image` | 2 credits |
+| `split(code, bookmaker, count=2, ...)` | `POST /split` | 2 credits plus 1 per extra part |
+| `merge(pairs, target=None)` | `POST /merge` | 2 credits plus 1 per extra code |
+| `book(bookmaker, plan_id=..., picks=...)` | `POST /book` | 2 credits per code |
+| `events_search(bookmaker, queries)` | `POST /events/search` | 0 credits |
+| `events(q=...)` | `GET /events` | 0 credits |
+| `event_markets(event_id)` | `GET /events/{id}/markets` | 0 credits |
+| `resolve(bookmaker, picks)` | `POST /resolve` | 0 credits |
+| `markets()` | `GET /markets` | 0 credits |
+| `books(limit=..., offset=...)` | `GET /books` | 0 credits |
+| `capabilities()` | `GET /capabilities` | 0 credits |
+| `usage()` | `GET /usage` | 0 credits |
+| `history(limit=..., offset=...)` | `GET /history` | 0 credits |
+| `jobs_create(payload)` | `POST /jobs` | Job price |
+| `job(job_id)` | `GET /jobs/{id}` | 0 credits |
+| `jobs()` | `GET /jobs` | 0 credits |
+| `cancel_job(job_id)` | `DELETE /jobs/{id}` | 0 credits |
+| `track_start(code, bookmaker)` | `POST /track` | 1 credit |
+| `track(track_id)` | `GET /track/{id}` | 0 credits |
+| `tracks()` | `GET /tracks` | 0 credits |
+| `stop_track(track_id)` | `DELETE /track/{id}` | 0 credits |
+
+The methods return the JSON response as a `dict`.
+`view_image` returns `bytes`.
+
+## Convert
+
+Convert one code to one target:
+
+```python
+client.convert("7B9A2F", "sportybet", "1xng")
+```
+
+Convert one code to a batch:
+
+```python
+client.convert("7B9A2F", "sportybet", ["1xng", "msport", "bet9ja"])
+```
+
+A batch accepts 2 to 6 targets.
+Use a job for more targets.
+
+## Book
+
+Book from a resolve plan:
+
+```python
+client.book("sportybet", plan_id="plan_123")
+```
+
+Book from direct picks:
+
+```python
+client.book(
+    "sportybet",
+    picks=[{"event_id": "sr:match:123", "market_id": "18",
+            "outcome_id": "12", "odds": "1.90"}],
+)
+```
+
+## Jobs
+
+`jobs_create` accepts a job body:
+
+```python
+job = client.jobs_create({
+    "kind": "convert",
+    "code": "7B9A2F",
+    "from": "sportybet",
+    "to": ["1xng", "msport", "bet9ja", "melbet"],
+})
+client.job(job["id"])
+```
+
+## Image
+
+```python
+png = client.view_image("7B9A2F", "sportybet")
+with open("slip.png", "wb") as file:
+    file.write(png)
+```
+
+The method returns the image bytes.
+It raises a typed error when the API returns an error envelope.
+
+## Idempotency
+
+The SDK adds an `Idempotency-Key` header to every POST call.
+Pass your own key when you need a stable value:
+
+```python
+client.convert("7B9A2F", "sportybet", "1xng", idempotency_key="order-123")
+```
+
+The SDK sends the same key on a retry.
+
+## Retries
+
+The SDK retries on these status codes:
+
+- `429`
+- `502`
+- `503`
+- `504`
+
+The SDK reads the `Retry-After` header.
+If the header is absent, the SDK uses exponential backoff.
+
+## Errors
+
+All errors inherit from `APIError`:
+
+| Error | Status | Meaning |
+|---|---|---|
+| `AuthenticationError` | 401, 403 | The key is missing, bad, or not allowed |
+| `QuotaError` | 429 | The plan credits or search cap are finished |
+| `RateLimitError` | 429 | The request rate is too high |
+| `ValidationError` | 400, 422 | A parameter or the body is invalid |
+| `APIError` | Other | Any other API error |
+
+Each error has these attributes:
+
+- `status`
+- `code`
+- `message`
+- `request_id`
+- `docs`
+- `details`
+
+`RateLimitError` also has `retry_after`.
+
+```python
+from managebetcodes import RateLimitError, ValidationError
+
+try:
+    client.convert("BAD", "sportybet", "1xng")
+except ValidationError as error:
+    print(error.code, error.details)
+except RateLimitError as error:
+    print("Retry after", error.retry_after)
+```
+
+## Webhooks
+
+Verify the raw request body before you trust a webhook:
+
+```python
+from managebetcodes import verify_webhook
+
+if not verify_webhook(secret, raw_body, request.headers["X-MBC-Signature"]):
+    return "invalid signature", 400
+```
+
+`raw_body` must be `bytes`.
+Do not parse the body before the check.
+The function returns `True` for a valid signature.
+It returns `False` for a bad signature.
+
+## Pagination
+
+Pass `limit` and `offset` to `history`, `jobs`, `books`, and `events`.
+The response returns `next_offset` when another page exists.
+
+```python
+page = client.history(limit=20, offset=0)
+for item in page["items"]:
+    print(item["id"])
+```
+
+## License
+
+MIT

managebetcodes-1.0.0/README.md

@@ -0,0 +1,250 @@
+# Manage Bet Codes Python SDK
+
+The official Python SDK for the Manage Bet Codes public API v1.
+
+- Python 3.9 or later.
+- No runtime dependencies. The SDK uses the Python standard library.
+- Synchronous client.
+
+## Install
+
+```bash
+pip install managebetcodes
+```
+
+## Command line
+
+The package installs an `mbc` command with the same client.
+
+```bash
+export MBC_API_KEY=mbc_live_your_key
+mbc convert 7B9A2F --from sportybet --to 1xng
+mbc view 7B9A2F --bookmaker sportybet
+mbc usage
+```
+
+## Quick start
+
+```python
+from managebetcodes import Client
+
+client = Client("mbc_live_your_key")
+
+result = client.convert("7B9A2F", "sportybet", "1xng")
+print(result["target"]["code"])
+```
+
+The client uses this base URL by default:
+
+```text
+https://api.managebetcodes.app/v1
+```
+
+Change the base URL for a test server:
+
+```python
+client = Client("mbc_live_your_key", base_url="http://127.0.0.1:8000/v1")
+```
+
+## Authentication
+
+Pass the API key to the constructor.
+The SDK sends the key in the `X-API-Key` header.
+Keys start with `mbc_live_`.
+Keep the key on the server.
+Do not put the key in browser code.
+
+## Client options
+
+```python
+Client(
+    api_key,
+    base_url="https://api.managebetcodes.app/v1",
+    timeout=30,
+    max_retries=3,
+)
+```
+
+- `timeout` is the socket timeout in seconds.
+- `max_retries` is the number of extra attempts.
+
+## Methods
+
+| Method | Call | Price |
+|---|---|---|
+| `convert(code, source, target)` | `POST /convert` | 2 credits per target |
+| `convert_to_all(code, source, to=...)` | `POST /convert/all` | 2 credits per target |
+| `convert_bulk(codes, to=...)` | `POST /convert/bulk` | 2 credits per pair |
+| `view(code, bookmaker)` | `GET /view` | 1 credit |
+| `view_image(code, bookmaker)` | `GET /view/image` | 2 credits |
+| `split(code, bookmaker, count=2, ...)` | `POST /split` | 2 credits plus 1 per extra part |
+| `merge(pairs, target=None)` | `POST /merge` | 2 credits plus 1 per extra code |
+| `book(bookmaker, plan_id=..., picks=...)` | `POST /book` | 2 credits per code |
+| `events_search(bookmaker, queries)` | `POST /events/search` | 0 credits |
+| `events(q=...)` | `GET /events` | 0 credits |
+| `event_markets(event_id)` | `GET /events/{id}/markets` | 0 credits |
+| `resolve(bookmaker, picks)` | `POST /resolve` | 0 credits |
+| `markets()` | `GET /markets` | 0 credits |
+| `books(limit=..., offset=...)` | `GET /books` | 0 credits |
+| `capabilities()` | `GET /capabilities` | 0 credits |
+| `usage()` | `GET /usage` | 0 credits |
+| `history(limit=..., offset=...)` | `GET /history` | 0 credits |
+| `jobs_create(payload)` | `POST /jobs` | Job price |
+| `job(job_id)` | `GET /jobs/{id}` | 0 credits |
+| `jobs()` | `GET /jobs` | 0 credits |
+| `cancel_job(job_id)` | `DELETE /jobs/{id}` | 0 credits |
+| `track_start(code, bookmaker)` | `POST /track` | 1 credit |
+| `track(track_id)` | `GET /track/{id}` | 0 credits |
+| `tracks()` | `GET /tracks` | 0 credits |
+| `stop_track(track_id)` | `DELETE /track/{id}` | 0 credits |
+
+The methods return the JSON response as a `dict`.
+`view_image` returns `bytes`.
+
+## Convert
+
+Convert one code to one target:
+
+```python
+client.convert("7B9A2F", "sportybet", "1xng")
+```
+
+Convert one code to a batch:
+
+```python
+client.convert("7B9A2F", "sportybet", ["1xng", "msport", "bet9ja"])
+```
+
+A batch accepts 2 to 6 targets.
+Use a job for more targets.
+
+## Book
+
+Book from a resolve plan:
+
+```python
+client.book("sportybet", plan_id="plan_123")
+```
+
+Book from direct picks:
+
+```python
+client.book(
+    "sportybet",
+    picks=[{"event_id": "sr:match:123", "market_id": "18",
+            "outcome_id": "12", "odds": "1.90"}],
+)
+```
+
+## Jobs
+
+`jobs_create` accepts a job body:
+
+```python
+job = client.jobs_create({
+    "kind": "convert",
+    "code": "7B9A2F",
+    "from": "sportybet",
+    "to": ["1xng", "msport", "bet9ja", "melbet"],
+})
+client.job(job["id"])
+```
+
+## Image
+
+```python
+png = client.view_image("7B9A2F", "sportybet")
+with open("slip.png", "wb") as file:
+    file.write(png)
+```
+
+The method returns the image bytes.
+It raises a typed error when the API returns an error envelope.
+
+## Idempotency
+
+The SDK adds an `Idempotency-Key` header to every POST call.
+Pass your own key when you need a stable value:
+
+```python
+client.convert("7B9A2F", "sportybet", "1xng", idempotency_key="order-123")
+```
+
+The SDK sends the same key on a retry.
+
+## Retries
+
+The SDK retries on these status codes:
+
+- `429`
+- `502`
+- `503`
+- `504`
+
+The SDK reads the `Retry-After` header.
+If the header is absent, the SDK uses exponential backoff.
+
+## Errors
+
+All errors inherit from `APIError`:
+
+| Error | Status | Meaning |
+|---|---|---|
+| `AuthenticationError` | 401, 403 | The key is missing, bad, or not allowed |
+| `QuotaError` | 429 | The plan credits or search cap are finished |
+| `RateLimitError` | 429 | The request rate is too high |
+| `ValidationError` | 400, 422 | A parameter or the body is invalid |
+| `APIError` | Other | Any other API error |
+
+Each error has these attributes:
+
+- `status`
+- `code`
+- `message`
+- `request_id`
+- `docs`
+- `details`
+
+`RateLimitError` also has `retry_after`.
+
+```python
+from managebetcodes import RateLimitError, ValidationError
+
+try:
+    client.convert("BAD", "sportybet", "1xng")
+except ValidationError as error:
+    print(error.code, error.details)
+except RateLimitError as error:
+    print("Retry after", error.retry_after)
+```
+
+## Webhooks
+
+Verify the raw request body before you trust a webhook:
+
+```python
+from managebetcodes import verify_webhook
+
+if not verify_webhook(secret, raw_body, request.headers["X-MBC-Signature"]):
+    return "invalid signature", 400
+```
+
+`raw_body` must be `bytes`.
+Do not parse the body before the check.
+The function returns `True` for a valid signature.
+It returns `False` for a bad signature.
+
+## Pagination
+
+Pass `limit` and `offset` to `history`, `jobs`, `books`, and `events`.
+The response returns `next_offset` when another page exists.
+
+```python
+page = client.history(limit=20, offset=0)
+for item in page["items"]:
+    print(item["id"])
+```
+
+## License
+
+MIT

managebetcodes-1.0.0/managebetcodes/__init__.py

@@ -0,0 +1,22 @@
+"""Official SDK for the Manage Bet Codes public API v1."""
+
+from .client import Client, __version__
+from .errors import (
+    APIError,
+    AuthenticationError,
+    QuotaError,
+    RateLimitError,
+    ValidationError,
+)
+from .webhooks import verify_webhook
+
+__all__ = [
+    "APIError",
+    "AuthenticationError",
+    "Client",
+    "QuotaError",
+    "RateLimitError",
+    "ValidationError",
+    "verify_webhook",
+    "__version__",
+]

managebetcodes-1.0.0/managebetcodes/cli.py

@@ -0,0 +1,121 @@
+"""The `mbc` command: convert and view codes from a terminal."""
+
+import argparse
+import json
+import os
+import sys
+import urllib.error
+import urllib.request
+from typing import Any, Dict, List, Optional, Sequence
+
+from .client import BASE_URL, Client, __version__
+from .errors import APIError
+
+
+def build_parser() -> argparse.ArgumentParser:
+    """Build the `mbc` argument parser."""
+
+    common = argparse.ArgumentParser(add_help=False)
+    common.add_argument(
+        "--api-key",
+        default=os.environ.get("MBC_API_KEY"),
+        help="API key (or set MBC_API_KEY). Not needed for capabilities.",
+    )
+    common.add_argument(
+        "--base-url",
+        default=os.environ.get("MBC_BASE_URL", BASE_URL),
+        help="API base URL (or set MBC_BASE_URL).",
+    )
+    parser = argparse.ArgumentParser(
+        prog="mbc",
+        description="Manage Bet Codes public API v1",
+        parents=[common],
+    )
+    parser.add_argument(
+        "--version",
+        action="version",
+        version=f"%(prog)s {__version__}",
+    )
+    sub = parser.add_subparsers(dest="command", required=True, metavar="command")
+
+    convert = sub.add_parser(
+        "convert", parents=[common], help="Convert a code to one or more targets."
+    )
+    convert.add_argument("code", help="Source booking code.")
+    convert.add_argument("--from", dest="source", required=True, help="Source bookmaker.")
+    convert.add_argument(
+        "--to",
+        dest="targets",
+        required=True,
+        help="Comma-separated target list, e.g. 1xng or 1xng,msport.",
+    )
+
+    view = sub.add_parser("view", parents=[common], help="View a slip as text.")
+    view.add_argument("code", help="Booking code.")
+    view.add_argument("--bookmaker", required=True, help="Bookmaker of the code.")
+
+    sub.add_parser("capabilities", parents=[common], help="Show the API manifest.")
+    sub.add_parser("usage", parents=[common], help="Show plan, credits, and limits.")
+    return parser
+
+
+def _targets(raw: str) -> List[str]:
+    return [part.strip() for part in raw.split(",") if part.strip()]
+
+
+def _public_capabilities(base_url: str) -> int:
+    """Read the public manifest without an API key."""
+
+    url = base_url.rstrip("/") + "/capabilities"
+    request = urllib.request.Request(url, headers={"Accept": "application/json"})
+    try:
+        with urllib.request.urlopen(request, timeout=30) as response:
+            print(json.dumps(json.loads(response.read().decode("utf-8")), indent=2))
+            return 0
+    except urllib.error.HTTPError as exc:
+        print(f"mbc: HTTP {exc.code} [http_{exc.code}]: the manifest read failed.",
+              file=sys.stderr)
+        return 1
+    except (urllib.error.URLError, TimeoutError) as exc:
+        print(f"mbc: the request to the API failed: {exc}", file=sys.stderr)
+        return 1
+
+
+def _print(payload: Dict[str, Any]) -> int:
+    print(json.dumps(payload, indent=2))
+    return 0
+
+
+def main(argv: Optional[Sequence[str]] = None) -> int:
+    """Run the `mbc` command. Returns the process exit code."""
+
+    args = build_parser().parse_args(argv)
+    if args.command == "capabilities":
+        return _public_capabilities(args.base_url)
+    if not args.api_key:
+        print("mbc: set --api-key or MBC_API_KEY.", file=sys.stderr)
+        return 2
+    client = Client(args.api_key, base_url=args.base_url)
+    try:
+        if args.command == "convert":
+            targets = _targets(args.targets)
+            if not targets:
+                print("mbc: --to needs at least one target.", file=sys.stderr)
+                return 2
+            target = targets[0] if len(targets) == 1 else targets
+            return _print(client.convert(args.code, args.source, target))
+        if args.command == "view":
+            return _print(client.view(args.code, args.bookmaker))
+        if args.command == "capabilities":
+            return _print(client.capabilities())
+        if args.command == "usage":
+            return _print(client.usage())
+    except APIError as error:
+        print(f"mbc: {error}", file=sys.stderr)
+        return 1
+    print(f"mbc: unknown command {args.command}.", file=sys.stderr)
+    return 2
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())