justoneapi 3.0.81__tar.gz → 3.0.83__tar.gz

{justoneapi-3.0.81/justoneapi.egg-info → justoneapi-3.0.83}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: justoneapi
-Version: 3.0.81
+Version: 3.0.83
 Summary: OpenAPI-driven Python SDK for Just One API
 Author-email: Just One API <support@justoneapi.com>
 Requires-Python: >=3.10
@@ -175,6 +175,7 @@ except BusinessError as exc:
 - [用户发布笔记 (V2)](https://docs.justoneapi.com/zh/api/xiaohongshu-rednote/user-published-notes-v2?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list) <!-- api-operation:GET /api/xiaohongshu/get-user-note-list/v2 -->
 - [用户发布笔记 (V3)](https://docs.justoneapi.com/zh/api/xiaohongshu-rednote/user-published-notes-v3?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list) <!-- api-operation:GET /api/xiaohongshu/get-user-note-list/v3 -->
 - [用户笔记 (V4)](https://docs.justoneapi.com/zh/api/xiaohongshu-rednote/user-notes-v4?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list) <!-- api-operation:GET /api/xiaohongshu/get-user-note-list/v4 --> <sub>[JSON](https://github.com/justoneapi-official/justoneapi-python/blob/main/docs/api-examples/getApiXiaohongshuGetUserNoteListV4.json)</sub>
+- [用户收藏的笔记 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-rednote/user-favorited-notes-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list) <!-- api-operation:GET /api/xiaohongshu/get-user-faved-note-list/v1 -->
 - [笔记详情 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-rednote/note-details-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list) <!-- api-operation:GET /api/xiaohongshu/get-note-detail/v1 --> <sub>[JSON](https://github.com/justoneapi-official/justoneapi-python/blob/main/docs/api-examples/getApiXiaohongshuGetNoteDetailV1.json)</sub>
 - [笔记详情 (V2)](https://docs.justoneapi.com/zh/api/xiaohongshu-rednote/note-details-v2?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list) <!-- api-operation:GET /api/xiaohongshu/get-note-detail/v2 -->
 - [笔记详情 (V3)](https://docs.justoneapi.com/zh/api/xiaohongshu-rednote/note-details-v3?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list) <!-- api-operation:GET /api/xiaohongshu/get-note-detail/v3 -->

{justoneapi-3.0.81 → justoneapi-3.0.83}/README.md

@@ -159,6 +159,7 @@ except BusinessError as exc:
 - [用户发布笔记 (V2)](https://docs.justoneapi.com/zh/api/xiaohongshu-rednote/user-published-notes-v2?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list) <!-- api-operation:GET /api/xiaohongshu/get-user-note-list/v2 -->
 - [用户发布笔记 (V3)](https://docs.justoneapi.com/zh/api/xiaohongshu-rednote/user-published-notes-v3?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list) <!-- api-operation:GET /api/xiaohongshu/get-user-note-list/v3 -->
 - [用户笔记 (V4)](https://docs.justoneapi.com/zh/api/xiaohongshu-rednote/user-notes-v4?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list) <!-- api-operation:GET /api/xiaohongshu/get-user-note-list/v4 --> <sub>[JSON](https://github.com/justoneapi-official/justoneapi-python/blob/main/docs/api-examples/getApiXiaohongshuGetUserNoteListV4.json)</sub>
+- [用户收藏的笔记 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-rednote/user-favorited-notes-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list) <!-- api-operation:GET /api/xiaohongshu/get-user-faved-note-list/v1 -->
 - [笔记详情 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-rednote/note-details-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list) <!-- api-operation:GET /api/xiaohongshu/get-note-detail/v1 --> <sub>[JSON](https://github.com/justoneapi-official/justoneapi-python/blob/main/docs/api-examples/getApiXiaohongshuGetNoteDetailV1.json)</sub>
 - [笔记详情 (V2)](https://docs.justoneapi.com/zh/api/xiaohongshu-rednote/note-details-v2?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list) <!-- api-operation:GET /api/xiaohongshu/get-note-detail/v2 -->
 - [笔记详情 (V3)](https://docs.justoneapi.com/zh/api/xiaohongshu-rednote/note-details-v3?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list) <!-- api-operation:GET /api/xiaohongshu/get-note-detail/v3 -->

justoneapi-3.0.83/justoneapi/_version.py

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

{justoneapi-3.0.81 → justoneapi-3.0.83}/justoneapi/generated/resources/__init__.py

@@ -17,7 +17,6 @@ from justoneapi.generated.resources.jd import JdResource
 from justoneapi.generated.resources.kuaishou import KuaishouResource
 from justoneapi.generated.resources.linkedin import LinkedinResource
 from justoneapi.generated.resources.llm import LlmResource
-from justoneapi.generated.resources.pixabay import PixabayResource
 from justoneapi.generated.resources.qq_huxuan import QqHuxuanResource
 from justoneapi.generated.resources.reddit import RedditResource
 from justoneapi.generated.resources.search import SearchResource
@@ -28,7 +27,6 @@ from justoneapi.generated.resources.tiktok import TiktokResource
 from justoneapi.generated.resources.tiktok_shop import TiktokShopResource
 from justoneapi.generated.resources.toutiao import ToutiaoResource
 from justoneapi.generated.resources.twitter import TwitterResource
-from justoneapi.generated.resources.vcg import VcgResource
 from justoneapi.generated.resources.weibo import WeiboResource
 from justoneapi.generated.resources.weixin import WeixinResource
 from justoneapi.generated.resources.weixin_channels import WeixinChannelsResource
@@ -59,7 +57,6 @@ RESOURCE_CLASSES = {
     "kuaishou": KuaishouResource,
     "linkedin": LinkedinResource,
     "llm": LlmResource,
-    "pixabay": PixabayResource,
     "qq_huxuan": QqHuxuanResource,
     "reddit": RedditResource,
     "search": SearchResource,
@@ -70,7 +67,6 @@ RESOURCE_CLASSES = {
     "tiktok_shop": TiktokShopResource,
     "toutiao": ToutiaoResource,
     "twitter": TwitterResource,
-    "vcg": VcgResource,
     "weibo": WeiboResource,
     "weixin": WeixinResource,
     "weixin_channels": WeixinChannelsResource,
@@ -102,7 +98,6 @@ __all__ = [
     "KuaishouResource",
     "LinkedinResource",
     "LlmResource",
-    "PixabayResource",
     "QqHuxuanResource",
     "RedditResource",
     "SearchResource",
@@ -113,7 +108,6 @@ __all__ = [
     "TiktokShopResource",
     "ToutiaoResource",
     "TwitterResource",
-    "VcgResource",
     "WeiboResource",
     "WeixinResource",
     "WeixinChannelsResource",

{justoneapi-3.0.81 → justoneapi-3.0.83}/justoneapi/generated/resources/xiaohongshu.py

@@ -337,6 +337,29 @@ class XiaohongshuResource(BaseResource):
             },
         )
 
+    def get_user_faved_note_list_v1(
+        self,
+        *,
+        user_id: str,
+        last_cursor: str | None = "",
+    ) -> ApiResponse[Any]:
+        """
+        User Favorited Notes
+
+        Retrieves a Xiaohongshu (RedNote) user's favorited notes by user ID with cursor pagination. Use it to review a user's saved content and research content interests.
+
+        Args:
+            user_id: Unique user identifier on Xiaohongshu.
+            last_cursor: For the next page, pass the cursor from the previous response. Omit or pass an empty value for the first page.
+        """
+        return self._get(
+            "/api/xiaohongshu/get-user-faved-note-list/v1",
+            {
+                "userId": user_id,
+                "lastCursor": last_cursor,
+            },
+        )
+
     def get_note_detail_v1(
         self,
         *,

{justoneapi-3.0.81 → justoneapi-3.0.83/justoneapi.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: justoneapi
-Version: 3.0.81
+Version: 3.0.83
 Summary: OpenAPI-driven Python SDK for Just One API
 Author-email: Just One API <support@justoneapi.com>
 Requires-Python: >=3.10
@@ -175,6 +175,7 @@ except BusinessError as exc:
 - [用户发布笔记 (V2)](https://docs.justoneapi.com/zh/api/xiaohongshu-rednote/user-published-notes-v2?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list) <!-- api-operation:GET /api/xiaohongshu/get-user-note-list/v2 -->
 - [用户发布笔记 (V3)](https://docs.justoneapi.com/zh/api/xiaohongshu-rednote/user-published-notes-v3?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list) <!-- api-operation:GET /api/xiaohongshu/get-user-note-list/v3 -->
 - [用户笔记 (V4)](https://docs.justoneapi.com/zh/api/xiaohongshu-rednote/user-notes-v4?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list) <!-- api-operation:GET /api/xiaohongshu/get-user-note-list/v4 --> <sub>[JSON](https://github.com/justoneapi-official/justoneapi-python/blob/main/docs/api-examples/getApiXiaohongshuGetUserNoteListV4.json)</sub>
+- [用户收藏的笔记 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-rednote/user-favorited-notes-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list) <!-- api-operation:GET /api/xiaohongshu/get-user-faved-note-list/v1 -->
 - [笔记详情 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-rednote/note-details-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list) <!-- api-operation:GET /api/xiaohongshu/get-note-detail/v1 --> <sub>[JSON](https://github.com/justoneapi-official/justoneapi-python/blob/main/docs/api-examples/getApiXiaohongshuGetNoteDetailV1.json)</sub>
 - [笔记详情 (V2)](https://docs.justoneapi.com/zh/api/xiaohongshu-rednote/note-details-v2?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list) <!-- api-operation:GET /api/xiaohongshu/get-note-detail/v2 -->
 - [笔记详情 (V3)](https://docs.justoneapi.com/zh/api/xiaohongshu-rednote/note-details-v3?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list) <!-- api-operation:GET /api/xiaohongshu/get-note-detail/v3 -->

{justoneapi-3.0.81 → justoneapi-3.0.83}/justoneapi.egg-info/SOURCES.txt

@@ -36,7 +36,6 @@ justoneapi/generated/resources/jd.py
 justoneapi/generated/resources/kuaishou.py
 justoneapi/generated/resources/linkedin.py
 justoneapi/generated/resources/llm.py
-justoneapi/generated/resources/pixabay.py
 justoneapi/generated/resources/qq_huxuan.py
 justoneapi/generated/resources/reddit.py
 justoneapi/generated/resources/search.py
@@ -47,7 +46,6 @@ justoneapi/generated/resources/tiktok.py
 justoneapi/generated/resources/tiktok_shop.py
 justoneapi/generated/resources/toutiao.py
 justoneapi/generated/resources/twitter.py
-justoneapi/generated/resources/vcg.py
 justoneapi/generated/resources/weibo.py
 justoneapi/generated/resources/weixin.py
 justoneapi/generated/resources/weixin_channels.py

{justoneapi-3.0.81 → justoneapi-3.0.83}/tests/test_codegen.py

@@ -1,10 +1,16 @@
 from __future__ import annotations
 
+import json
 from pathlib import Path
 
+import httpx
+import pytest
+
+from tools import sdk_codegen
 from tools.sdk_codegen import (
     build_diff_summary,
     collect_resources,
+    fetch_openapi,
     load_json,
     load_overrides,
     normalize_spec,
@@ -14,6 +20,111 @@ RAW_SPEC_PATH = Path("openapi/public-api.json")
 OVERRIDES_PATH = Path("openapi/sdk_overrides.yaml")
 
 
+@pytest.fixture
+def mock_openapi_fetch(monkeypatch):
+    outcomes = []
+    requests = []
+    delays = []
+
+    def handle(request):
+        requests.append(request)
+        outcome = outcomes.pop(0)
+        if isinstance(outcome, Exception):
+            raise outcome
+        return outcome
+
+    client_type = httpx.Client
+    monkeypatch.setattr(
+        sdk_codegen.httpx,
+        "Client",
+        lambda **kwargs: client_type(transport=httpx.MockTransport(handle), **kwargs),
+    )
+    monkeypatch.setattr(sdk_codegen.time, "sleep", delays.append)
+    return outcomes, requests, delays
+
+
+@pytest.mark.parametrize("timeout_type", [httpx.ConnectTimeout, httpx.ReadTimeout])
+@pytest.mark.parametrize("timeouts_before_success", [0, 1, 2])
+def test_fetch_openapi_recovers_from_temporary_timeouts(
+    mock_openapi_fetch, timeout_type, timeouts_before_success
+):
+    outcomes, requests, delays = mock_openapi_fetch
+    spec = {"openapi": "3.0.3", "paths": {}}
+    outcomes.extend(
+        timeout_type("Temporary timeout") for _ in range(timeouts_before_success)
+    )
+    outcomes.append(httpx.Response(200, json=spec))
+
+    assert (
+        fetch_openapi("https://example.test/openapi", "test-user", "test-pass") == spec
+    )
+
+    assert len(requests) == timeouts_before_success + 1
+    assert delays == [2, 4][:timeouts_before_success]
+    assert all(request.method == "GET" for request in requests)
+    assert all(
+        request.headers["authorization"] == requests[0].headers["authorization"]
+        for request in requests
+    )
+
+
+@pytest.mark.parametrize("timeout_type", [httpx.ConnectTimeout, httpx.ReadTimeout])
+def test_fetch_openapi_raises_after_three_timeouts(mock_openapi_fetch, timeout_type):
+    outcomes, requests, delays = mock_openapi_fetch
+    last_error = timeout_type("Still unavailable")
+    outcomes.extend(
+        [
+            timeout_type("Temporary timeout"),
+            timeout_type("Temporary timeout"),
+            last_error,
+        ]
+    )
+
+    with pytest.raises(timeout_type) as caught:
+        fetch_openapi("https://example.test/openapi", "test-user", "test-pass")
+
+    assert caught.value is last_error
+    assert len(requests) == 3
+    assert delays == [2, 4]
+
+
+@pytest.mark.parametrize("status_code", [401, 503])
+def test_fetch_openapi_does_not_retry_http_errors(mock_openapi_fetch, status_code):
+    outcomes, requests, delays = mock_openapi_fetch
+    outcomes.append(httpx.Response(status_code))
+
+    with pytest.raises(httpx.HTTPStatusError):
+        fetch_openapi("https://example.test/openapi", "test-user", "test-pass")
+
+    assert len(requests) == 1
+    assert delays == []
+
+
+def test_fetch_openapi_does_not_retry_invalid_json(mock_openapi_fetch):
+    outcomes, requests, delays = mock_openapi_fetch
+    outcomes.append(httpx.Response(200, text="not JSON"))
+
+    with pytest.raises(json.JSONDecodeError):
+        fetch_openapi("https://example.test/openapi", "test-user", "test-pass")
+
+    assert len(requests) == 1
+    assert delays == []
+
+
+@pytest.mark.parametrize("error_type", [httpx.ConnectError, httpx.WriteTimeout])
+def test_fetch_openapi_does_not_retry_other_transport_errors(
+    mock_openapi_fetch, error_type
+):
+    outcomes, requests, delays = mock_openapi_fetch
+    outcomes.append(error_type("Non-retryable transport failure"))
+
+    with pytest.raises(error_type):
+        fetch_openapi("https://example.test/openapi", "test-user", "test-pass")
+
+    assert len(requests) == 1
+    assert delays == []
+
+
 def count_operations(spec: dict) -> int:
     return sum(
         1

justoneapi-3.0.81/justoneapi/_version.py

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

justoneapi-3.0.81/justoneapi/generated/resources/pixabay.py

@@ -1,39 +0,0 @@
-from __future__ import annotations
-
-from typing import Any
-
-from justoneapi._resource import BaseResource
-from justoneapi._response import ApiResponse
-
-
-class PixabayResource(BaseResource):
-    """Generated resource for Pixabay."""
-
-    def search_image_v1(
-        self,
-        *,
-        keyword: str,
-        limit: str | None = None,
-        start_page: str | None = None,
-        max_pages: str | None = None,
-    ) -> ApiResponse[Any]:
-        """
-        Photo Search
-
-        Searches public Pixabay photo result pages by keyword with a requested image count and page controls. Each result includes its Pixabay photo page, public contributor information when shown, and a source-provided image URL.
-
-        Args:
-            keyword: Photo search keyword, up to 100 characters without control characters.
-            limit: Maximum number of unique photos to return.
-            start_page: First result page to search, starting from 1.
-            max_pages: Maximum number of pages to visit in this request. The last page must not exceed 10000.
-        """
-        return self._get(
-            "/api/pixabay/search-image/v1",
-            {
-                "keyword": keyword,
-                "limit": limit,
-                "startPage": start_page,
-                "maxPages": max_pages,
-            },
-        )

justoneapi-3.0.81/justoneapi/generated/resources/vcg.py

@@ -1,48 +0,0 @@
-from __future__ import annotations
-
-from typing import Any
-
-from justoneapi._resource import BaseResource
-from justoneapi._response import ApiResponse
-
-
-class VcgResource(BaseResource):
-    """Generated resource for VCG."""
-
-    def search_image_v1(
-        self,
-        *,
-        keyword: str,
-        limit: str | None = None,
-        start_page: str | None = None,
-        max_pages: str | None = None,
-        exclude_resource_ids: list[Any] | None = None,
-        content_filter: str | None = "all",
-        result_mode: str | None = "full",
-    ) -> ApiResponse[Any]:
-        """
-        Image Search
-
-        Searches VCG images by keyword with page controls, resource ID exclusions, and an optional 500px Select/Prime filter excluding AIGC. Use full image details for collection or candidate_ids for single-page ID inspection.
-
-        Args:
-            keyword: Image search keyword, up to 200 characters without control characters.
-            limit: Maximum number of unique images to return, excluding the supplied resource IDs.
-            start_page: First page to search, starting from 1. For continuation, use the next page returned by the previous request.
-            max_pages: Maximum number of pages to visit in this request. The last requested page must not exceed 10000.
-            exclude_resource_ids: Previously collected VCG resource IDs to exclude when continuing a search. Supply comma-separated IDs or repeat this query parameter.
-            content_filter: Optional brand and AIGC search restriction. Keep this value unchanged across pagination and continuation.  Available Values: - `all`: Keep the default search without additional brand or AIGC filters. - `selected_500px_no_aigc`: Select only 500px Select and 500px Prime, exclude AIGC using the site's filter, and retain best ordering. Do not expand to other brands when results run out.
-            result_mode: Result mode: full returns normal image details; candidate_ids only inspects one page of resource IDs and requires limit 10000, maxPages 1, and no excluded resource IDs. A candidate inspection does not complete or advance an image search.  Available Values: - `full`: Return the normal image search result with complete image details. - `candidate_ids`: Inspect resource IDs from one validated search page without image details. Requires limit 10000, maxPages 1, and no excluded resource IDs; this is not an image result or a completion receipt.
-        """
-        return self._get(
-            "/api/vcg/search-image/v1",
-            {
-                "keyword": keyword,
-                "limit": limit,
-                "startPage": start_page,
-                "maxPages": max_pages,
-                "excludeResourceIds": exclude_resource_ids,
-                "contentFilter": content_filter,
-                "resultMode": result_mode,
-            },
-        )