rimble 0.1.0__tar.gz

rimble-0.1.0/LICENSE

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

rimble-0.1.0/MANIFEST.in

@@ -0,0 +1,2 @@
+include README.md
+include LICENSE

rimble-0.1.0/PKG-INFO

@@ -0,0 +1,88 @@
+Metadata-Version: 2.1
+Name: rimble
+Version: 0.1.0
+Summary: Python SDK for the Rimble Raw Data API — esports data for LoL, CS:GO, DOTA 2, Valorant, and more.
+Home-page: https://www.rimble.io
+Author: Rimble
+Author-email: support@rimble.io
+License: MIT
+Project-URL: Homepage, https://www.rimble.io
+Project-URL: Documentation, https://www.rimble.io/docs
+Project-URL: Repository, https://github.com/rimble/rimble-python
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# Rimble Python SDK
+
+Python client for the [Rimble Raw Data API](https://www.rimble.io/docs) — real-time esports data across 10 titles.
+
+## Installation
+
+```bash
+pip install rimble
+```
+
+## Quick Start
+
+```python
+from rimble import RimbleClient
+
+client = RimbleClient(api_key="YOUR_API_KEY")
+
+# Get upcoming League of Legends matches
+matches = client.get_upcoming_matches("lol")
+for match in matches:
+    print(f"{match['team_1_name']} vs {match['team_2_name']} — {match['date']}")
+```
+
+## Filtering with Query Parameters
+
+```python
+# Filter by date
+matches = client.get_upcoming_matches("csgo", date="2024-03-15")
+
+# Filter by team
+matches = client.get_upcoming_matches("valorant", team="Sentinels")
+
+# Filter by league
+matches = client.get_completed_matches("lol", league="LCS")
+
+# Multiple filters
+matches = client.get_completed_matches("dota2", date="2024-03-10", team="OG")
+```
+
+## Available Methods
+
+| Method | Description |
+|--------|-------------|
+| `get_upcoming_matches(sport, **params)` | Upcoming matches |
+| `get_live_matches(sport, **params)` | Currently live matches |
+| `get_completed_matches(sport, **params)` | Completed matches (last 5 days) |
+| `get_match_status(sport, matchid, **params)` | Status of a specific match |
+| `get_league_mappings(sport, **params)` | League/tournament directory |
+| `get_teams(sport, **params)` | Team directory |
+| `get_players(sport, **params)` | Player directory |
+
+## Supported Esports
+
+`lol`, `csgo`, `dota2`, `valorant`, `rocketleague`, `cod`, `nba2k`, `fifa`, `siege`, `cricket`
+
+## Error Handling
+
+```python
+from rimble import RimbleClient, RimbleAPIError
+
+client = RimbleClient(api_key="YOUR_API_KEY")
+
+try:
+    matches = client.get_upcoming_matches("lol")
+except RimbleAPIError as e:
+    print(f"API error: {e.status_code} — {e.message}")
+```
+
+## Links
+
+- [API Documentation](https://www.rimble.io/docs)
+- [Website](https://www.rimble.io)
+- [Contact](mailto:support@rimble.io)

rimble-0.1.0/README.md

@@ -0,0 +1,73 @@
+# Rimble Python SDK
+
+Python client for the [Rimble Raw Data API](https://www.rimble.io/docs) — real-time esports data across 10 titles.
+
+## Installation
+
+```bash
+pip install rimble
+```
+
+## Quick Start
+
+```python
+from rimble import RimbleClient
+
+client = RimbleClient(api_key="YOUR_API_KEY")
+
+# Get upcoming League of Legends matches
+matches = client.get_upcoming_matches("lol")
+for match in matches:
+    print(f"{match['team_1_name']} vs {match['team_2_name']} — {match['date']}")
+```
+
+## Filtering with Query Parameters
+
+```python
+# Filter by date
+matches = client.get_upcoming_matches("csgo", date="2024-03-15")
+
+# Filter by team
+matches = client.get_upcoming_matches("valorant", team="Sentinels")
+
+# Filter by league
+matches = client.get_completed_matches("lol", league="LCS")
+
+# Multiple filters
+matches = client.get_completed_matches("dota2", date="2024-03-10", team="OG")
+```
+
+## Available Methods
+
+| Method | Description |
+|--------|-------------|
+| `get_upcoming_matches(sport, **params)` | Upcoming matches |
+| `get_live_matches(sport, **params)` | Currently live matches |
+| `get_completed_matches(sport, **params)` | Completed matches (last 5 days) |
+| `get_match_status(sport, matchid, **params)` | Status of a specific match |
+| `get_league_mappings(sport, **params)` | League/tournament directory |
+| `get_teams(sport, **params)` | Team directory |
+| `get_players(sport, **params)` | Player directory |
+
+## Supported Esports
+
+`lol`, `csgo`, `dota2`, `valorant`, `rocketleague`, `cod`, `nba2k`, `fifa`, `siege`, `cricket`
+
+## Error Handling
+
+```python
+from rimble import RimbleClient, RimbleAPIError
+
+client = RimbleClient(api_key="YOUR_API_KEY")
+
+try:
+    matches = client.get_upcoming_matches("lol")
+except RimbleAPIError as e:
+    print(f"API error: {e.status_code} — {e.message}")
+```
+
+## Links
+
+- [API Documentation](https://www.rimble.io/docs)
+- [Website](https://www.rimble.io)
+- [Contact](mailto:support@rimble.io)

rimble-0.1.0/pyproject.toml

@@ -0,0 +1,17 @@
+[build-system]
+requires = ["setuptools>=64", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "rimble"
+version = "0.1.0"
+description = "Python SDK for the Rimble Raw Data API — esports data for LoL, CS:GO, DOTA 2, Valorant, and more."
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.7"
+dependencies = ["requests>=2.20.0"]
+
+[project.urls]
+Homepage = "https://www.rimble.io"
+Documentation = "https://www.rimble.io/docs"
+Repository = "https://github.com/rimble/rimble-python"

rimble-0.1.0/rimble/__init__.py

@@ -0,0 +1,5 @@
+from .client import RimbleClient
+from .exceptions import RimbleAPIError
+
+__all__ = ['RimbleClient', 'RimbleAPIError']
+__version__ = '0.1.0'

rimble-0.1.0/rimble/client.py

@@ -0,0 +1,52 @@
+import requests
+from .exceptions import RimbleAPIError
+
+VALID_SPORTS = ('lol', 'csgo', 'dota2', 'valorant', 'rocketleague', 'cod', 'nba2k', 'fifa', 'siege', 'cricket')
+DEFAULT_BASE_URL = 'https://rimbleanalytics.com'
+
+
+class RimbleClient:
+    """Client for the Rimble Raw Data API."""
+
+    def __init__(self, api_key, base_url=DEFAULT_BASE_URL):
+        self.api_key = api_key
+        self.base_url = base_url.rstrip('/')
+        self.session = requests.Session()
+        self.session.headers.update({'x-api-key': api_key})
+
+    def _request(self, sport, endpoint, **params):
+        if sport not in VALID_SPORTS:
+            raise ValueError(f"Invalid sport '{sport}'. Must be one of: {', '.join(VALID_SPORTS)}")
+        url = f"{self.base_url}/raw/{sport}/{endpoint}/"
+        resp = self.session.get(url, params=params or None)
+        if resp.status_code != 200:
+            raise RimbleAPIError(resp.status_code, response=resp)
+        return resp.json()
+
+    def get_upcoming_matches(self, sport, **params):
+        """Get upcoming matches. Params: date, matchid, time, team, league."""
+        return self._request(sport, 'upcoming-matches', **params)
+
+    def get_live_matches(self, sport, **params):
+        """Get live matches. Params: date, matchid, time, team, league."""
+        return self._request(sport, 'live-matches', **params)
+
+    def get_completed_matches(self, sport, **params):
+        """Get completed matches (last 5 days). Params: date, matchid, time, team, league."""
+        return self._request(sport, 'completed-matches', **params)
+
+    def get_match_status(self, sport, matchid, **params):
+        """Get match status. Returns: upcoming, live, ended, completed, or cancelled."""
+        return self._request(sport, 'match-status', matchid=matchid, **params)
+
+    def get_league_mappings(self, sport, **params):
+        """Get league/tournament mappings. Params: league_id, name, min_prize_money."""
+        return self._request(sport, 'league-mappings', **params)
+
+    def get_teams(self, sport, **params):
+        """Get teams. Params: id."""
+        return self._request(sport, 'teams', **params)
+
+    def get_players(self, sport, **params):
+        """Get players. Params: id."""
+        return self._request(sport, 'players', **params)

rimble-0.1.0/rimble/exceptions.py

@@ -0,0 +1,8 @@
+class RimbleAPIError(Exception):
+    """Raised when the Rimble API returns a non-200 response."""
+
+    def __init__(self, status_code, message=None, response=None):
+        self.status_code = status_code
+        self.message = message or f"API request failed with status {status_code}"
+        self.response = response
+        super().__init__(self.message)

rimble-0.1.0/rimble.egg-info/PKG-INFO

@@ -0,0 +1,88 @@
+Metadata-Version: 2.1
+Name: rimble
+Version: 0.1.0
+Summary: Python SDK for the Rimble Raw Data API — esports data for LoL, CS:GO, DOTA 2, Valorant, and more.
+Home-page: https://www.rimble.io
+Author: Rimble
+Author-email: support@rimble.io
+License: MIT
+Project-URL: Homepage, https://www.rimble.io
+Project-URL: Documentation, https://www.rimble.io/docs
+Project-URL: Repository, https://github.com/rimble/rimble-python
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# Rimble Python SDK
+
+Python client for the [Rimble Raw Data API](https://www.rimble.io/docs) — real-time esports data across 10 titles.
+
+## Installation
+
+```bash
+pip install rimble
+```
+
+## Quick Start
+
+```python
+from rimble import RimbleClient
+
+client = RimbleClient(api_key="YOUR_API_KEY")
+
+# Get upcoming League of Legends matches
+matches = client.get_upcoming_matches("lol")
+for match in matches:
+    print(f"{match['team_1_name']} vs {match['team_2_name']} — {match['date']}")
+```
+
+## Filtering with Query Parameters
+
+```python
+# Filter by date
+matches = client.get_upcoming_matches("csgo", date="2024-03-15")
+
+# Filter by team
+matches = client.get_upcoming_matches("valorant", team="Sentinels")
+
+# Filter by league
+matches = client.get_completed_matches("lol", league="LCS")
+
+# Multiple filters
+matches = client.get_completed_matches("dota2", date="2024-03-10", team="OG")
+```
+
+## Available Methods
+
+| Method | Description |
+|--------|-------------|
+| `get_upcoming_matches(sport, **params)` | Upcoming matches |
+| `get_live_matches(sport, **params)` | Currently live matches |
+| `get_completed_matches(sport, **params)` | Completed matches (last 5 days) |
+| `get_match_status(sport, matchid, **params)` | Status of a specific match |
+| `get_league_mappings(sport, **params)` | League/tournament directory |
+| `get_teams(sport, **params)` | Team directory |
+| `get_players(sport, **params)` | Player directory |
+
+## Supported Esports
+
+`lol`, `csgo`, `dota2`, `valorant`, `rocketleague`, `cod`, `nba2k`, `fifa`, `siege`, `cricket`
+
+## Error Handling
+
+```python
+from rimble import RimbleClient, RimbleAPIError
+
+client = RimbleClient(api_key="YOUR_API_KEY")
+
+try:
+    matches = client.get_upcoming_matches("lol")
+except RimbleAPIError as e:
+    print(f"API error: {e.status_code} — {e.message}")
+```
+
+## Links
+
+- [API Documentation](https://www.rimble.io/docs)
+- [Website](https://www.rimble.io)
+- [Contact](mailto:support@rimble.io)

rimble-0.1.0/rimble.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+setup.py
+rimble/__init__.py
+rimble/client.py
+rimble/exceptions.py
+rimble.egg-info/PKG-INFO
+rimble.egg-info/SOURCES.txt
+rimble.egg-info/dependency_links.txt
+rimble.egg-info/requires.txt
+rimble.egg-info/top_level.txt

rimble-0.1.0/rimble.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

rimble-0.1.0/rimble.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.20.0

rimble-0.1.0/rimble.egg-info/top_level.txt

@@ -0,0 +1 @@
+rimble

rimble-0.1.0/setup.cfg

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

rimble-0.1.0/setup.py

@@ -0,0 +1,15 @@
+from setuptools import setup, find_packages
+
+setup(
+    name='rimble',
+    version='0.1.0',
+    packages=find_packages(),
+    install_requires=['requests>=2.20.0'],
+    python_requires='>=3.7',
+    author='Rimble',
+    author_email='support@rimble.io',
+    description='Python SDK for the Rimble Raw Data API',
+    long_description=open('README.md').read(),
+    long_description_content_type='text/markdown',
+    url='https://www.rimble.io',
+)