OpenMLBB 4.0.3__tar.gz → 4.0.4__tar.gz

openmlbb-4.0.4/OpenMLBB/README.md

@@ -0,0 +1,71 @@
+# OpenMLBB Python SDK
+
+OpenMLBB is the official Python SDK for `https://mlbb.rone.dev/api`.
+
+- API base: `https://mlbb.rone.dev/api`
+- Docs: `https://mlbb.rone.dev/openmlbb`
+- Groups: `academy`, `mlbb`, `user`, `addon`
+
+## Install
+
+```bash
+pip install OpenMLBB
+```
+
+## Quick Start
+
+```python
+from OpenMLBB import OpenMLBB
+
+client = OpenMLBB()
+
+heroes = client.mlbb.heroes(size=5, index=1, order="desc", lang="en")
+academy_roles = client.academy.roles(lang="en")
+win_rate = client.addon.win_rate_calculator(match_now=100, wr_now=50, wr_future=60)
+
+print(heroes)
+print(academy_roles)
+print(win_rate)
+```
+
+Every SDK method returns API JSON as a Python dictionary.
+
+## Endpoint Coverage
+
+OpenMLBB follows the same route coverage as API routers:
+
+- `academy`: version, heroes, roles, equipment, spells, emblems, ranks, recommendations, ratings
+- `mlbb`: heroes list, rank, positions, details, stats, combos, trends, relations, counters, compatibility
+- `user`: auth, profile, stats, privacy, season, matches, hero matches, friends
+- `addon`: win-rate calculator, IP lookup
+
+See the interactive SDK docs at `https://mlbb.rone.dev/openmlbb` for endpoint-by-endpoint usage examples.
+
+## Common Examples
+
+```python
+from OpenMLBB import OpenMLBB
+
+client = OpenMLBB()
+
+# academy
+academy_version = client.academy.meta_version(size=20, index=1, order="desc", lang="en")
+
+# mlbb
+hero_list = client.mlbb.heroes(size=10, index=1, order="desc", lang="en")
+
+# addon
+wr_calc = client.addon.win_rate_calculator(match_now=100, wr_now=50, wr_future=60)
+
+print(academy_version)
+print(hero_list)
+print(wr_calc)
+```
+
+## User-Agent
+
+The default `User-Agent` is:
+
+`RoneAI-OpenMLBB-Python-SDK`
+
+You can override it by passing `user_agent=` to `OpenMLBB(...)`.

{openmlbb-4.0.3 → openmlbb-4.0.4}/OpenMLBB/src/OpenMLBB/_version.py

@@ -1,3 +1,3 @@
 """Package version for OpenMLBB."""
 
-__version__ = "4.0.3"
+__version__ = "4.0.4"

{openmlbb-4.0.3 → openmlbb-4.0.4}/OpenMLBB/src/OpenMLBB/client.py

@@ -141,6 +141,9 @@ class AcademyClient:
     def heroes_ratings(self, **params: Any) -> dict[str, Any]:
         return self._transport.request("GET", "/academy/heroes/ratings", params=params)
 
+    def heroes_ratings_subject(self, subject: str, **params: Any) -> dict[str, Any]:
+        return self._transport.request("GET", f"/academy/heroes/ratings/{subject}", params=params)
+
 
 class MlbbClient:
     def __init__(self, transport: _Transport) -> None:

