ateve 0.0.1__tar.gz

ateve-0.0.1/.gitignore

@@ -0,0 +1,9 @@
+__pycache__/
+*.py[cod]
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+.venv/
+build/
+dist/
+*.egg-info/

ateve-0.0.1/PKG-INFO

@@ -0,0 +1,80 @@
+Metadata-Version: 2.4
+Name: ateve
+Version: 0.0.1
+Summary: Official Python SDK for the Ateve Search API
+Project-URL: Homepage, https://ateve.ai
+Project-URL: Documentation, https://ateve.ai/docs
+Project-URL: Repository, https://github.com/ateve-inc/ateve-sdks
+Author-email: "Ateve Inc." <ops@ateve-inc.com>
+License: Apache-2.0
+Keywords: AI,RAG,ateve,search
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: httpx<1,>=0.28.1
+Requires-Dist: pydantic<3,>=2.10
+Requires-Dist: tzdata>=2025.2; platform_system == 'Windows'
+Description-Content-Type: text/markdown
+
+# Ateve Python SDK
+
+Official typed client for `POST /v1/search`. Requires Python 3.11+.
+
+## Install
+
+```bash
+pip install ateve
+```
+
+## Synchronous
+
+```python
+from ateve import Ateve, ContentOptions, Topic
+
+with Ateve() as client:  # reads ATEVE_API_KEY
+    response = client.search(
+        query="quantum computing",
+        date_range="week",
+        topic=Topic.NEWS,
+        content=ContentOptions(summary=True, highlights=True),
+    )
+    print(response.results[0].title, response.usage.credits)
+```
+
+## Asynchronous
+
+```python
+from ateve import AsyncAteve
+
+async with AsyncAteve() as client:
+    response = await client.search("quantum computing", limit=10)
+```
+
+`Ateve` owns and closes its default `httpx.Client`; `AsyncAteve` does the same
+for its default `httpx.AsyncClient`. An injected `http_client` is borrowed and
+never closed by the SDK. Reuse one Ateve client for its connection pool instead
+of constructing one per request.
+
+Each `search` call sends exactly one HTTP request. The SDK never retries,
+backs off, or switches endpoints. This is intentional: a timeout/reset can
+happen after the billable search already ran. `ApiConnectionError` exposes
+`request_may_have_been_sent`; only DNS/connect/connect-timeout/pool-timeout
+failures are classified as definitely not sent.
+
+The built-in path defaults to a 60-second request timeout, 5-second connect
+timeout, a 32 MiB response cap, and no redirects. Use
+`max_concurrent_requests` for an optional fail-fast bulkhead.
+
+Typed errors include `AuthenticationError`, `PaymentRequiredError`,
+`RateLimitError`, `InvalidRequestError`, `ServerError`,
+`ApiConnectionError`, `ApiResponseError`, and `ConcurrencyLimitError`.
+`RateLimitError` preserves `retry_after_seconds` and `limit_scope`; retry
+decisions remain caller-owned.

ateve-0.0.1/README.md

@@ -0,0 +1,54 @@
+# Ateve Python SDK
+
+Official typed client for `POST /v1/search`. Requires Python 3.11+.
+
+## Install
+
+```bash
+pip install ateve
+```
+
+## Synchronous
+
+```python
+from ateve import Ateve, ContentOptions, Topic
+
+with Ateve() as client:  # reads ATEVE_API_KEY
+    response = client.search(
+        query="quantum computing",
+        date_range="week",
+        topic=Topic.NEWS,
+        content=ContentOptions(summary=True, highlights=True),
+    )
+    print(response.results[0].title, response.usage.credits)
+```
+
+## Asynchronous
+
+```python
+from ateve import AsyncAteve
+
+async with AsyncAteve() as client:
+    response = await client.search("quantum computing", limit=10)
+```
+
+`Ateve` owns and closes its default `httpx.Client`; `AsyncAteve` does the same
+for its default `httpx.AsyncClient`. An injected `http_client` is borrowed and
+never closed by the SDK. Reuse one Ateve client for its connection pool instead
+of constructing one per request.
+
+Each `search` call sends exactly one HTTP request. The SDK never retries,
+backs off, or switches endpoints. This is intentional: a timeout/reset can
+happen after the billable search already ran. `ApiConnectionError` exposes
+`request_may_have_been_sent`; only DNS/connect/connect-timeout/pool-timeout
+failures are classified as definitely not sent.
+
+The built-in path defaults to a 60-second request timeout, 5-second connect
+timeout, a 32 MiB response cap, and no redirects. Use
+`max_concurrent_requests` for an optional fail-fast bulkhead.
+
+Typed errors include `AuthenticationError`, `PaymentRequiredError`,
+`RateLimitError`, `InvalidRequestError`, `ServerError`,
+`ApiConnectionError`, `ApiResponseError`, and `ConcurrencyLimitError`.
+`RateLimitError` preserves `retry_after_seconds` and `limit_scope`; retry
+decisions remain caller-owned.

