chore: add get secret to stainless (#7833)

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 115
+configured_endpoints: 116
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai%2Frunloop-563a11030291b5dd44e1b1b917e3e7bb865d7c873bf49c82056bfade22166843.yml
 openapi_spec_hash: 20770e5f6ed8370fc14ff0e1351ccffc
-config_hash: 12de9459ff629b6a3072a75b236b7b70
+config_hash: 436c8d4e665915db22b5d98fe58382c1

api.md

@@ -381,6 +381,7 @@ from runloop_api_client.types import (
 Methods:
 
 - <code title="post /v1/secrets">client.secrets.<a href="./src/runloop_api_client/resources/secrets.py">create</a>(\*\*<a href="src/runloop_api_client/types/secret_create_params.py">params</a>) -> <a href="./src/runloop_api_client/types/secret_view.py">SecretView</a></code>
+- <code title="get /v1/secrets/{name}">client.secrets.<a href="./src/runloop_api_client/resources/secrets.py">retrieve</a>(name) -> <a href="./src/runloop_api_client/types/secret_view.py">SecretView</a></code>
 - <code title="post /v1/secrets/{name}">client.secrets.<a href="./src/runloop_api_client/resources/secrets.py">update</a>(name, \*\*<a href="src/runloop_api_client/types/secret_update_params.py">params</a>) -> <a href="./src/runloop_api_client/types/secret_view.py">SecretView</a></code>
 - <code title="get /v1/secrets">client.secrets.<a href="./src/runloop_api_client/resources/secrets.py">list</a>(\*\*<a href="src/runloop_api_client/types/secret_list_params.py">params</a>) -> <a href="./src/runloop_api_client/types/secret_list_view.py">SecretListView</a></code>
 - <code title="post /v1/secrets/{name}/delete">client.secrets.<a href="./src/runloop_api_client/resources/secrets.py">delete</a>(name) -> <a href="./src/runloop_api_client/types/secret_view.py">SecretView</a></code>

src/runloop_api_client/resources/secrets.py

@@ -100,13 +100,17 @@ def retrieve(
         self,
         name: str,
         *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SecretView:
         """Retrieve a Secret by name.
 
+        The secret value is not included for security.
+
         Args:
           extra_headers: Send extra headers
 
@@ -119,12 +123,9 @@ def retrieve(
         if not name:
             raise ValueError(f"Expected a non-empty value for `name` but received {name!r}")
         return self._get(
-            f"/v1/secrets/{name}",
+            path_template("/v1/secrets/{name}", name=name),
             options=make_request_options(
-                extra_headers=extra_headers,
-                extra_query=extra_query,
-                extra_body=extra_body,
-                timeout=timeout,
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
             cast_to=SecretView,
         )
@@ -336,13 +337,17 @@ async def retrieve(
         self,
         name: str,
         *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SecretView:
         """Retrieve a Secret by name.
 
+        The secret value is not included for security.
+
         Args:
           extra_headers: Send extra headers
 
@@ -355,12 +360,9 @@ async def retrieve(
         if not name:
             raise ValueError(f"Expected a non-empty value for `name` but received {name!r}")
         return await self._get(
-            f"/v1/secrets/{name}",
+            path_template("/v1/secrets/{name}", name=name),
             options=make_request_options(
-                extra_headers=extra_headers,
-                extra_query=extra_query,
-                extra_body=extra_body,
-                timeout=timeout,
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
             cast_to=SecretView,
         )

tests/api_resources/test_secrets.py

@@ -54,6 +54,44 @@ def test_streaming_response_create(self, client: Runloop) -> None:
 
         assert cast(Any, response.is_closed) is True
 
+    @parametrize
+    def test_method_retrieve(self, client: Runloop) -> None:
+        secret = client.secrets.retrieve(
+            "name",
+        )
+        assert_matches_type(SecretView, secret, path=["response"])
+
+    @parametrize
+    def test_raw_response_retrieve(self, client: Runloop) -> None:
+        response = client.secrets.with_raw_response.retrieve(
+            "name",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        secret = response.parse()
+        assert_matches_type(SecretView, secret, path=["response"])
+
+    @parametrize
+    def test_streaming_response_retrieve(self, client: Runloop) -> None:
+        with client.secrets.with_streaming_response.retrieve(
+            "name",
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            secret = response.parse()
+            assert_matches_type(SecretView, secret, path=["response"])
+
+        assert cast(Any, response.is_closed) is True
+
+    @parametrize
+    def test_path_params_retrieve(self, client: Runloop) -> None:
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `name` but received ''"):
+            client.secrets.with_raw_response.retrieve(
+                "",
+            )
+
     @parametrize
     def test_method_update(self, client: Runloop) -> None:
         secret = client.secrets.update(
@@ -206,6 +244,44 @@ async def test_streaming_response_create(self, async_client: AsyncRunloop) -> No
 
         assert cast(Any, response.is_closed) is True
 
+    @parametrize
+    async def test_method_retrieve(self, async_client: AsyncRunloop) -> None:
+        secret = await async_client.secrets.retrieve(
+            "name",
+        )
+        assert_matches_type(SecretView, secret, path=["response"])
+
+    @parametrize
+    async def test_raw_response_retrieve(self, async_client: AsyncRunloop) -> None:
+        response = await async_client.secrets.with_raw_response.retrieve(
+            "name",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        secret = await response.parse()
+        assert_matches_type(SecretView, secret, path=["response"])
+
+    @parametrize
+    async def test_streaming_response_retrieve(self, async_client: AsyncRunloop) -> None:
+        async with async_client.secrets.with_streaming_response.retrieve(
+            "name",
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            secret = await response.parse()
+            assert_matches_type(SecretView, secret, path=["response"])
+
+        assert cast(Any, response.is_closed) is True
+
+    @parametrize
+    async def test_path_params_retrieve(self, async_client: AsyncRunloop) -> None:
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `name` but received ''"):
+            await async_client.secrets.with_raw_response.retrieve(
+                "",
+            )
+
     @parametrize
     async def test_method_update(self, async_client: AsyncRunloop) -> None:
         secret = await async_client.secrets.update(