rtbnext 1.0.0__tar.gz → 1.0.2__tar.gz

{rtbnext-1.0.0 → rtbnext-1.0.2}/.gitignore

@@ -1,3 +1,4 @@
-.venv/
-__pycache__/
-dist/
+.venv/
+__pycache__/
+dist/
+.pypirc

{rtbnext-1.0.0 → rtbnext-1.0.2}/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 RTBNext by Paul Köhler (komed3)
-
-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.
+MIT License
+
+Copyright (c) 2026 RTBNext by Paul Köhler (komed3)
+
+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.

{rtbnext-1.0.0 → rtbnext-1.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: rtbnext
-Version: 1.0.0
+Version: 1.0.2
 Summary: Official Python SDK for the RTBNext API.
 Project-URL: Homepage, https://rtbnext.de
 Project-URL: Documentation, https://sdk.rtbnext.de
@@ -33,6 +33,10 @@ Description-Content-Type: text/markdown
 
 # rtbnext
 
+[![Static Badge](https://img.shields.io/badge/sdk-rtbnext?style=for-the-badge&label=rtbnext&color=%23d3ff1a)](https://rtbnext.de)
+[![PyPI License](https://img.shields.io/pypi/l/rtbnext?style=for-the-badge)](https://github.com/rtbnext/sdk-python/blob/master/LICENSE)
+[![PyPI Version](https://img.shields.io/pypi/v/rtbnext?style=for-the-badge)](https://pypi.org/project/rtbnext)
+
 **Official Python SDK for the RTBNext API.**
 
 The RTBNext SDK provides a typed, asynchronous interface for accessing billionaire profiles, lists, filters, statistics, historical data and system information from the [RTBNext API](https://api.rtbnext.de).

{rtbnext-1.0.0 → rtbnext-1.0.2}/README.md

@@ -1,128 +1,132 @@
-# rtbnext
-
-**Official Python SDK for the RTBNext API.**
-
-The RTBNext SDK provides a typed, asynchronous interface for accessing billionaire profiles, lists, filters, statistics, historical data and system information from the [RTBNext API](https://api.rtbnext.de).
-
-The SDK follows a consistent resource-oriented design: resources are loaded lazily, cached according to the configured cache mode, and expose typed helper methods for collections, time series and indexed data.
-
-The package includes Python type information and is compatible with static type checkers such as Pyright, Pylance and mypy.
-
-To find a list of all available API endpoints, please refer to the [API Documentation](https://docs.rtbnext.de). Also visit the [API endpoint](https://api.rtbnext.de) or review the [SDK Documentation](https://sdk.rtbnext.de) for additional details. For updates on current issues or maintenance, please refer to the [System Status](https://status.rtbnext.de).
-
-## Installation
-
-Install the package using pip:
-
-```bash
-pip install rtbnext
-```
-
-## First usage
-
-Every client application **must identify** itself when creating an SDK instance. This information is sent with API requests and helps to provide transparency about API consumers.
-
-```py
-import asyncio
-
-from rtbnext import ClientIdentity, rtbnext
-
-
-async def main() -> None:
-    async with rtbnext(
-        client= ClientIdentity(
-            name= "my-application",
-            version= "1.0.0",
-            contact= "https://example.com/contact"
-        )
-    ) as client:
-
-        stats = await client.stats.global_.data()
-        print( stats["count"] )
-
-
-asyncio.run( main() )
-```
-
-The client identity consists of:
-
-- `name` — application or project name
-- `version` — application version
-- `contact` — optional contact URL
-- `email` — optional contact email address
-
-## Core concepts
-
-### Lazy resources
-
-Resources are not downloaded when they are created. Data is loaded only when it is requested.
-
-```py
-profile = client.profile.get( "bill-gates" )
-
-# No request has been made yet.
-
-data = await profile.meta.data()
-```
-
-### Collections
-
-Collection resources provide filtering, searching, sorting and paging helpers.
-
-```py
-profiles = await client.profile.index.collection()
-
-for profile in profiles.search( "bill" ).order_by( "networth", descending= True ).take( 5 ):
-    print( item.raw["name"], item.raw["uri"] )
-```
-
-### Time series
-
-Historical data can be accessed through typed time-series resources.
-
-```py
-history = await client.profile.get( "bill-gates" ).history.series()
-print( history.latest )
-```
-
-Time series collections support date-based navigation and cursor operations:
-
-```py
-history.seek( "2026-01-01" )
-
-while ( point := history.next ) is not None:
-    print( point["date"], point["networth"] )
-```
-
-## Cache behavior
-
-The SDK includes a configurable resource cache layer that follows HTTP cache semantics. Resources are cached according to the selected cache mode and server-provided cache headers.
-
-Supported cache modes:
-
-- `ttl` — uses the server-defined cache lifetime (`Cache-Control`)
-- `revalidate` — performs conditional requests using validators such as `ETag` and `Last-Modified`
-- `session` — keeps resources during the lifetime of the SDK instance
-
-The SDK does not bypass HTTP cache validation. Expired resources are refreshed according to the configured mode to prevent serving outdated data indefinitely.
-
-A custom cache implementation can be provided by implementing the `Cache` protocol. This allows applications to integrate their own storage solutions, such as databases, filesystem caches or distributed cache systems.
-
-The cache interface requires the following operations:
-
-- retrieve a cached resource state
-- store a resource state
-- delete a resource
-- clear the cache
-- report the current cache size
-
-## Requirements
-
-- Python 3.12+
-- httpx 0.28+
-
-## License
-
-**Copyright © 2026 RTBNext**  
-Created and maintained by [Paul Köhler](https://komed3.de) (komed3).  
-Licensed under the [MIT License](./LICENSE).
+# rtbnext
+
+[![Static Badge](https://img.shields.io/badge/sdk-rtbnext?style=for-the-badge&label=rtbnext&color=%23d3ff1a)](https://rtbnext.de)
+[![PyPI License](https://img.shields.io/pypi/l/rtbnext?style=for-the-badge)](https://github.com/rtbnext/sdk-python/blob/master/LICENSE)
+[![PyPI Version](https://img.shields.io/pypi/v/rtbnext?style=for-the-badge)](https://pypi.org/project/rtbnext)
+
+**Official Python SDK for the RTBNext API.**
+
+The RTBNext SDK provides a typed, asynchronous interface for accessing billionaire profiles, lists, filters, statistics, historical data and system information from the [RTBNext API](https://api.rtbnext.de).
+
+The SDK follows a consistent resource-oriented design: resources are loaded lazily, cached according to the configured cache mode, and expose typed helper methods for collections, time series and indexed data.
+
+The package includes Python type information and is compatible with static type checkers such as Pyright, Pylance and mypy.
+
+To find a list of all available API endpoints, please refer to the [API Documentation](https://docs.rtbnext.de). Also visit the [API endpoint](https://api.rtbnext.de) or review the [SDK Documentation](https://sdk.rtbnext.de) for additional details. For updates on current issues or maintenance, please refer to the [System Status](https://status.rtbnext.de).
+
+## Installation
+
+Install the package using pip:
+
+```bash
+pip install rtbnext
+```
+
+## First usage
+
+Every client application **must identify** itself when creating an SDK instance. This information is sent with API requests and helps to provide transparency about API consumers.
+
+```py
+import asyncio
+
+from rtbnext import ClientIdentity, rtbnext
+
+
+async def main() -> None:
+    async with rtbnext(
+        client= ClientIdentity(
+            name= "my-application",
+            version= "1.0.0",
+            contact= "https://example.com/contact"
+        )
+    ) as client:
+
+        stats = await client.stats.global_.data()
+        print( stats["count"] )
+
+
+asyncio.run( main() )
+```
+
+The client identity consists of:
+
+- `name` — application or project name
+- `version` — application version
+- `contact` — optional contact URL
+- `email` — optional contact email address
+
+## Core concepts
+
+### Lazy resources
+
+Resources are not downloaded when they are created. Data is loaded only when it is requested.
+
+```py
+profile = client.profile.get( "bill-gates" )
+
+# No request has been made yet.
+
+data = await profile.meta.data()
+```
+
+### Collections
+
+Collection resources provide filtering, searching, sorting and paging helpers.
+
+```py
+profiles = await client.profile.index.collection()
+
+for profile in profiles.search( "bill" ).order_by( "networth", descending= True ).take( 5 ):
+    print( item.raw["name"], item.raw["uri"] )
+```
+
+### Time series
+
+Historical data can be accessed through typed time-series resources.
+
+```py
+history = await client.profile.get( "bill-gates" ).history.series()
+print( history.latest )
+```
+
+Time series collections support date-based navigation and cursor operations:
+
+```py
+history.seek( "2026-01-01" )
+
+while ( point := history.next ) is not None:
+    print( point["date"], point["networth"] )
+```
+
+## Cache behavior
+
+The SDK includes a configurable resource cache layer that follows HTTP cache semantics. Resources are cached according to the selected cache mode and server-provided cache headers.
+
+Supported cache modes:
+
+- `ttl` — uses the server-defined cache lifetime (`Cache-Control`)
+- `revalidate` — performs conditional requests using validators such as `ETag` and `Last-Modified`
+- `session` — keeps resources during the lifetime of the SDK instance
+
+The SDK does not bypass HTTP cache validation. Expired resources are refreshed according to the configured mode to prevent serving outdated data indefinitely.
+
+A custom cache implementation can be provided by implementing the `Cache` protocol. This allows applications to integrate their own storage solutions, such as databases, filesystem caches or distributed cache systems.
+
+The cache interface requires the following operations:
+
+- retrieve a cached resource state
+- store a resource state
+- delete a resource
+- clear the cache
+- report the current cache size
+
+## Requirements
+
+- Python 3.12+
+- httpx 0.28+
+
+## License
+
+**Copyright © 2026 RTBNext**  
+Created and maintained by [Paul Köhler](https://komed3.de) (komed3).  
+Licensed under the [MIT License](./LICENSE).

{rtbnext-1.0.0 → rtbnext-1.0.2}/pyproject.toml

@@ -1,103 +1,103 @@
-[build-system]
-build-backend = "hatchling.build"
-requires = [
-    "hatchling >= 1.27"
-]
-
-[project]
-name = "rtbnext"
-version = "1.0.0"
-description = "Official Python SDK for the RTBNext API."
-readme = "README.md"
-license = "MIT"
-requires-python = ">= 3.12"
-
-authors = [
-    { name = "Paul Köhler (komed3)", email = "webmaster@komed3.de" }
-]
-
-keywords = [
-    "rtbnext",
-    "billionaires",
-    "api",
-    "sdk"
-]
-
-classifiers = [
-    "Development Status :: 5 - Production/Stable",
-    "Intended Audience :: Developers",
-    "License :: OSI Approved :: MIT License",
-    "Programming Language :: Python :: 3 :: Only",
-    "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.12",
-    "Programming Language :: Python :: 3.13",
-    "Programming Language :: Python :: 3.14",
-    "Operating System :: OS Independent",
-    "Typing :: Typed"
-]
-
-dependencies = [
-    "httpx >= 0.28"
-]
-
-[project.urls]
-Homepage = "https://rtbnext.de"
-Documentation = "https://sdk.rtbnext.de"
-Repository = "https://github.com/rtbnext/sdk-python"
-"Bug Tracker" = "https://github.com/rtbnext/sdk-python/issues"
-
-[project.optional-dependencies]
-dev = [
-    "build >= 1.5",
-    "hatchling >= 1.27",
-    "twine >= 7.0",
-    "pylint >= 4.0",
-    "isort >= 8.0",
-    "pre-commit >= 4.6"
-]
-
-[tool.hatch.build.targets.wheel]
-packages = [
-    "src/rtbnext"
-]
-
-[tool.hatch.build.targets.sdist]
-include = [
-    "src/rtbnext",
-    "LICENSE",
-    "README.md"
-]
-
-[tool.hatch.build.targets.wheel.force-include]
-"src/rtbnext/py.typed" = "rtbnext/py.typed"
-
-[tool.pylint]
-ignore = [
-    "examples",
-    ".venv",
-    "node_modules",
-    "__pycache__"
-]
-
-[tool.pylint.design]
-min-public-methods = 0
-max-attributes = 12
-max-args = 12
-
-[tool.pylint.messages_control]
-disable = [
-    "duplicate-code",
-    "unnecessary-ellipsis"
-]
-
-[tool.isort]
-profile = "black"
-multi_line_output = 5
-include_trailing_comma = false
-line_length = 100
-skip = [
-    "examples",
-    ".venv",
-    "node_modules",
-    "__pycache__"
-]
+[build-system]
+build-backend = "hatchling.build"
+requires = [
+    "hatchling >= 1.27"
+]
+
+[project]
+name = "rtbnext"
+version = "1.0.2"
+description = "Official Python SDK for the RTBNext API."
+readme = "README.md"
+license = "MIT"
+requires-python = ">= 3.12"
+
+authors = [
+    { name = "Paul Köhler (komed3)", email = "webmaster@komed3.de" }
+]
+
+keywords = [
+    "rtbnext",
+    "billionaires",
+    "api",
+    "sdk"
+]
+
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Operating System :: OS Independent",
+    "Typing :: Typed"
+]
+
+dependencies = [
+    "httpx >= 0.28"
+]
+
+[project.urls]
+Homepage = "https://rtbnext.de"
+Documentation = "https://sdk.rtbnext.de"
+Repository = "https://github.com/rtbnext/sdk-python"
+"Bug Tracker" = "https://github.com/rtbnext/sdk-python/issues"
+
+[project.optional-dependencies]
+dev = [
+    "build >= 1.5",
+    "hatchling >= 1.27",
+    "twine >= 7.0",
+    "pylint >= 4.0",
+    "isort >= 8.0",
+    "pre-commit >= 4.6"
+]
+
+[tool.hatch.build.targets.wheel]
+packages = [
+    "src/rtbnext"
+]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "src/rtbnext",
+    "LICENSE",
+    "README.md"
+]
+
+[tool.hatch.build.targets.wheel.force-include]
+"src/rtbnext/py.typed" = "rtbnext/py.typed"
+
+[tool.pylint]
+ignore = [
+    "examples",
+    ".venv",
+    "node_modules",
+    "__pycache__"
+]
+
+[tool.pylint.design]
+min-public-methods = 0
+max-attributes = 12
+max-args = 12
+
+[tool.pylint.messages_control]
+disable = [
+    "duplicate-code",
+    "unnecessary-ellipsis"
+]
+
+[tool.isort]
+profile = "black"
+multi_line_output = 5
+include_trailing_comma = false
+line_length = 100
+skip = [
+    "examples",
+    ".venv",
+    "node_modules",
+    "__pycache__"
+]

{rtbnext-1.0.0 → rtbnext-1.0.2}/src/rtbnext/__init__.py

@@ -1,26 +1,34 @@
-"""
-RTBNext Python SDK
-
-Official Python SDK for the RTBNext API.
-
-Provides access to all RTBNext API endpoints, resources, and data models.
-The SDK offers lazy loading, transparent caching, automatic revalidation,
-and a resource-oriented API for working with lists, profiles, filters,
-statistics, and time series data.
-
-Author: Paul Köhler (komed3)
-License: MIT
-"""
-
-from rtbnext._version import __version__
-from rtbnext.core.http_client import ClientIdentity
-from rtbnext.core.loader import CacheMode, CacheType
-from rtbnext.rtbnext import RTBNext, rtbnext
-
-__all__ = [
-    "RTBNext",
-    "rtbnext",
-    "ClientIdentity",
-    "CacheType",
-    "CacheMode"
-]
+"""
+RTBNext Python SDK
+
+Official Python SDK for the RTBNext API.
+
+Provides access to all RTBNext API endpoints, resources, and data models.
+The SDK offers lazy loading, transparent caching, automatic revalidation,
+and a resource-oriented API for working with lists, profiles, filters,
+statistics, and time series data.
+
+Author: Paul Köhler (komed3)
+License: MIT
+"""
+
+from rtbnext._version import __version__
+from rtbnext.core.cache import Cache
+from rtbnext.core.http_client import ClientIdentity
+from rtbnext.core.loader import CacheMode, CacheType
+from rtbnext.core.rate_limiter import RateLimitMode
+from rtbnext.resource.base import ResourceEvent
+from rtbnext.resource.series import AggregatePeriod
+from rtbnext.rtbnext import RTBNext, rtbnext
+
+__all__ = [
+    "RTBNext",
+    "rtbnext",
+    "ClientIdentity",
+    "RateLimitMode",
+    "CacheType",
+    "CacheMode",
+    "ResourceEvent",
+    "AggregatePeriod",
+    "Cache"
+]

{rtbnext-1.0.0 → rtbnext-1.0.2}/src/rtbnext/_version.py

@@ -1,7 +1,7 @@
-"""
-Version
-
-Declares the RTBNext Python SDK version.
-"""
-
-__version__ = "1.0.0"
+"""
+Version
+
+Declares the RTBNext Python SDK version.
+"""
+
+__version__ = "1.0.2"