stadar 0.1.5__tar.gz

stadar-0.1.5/PKG-INFO

@@ -0,0 +1,86 @@
+Metadata-Version: 2.4
+Name: stadar
+Version: 0.1.5
+Summary: Official Python SDK for the Stadar esports API (stadar.net)
+Author-email: Stadar <hello@stadar.net>
+License: MIT
+Project-URL: Homepage, https://stadar.net
+Project-URL: Documentation, https://stadar.net/docs/api
+Project-URL: Repository, https://github.com/macgraver/esports-api
+Project-URL: Changelog, https://stadar.net/changelog
+Keywords: esports,api,stadar,lol,cs2,dota,valorant
+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
+Description-Content-Type: text/markdown
+Requires-Dist: urllib3<3.0.0,>=1.25.3
+Requires-Dist: python-dateutil>=2.8.2
+Requires-Dist: pydantic>=2.0
+Requires-Dist: typing-extensions>=4.7.1
+
+# stadar — Python SDK for the Stadar esports API
+
+Official Python client. Pip-installable. Type-hinted. Generated from
+the public OpenAPI 3.1 spec — see
+[stadar.net/docs/api](https://stadar.net/docs/api) for the full
+reference and `clients/README.md` in the
+[monorepo](https://github.com/macgraver/esports-api) for the codegen
+posture.
+
+```bash
+pip install stadar
+```
+
+## Quick start
+
+```python
+from stadar import Client
+
+# Reads $STADAR_API_KEY from env, with $STADAR_API_URL override.
+client = Client.from_env()
+
+# Or pass explicitly:
+client = Client(api_key="esp_live_...", base_url="https://api.stadar.net")
+
+matches = client.matches.list(game="cs2", status="live")
+for m in matches.data:
+    print(m.id, m.team_a.slug, "vs", m.team_b.slug)
+```
+
+## Sandbox
+
+```python
+# `esp_test_`-prefixed keys auto-route to the sandbox fixture set.
+# `meta.sandbox: true` flags every response from the sandbox.
+client = Client(api_key="esp_test_...")
+```
+
+## Webhooks
+
+```python
+from stadar.webhooks import verify_signature
+
+@app.post("/stadar-webhook")
+def handle(request):
+    body = request.body  # raw bytes
+    signature = request.headers["X-Stadar-Signature"]
+    if not verify_signature(body, signature, secret="your-webhook-secret"):
+        return 401
+    event = parse_event(body)
+    # ... handle event
+```
+
+See [stadar.net/docs/webhooks](https://stadar.net/docs/webhooks) for
+the signature verification recipe.
+
+## License
+
+MIT. Source of truth is the OpenAPI spec; regeneration is part of
+every spec change.

stadar-0.1.5/README.md

@@ -0,0 +1,59 @@
+# stadar — Python SDK for the Stadar esports API
+
+Official Python client. Pip-installable. Type-hinted. Generated from
+the public OpenAPI 3.1 spec — see
+[stadar.net/docs/api](https://stadar.net/docs/api) for the full
+reference and `clients/README.md` in the
+[monorepo](https://github.com/macgraver/esports-api) for the codegen
+posture.
+
+```bash
+pip install stadar
+```
+
+## Quick start
+
+```python
+from stadar import Client
+
+# Reads $STADAR_API_KEY from env, with $STADAR_API_URL override.
+client = Client.from_env()
+
+# Or pass explicitly:
+client = Client(api_key="esp_live_...", base_url="https://api.stadar.net")
+
+matches = client.matches.list(game="cs2", status="live")
+for m in matches.data:
+    print(m.id, m.team_a.slug, "vs", m.team_b.slug)
+```
+
+## Sandbox
+
+```python
+# `esp_test_`-prefixed keys auto-route to the sandbox fixture set.
+# `meta.sandbox: true` flags every response from the sandbox.
+client = Client(api_key="esp_test_...")
+```
+
+## Webhooks
+
+```python
+from stadar.webhooks import verify_signature
+
+@app.post("/stadar-webhook")
+def handle(request):
+    body = request.body  # raw bytes
+    signature = request.headers["X-Stadar-Signature"]
+    if not verify_signature(body, signature, secret="your-webhook-secret"):
+        return 401
+    event = parse_event(body)
+    # ... handle event
+```
+
+See [stadar.net/docs/webhooks](https://stadar.net/docs/webhooks) for
+the signature verification recipe.
+
+## License
+
+MIT. Source of truth is the OpenAPI spec; regeneration is part of
+every spec change.

stadar-0.1.5/pyproject.toml

@@ -0,0 +1,49 @@
+# clients/python — packaging manifest for `stadar-python`.
+#
+# Hand-written; protected from openapi-generator regeneration via
+# clients/python/.openapi-generator-ignore.
+#
+# Published to PyPI as `stadar` (`pip install stadar`).
+
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "stadar"
+version = "0.1.5"
+description = "Official Python SDK for the Stadar esports API (stadar.net)"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [
+    { name = "Stadar", email = "hello@stadar.net" }
+]
+keywords = ["esports", "api", "stadar", "lol", "cs2", "dota", "valorant"]
+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 = [
+    "urllib3 >= 1.25.3, < 3.0.0",
+    "python-dateutil >= 2.8.2",
+    "pydantic >= 2.0",
+    "typing-extensions >= 4.7.1"
+]
+
+[project.urls]
+Homepage = "https://stadar.net"
+Documentation = "https://stadar.net/docs/api"
+Repository = "https://github.com/macgraver/esports-api"
+Changelog = "https://stadar.net/changelog"
+
+[tool.setuptools.packages.find]
+include = ["stadar*"]
+exclude = ["test*", "docs*"]

stadar-0.1.5/setup.cfg

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

stadar-0.1.5/stadar/__init__.py

@@ -0,0 +1,177 @@
+# coding: utf-8
+
+# flake8: noqa
+
+"""
+    Stadar Esports Data API
+
+    Read-only, betting-friendly esports data across all major competitive titles. Flat-tier pricing (no per-game gates), Polar- billed subscriptions (Merchant of Record), sandbox keys for evaluation. See https://stadar.net for tier pricing. All endpoints under `/v1/...`. The version in `info.version` matches the URL prefix; non-breaking field additions ship in `/v1`, breaking changes get a `/v2`. We commit to 24 months of `/v1` support after `/v2` ships. Times are UTC end-to-end (RFC 3339). Localization is the client's problem. Cursors are opaque base64 strings; treat them as such. 
+
+    The version of the OpenAPI document: v1
+    Contact: api@stadar.net
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+__version__ = "0.1.0"
+
+# Define package exports
+__all__ = [
+    "AccountApi",
+    "AuthApi",
+    "BillingApi",
+    "GamesApi",
+    "LeaguesApi",
+    "MatchesApi",
+    "MetaApi",
+    "SeriesApi",
+    "TournamentsApi",
+    "WebhooksApi",
+    "ApiResponse",
+    "ApiClient",
+    "Configuration",
+    "OpenApiException",
+    "ApiTypeError",
+    "ApiValueError",
+    "ApiKeyError",
+    "ApiAttributeError",
+    "ApiException",
+    "APIKeySummary",
+    "AccountCreateKey201Response",
+    "AccountCreateKeyRequest",
+    "AccountListKeys200Response",
+    "AccountMeCapabilities200Response",
+    "AccountUsageRecent200Response",
+    "AuthMeResponse",
+    "AuthMeResponseData",
+    "CS2PreviewExtras",
+    "CS2PreviewExtrasMapVetoHistory",
+    "CS2PreviewExtrasMapWinRateValue",
+    "CapabilitySet",
+    "ErrorBody",
+    "ErrorEnvelope",
+    "Game",
+    "GameEnvelope",
+    "GamesListResponse",
+    "HeadToHead",
+    "Healthz200Response",
+    "Last5Result",
+    "League",
+    "LeagueEnvelope",
+    "LeagueSummary",
+    "LeaguesListResponse",
+    "Match",
+    "MatchEnvelope",
+    "MatchParticipant",
+    "MatchPreview",
+    "MatchPreviewEnvelope",
+    "MatchPreviewForm",
+    "MatchPreviewLast5",
+    "MatchesListResponse",
+    "Meta",
+    "Paging",
+    "RootVersion200Response",
+    "Series",
+    "SeriesEnvelope",
+    "SeriesListResponse",
+    "SeriesSummary",
+    "SeriesWinner",
+    "SignupRequest",
+    "SourceCredit",
+    "Stream",
+    "TeamForm",
+    "Tournament",
+    "TournamentEnvelope",
+    "TournamentPrizePool",
+    "TournamentSummary",
+    "TournamentsListResponse",
+    "UsageRow",
+    "UsageToday",
+    "WebhookSubscription",
+    "WebhookSubscriptionRequest",
+    "WebhooksCreate201Response",
+    "WebhooksList200Response",
+]
+
+# import apis into sdk package
+from stadar.api.account_api import AccountApi as AccountApi
+from stadar.api.auth_api import AuthApi as AuthApi
+from stadar.api.billing_api import BillingApi as BillingApi
+from stadar.api.games_api import GamesApi as GamesApi
+from stadar.api.leagues_api import LeaguesApi as LeaguesApi
+from stadar.api.matches_api import MatchesApi as MatchesApi
+from stadar.api.meta_api import MetaApi as MetaApi
+from stadar.api.series_api import SeriesApi as SeriesApi
+from stadar.api.tournaments_api import TournamentsApi as TournamentsApi
+from stadar.api.webhooks_api import WebhooksApi as WebhooksApi
+
+# import ApiClient
+from stadar.api_response import ApiResponse as ApiResponse
+from stadar.api_client import ApiClient as ApiClient
+from stadar.configuration import Configuration as Configuration
+from stadar.exceptions import OpenApiException as OpenApiException
+from stadar.exceptions import ApiTypeError as ApiTypeError
+from stadar.exceptions import ApiValueError as ApiValueError
+from stadar.exceptions import ApiKeyError as ApiKeyError
+from stadar.exceptions import ApiAttributeError as ApiAttributeError
+from stadar.exceptions import ApiException as ApiException
+
+# import models into sdk package
+from stadar.models.api_key_summary import APIKeySummary as APIKeySummary
+from stadar.models.account_create_key201_response import AccountCreateKey201Response as AccountCreateKey201Response
+from stadar.models.account_create_key_request import AccountCreateKeyRequest as AccountCreateKeyRequest
+from stadar.models.account_list_keys200_response import AccountListKeys200Response as AccountListKeys200Response
+from stadar.models.account_me_capabilities200_response import AccountMeCapabilities200Response as AccountMeCapabilities200Response
+from stadar.models.account_usage_recent200_response import AccountUsageRecent200Response as AccountUsageRecent200Response
+from stadar.models.auth_me_response import AuthMeResponse as AuthMeResponse
+from stadar.models.auth_me_response_data import AuthMeResponseData as AuthMeResponseData
+from stadar.models.cs2_preview_extras import CS2PreviewExtras as CS2PreviewExtras
+from stadar.models.cs2_preview_extras_map_veto_history import CS2PreviewExtrasMapVetoHistory as CS2PreviewExtrasMapVetoHistory
+from stadar.models.cs2_preview_extras_map_win_rate_value import CS2PreviewExtrasMapWinRateValue as CS2PreviewExtrasMapWinRateValue
+from stadar.models.capability_set import CapabilitySet as CapabilitySet
+from stadar.models.error_body import ErrorBody as ErrorBody
+from stadar.models.error_envelope import ErrorEnvelope as ErrorEnvelope
+from stadar.models.game import Game as Game
+from stadar.models.game_envelope import GameEnvelope as GameEnvelope
+from stadar.models.games_list_response import GamesListResponse as GamesListResponse
+from stadar.models.head_to_head import HeadToHead as HeadToHead
+from stadar.models.healthz200_response import Healthz200Response as Healthz200Response
+from stadar.models.last5_result import Last5Result as Last5Result
+from stadar.models.league import League as League
+from stadar.models.league_envelope import LeagueEnvelope as LeagueEnvelope
+from stadar.models.league_summary import LeagueSummary as LeagueSummary
+from stadar.models.leagues_list_response import LeaguesListResponse as LeaguesListResponse
+from stadar.models.match import Match as Match
+from stadar.models.match_envelope import MatchEnvelope as MatchEnvelope
+from stadar.models.match_participant import MatchParticipant as MatchParticipant
+from stadar.models.match_preview import MatchPreview as MatchPreview
+from stadar.models.match_preview_envelope import MatchPreviewEnvelope as MatchPreviewEnvelope
+from stadar.models.match_preview_form import MatchPreviewForm as MatchPreviewForm
+from stadar.models.match_preview_last5 import MatchPreviewLast5 as MatchPreviewLast5
+from stadar.models.matches_list_response import MatchesListResponse as MatchesListResponse
+from stadar.models.meta import Meta as Meta
+from stadar.models.paging import Paging as Paging
+from stadar.models.root_version200_response import RootVersion200Response as RootVersion200Response
+from stadar.models.series import Series as Series
+from stadar.models.series_envelope import SeriesEnvelope as SeriesEnvelope
+from stadar.models.series_list_response import SeriesListResponse as SeriesListResponse
+from stadar.models.series_summary import SeriesSummary as SeriesSummary
+from stadar.models.series_winner import SeriesWinner as SeriesWinner
+from stadar.models.signup_request import SignupRequest as SignupRequest
+from stadar.models.source_credit import SourceCredit as SourceCredit
+from stadar.models.stream import Stream as Stream
+from stadar.models.team_form import TeamForm as TeamForm
+from stadar.models.tournament import Tournament as Tournament
+from stadar.models.tournament_envelope import TournamentEnvelope as TournamentEnvelope
+from stadar.models.tournament_prize_pool import TournamentPrizePool as TournamentPrizePool
+from stadar.models.tournament_summary import TournamentSummary as TournamentSummary
+from stadar.models.tournaments_list_response import TournamentsListResponse as TournamentsListResponse
+from stadar.models.usage_row import UsageRow as UsageRow
+from stadar.models.usage_today import UsageToday as UsageToday
+from stadar.models.webhook_subscription import WebhookSubscription as WebhookSubscription
+from stadar.models.webhook_subscription_request import WebhookSubscriptionRequest as WebhookSubscriptionRequest
+from stadar.models.webhooks_create201_response import WebhooksCreate201Response as WebhooksCreate201Response
+from stadar.models.webhooks_list200_response import WebhooksList200Response as WebhooksList200Response
+

stadar-0.1.5/stadar/api/__init__.py

@@ -0,0 +1,14 @@
+# flake8: noqa
+
+# import apis into api package
+from stadar.api.account_api import AccountApi
+from stadar.api.auth_api import AuthApi
+from stadar.api.billing_api import BillingApi
+from stadar.api.games_api import GamesApi
+from stadar.api.leagues_api import LeaguesApi
+from stadar.api.matches_api import MatchesApi
+from stadar.api.meta_api import MetaApi
+from stadar.api.series_api import SeriesApi
+from stadar.api.tournaments_api import TournamentsApi
+from stadar.api.webhooks_api import WebhooksApi
+