{openmlbb-4.0.3 → openmlbb-4.0.4/OpenMLBB/src/OpenMLBB.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: OpenMLBB
-Version: 4.0.3
+Version: 4.0.4
 Summary: Official Python SDK for the MLBB Public Data API
 Author: ridwaanhall
 License: BSD-3-Clause
@@ -20,6 +20,10 @@ Dynamic: license-file
 
 OpenMLBB is the official Python SDK for `https://mlbb.rone.dev/api`.
 
+- API base: `https://mlbb.rone.dev/api`
+- Docs: `https://mlbb.rone.dev/openmlbb`
+- Groups: `academy`, `mlbb`, `user`, `addon`
+
 ## Install
 
 ```bash
@@ -44,6 +48,38 @@ print(win_rate)
 
 Every SDK method returns API JSON as a Python dictionary.
 
+## Endpoint Coverage
+
+OpenMLBB follows the same route coverage as API routers:
+
+- `academy`: version, heroes, roles, equipment, spells, emblems, ranks, recommendations, ratings
+- `mlbb`: heroes list, rank, positions, details, stats, combos, trends, relations, counters, compatibility
+- `user`: auth, profile, stats, privacy, season, matches, hero matches, friends
+- `addon`: win-rate calculator, IP lookup
+
+See the interactive SDK docs at `https://mlbb.rone.dev/openmlbb` for endpoint-by-endpoint usage examples.
+
+## Common Examples
+
+```python
+from OpenMLBB import OpenMLBB
+
+client = OpenMLBB()
+
+# academy
+academy_version = client.academy.meta_version(size=20, index=1, order="desc", lang="en")
+
+# mlbb
+hero_list = client.mlbb.heroes(size=10, index=1, order="desc", lang="en")
+
+# addon
+wr_calc = client.addon.win_rate_calculator(match_now=100, wr_now=50, wr_future=60)
+
+print(academy_version)
+print(hero_list)
+print(wr_calc)
+```
+
 ## User-Agent
 
 The default `User-Agent` is:

{openmlbb-4.0.3/OpenMLBB/src/OpenMLBB.egg-info → openmlbb-4.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: OpenMLBB
-Version: 4.0.3
+Version: 4.0.4
 Summary: Official Python SDK for the MLBB Public Data API
 Author: ridwaanhall
 License: BSD-3-Clause
@@ -20,6 +20,10 @@ Dynamic: license-file
 
 OpenMLBB is the official Python SDK for `https://mlbb.rone.dev/api`.
 
+- API base: `https://mlbb.rone.dev/api`
+- Docs: `https://mlbb.rone.dev/openmlbb`
+- Groups: `academy`, `mlbb`, `user`, `addon`
+
 ## Install
 
 ```bash
@@ -44,6 +48,38 @@ print(win_rate)
 
 Every SDK method returns API JSON as a Python dictionary.
 
+## Endpoint Coverage
+
+OpenMLBB follows the same route coverage as API routers:
+
+- `academy`: version, heroes, roles, equipment, spells, emblems, ranks, recommendations, ratings
+- `mlbb`: heroes list, rank, positions, details, stats, combos, trends, relations, counters, compatibility
+- `user`: auth, profile, stats, privacy, season, matches, hero matches, friends
+- `addon`: win-rate calculator, IP lookup
+
+See the interactive SDK docs at `https://mlbb.rone.dev/openmlbb` for endpoint-by-endpoint usage examples.
+
+## Common Examples
+
+```python
+from OpenMLBB import OpenMLBB
+
+client = OpenMLBB()
+
+# academy
+academy_version = client.academy.meta_version(size=20, index=1, order="desc", lang="en")
+
+# mlbb
+hero_list = client.mlbb.heroes(size=10, index=1, order="desc", lang="en")
+
+# addon
+wr_calc = client.addon.win_rate_calculator(match_now=100, wr_now=50, wr_future=60)
+
+print(academy_version)
+print(hero_list)
+print(wr_calc)
+```
+
 ## User-Agent
 
 The default `User-Agent` is:

{openmlbb-4.0.3 → openmlbb-4.0.4}/README.md

@@ -36,6 +36,7 @@ This API & Web provides access to hero analytics, in-game performance data, acad
 | Website Home | [mlbb.rone.dev](https://mlbb.rone.dev) | Main landing page with quick access to Demo Website and API Docs. |
 | Tutorial and Blog | [mlbb.rone.dev/blog](https://mlbb.rone.dev/blog) | Guides, tutorials, and release/changelog posts. |
 | Web Playground | [mlbb.rone.dev/web](https://mlbb.rone.dev/web) | Interactive endpoint workspace for executing API requests from browser forms. |
+| OpenMLBB SDK Docs | [mlbb.rone.dev/openmlbb](https://mlbb.rone.dev/openmlbb) | Structured Python SDK docs for academy, mlbb, user, and addon clients with endpoint-level examples. |
 | Swagger UI | [mlbb.rone.dev/api/docs](https://mlbb.rone.dev/api/docs) | OpenAPI-powered docs with live request execution and authorization support. |
 | ReDoc | [mlbb.rone.dev/api/redoc](https://mlbb.rone.dev/api/redoc) | Alternative API documentation view optimized for reference reading. |
 | OpenAPI JSON | [mlbb.rone.dev/api/openapi.json](https://mlbb.rone.dev/api/openapi.json) | Raw OpenAPI schema for tooling, SDK generation, and integrations. |
@@ -60,6 +61,11 @@ https://mlbb.rone.dev/web/user          # User endpoints playground
 https://mlbb.rone.dev/web/mlbb          # MLBB endpoints playground
 https://mlbb.rone.dev/web/academy       # Academy endpoints playground
 https://mlbb.rone.dev/web/addon         # Addon endpoints playground
+https://mlbb.rone.dev/openmlbb          # OpenMLBB docs (redirects to /openmlbb/user)
+https://mlbb.rone.dev/openmlbb/user     # OpenMLBB user client docs
+https://mlbb.rone.dev/openmlbb/mlbb     # OpenMLBB mlbb client docs
+https://mlbb.rone.dev/openmlbb/academy  # OpenMLBB academy client docs
+https://mlbb.rone.dev/openmlbb/addon    # OpenMLBB addon client docs
 https://mlbb.rone.dev/api               # API index/status
 https://mlbb.rone.dev/api/docs          # Swagger UI
 https://mlbb.rone.dev/api/redoc         # ReDoc
@@ -98,15 +104,14 @@ SDK defaults:
 ### Automated Release Rules (4.x.x)
 
 - Workflow file: `.github/workflows/python-publish.yml`
+- Version source for release/tag/PyPI: `API_VERSION` default in `app/core/config.py`
 - Version tags use format: `4.x.x` (no `v` prefix)
 - Push behavior:
-	- Add `[release]` in commit message to trigger publish flow.
-	- Without `[release]`, workflow skips release/tag/publish.
-- Branch behavior when `[release]` is used:
-	- `main` branch creates stable release (`4.0.1`, `4.0.2`, ...)
-	- non-`main` branch creates prerelease (`4.0.1rc1`, `4.0.1rc2`, ...)
-- Manual behavior:
-	- Run `workflow_dispatch` and set `publish=true` for forced release.
+  - `main` branch creates stable GitHub release and publishes to PyPI.
+  - non-`main` branch creates prerelease only when `ENABLE_NON_MAIN_PRERELEASE="true"`.
+- Update process:
+  - Manually set the next version in `app/core/config.py` before pushing release commit.
+  - Workflow still automates release build, tag, GitHub release, and PyPI publish.
 
 ## API Coverage
 

{openmlbb-4.0.3 → openmlbb-4.0.4}/tests/test_web_interface.py

@@ -299,5 +299,112 @@ def test_navbar_includes_tutorial_button() -> None:
     response = client.get("/web/user")
 
     assert response.status_code == 200
-    assert ">Tutorial<" in response.text
+    assert "Tutorial" in response.text
     assert "href=\"/blog\"" in response.text
+
+
+def test_openmlbb_page_is_available() -> None:
+    home_response = client.get("/openmlbb")
+    assert home_response.status_code == 200
+    assert "OpenMLBB SDK" in home_response.text
+    assert "pip install OpenMLBB" in home_response.text
+    assert '/openmlbb/user' in home_response.text
+
+    response = client.get("/openmlbb/academy/meta/version")
+
+    assert response.status_code == 200
+    assert "OpenMLBB SDK Docs" in response.text
+    assert "client.academy.meta_version" in response.text
+    assert "Path and Query Parameters" in response.text
+
+
+def test_openmlbb_group_pages_cover_all_clients() -> None:
+    for group in WEB_GROUPS:
+        response = client.get(f"/openmlbb/{group}")
+        assert response.status_code == 200
+        assert "OpenMLBB" in response.text
+        assert f"/openmlbb/{group}" in response.text
+
+    user_page = client.get("/openmlbb/user")
+    assert user_page.status_code == 200
+    assert "client.user.login" in user_page.text
+
+    mlbb_page = client.get("/openmlbb/mlbb")
+    assert mlbb_page.status_code == 200
+    assert "client.mlbb.heroes" in mlbb_page.text
+
+    addon_page = client.get("/openmlbb/addon")
+    assert addon_page.status_code == 200
+    assert "client.addon.win_rate_calculator" in addon_page.text
+
+
+def test_openmlbb_hub_includes_group_cards_and_copy_button() -> None:
+    response = client.get("/openmlbb")
+
+    assert response.status_code == 200
+    assert 'data-copy-pip-install' in response.text
+    assert '/openmlbb/user' in response.text
+    assert '/openmlbb/mlbb' in response.text
+    assert '/openmlbb/academy' in response.text
+    assert '/openmlbb/addon' in response.text
+
+
+def test_openmlbb_endpoint_card_has_open_only_this_and_show_more() -> None:
+    response = client.get("/openmlbb/academy/meta/version")
+
+    assert response.status_code == 200
+    assert "Open Only This" in response.text
+    assert 'data-desc-toggle' in response.text
+    assert "overflow-hidden" in response.text
+    assert "Show more" in response.text
+
+
+def test_landing_page_highlights_openmlbb_install() -> None:
+    response = client.get("/")
+
+    assert response.status_code == 200
+    assert "pip install OpenMLBB" in response.text
+    assert "Official Python SDK" in response.text
+    assert 'data-copy-pip-install' in response.text
+
+
+def test_blog_list_includes_v4_0_4_release_notes() -> None:
+    response = client.get("/blog")
+
+    assert response.status_code == 200
+    assert "MLBB API Web v4.0.4 Release Notes (3.2.3 -&gt; 4.0.4)" in response.text or "MLBB API Web v4.0.4 Release Notes (3.2.3 -> 4.0.4)" in response.text
+
+
+def test_blog_detail_v4_0_4_release_notes_no_commit_hash() -> None:
+    response = client.get("/blog/mlbb-api-web-v4-0-4-release-notes-3-2-3-4-0-4")
+
+    assert response.status_code == 200
+    assert "Version move: 3.2.3 -&gt; 4.0.4" in response.text or "Version move: 3.2.3 -> 4.0.4" in response.text
+    assert "OpenMLBB SDK documentation" in response.text
+    assert "799250329d76cefce207c7ed425f2606c5d57a62" not in response.text
+
+
+def test_navbar_includes_openmlbb_button_between_card_and_tutorial() -> None:
+    response = client.get("/web/user")
+
+    assert response.status_code == 200
+    card_idx = response.text.find('href="https://mlbb-card.rone.dev"')
+    openmlbb_idx = response.text.find('href="/openmlbb"')
+    tutorial_idx = response.text.find('href="/blog"')
+
+    assert card_idx != -1
+    assert openmlbb_idx != -1
+    assert tutorial_idx != -1
+    assert card_idx < openmlbb_idx < tutorial_idx
+    assert 'href="/openmlbb"' in response.text
+    assert "OpenMLBB" in response.text
+
+
+def test_navbar_group_links_follow_openmlbb_namespace() -> None:
+    response = client.get("/openmlbb/user")
+
+    assert response.status_code == 200
+    assert 'href="/openmlbb/user"' in response.text
+    assert 'href="/openmlbb/mlbb"' in response.text
+    assert 'href="/openmlbb/academy"' in response.text
+    assert 'href="/openmlbb/addon"' in response.text

openmlbb-4.0.3/OpenMLBB/README.md

@@ -1,35 +0,0 @@
-# OpenMLBB Python SDK
-
-OpenMLBB is the official Python SDK for `https://mlbb.rone.dev/api`.
-
-## Install
-
-```bash
-pip install OpenMLBB
-```
-
-## Quick Start
-
-```python
-from OpenMLBB import OpenMLBB
-
-client = OpenMLBB()
-
-heroes = client.mlbb.heroes(size=5, index=1, order="desc", lang="en")
-academy_roles = client.academy.roles(lang="en")
-win_rate = client.addon.win_rate_calculator(match_now=100, wr_now=50, wr_future=60)
-
-print(heroes)
-print(academy_roles)
-print(win_rate)
-```
-
-Every SDK method returns API JSON as a Python dictionary.
-
-## User-Agent
-
-The default `User-Agent` is:
-
-`RoneAI-OpenMLBB-Python-SDK`
-
-You can override it by passing `user_agent=` to `OpenMLBB(...)`.