google-genai 1.56.0__py3-none-any.whl → 1.58.0__py3-none-any.whl

google/genai/tests/shared/models/test_edit_image.py

@@ -0,0 +1,67 @@
+# Copyright 2025 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.
+#
+
+
+"""Tests for edit_image."""
+
+import os
+
+from .... import types
+from ... import pytest_helper
+
+CAPABILITY_MODEL_NAME = 'imagen-3.0-capability-001'
+
+IMAGE_FILE_PATH = os.path.abspath(
+    os.path.join(os.path.dirname(__file__), '../../data/google.png')
+)
+
+MASK_FILE_PATH = os.path.abspath(
+    os.path.join(os.path.dirname(__file__), '../../data/checkerboard.png')
+)
+
+raw_ref_image = types.RawReferenceImage(
+    reference_id=1,
+    reference_image=types.Image.from_file(location=IMAGE_FILE_PATH),
+)
+
+mask_ref_image = types.MaskReferenceImage(
+    reference_id=2,
+    config=types.MaskReferenceConfig(
+        mask_mode='MASK_MODE_BACKGROUND',
+        mask_dilation=0.06,
+    ),
+)
+
+test_table: list[pytest_helper.TestTableItem] = [
+    pytest_helper.TestTableItem(
+        name='test_edit_mask_inpaint_insert',
+        exception_if_mldev='only supported in the Vertex AI client',
+        parameters=types._EditImageParameters(
+            model=CAPABILITY_MODEL_NAME,
+            prompt='Sunlight and clear weather',
+            reference_images=[raw_ref_image, mask_ref_image],
+            config=types.EditImageConfig(
+                edit_mode=types.EditMode.EDIT_MODE_INPAINT_INSERTION,
+            ),
+        ),
+    ),
+]
+
+pytestmark = pytest_helper.setup(
+    file=__file__,
+    globals_for_file=globals(),
+    test_method='models.edit_image',
+    test_table=test_table,
+)

google/genai/tests/shared/models/test_embed.py

@@ -0,0 +1,40 @@
+# Copyright 2025 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.
+#
+
+
+"""Tests for models.embed()."""
+
+from .... import types as genai_types
+from ... import pytest_helper
+
+
+test_table: list[pytest_helper.TestTableItem] = [
+    pytest_helper.TestTableItem(
+        name='test_embed',
+        parameters=genai_types._EmbedContentParameters(
+            model='text-embedding-004',
+            contents='Hello world!',
+        ),
+    ),
+]
+
+pytestmark = pytest_helper.setup(
+    file=__file__,
+    globals_for_file=globals(),
+    test_method='models.embed_content',
+    test_table=test_table,
+)
+
+pytest_plugins = ('pytest_asyncio',)

google/genai/tests/shared/models/test_generate_content.py

@@ -0,0 +1,39 @@
+# Copyright 2025 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.
+#
+
+"""Tests for models.generate_content()."""
+
+from .... import types as genai_types
+from ... import pytest_helper
+
+
+test_table: list[pytest_helper.TestTableItem] = [
+    pytest_helper.TestTableItem(
+        name='test_generate_content',
+        parameters=genai_types._GenerateContentParameters(
+            model='gemini-2.5-flash',
+            contents='The quick brown fox jumps over the lazy dog.',
+        ),
+    ),
+]
+
+pytestmark = pytest_helper.setup(
+    file=__file__,
+    globals_for_file=globals(),
+    test_method='models.generate_content',
+    test_table=test_table,
+)
+
+pytest_plugins = ('pytest_asyncio',)

google/genai/tests/shared/models/test_generate_content_stream.py

@@ -0,0 +1,54 @@
+# Copyright 2025 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.
+#
+
+"""Tests for models.generate_content_stream()."""
+
+from .... import types as genai_types
+from ... import pytest_helper
+from pydantic import BaseModel
+
+
+class _GenerateContentStreamParameters(BaseModel):
+    model: str
+    contents: str
+
+
+def generate_content_stream(client, parameters):
+  response = client.models.generate_content_stream(
+      model=parameters.model,
+      contents=parameters.contents,
+  )
+  for _ in response:
+    pass
+
+
+test_table: list[pytest_helper.TestTableItem] = [
+    pytest_helper.TestTableItem(
+        name='test_generate_content_stream',
+        parameters=_GenerateContentStreamParameters(
+            model='gemini-2.5-flash',
+            contents='The quick brown fox jumps over the lazy dog.',
+        ),
+    ),
+]
+
+pytestmark = pytest_helper.setup(
+    file=__file__,
+    globals_for_file=globals(),
+    test_method='generate_content_stream',
+    test_table=test_table,
+)
+
+pytest_plugins = ('pytest_asyncio',)

google/genai/tests/shared/models/test_generate_images.py

