# Copyright 2026 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
# pyformat: disable
# pylint: skip-file

"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""

from .basesdk import AsyncBaseSDK, BaseSDK
from . import errors, models, types, utils
from ._hooks import AfterParseErrorContext, HookContext, ResponseContext
from .types import OptionalNullable, UNSET, environments
from .utils import get_security_from_env, response_helpers
from .utils.unmarshal_json_response import unmarshal_json_response
import httpx
from typing import Any, Mapping, Optional, Union, cast


class Files(BaseSDK):
    @property
    def with_raw_response(self):
        return FilesWithRawResponse(self)

    @property
    def with_streaming_response(self):
        return FilesWithStreamingResponse(self)

    def list(
        self,
        environment: str,
        path: str,
        *,
        api_version: Optional[str] = None,
        page_size: Optional[int] = None,
        page_token: Optional[str] = None,
        recursive: Optional[bool] = None,
        extra_headers: Optional[Mapping[str, str]] = None,
        extra_query: Optional[Mapping[str, Any]] = None,
        timeout: Optional[Union[float, httpx.Timeout]] = None,
    ) -> environments.GetEnvironmentFilesResponse:
        r"""Retrieves file metadata or directory contents from an environment's snapshot. To download file contents directly, pass ?alt=media or use the files.download helper.

        :param environment:
        :param path:
        :param api_version: Which version of the API to use.
        :param page_size: Optional. Maximum number of entries to return per page (for directory listing).
        :param page_token: Optional. Pagination token for directory listing.
        :param recursive: Optional. If true and the path is a directory, recursively lists all files.
        :param extra_headers: Additional headers to set or replace on requests.
        :param extra_query: Additional query parameters to append to requests.
        :param timeout: Override the default request timeout configuration for this method in seconds
        """
        base_url = None
        url_variables = None
        retries: OptionalNullable[utils.RetryConfig] = UNSET
        server_url = None
        http_headers = extra_headers
        timeout_ms = self._coerce_timeout_ms(timeout)
        if timeout_ms is None:
            timeout_ms = self.sdk_configuration.timeout_ms

        if server_url is not None:
            base_url = server_url
        else:
            base_url = self._get_url(base_url, url_variables)

        request = models.GetEnvironmentFilesRequest(
            api_version=api_version,
            environment=environment,
            path=path,
            page_size=page_size,
            page_token=page_token,
            recursive=recursive,
        )

        _speakeasy_response_mode, http_headers = response_helpers.consume_response_mode(
            http_headers
        )
        req = self._build_request(
            method="GET",
            path="/{api_version}/environments/{environment}/files/{path}",
            base_url=base_url,
            url_variables=url_variables,
            request=request,
            request_body_required=False,
            request_has_path_params=True,
            request_has_query_params=True,
            user_agent_header="user-agent",
            accept_header_value="application/json",
            http_headers=http_headers,
            extra_query_params=extra_query,
            _globals=models.GetEnvironmentFilesGlobals(
                api_version=self.sdk_configuration.globals.api_version,
            ),
            security=self.sdk_configuration.security,
            allow_empty_value=None,
            timeout_ms=timeout_ms,
        )

        if retries == UNSET:
            if self.sdk_configuration.retry_config is not UNSET:
                retries = self.sdk_configuration.retry_config
            else:
                retries = utils.RetryConfig(
                    "attempt-count-backoff",
                    utils.BackoffStrategy(500, 8000, 2, 30000),
                    True,
                    max_retries=4,
                )

        retry_config = None
        if isinstance(retries, utils.RetryConfig):
            retry_config = (retries, ["408", "409", "429", "5XX"])

        def _speakeasy_parse_response(http_res):
            if utils.match_response(http_res, "200", "application/json"):
                return unmarshal_json_response(
                    environments.GetEnvironmentFilesResponse, http_res, validate=False
                )
            if utils.match_response(http_res, "4XX", "*"):
                http_res_text = utils.stream_to_text(http_res)
                raise errors.GenAiDefaultError(
                    "API error occurred", http_res, http_res_text
                )
            if utils.match_response(http_res, "5XX", "*"):
                http_res_text = utils.stream_to_text(http_res)
                raise errors.GenAiDefaultError(
                    "API error occurred", http_res, http_res_text
                )

            raise errors.GenAiDefaultError("Unexpected response received", http_res)

        _speakeasy_hook_ctx = HookContext(
            config=self.sdk_configuration,
            base_url=base_url or "",
            operation_id="GetEnvironmentFiles",
            oauth2_scopes=None,
            security_source=get_security_from_env(
                self.sdk_configuration.security, types.Security
            ),
            tags=None,
            extensions={
                "x-codeSamples": [
                    {
                        "label": "list_files",
                        "lang": "sh",
                        "source": "curl -X GET 'https://generativelanguage.googleapis.com/v1beta/environments/env_abc123/files/src' \\\n  -H \"x-goog-api-key: $GEMINI_API_KEY\"\n",
                    },
                    {
                        "label": "list_files",
                        "lang": "python",
                        "source": 'from google import genai\n\nclient = genai.Client()\n\n# [setup]\ncreated = client.environments.create(\n    sources=[{"type": "inline", "target": "src/main.py", "content": "print(\'Hello\')"}]\n)\n# [/setup]\n\nresponse = client.environments.files.list(\n    environment=created.id,\n    path="src",\n)\nfor file in response.files or []:\n    print(file.name, file.type, file.size_bytes)\n\n# [cleanup]\nclient.environments.delete(id=created.id)\n# [/cleanup]\n',
                    },
                    {
                        "label": "list_files",
                        "lang": "javascript",
                        "source": "import {GoogleGenAI} from '@google/genai';\n\nconst ai = new GoogleGenAI({});\n\n// [setup]\nconst created = await ai.environments.create({\n    sources: [{type: 'inline', target: 'src/main.py', content: \"print('Hello')\"}],\n});\nif (!created.id) throw new Error('Failed to create environment');\n// [/setup]\n\nconst response = await ai.environments.files.list({\n    environment: created.id,\n    path: 'src',\n});\nfor (const file of (response.files ?? [])) {\n    console.log(file.name, file.type, file.size_bytes);\n}\n\n// [cleanup]\nawait ai.environments.delete(created.id);\n// [/cleanup]\n",
                    },
                    {
                        "label": "list_files",
                        "lang": "java",
                        "source": 'import com.google.genai.Client;\nimport com.google.genai.gaos.models.environments.CreateEnvironmentRequest;\nimport com.google.genai.gaos.models.environments.Environment;\nimport com.google.genai.gaos.models.environments.EnvironmentFile;\nimport com.google.genai.gaos.models.environments.GetEnvironmentFilesResponse;\nimport com.google.genai.gaos.models.interactions.Source;\nimport com.google.genai.gaos.models.interactions.SourceType;\nimport com.google.genai.gaos.models.operations.GetEnvironmentFilesRequest;\nimport java.util.List;\n\nClient client = new Client();\n\n// [setup]\nCreateEnvironmentRequest createReq = CreateEnvironmentRequest.builder()\n    .sources(List.of(Source.builder()\n        .type(SourceType.INLINE)\n        .target("src/main.py")\n        .content("print(\'Hello\')")\n        .build()))\n    .build();\nEnvironment created = client.environments.createEnvironment(createReq).environment().orElseThrow();\nString envId = created.id().orElseThrow();\n// [/setup]\n\ncom.google.genai.gaos.models.operations.GetEnvironmentFilesResponse response = client.environments.files().list(\n    GetEnvironmentFilesRequest.builder()\n        .environment(envId)\n        .path("src")\n        .build());\nGetEnvironmentFilesResponse filesResponse = response.getEnvironmentFilesResponse().orElseThrow();\nfor (EnvironmentFile file : filesResponse.files().orElse(List.of())) {\n    System.out.println(file.name().orElse("") + " " + file.type().map(Object::toString).orElse("") + " " + file.sizeBytes().orElse(""));\n}\n\n// [cleanup]\nclient.environments.deleteEnvironment(envId);\n// [/cleanup]\n',
                    },
                    {
                        "label": "get_file",
                        "lang": "sh",
                        "source": "curl -X GET 'https://generativelanguage.googleapis.com/v1beta/environments/env_abc123/files/main.py' \\\n  -H \"x-goog-api-key: $GEMINI_API_KEY\"\n",
                    },
                    {
                        "label": "get_file",
                        "lang": "python",
                        "source": 'from google import genai\n\nclient = genai.Client()\n\n# [setup]\ncreated = client.environments.create(\n    sources=[{"type": "inline", "target": "main.py", "content": "print(\'Hello\')"}]\n)\n# [/setup]\n\nresponse = client.environments.files.get(\n    environment=created.id,\n    path="main.py",\n)\nfor file in response.files or []:\n    print(file.name, file.size_bytes)\n\n# [cleanup]\nclient.environments.delete(id=created.id)\n# [/cleanup]\n',
                    },
                    {
                        "label": "get_file",
                        "lang": "javascript",
                        "source": "import {GoogleGenAI} from '@google/genai';\n\nconst ai = new GoogleGenAI({});\n\n// [setup]\nconst created = await ai.environments.create({\n    sources: [{type: 'inline', target: 'main.py', content: \"print('Hello')\"}],\n});\nif (!created.id) throw new Error('Failed to create environment');\n// [/setup]\n\nconst response = await ai.environments.files.list({\n    environment: created.id,\n    path: 'main.py',\n});\nfor (const file of (response.files ?? [])) {\n    console.log(file.name, file.size_bytes);\n}\n\n// [cleanup]\nawait ai.environments.delete(created.id);\n// [/cleanup]\n",
                    },
                    {
                        "label": "get_file",
                        "lang": "java",
                        "source": 'import com.google.genai.Client;\nimport com.google.genai.gaos.models.environments.CreateEnvironmentRequest;\nimport com.google.genai.gaos.models.environments.Environment;\nimport com.google.genai.gaos.models.environments.EnvironmentFile;\nimport com.google.genai.gaos.models.environments.GetEnvironmentFilesResponse;\nimport com.google.genai.gaos.models.interactions.Source;\nimport com.google.genai.gaos.models.interactions.SourceType;\nimport com.google.genai.gaos.models.operations.GetEnvironmentFilesRequest;\nimport java.util.List;\n\nClient client = new Client();\n\n// [setup]\nCreateEnvironmentRequest createReq = CreateEnvironmentRequest.builder()\n    .sources(List.of(Source.builder()\n        .type(SourceType.INLINE)\n        .target("main.py")\n        .content("print(\'Hello\')")\n        .build()))\n    .build();\nEnvironment created = client.environments.createEnvironment(createReq).environment().orElseThrow();\nString envId = created.id().orElseThrow();\n// [/setup]\n\ncom.google.genai.gaos.models.operations.GetEnvironmentFilesResponse response = client.environments.files().list(\n    GetEnvironmentFilesRequest.builder()\n        .environment(envId)\n        .path("main.py")\n        .build());\nGetEnvironmentFilesResponse filesResponse = response.getEnvironmentFilesResponse().orElseThrow();\nfor (EnvironmentFile file : filesResponse.files().orElse(List.of())) {\n    System.out.println(file.name().orElse("") + " " + file.sizeBytes().orElse(""));\n}\n\n// [cleanup]\nclient.environments.deleteEnvironment(envId);\n// [/cleanup]\n',
                    },
                    {
                        "label": "download_file",
                        "lang": "sh",
                        "source": "curl -X GET 'https://generativelanguage.googleapis.com/v1beta/environments/env_abc123/files/src/main.py?alt=media' \\\n  -H \"x-goog-api-key: $GEMINI_API_KEY\" \\\n  --output main.py\n",
                    },
                    {
                        "label": "download_file",
                        "lang": "python",
                        "source": 'from google import genai\n\nclient = genai.Client()\n\n# [setup]\ncreated = client.environments.create(\n    sources=[{"type": "inline", "target": "src/main.py", "content": "print(\'Hello\')"}]\n)\n# [/setup]\n\ncontent = client.environments.files.download(\n    environment=created.id,\n    path="src/main.py",\n)\nprint(content.decode("utf-8"))\n\n# [cleanup]\nclient.environments.delete(id=created.id)\n# [/cleanup]\n',
                    },
                ]
            },
            response=ResponseContext(mode=_speakeasy_response_mode, execution="sync"),
        )
        http_res = self.do_request(
            hook_ctx=_speakeasy_hook_ctx,
            request=req,
            is_error_status_code=lambda c: utils.match_status_codes(["4XX", "5XX"], c),
            stream=_speakeasy_response_mode == "streaming",
            retry_config=retry_config,
        )
        if _speakeasy_response_mode != "parsed":
            if utils.match_status_codes(["4XX", "5XX"], http_res.status_code):
                http_res.read()
                try:
                    _speakeasy_parse_response(http_res)
                except Exception as parse_exc_:
                    response_helpers.raise_parse_error(
                        self.sdk_configuration.__dict__["_hooks"],
                        AfterParseErrorContext(_speakeasy_hook_ctx),
                        http_res,
                        parse_exc_,
                    )
            _speakeasy_response_cls = (
                response_helpers.StreamedAPIResponse
                if _speakeasy_response_mode == "streaming"
                else response_helpers.APIResponse
            )
            return cast(
                Any,
                _speakeasy_response_cls(
                    raw=http_res,
                    parser=_speakeasy_parse_response,
                    mode="buffered",
                    client_ref=self,
                    hook_ctx=AfterParseErrorContext(_speakeasy_hook_ctx),
                    hooks=self.sdk_configuration.__dict__.get("_hooks"),
                ),
            )
        try:
            return _speakeasy_parse_response(http_res)
        except Exception as parse_exc_:
            response_helpers.raise_parse_error(
                self.sdk_configuration.__dict__["_hooks"],
                AfterParseErrorContext(_speakeasy_hook_ctx),
                http_res,
                parse_exc_,
            )