ateve-0.0.1/pyproject.toml

@@ -0,0 +1,65 @@
+[build-system]
+requires = ["hatchling>=1.27,<2"]
+build-backend = "hatchling.build"
+
+[project]
+name = "ateve"
+version = "0.0.1"
+description = "Official Python SDK for the Ateve Search API"
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "Apache-2.0" }
+authors = [{ name = "Ateve Inc.", email = "ops@ateve-inc.com" }]
+keywords = ["ateve", "search", "RAG", "AI"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: Apache Software License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Typing :: Typed",
+]
+dependencies = [
+  "httpx>=0.28.1,<1",
+  "pydantic>=2.10,<3",
+  "tzdata>=2025.2; platform_system == 'Windows'",
+]
+
+[project.urls]
+Homepage = "https://ateve.ai"
+Documentation = "https://ateve.ai/docs"
+Repository = "https://github.com/ateve-inc/ateve-sdks"
+
+[dependency-groups]
+dev = [
+  "hatch>=1.14,<2",
+  "mypy>=1.15,<2",
+  "pytest>=8.3,<9",
+  "pytest-asyncio>=0.25,<2",
+  "ruff>=0.11,<1",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/ateve"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-q"
+
+[tool.ruff]
+target-version = "py311"
+line-length = 100
+
+[tool.ruff.lint]
+# Type syntax remains deliberately conservative so generated documentation is
+# easy to read across the currently supported Python versions.
+select = ["E", "F", "I", "B", "SIM"]
+
+[tool.mypy]
+python_version = "3.11"
+strict = true
+packages = ["ateve"]

ateve-0.0.1/src/ateve/__init__.py

@@ -0,0 +1,64 @@
+"""Official Python SDK for the Ateve Search API."""
+
+from ._version import __version__
+from .client import AsyncAteve, Ateve
+from .errors import (
+    ApiConnectionError,
+    ApiError,
+    ApiResponseError,
+    AteveError,
+    AuthenticationError,
+    ConcurrencyLimitError,
+    InvalidRequestError,
+    PaymentRequiredError,
+    RateLimitError,
+    ServerError,
+)
+from .models import (
+    AnswerBlock,
+    Citation,
+    ContentFormat,
+    ContentOptions,
+    ImageItem,
+    LocaleSettings,
+    QueryInfo,
+    SearchRequest,
+    SearchResponse,
+    SearchResult,
+    Topic,
+    Usage,
+    UsageBreakdown,
+    UserLocation,
+    VideoItem,
+)
+
+__all__ = [
+    "AnswerBlock",
+    "ApiConnectionError",
+    "ApiError",
+    "ApiResponseError",
+    "AsyncAteve",
+    "Ateve",
+    "AteveError",
+    "AuthenticationError",
+    "Citation",
+    "ConcurrencyLimitError",
+    "ContentFormat",
+    "ContentOptions",
+    "ImageItem",
+    "InvalidRequestError",
+    "LocaleSettings",
+    "PaymentRequiredError",
+    "QueryInfo",
+    "RateLimitError",
+    "SearchRequest",
+    "SearchResponse",
+    "SearchResult",
+    "ServerError",
+    "Topic",
+    "Usage",
+    "UsageBreakdown",
+    "UserLocation",
+    "VideoItem",
+    "__version__",
+]

ateve-0.0.1/src/ateve/_version.py

@@ -0,0 +1 @@
+__version__ = "0.0.1"