@@ -0,0 +1,40 @@
+# Copyright 2025 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.
+#
+"""Tests for generate_images."""
+
+from .... import types
+from ... import pytest_helper
+
+IMAGEN_MODEL_LATEST = 'imagen-4.0-generate-001'
+
+test_table: list[pytest_helper.TestTableItem] = [
+    pytest_helper.TestTableItem(
+        name='test_simple_prompt',
+        parameters=types._GenerateImagesParameters(
+            model=IMAGEN_MODEL_LATEST,
+            prompt='Red skateboard',
+            config=types.GenerateImagesConfig(
+                number_of_images=1,
+                output_mime_type='image/jpeg',
+            ),
+        ),
+    ),
+]
+pytestmark = pytest_helper.setup(
+    file=__file__,
+    globals_for_file=globals(),
+    test_method='models.generate_images',
+    test_table=test_table,
+)

google/genai/tests/shared/models/test_generate_videos.py

@@ -0,0 +1,38 @@
+# Copyright 2025 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.
+#
+"""Tests for generate_videos."""
+
+import os
+from .... import types
+from ... import pytest_helper
+
+VEO_MODEL_LATEST = "veo-2.0-generate-001"
+
+
+test_table: list[pytest_helper.TestTableItem] = [
+    pytest_helper.TestTableItem(
+        name="test_simple_prompt",
+        parameters=types._GenerateVideosParameters(
+            model=VEO_MODEL_LATEST,
+            prompt="Man with a dog",
+        ),
+    ),
+]
+pytestmark = pytest_helper.setup(
+    file=__file__,
+    globals_for_file=globals(),
+    test_method="models.generate_videos",
+    test_table=test_table,
+)

google/genai/tests/shared/models/test_list.py

@@ -0,0 +1,37 @@
+# Copyright 2025 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.
+#
+
+
+"""Tests for models.list."""
+
+
+from .... import types
+from ... import pytest_helper
+
+test_table: list[pytest_helper.TestTableItem] = [
+    pytest_helper.TestTableItem(
+        name='test_list',
+        parameters=types._ListModelsParameters(
+            config=types.ListModelsConfig(page_size=1)
+        ),
+    ),
+]
+
+pytestmark = pytest_helper.setup(
+    file=__file__,
+    globals_for_file=globals(),
+    test_method='models.list',
+    test_table=test_table,
+)

google/genai/tests/shared/models/test_recontext_image.py

@@ -0,0 +1,55 @@
+# Copyright 2025 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.
+#
+
+
+"""Tests for recontext_image."""
+
+from .... import types
+from ... import pytest_helper
+
+PRODUCT_RECONTEXT_MODEL_LATEST = 'imagen-product-recontext-preview-06-30'
+
+BACKPACK1 = types.Image(
+    gcs_uri='gs://genai-sdk-tests/inputs/images/backpack1.png',
+)
+
+test_table: list[pytest_helper.TestTableItem] = [
+    pytest_helper.TestTableItem(
+        name='test_product_recontext',
+        exception_if_mldev='only supported in the Vertex AI client',
+        parameters=types._RecontextImageParameters(
+            model=PRODUCT_RECONTEXT_MODEL_LATEST,
+            source=types.RecontextImageSource(
+                prompt='On a school desk',
+                product_images=[
+                    types.ProductImage(product_image=BACKPACK1)
+                ],
+            ),
+            config=types.RecontextImageConfig(
+                number_of_images=1,
+                add_watermark=True,
+                output_mime_type='image/jpeg',
+            ),
+        ),
+    ),
+]
+
+
+pytestmark = pytest_helper.setup(
+    file=__file__,
+    globals_for_file=globals(),
+    test_method='models.recontext_image',
+    test_table=test_table,
+)

google/genai/tests/shared/models/test_segment_image.py

@@ -0,0 +1,52 @@
+# Copyright 2025 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.
+#
+
+
+"""Tests for segment_image."""
+
+import os
+
+from .... import types
+from ... import pytest_helper
+
+SEGMENT_IMAGE_MODEL_LATEST = 'image-segmentation-001'
+
+SOURCE_IMAGE_FILE_PATH1 = os.path.abspath(
+    os.path.join(os.path.dirname(__file__), '../../data/google.png')
+)
+
+SOURCE_IMAGE1 = types.Image.from_file(location=SOURCE_IMAGE_FILE_PATH1)
+
+test_table: list[pytest_helper.TestTableItem] = [
+    pytest_helper.TestTableItem(
+        name='test_segment_background',
+        exception_if_mldev='only supported in the Vertex AI client',
+        parameters=types._SegmentImageParameters(
+            model=SEGMENT_IMAGE_MODEL_LATEST,
+            source=types.SegmentImageSource(
+                image=SOURCE_IMAGE1,
+            ),
+            config=types.SegmentImageConfig(
+                mode=types.SegmentMode.BACKGROUND,
+            ),
+        ),
+    ),
+]
+pytestmark = pytest_helper.setup(
+    file=__file__,
+    globals_for_file=globals(),
+    test_method='models.segment_image',
+    test_table=test_table,
+)

google/genai/tests/shared/models/test_upscale_image.py

