cosplay2py 0.3.0__tar.gz

cosplay2py-0.3.0/LICENSE

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

cosplay2py-0.3.0/PKG-INFO

@@ -0,0 +1,199 @@
+Metadata-Version: 2.4
+Name: cosplay2py
+Version: 0.3.0
+Summary: Unofficial typed sync and async client for the Cosplay2.ru API
+Keywords: cosplay2,cosplay,events,api,client,async,typed,pydantic,httpx2
+Author: Arutemu64
+Author-email: Arutemu64 <arutemu64@outlook.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Framework :: AnyIO
+Classifier: Framework :: Pydantic :: 2
+Classifier: Typing :: Typed
+Requires-Dist: anyio>=4.0.0
+Requires-Dist: httpx2>=2.0.0
+Requires-Dist: pydantic>=2.4.0
+Requires-Python: >=3.12
+Project-URL: Homepage, https://github.com/Arutemu64/cosplay2py
+Project-URL: Repository, https://github.com/Arutemu64/cosplay2py
+Project-URL: Issues, https://github.com/Arutemu64/cosplay2py/issues
+Description-Content-Type: text/markdown
+
+# cosplay2py
+
+Unofficial typed sync and async client for the [Cosplay2.ru](https://cosplay2.ru) API, built on
+[httpx2](https://github.com/pydantic/httpx2) and [Pydantic](https://docs.pydantic.dev).
+
+> [!WARNING]
+> This project is AI-generated: most of the code, tests and documentation were written
+> with an AI assistant. Review it before relying on it, and expect rough edges.
+
+## Installing
+
+The package is not on PyPI. Install it from a release tag:
+
+```shell
+uv add "cosplay2py @ git+https://github.com/Arutemu64/cosplay2py" --tag v0.2.0
+```
+
+Versions follow SemVer. On `0.x`, a minor bump (`0.1` → `0.2`) may break things and a
+patch bump never does. See [CHANGELOG.md](CHANGELOG.md).
+
+## Authentication
+
+API tokens are issued **per event**: on the event site open *Орги → Настройка → API токены*
+and create a token. You get an API key and an API secret (the secret is shown once;
+tokens expire after 30 days). The client sends them as `X-API-Key` / `X-API-Secret`.
+
+## Usage
+
+```python
+from cosplay2py import Cosplay2
+from cosplay2py.models import BlankId, RequestStatus
+
+with Cosplay2(subdomain="ff26summer", api_key="...", api_secret="...") as c2:
+    event = c2.events.get_settings()
+    print(event.title, event.timezone)
+
+    for topic in c2.topics.get_list():
+        listing = c2.topics.get_requests(topic.url_code)
+        approved = [r for r in listing.requests if r.status is RequestStatus.APPROVED]
+        print(topic.title, len(approved))
+
+    details = c2.requests.get(687475)
+    print(details.values_by_field())
+
+    jury_sheet = c2.events.get_blank(BlankId.JURY).html
+```
+
+Async (asyncio or trio):
+
+```python
+from cosplay2py import AsyncCosplay2
+
+async with AsyncCosplay2(subdomain="ff26summer") as c2:
+    state = await c2.events.get_state()
+    print(state.requests_total)
+```
+
+Events on a custom domain: `Cosplay2(base_url="https://fancom.info", ...)`.
+
+Any argument left out falls back to the environment: `COSPLAY2_API_KEY`,
+`COSPLAY2_API_SECRET`, `COSPLAY2_BASE_URL`.
+
+### Resources
+
+| Attribute     | Methods |
+|---------------|---------|
+| `events`      | `get_settings`, `save_setting`, `get_state`, `get_topics_state`, `get_topics_statistic`, `get_staff`, `add_org`, `delete_org`, `change_main_org`, `add_curator`, `delete_curator`, `get_winners`, `get_plan`, `save_plan`, `get_blank`, `get_reg_topics`, `get_reg_alphabet`, `search`, `set_deadline` |
+| `topics`      | `get_list`, `get_requests`, `get_all_requests`, `get_requests_for_planner`, `get_form`, `get_with_groups`, `add_child_topic`, `delete_child_topic`, `create`, `delete`, `reorder`, `fill_from_template`, `fill_from_topic`, `add_section`, `save_section`, `delete_section`, `add_field`, `delete_field`, `save_field`, `save_topic`, `reorder_section`, `reorder_field`, `generate_card_titles`, `reorder_requests` |
+| `requests`    | `get`, `get_comments`, `get_org_comments`, `get_user`, `generate_card_title`, `generate_card_announcement`, `generate_card_diplom`, `generate_voting_number`, `search`, `get_value_history`, `add_comment`, `delete_comment`, `save_field`, `upload_image`, `delete_image`, `upload_file`, `delete_file`, `save_data`, `set_status`, `create`, `create_section`, `delete_section`, `change_topic`, `add_org_comment`, `delete_org_comment`, `get_feedbacks`, `add_feedback`, `delete_feedback` |
+| `users`       | `search` |
+| `design`      | `get`, `get_images`, `save`, `upload_image`, `delete_image`, `delete_panel_logo`, `delete_header_logo`, `delete_site_background` |
+| `pages`       | `get_list`, `get`, `create`, `save_field`, `save_fields`, `delete`, `reorder` |
+| `media`       | `get_data`, `add_album`, `save_album_field`, `delete_album` |
+| `cards`       | `get_topics_and_cards`, `get_card`, `get_topics_and_requests`, `get_request` |
+| `etickets`    | `get_list`, `get_types`, `add_type`, `delete_type`, `reorder_type`, `save_type_field`, `save_field`, `delete`, `create`, `get`, `get_status`, `save_personal_data` |
+| `tickets`     | `get_statistic`, `get_voting_statistics`, `create`, `clear_votes`, `add_prize`, `delete_prize`, `save_prize_field`, `save_prize_handed`, `get_ticket`, `check_for_voting`, `get_voting_data`, `get_cards`, `select_winner` |
+
+### Data conventions
+
+- Server timestamps become timezone-aware UTC `datetime`s, whether the API sent
+  `"YYYY-MM-DD HH:MM:SS"`, Unix seconds or Unix milliseconds.
+- Display strings like `"22.08.26 03:00"` (`TopicState`, `Event.start_time`) become
+  naive `datetime`s, as the site shows them.
+- `0`/`1` flags become `bool`. JSON packed into strings (`Event.design`, the plan) is parsed.
+- Closed domain sets (`RequestStatus`, `TopicFieldType`, `PageType`, `PlanNodeType`,
+  `EventRole`, `EventStatus`, `EventTime`, `TopicCategory`,
+  `PublicRequests`, `TopicTemplate`, `SectionTemplate`, `FieldTemplate`, `FeedbackMark`,
+  `CardField`, `TicketKind`, `TicketCreateMode`, `VotingType`, `BlankId`, `Deadline`) are
+  validated strictly as `StrEnum` / `IntEnum` members (empty strings on optional fields
+  normalize to `None`).
+- Unknown fields are kept rather than rejected. Read them via `model.model_extra`.
+
+Talking to the API without this library? [docs/api-notes.md](docs/api-notes.md)
+describes its endpoints, wire formats and quirks.
+
+### Errors
+
+```
+Cosplay2Error
+└── APIError
+    ├── APIConnectionError
+    │   └── APITimeoutError
+    ├── APIResponseValidationError   # 2xx, but not the expected JSON
+    └── APIStatusError               # non-2xx; .status_code, .body, .response
+        ├── BadRequestError (400)
+        ├── AuthenticationError (401)
+        ├── PermissionDeniedError (403)
+        ├── NotFoundError (404)
+        ├── RateLimitError (429)
+        └── InternalServerError (5xx)
+```
+
+Repeatable reads retry transport failures and 429/502/503/504 responses, with
+exponential backoff and jitter (2 retries by default, configurable with
+`max_retries`). Writes retry only connection failures (`ConnectError`), never
+HTTP responses or read/write timeouts. An ambiguous failure may mean a write
+succeeded; check the service before repeating it yourself.
+
+`Retry-After` supports seconds and HTTP dates. If the server asks for more than
+30 seconds, the error is returned immediately instead of retrying early.
+Error messages omit response bodies and validation inputs. Inspect `.response`
+or `.body` explicitly when debugging; these can contain personal data.
+
+### Customizing HTTP
+
+Pass `timeout=` (seconds or `httpx2.Timeout`), extra `headers=`, or a fully configured
+`http_client=httpx2.Client(...)` / `httpx2.AsyncClient(...)` for proxies, custom
+transports or testing with `httpx2.MockTransport`. A client you pass in is not closed by
+the wrapper. Its timeout and default headers apply; wrapper headers override
+matching defaults, and redirects are always disabled. `timeout=` applies only to a
+client created by the wrapper. Timeouts limit network phases, not the total time
+across retries. Use HTTPS for event credentials; HTTP is supported for local testing.
+Base URLs cannot contain userinfo, query strings or fragments.
+
+This client follows observed site behavior, which can change without notice.
+Enable `logging.getLogger("cosplay2py")` at `DEBUG` to see requests.
+
+## Development
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for how to propose changes.
+
+```shell
+uv sync
+uv run prek install           # install Git hooks once per clone
+uv run pytest                 # offline unit tests (default)
+uv run prek run --all-files    # lint, format, and type-check
+```
+
+### Testing against the real site
+
+`tests/live` holds read-only smoke tests that are deselected by default. They need a token
+for the event (PowerShell shown):
+
+```powershell
+$env:COSPLAY2_API_KEY = "..."
+$env:COSPLAY2_API_SECRET = "..."
+$env:COSPLAY2_BASE_URL = "https://ff26summer.cosplay2.ru"
+uv run pytest -m live -rw
+```
+
+`-rw` lists warnings: fields the API returns that the models don't declare yet show up
+as `UnknownFieldsWarning`, an early sign of API drift.
+
+Portal reads work with the configured event base URL (verified with event API
+credentials); `https://cosplay2.ru` returned HTTP 403 with those credentials. Methods: `events.filter_list()`,
+`events.get_types()`, `events.create_festival()`, `events.create_festival_logo()`,
+`users.ratings_global()` and the country/area/region/city variants,
+`users.get_region_geo_id()`, and `geo.code_city()`. Unobserved response shapes
+are returned as JSON data.

cosplay2py-0.3.0/README.md

@@ -0,0 +1,169 @@
+# cosplay2py
+
+Unofficial typed sync and async client for the [Cosplay2.ru](https://cosplay2.ru) API, built on
+[httpx2](https://github.com/pydantic/httpx2) and [Pydantic](https://docs.pydantic.dev).
+
+> [!WARNING]
+> This project is AI-generated: most of the code, tests and documentation were written
+> with an AI assistant. Review it before relying on it, and expect rough edges.
+
+## Installing
+
+The package is not on PyPI. Install it from a release tag:
+
+```shell
+uv add "cosplay2py @ git+https://github.com/Arutemu64/cosplay2py" --tag v0.2.0
+```
+
+Versions follow SemVer. On `0.x`, a minor bump (`0.1` → `0.2`) may break things and a
+patch bump never does. See [CHANGELOG.md](CHANGELOG.md).
+
+## Authentication
+
+API tokens are issued **per event**: on the event site open *Орги → Настройка → API токены*
+and create a token. You get an API key and an API secret (the secret is shown once;
+tokens expire after 30 days). The client sends them as `X-API-Key` / `X-API-Secret`.
+
+## Usage
+
+```python
+from cosplay2py import Cosplay2
+from cosplay2py.models import BlankId, RequestStatus
+
+with Cosplay2(subdomain="ff26summer", api_key="...", api_secret="...") as c2:
+    event = c2.events.get_settings()
+    print(event.title, event.timezone)
+
+    for topic in c2.topics.get_list():
+        listing = c2.topics.get_requests(topic.url_code)
+        approved = [r for r in listing.requests if r.status is RequestStatus.APPROVED]
+        print(topic.title, len(approved))
+
+    details = c2.requests.get(687475)
+    print(details.values_by_field())
+
+    jury_sheet = c2.events.get_blank(BlankId.JURY).html
+```
+
+Async (asyncio or trio):
+
+```python
+from cosplay2py import AsyncCosplay2
+
+async with AsyncCosplay2(subdomain="ff26summer") as c2:
+    state = await c2.events.get_state()
+    print(state.requests_total)
+```
+
+Events on a custom domain: `Cosplay2(base_url="https://fancom.info", ...)`.
+
+Any argument left out falls back to the environment: `COSPLAY2_API_KEY`,
+`COSPLAY2_API_SECRET`, `COSPLAY2_BASE_URL`.
+
+### Resources
+
+| Attribute     | Methods |
+|---------------|---------|
+| `events`      | `get_settings`, `save_setting`, `get_state`, `get_topics_state`, `get_topics_statistic`, `get_staff`, `add_org`, `delete_org`, `change_main_org`, `add_curator`, `delete_curator`, `get_winners`, `get_plan`, `save_plan`, `get_blank`, `get_reg_topics`, `get_reg_alphabet`, `search`, `set_deadline` |
+| `topics`      | `get_list`, `get_requests`, `get_all_requests`, `get_requests_for_planner`, `get_form`, `get_with_groups`, `add_child_topic`, `delete_child_topic`, `create`, `delete`, `reorder`, `fill_from_template`, `fill_from_topic`, `add_section`, `save_section`, `delete_section`, `add_field`, `delete_field`, `save_field`, `save_topic`, `reorder_section`, `reorder_field`, `generate_card_titles`, `reorder_requests` |
+| `requests`    | `get`, `get_comments`, `get_org_comments`, `get_user`, `generate_card_title`, `generate_card_announcement`, `generate_card_diplom`, `generate_voting_number`, `search`, `get_value_history`, `add_comment`, `delete_comment`, `save_field`, `upload_image`, `delete_image`, `upload_file`, `delete_file`, `save_data`, `set_status`, `create`, `create_section`, `delete_section`, `change_topic`, `add_org_comment`, `delete_org_comment`, `get_feedbacks`, `add_feedback`, `delete_feedback` |
+| `users`       | `search` |
+| `design`      | `get`, `get_images`, `save`, `upload_image`, `delete_image`, `delete_panel_logo`, `delete_header_logo`, `delete_site_background` |
+| `pages`       | `get_list`, `get`, `create`, `save_field`, `save_fields`, `delete`, `reorder` |
+| `media`       | `get_data`, `add_album`, `save_album_field`, `delete_album` |
+| `cards`       | `get_topics_and_cards`, `get_card`, `get_topics_and_requests`, `get_request` |
+| `etickets`    | `get_list`, `get_types`, `add_type`, `delete_type`, `reorder_type`, `save_type_field`, `save_field`, `delete`, `create`, `get`, `get_status`, `save_personal_data` |
+| `tickets`     | `get_statistic`, `get_voting_statistics`, `create`, `clear_votes`, `add_prize`, `delete_prize`, `save_prize_field`, `save_prize_handed`, `get_ticket`, `check_for_voting`, `get_voting_data`, `get_cards`, `select_winner` |
+
+### Data conventions
+
+- Server timestamps become timezone-aware UTC `datetime`s, whether the API sent
+  `"YYYY-MM-DD HH:MM:SS"`, Unix seconds or Unix milliseconds.
+- Display strings like `"22.08.26 03:00"` (`TopicState`, `Event.start_time`) become
+  naive `datetime`s, as the site shows them.
+- `0`/`1` flags become `bool`. JSON packed into strings (`Event.design`, the plan) is parsed.
+- Closed domain sets (`RequestStatus`, `TopicFieldType`, `PageType`, `PlanNodeType`,
+  `EventRole`, `EventStatus`, `EventTime`, `TopicCategory`,
+  `PublicRequests`, `TopicTemplate`, `SectionTemplate`, `FieldTemplate`, `FeedbackMark`,
+  `CardField`, `TicketKind`, `TicketCreateMode`, `VotingType`, `BlankId`, `Deadline`) are
+  validated strictly as `StrEnum` / `IntEnum` members (empty strings on optional fields
+  normalize to `None`).
+- Unknown fields are kept rather than rejected. Read them via `model.model_extra`.
+
+Talking to the API without this library? [docs/api-notes.md](docs/api-notes.md)
+describes its endpoints, wire formats and quirks.
+
+### Errors
+
+```
+Cosplay2Error
+└── APIError
+    ├── APIConnectionError
+    │   └── APITimeoutError
+    ├── APIResponseValidationError   # 2xx, but not the expected JSON
+    └── APIStatusError               # non-2xx; .status_code, .body, .response
+        ├── BadRequestError (400)
+        ├── AuthenticationError (401)
+        ├── PermissionDeniedError (403)
+        ├── NotFoundError (404)
+        ├── RateLimitError (429)
+        └── InternalServerError (5xx)
+```
+
+Repeatable reads retry transport failures and 429/502/503/504 responses, with
+exponential backoff and jitter (2 retries by default, configurable with
+`max_retries`). Writes retry only connection failures (`ConnectError`), never
+HTTP responses or read/write timeouts. An ambiguous failure may mean a write
+succeeded; check the service before repeating it yourself.
+
+`Retry-After` supports seconds and HTTP dates. If the server asks for more than
+30 seconds, the error is returned immediately instead of retrying early.
+Error messages omit response bodies and validation inputs. Inspect `.response`
+or `.body` explicitly when debugging; these can contain personal data.
+
+### Customizing HTTP
+
+Pass `timeout=` (seconds or `httpx2.Timeout`), extra `headers=`, or a fully configured
+`http_client=httpx2.Client(...)` / `httpx2.AsyncClient(...)` for proxies, custom
+transports or testing with `httpx2.MockTransport`. A client you pass in is not closed by
+the wrapper. Its timeout and default headers apply; wrapper headers override
+matching defaults, and redirects are always disabled. `timeout=` applies only to a
+client created by the wrapper. Timeouts limit network phases, not the total time
+across retries. Use HTTPS for event credentials; HTTP is supported for local testing.
+Base URLs cannot contain userinfo, query strings or fragments.
+
+This client follows observed site behavior, which can change without notice.
+Enable `logging.getLogger("cosplay2py")` at `DEBUG` to see requests.
+
+## Development
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for how to propose changes.
+
+```shell
+uv sync
+uv run prek install           # install Git hooks once per clone
+uv run pytest                 # offline unit tests (default)
+uv run prek run --all-files    # lint, format, and type-check
+```
+
+### Testing against the real site
+
+`tests/live` holds read-only smoke tests that are deselected by default. They need a token
+for the event (PowerShell shown):
+
+```powershell
+$env:COSPLAY2_API_KEY = "..."
+$env:COSPLAY2_API_SECRET = "..."
+$env:COSPLAY2_BASE_URL = "https://ff26summer.cosplay2.ru"
+uv run pytest -m live -rw
+```
+
+`-rw` lists warnings: fields the API returns that the models don't declare yet show up
+as `UnknownFieldsWarning`, an early sign of API drift.
+
+Portal reads work with the configured event base URL (verified with event API
+credentials); `https://cosplay2.ru` returned HTTP 403 with those credentials. Methods: `events.filter_list()`,
+`events.get_types()`, `events.create_festival()`, `events.create_festival_logo()`,
+`users.ratings_global()` and the country/area/region/city variants,
+`users.get_region_geo_id()`, and `geo.code_city()`. Unobserved response shapes
+are returned as JSON data.

cosplay2py-0.3.0/pyproject.toml

@@ -0,0 +1,113 @@
+[project]
+name = "cosplay2py"
+version = "0.3.0"
+description = "Unofficial typed sync and async client for the Cosplay2.ru API"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = [
+    "cosplay2",
+    "cosplay",
+    "events",
+    "api",
+    "client",
+    "async",
+    "typed",
+    "pydantic",
+    "httpx2",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
+    "Framework :: AnyIO",
+    "Framework :: Pydantic :: 2",
+    "Typing :: Typed",
+]
+requires-python = ">=3.12"
+dependencies = [
+    "anyio>=4.0.0",
+    "httpx2>=2.0.0",
+    "pydantic>=2.4.0",
+]
+
+[[project.authors]]
+name = "Arutemu64"
+email = "arutemu64@outlook.com"
+
+[project.urls]
+Homepage = "https://github.com/Arutemu64/cosplay2py"
+Repository = "https://github.com/Arutemu64/cosplay2py"
+Issues = "https://github.com/Arutemu64/cosplay2py/issues"
+
+[build-system]
+requires = ["uv_build>=0.12.3,<0.13.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.2.0",
+    "ruff>=0.17.3",
+    "ty==0.0.93",
+    "trio>=0.26",
+    "prek>=0.5.7",
+]
+
+[tool.pytest]
+strict = true
+testpaths = ["tests"]
+addopts = [
+    "-m",
+    "not live",
+]
+markers = ["live: calls the real Cosplay2 API (needs COSPLAY2_API_KEY, COSPLAY2_API_SECRET, COSPLAY2_BASE_URL)"]
+
+[tool.ruff]
+line-length = 88
+src = [
+    "src",
+    "tests",
+]
+
+[tool.ruff.lint]
+extend-select = [
+    "I",
+    "UP",
+    "B",
+    "SIM",
+    "C4",
+    "PIE",
+    "RET",
+    "PT",
+    "PTH",
+    "ASYNC",
+    "DTZ",
+    "N",
+    "RUF",
+    "TID",
+]
+
+[tool.ruff.lint.flake8-tidy-imports]
+ban-relative-imports = "all"
+
+[tool.ruff.lint.isort]
+known-first-party = ["cosplay2py"]
+
+[tool.ruff.format]
+docstring-code-format = true
+line-ending = "lf"
+
+[tool.ty.src]
+include = [
+    "src",
+    "tests",
+]
+
+[tool.ty.terminal]
+error-on-warning = true

cosplay2py-0.3.0/pyproject.toml.orig

@@ -0,0 +1,110 @@
+[project]
+name = "cosplay2py"
+version = "0.3.0"
+description = "Unofficial typed sync and async client for the Cosplay2.ru API"
+readme = "README.md"
+authors = [
+    { name = "Arutemu64", email = "arutemu64@outlook.com" }
+]
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = [
+    "cosplay2",
+    "cosplay",
+    "events",
+    "api",
+    "client",
+    "async",
+    "typed",
+    "pydantic",
+    "httpx2",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
+    "Framework :: AnyIO",
+    "Framework :: Pydantic :: 2",
+    "Typing :: Typed",
+]
+requires-python = ">=3.12"
+# Lower bounds only: they are the oldest versions the test suite passes with
+# (`uv run --python 3.12 --resolution lowest-direct pytest`).
+dependencies = [
+    "anyio>=4.0.0",
+    "httpx2>=2.0.0",
+    "pydantic>=2.4.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/Arutemu64/cosplay2py"
+Repository = "https://github.com/Arutemu64/cosplay2py"
+Issues = "https://github.com/Arutemu64/cosplay2py/issues"
+
+[build-system]
+requires = ["uv_build>=0.12.3,<0.13.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.2.0",
+    "ruff>=0.17.3",
+    # Pre-1.0: releases can change diagnostics, so pin exactly.
+    "ty==0.0.93",
+    "trio>=0.26",
+    "prek>=0.5.7",
+]
+
+[tool.pytest]
+strict = true
+testpaths = ["tests"]
+# Live tests hit the real site; run them explicitly with `pytest -m live`.
+addopts = ["-m", "not live"]
+markers = [
+    "live: calls the real Cosplay2 API (needs COSPLAY2_API_KEY, COSPLAY2_API_SECRET, COSPLAY2_BASE_URL)",
+]
+
+[tool.ruff]
+line-length = 88
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+# Keep Ruff's curated default rule set (`select` would replace it) and add more.
+extend-select = [
+    "I",     # isort
+    "UP",    # pyupgrade
+    "B",     # flake8-bugbear
+    "SIM",   # flake8-simplify
+    "C4",    # flake8-comprehensions
+    "PIE",   # flake8-pie
+    "RET",   # flake8-return
+    "PT",    # flake8-pytest-style
+    "PTH",   # flake8-use-pathlib
+    "ASYNC", # flake8-async
+    "DTZ",   # flake8-datetimez
+    "N",     # pep8-naming
+    "RUF",   # ruff-specific rules
+    "TID",   # flake8-tidy-imports
+]
+
+[tool.ruff.lint.flake8-tidy-imports]
+ban-relative-imports = "all"
+
+[tool.ruff.lint.isort]
+known-first-party = ["cosplay2py"]
+
+[tool.ruff.format]
+docstring-code-format = true
+line-ending = "lf"
+
+[tool.ty.src]
+include = ["src", "tests"]
+
+[tool.ty.terminal]
+error-on-warning = true

cosplay2py-0.3.0/src/cosplay2py/__init__.py

@@ -0,0 +1,38 @@
+"""Sync and async client for the Cosplay2.ru event API."""
+
+from cosplay2py import models
+from cosplay2py._base_client import __version__
+from cosplay2py._client import AsyncCosplay2, Cosplay2
+from cosplay2py._exceptions import (
+    APIConnectionError,
+    APIError,
+    APIResponseValidationError,
+    APIStatusError,
+    APITimeoutError,
+    AuthenticationError,
+    BadRequestError,
+    Cosplay2Error,
+    InternalServerError,
+    NotFoundError,
+    PermissionDeniedError,
+    RateLimitError,
+)
+
+__all__ = [
+    "APIConnectionError",
+    "APIError",
+    "APIResponseValidationError",
+    "APIStatusError",
+    "APITimeoutError",
+    "AsyncCosplay2",
+    "AuthenticationError",
+    "BadRequestError",
+    "Cosplay2",
+    "Cosplay2Error",
+    "InternalServerError",
+    "NotFoundError",
+    "PermissionDeniedError",
+    "RateLimitError",
+    "__version__",
+    "models",
+]