class FilesWithRawResponse:
    def __init__(self, sdk: Files) -> None:
        self._sdk = sdk
        self.list = response_helpers.to_raw_response_wrapper(sdk.list, "extra_headers")


class FilesWithStreamingResponse:
    def __init__(self, sdk: Files) -> None:
        self._sdk = sdk
        self.list = response_helpers.to_streamed_response_wrapper(
            sdk.list, "extra_headers"
        )


class AsyncFiles(AsyncBaseSDK):
    @property
    def with_raw_response(self):
        return AsyncFilesWithRawResponse(self)

    @property
    def with_streaming_response(self):
        return AsyncFilesWithStreamingResponse(self)

    async def list(
        self,
        environment: str,
        path: str,
        *,
        api_version: Optional[str] = None,
        page_size: Optional[int] = None,
        page_token: Optional[str] = None,
        recursive: Optional[bool] = None,
        extra_headers: Optional[Mapping[str, str]] = None,
        extra_query: Optional[Mapping[str, Any]] = None,
        timeout: Optional[Union[float, httpx.Timeout]] = None,
    ) -> environments.GetEnvironmentFilesResponse:
        r"""Retrieves file metadata or directory contents from an environment's snapshot. To download file contents directly, pass ?alt=media or use the files.download helper.

        :param environment:
        :param path:
        :param api_version: Which version of the API to use.
        :param page_size: Optional. Maximum number of entries to return per page (for directory listing).
        :param page_token: Optional. Pagination token for directory listing.
        :param recursive: Optional. If true and the path is a directory, recursively lists all files.
        :param extra_headers: Additional headers to set or replace on requests.
        :param extra_query: Additional query parameters to append to requests.
        :param timeout: Override the default request timeout configuration for this method in seconds
        """
        base_url = None
        url_variables = None
        retries: OptionalNullable[utils.RetryConfig] = UNSET
        server_url = None
        http_headers = extra_headers
        timeout_ms = self._coerce_timeout_ms(timeout)
        if timeout_ms is None:
            timeout_ms = self.sdk_configuration.timeout_ms

        if server_url is not None:
            base_url = server_url
        else:
            base_url = self._get_url(base_url, url_variables)

        request = models.GetEnvironmentFilesRequest(
            api_version=api_version,
            environment=environment,
            path=path,
            page_size=page_size,
            page_token=page_token,
            recursive=recursive,
        )

        _speakeasy_response_mode, http_headers = response_helpers.consume_response_mode(
            http_headers
        )
        req = self._build_request_async(
            method="GET",
            path="/{api_version}/environments/{environment}/files/{path}",
            base_url=base_url,
            url_variables=url_variables,
            request=request,
            request_body_required=False,
            request_has_path_params=True,
            request_has_query_params=True,
            user_agent_header="user-agent",
            accept_header_value="application/json",
            http_headers=http_headers,
            extra_query_params=extra_query,
            _globals=models.GetEnvironmentFilesGlobals(
                api_version=self.sdk_configuration.globals.api_version,
            ),
            security=self.sdk_configuration.security,
            allow_empty_value=None,
            timeout_ms=timeout_ms,
        )

        if retries == UNSET:
            if self.sdk_configuration.retry_config is not UNSET:
                retries = self.sdk_configuration.retry_config
            else:
                retries = utils.RetryConfig(
                    "attempt-count-backoff",
                    utils.BackoffStrategy(500, 8000, 2, 30000),
                    True,
                    max_retries=4,
                )

        retry_config = None
        if isinstance(retries, utils.RetryConfig):
            retry_config = (retries, ["408", "409", "429", "5XX"])

        async def _speakeasy_parse_response(http_res):
            if utils.match_response(http_res, "200", "application/json"):
                return unmarshal_json_response(
                    environments.GetEnvironmentFilesResponse, http_res, validate=False
                )
            if utils.match_response(http_res, "4XX", "*"):
                http_res_text = await utils.stream_to_text_async(http_res)
                raise errors.GenAiDefaultError(
                    "API error occurred", http_res, http_res_text
                )
            if utils.match_response(http_res, "5XX", "*"):
                http_res_text = await utils.stream_to_text_async(http_res)
                raise errors.GenAiDefaultError(
                    "API error occurred", http_res, http_res_text
                )

            raise errors.GenAiDefaultError("Unexpected response received", http_res)

        _speakeasy_hook_ctx = HookContext(
            config=self.sdk_configuration,
            base_url=base_url or "",
            operation_id="GetEnvironmentFiles",
            oauth2_scopes=None,
            security_source=get_security_from_env(
                self.sdk_configuration.security, types.Security
            ),
            tags=None,
            extensions={
                "x-codeSamples": [
                    {
                        "label": "list_files",
                        "lang": "sh",
                        "source": "curl -X GET 'https://generativelanguage.googleapis.com/v1beta/environments/env_abc123/files/src' \\\n  -H \"x-goog-api-key: $GEMINI_API_KEY\"\n",
                    },
                    {
                        "label": "list_files",
                        "lang": "python",
                        "source": 'from google import genai\n\nclient = genai.Client()\n\n# [setup]\ncreated = client.environments.create(\n    sources=[{"type": "inline", "target": "src/main.py", "content": "print(\'Hello\')"}]\n)\n# [/setup]\n\nresponse = client.environments.files.list(\n    environment=created.id,\n    path="src",\n)\nfor file in response.files or []:\n    print(file.name, file.type, file.size_bytes)\n\n# [cleanup]\nclient.environments.delete(id=created.id)\n# [/cleanup]\n',
                    },
                    {
                        "label": "list_files",
                        "lang": "javascript",
                        "source": "import {GoogleGenAI} from '@google/genai';\n\nconst ai = new GoogleGenAI({});\n\n// [setup]\nconst created = await ai.environments.create({\n    sources: [{type: 'inline', target: 'src/main.py', content: \"print('Hello')\"}],\n});\nif (!created.id) throw new Error('Failed to create environment');\n// [/setup]\n\nconst response = await ai.environments.files.list({\n    environment: created.id,\n    path: 'src',\n});\nfor (const file of (response.files ?? [])) {\n    console.log(file.name, file.type, file.size_bytes);\n}\n\n// [cleanup]\nawait ai.environments.delete(created.id);\n// [/cleanup]\n",
                    },
                    {
                        "label": "list_files",
                        "lang": "java",
                        "source": 'import com.google.genai.Client;\nimport com.google.genai.gaos.models.environments.CreateEnvironmentRequest;\nimport com.google.genai.gaos.models.environments.Environment;\nimport com.google.genai.gaos.models.environments.EnvironmentFile;\nimport com.google.genai.gaos.models.environments.GetEnvironmentFilesResponse;\nimport com.google.genai.gaos.models.interactions.Source;\nimport com.google.genai.gaos.models.interactions.SourceType;\nimport com.google.genai.gaos.models.operations.GetEnvironmentFilesRequest;\nimport java.util.List;\n\nClient client = new Client();\n\n// [setup]\nCreateEnvironmentRequest createReq = CreateEnvironmentRequest.builder()\n    .sources(List.of(Source.builder()\n        .type(SourceType.INLINE)\n        .target("src/main.py")\n        .content("print(\'Hello\')")\n        .build()))\n    .build();\nEnvironment created = client.environments.createEnvironment(createReq).environment().orElseThrow();\nString envId = created.id().orElseThrow();\n// [/setup]\n\ncom.google.genai.gaos.models.operations.GetEnvironmentFilesResponse response = client.environments.files().list(\n    GetEnvironmentFilesRequest.builder()\n        .environment(envId)\n        .path("src")\n        .build());\nGetEnvironmentFilesResponse filesResponse = response.getEnvironmentFilesResponse().orElseThrow();\nfor (EnvironmentFile file : filesResponse.files().orElse(List.of())) {\n    System.out.println(file.name().orElse("") + " " + file.type().map(Object::toString).orElse("") + " " + file.sizeBytes().orElse(""));\n}\n\n// [cleanup]\nclient.environments.deleteEnvironment(envId);\n// [/cleanup]\n',
                    },
                    {
                        "label": "get_file",
                        "lang": "sh",
                        "source": "curl -X GET 'https://generativelanguage.googleapis.com/v1beta/environments/env_abc123/files/main.py' \\\n  -H \"x-goog-api-key: $GEMINI_API_KEY\"\n",
                    },
                    {
                        "label": "get_file",
                        "lang": "python",
                        "source": 'from google import genai\n\nclient = genai.Client()\n\n# [setup]\ncreated = client.environments.create(\n    sources=[{"type": "inline", "target": "main.py", "content": "print(\'Hello\')"}]\n)\n# [/setup]\n\nresponse = client.environments.files.get(\n    environment=created.id,\n    path="main.py",\n)\nfor file in response.files or []:\n    print(file.name, file.size_bytes)\n\n# [cleanup]\nclient.environments.delete(id=created.id)\n# [/cleanup]\n',
                    },
                    {
                        "label": "get_file",
                        "lang": "javascript",
                        "source": "import {GoogleGenAI} from '@google/genai';\n\nconst ai = new GoogleGenAI({});\n\n// [setup]\nconst created = await ai.environments.create({\n    sources: [{type: 'inline', target: 'main.py', content: \"print('Hello')\"}],\n});\nif (!created.id) throw new Error('Failed to create environment');\n// [/setup]\n\nconst response = await ai.environments.files.list({\n    environment: created.id,\n    path: 'main.py',\n});\nfor (const file of (response.files ?? [])) {\n    console.log(file.name, file.size_bytes);\n}\n\n// [cleanup]\nawait ai.environments.delete(created.id);\n// [/cleanup]\n",
                    },
                    {
                        "label": "get_file",
                        "lang": "java",
                        "source": 'import com.google.genai.Client;\nimport com.google.genai.gaos.models.environments.CreateEnvironmentRequest;\nimport com.google.genai.gaos.models.environments.Environment;\nimport com.google.genai.gaos.models.environments.EnvironmentFile;\nimport com.google.genai.gaos.models.environments.GetEnvironmentFilesResponse;\nimport com.google.genai.gaos.models.interactions.Source;\nimport com.google.genai.gaos.models.interactions.SourceType;\nimport com.google.genai.gaos.models.operations.GetEnvironmentFilesRequest;\nimport java.util.List;\n\nClient client = new Client();\n\n// [setup]\nCreateEnvironmentRequest createReq = CreateEnvironmentRequest.builder()\n    .sources(List.of(Source.builder()\n        .type(SourceType.INLINE)\n        .target("main.py")\n        .content("print(\'Hello\')")\n        .build()))\n    .build();\nEnvironment created = client.environments.createEnvironment(createReq).environment().orElseThrow();\nString envId = created.id().orElseThrow();\n// [/setup]\n\ncom.google.genai.gaos.models.operations.GetEnvironmentFilesResponse response = client.environments.files().list(\n    GetEnvironmentFilesRequest.builder()\n        .environment(envId)\n        .path("main.py")\n        .build());\nGetEnvironmentFilesResponse filesResponse = response.getEnvironmentFilesResponse().orElseThrow();\nfor (EnvironmentFile file : filesResponse.files().orElse(List.of())) {\n    System.out.println(file.name().orElse("") + " " + file.sizeBytes().orElse(""));\n}\n\n// [cleanup]\nclient.environments.deleteEnvironment(envId);\n// [/cleanup]\n',
                    },
                    {
                        "label": "download_file",
                        "lang": "sh",
                        "source": "curl -X GET 'https://generativelanguage.googleapis.com/v1beta/environments/env_abc123/files/src/main.py?alt=media' \\\n  -H \"x-goog-api-key: $GEMINI_API_KEY\" \\\n  --output main.py\n",
                    },
                    {
                        "label": "download_file",
                        "lang": "python",
                        "source": 'from google import genai\n\nclient = genai.Client()\n\n# [setup]\ncreated = client.environments.create(\n    sources=[{"type": "inline", "target": "src/main.py", "content": "print(\'Hello\')"}]\n)\n# [/setup]\n\ncontent = client.environments.files.download(\n    environment=created.id,\n    path="src/main.py",\n)\nprint(content.decode("utf-8"))\n\n# [cleanup]\nclient.environments.delete(id=created.id)\n# [/cleanup]\n',
                    },
                ]
            },
            response=ResponseContext(mode=_speakeasy_response_mode, execution="async"),
        )
        http_res = await self.do_request_async(
            hook_ctx=_speakeasy_hook_ctx,
            request=req,
            is_error_status_code=lambda c: utils.match_status_codes(["4XX", "5XX"], c),
            stream=_speakeasy_response_mode == "streaming",
            retry_config=retry_config,
        )
        if _speakeasy_response_mode != "parsed":
            if utils.match_status_codes(["4XX", "5XX"], http_res.status_code):
                await http_res.aread()
                try:
                    await _speakeasy_parse_response(http_res)
                except Exception as parse_exc_:
                    await response_helpers.raise_parse_error_async(
                        self.sdk_configuration.__dict__.get("_async_hooks"),
                        self.sdk_configuration.__dict__.get("_hooks"),
                        AfterParseErrorContext(_speakeasy_hook_ctx),
                        http_res,
                        parse_exc_,
                    )
            _speakeasy_response_cls = (
                response_helpers.AsyncStreamedAPIResponse
                if _speakeasy_response_mode == "streaming"
                else response_helpers.AsyncAPIResponse
            )
            return cast(
                Any,
                _speakeasy_response_cls(
                    raw=http_res,
                    parser=_speakeasy_parse_response,
                    mode="buffered",
                    client_ref=self,
                    hook_ctx=AfterParseErrorContext(_speakeasy_hook_ctx),
                    hooks=self.sdk_configuration.__dict__.get("_hooks"),
                    async_hooks=self.sdk_configuration.__dict__.get("_async_hooks"),
                ),
            )
        try:
            return await _speakeasy_parse_response(http_res)
        except Exception as parse_exc_:
            await response_helpers.raise_parse_error_async(
                self.sdk_configuration.__dict__.get("_async_hooks"),
                self.sdk_configuration.__dict__.get("_hooks"),
                AfterParseErrorContext(_speakeasy_hook_ctx),
                http_res,
                parse_exc_,
            )


class AsyncFilesWithRawResponse:
    def __init__(self, sdk: AsyncFiles) -> None:
        self._sdk = sdk
        self.list = response_helpers.async_to_raw_response_wrapper(
            sdk.list, "extra_headers"
        )


class AsyncFilesWithStreamingResponse:
    def __init__(self, sdk: AsyncFiles) -> None:
        self._sdk = sdk
        self.list = response_helpers.async_to_streamed_response_wrapper(
            sdk.list, "extra_headers"
        )