@@ -0,0 +1,52 @@
+# Copyright 2025 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.
+#
+
+"""Tests for upscale_image."""
+
+import os
+
+from .... import types
+from ... import pytest_helper
+
+IMAGEN_MODEL_LATEST = 'imagen-4.0-upscale-preview'
+
+IMAGE_FILE_PATH = os.path.abspath(
+    os.path.join(os.path.dirname(__file__), '../../data/bridge1.png')
+)
+
+test_table: list[pytest_helper.TestTableItem] = [
+    pytest_helper.TestTableItem(
+        name='test_upscale',
+        exception_if_mldev='only supported in the Vertex AI client',
+        parameters=types.UpscaleImageParameters(
+            model=IMAGEN_MODEL_LATEST,
+            image=types.Image.from_file(location=IMAGE_FILE_PATH),
+            upscale_factor='x2',
+            config=types.UpscaleImageConfig(
+                include_rai_reason=True,
+                output_mime_type='image/jpeg',
+                output_compression_quality=80,
+                enhance_input_image=True,
+                image_preservation_factor=0.6,
+            ),
+        ),
+    ),
+]
+pytestmark = pytest_helper.setup(
+    file=__file__,
+    globals_for_file=globals(),
+    test_method='models.upscale_image',
+    test_table=test_table,
+)

google/genai/tests/shared/tunings/__init__.py

@@ -0,0 +1,16 @@
+# Copyright 2025 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.
+#
+
+

google/genai/tests/shared/tunings/test_create.py

@@ -0,0 +1,46 @@
+# Copyright 2025 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.
+#
+
+
+"""Tests for tunings.tune()."""
+
+from .... import types as genai_types
+from ... import pytest_helper
+
+
+test_table: list[pytest_helper.TestTableItem] = [
+    pytest_helper.TestTableItem(
+        name='test_tune',
+        parameters=genai_types.CreateTuningJobParameters(
+            base_model='gemini-2.5-flash',
+            training_dataset=genai_types.TuningDataset(
+                gcs_uri='gs://cloud-samples-data/ai-platform/generative_ai/gemini-2_0/text/sft_train_data.jsonl',
+            ),
+            config=genai_types.CreateTuningJobConfig(
+                epoch_count=1,
+            ),
+        ),
+        exception_if_mldev='not supported in Gemini API.',
+    ),
+]
+
+pytestmark = pytest_helper.setup(
+    file=__file__,
+    globals_for_file=globals(),
+    test_method='tunings.tune',
+    test_table=test_table,
+)
+
+pytest_plugins = ('pytest_asyncio',)

google/genai/tests/shared/tunings/test_create_get_cancel.py

@@ -0,0 +1,56 @@
+# Copyright 2025 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.
+#
+
+
+"""Tests tunings.tune(), tunings.get(), tunings.cancel()."""
+
+from .... import types as genai_types
+from ... import pytest_helper
+
+
+def create_get_cancel(client, parameters):
+  tuning_job = client.tunings.tune(
+      base_model=parameters.base_model,
+      training_dataset=parameters.training_dataset,
+      config=parameters.config,
+  )
+  tuning_job = client.tunings.get(name=tuning_job.name)
+  client.tunings.cancel(name=tuning_job.name)
+
+
+test_table: list[pytest_helper.TestTableItem] = [
+    pytest_helper.TestTableItem(
+        name="test_create_get_cancel",
+        parameters=genai_types.CreateTuningJobParameters(
+            base_model="gemini-2.5-flash",
+            training_dataset=genai_types.TuningDataset(
+                gcs_uri="gs://cloud-samples-data/ai-platform/generative_ai/gemini-2_0/text/sft_train_data.jsonl",
+            ),
+            config=genai_types.CreateTuningJobConfig(
+                epoch_count=1,
+            ),
+        ),
+        exception_if_mldev="not supported in Gemini API.",
+    ),
+]
+
+pytestmark = pytest_helper.setup(
+    file=__file__,
+    globals_for_file=globals(),
+    test_method="create_get_cancel",
+    test_table=test_table,
+)
+
+pytest_plugins = ("pytest_asyncio",)

google/genai/tests/shared/tunings/test_list.py

@@ -0,0 +1,39 @@
+# Copyright 2025 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.
+#
+
+
+"""Tests for tunings.list()."""
+
+from .... import types as genai_types
+from ... import pytest_helper
+
+
+test_table: list[pytest_helper.TestTableItem] = [
+    pytest_helper.TestTableItem(
+        name='test_default',
+        parameters=genai_types._ListTuningJobsParameters(
+            config=genai_types.ListTuningJobsConfig(page_size=1)
+        ),
+    ),
+]
+
+pytestmark = pytest_helper.setup(
+    file=__file__,
+    globals_for_file=globals(),
+    test_method='tunings.list',
+    test_table=test_table,
+)
+
+pytest_plugins = ('pytest_asyncio',)

google/genai/tests/tokens/__init__.py

@@ -0,0 +1,16 @@
+# Copyright 2025 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.
+#
+
+