# 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.
#
# SPDX-License-Identifier: Apache-2.0
"""Tests for PartConverter utility functions.
These tests verify the edge cases documented in the utils.py module docstring,
particularly around URL classification and media part conversion.
"""
from unittest.mock import AsyncMock, patch
import pytest
from google import genai
from genkit.plugins.google_genai.models.utils import PartConverter
from genkit.types import Media, MediaPart, Part
class TestIsGeminiNativeUrl:
"""Tests for _is_gemini_native_url hostname classification."""
def test_youtube_www(self) -> None:
"""YouTube www subdomain is natively resolved."""
got = PartConverter._is_gemini_native_url('https://www.youtube.com/watch?v=abc123')
if not got:
pytest.fail(f'_is_gemini_native_url(www.youtube.com) = {got}, want True')
def test_youtube_bare(self) -> None:
"""YouTube bare domain is natively resolved."""
got = PartConverter._is_gemini_native_url('https://youtube.com/watch?v=abc123')
if not got:
pytest.fail(f'_is_gemini_native_url(youtube.com) = {got}, want True')
def test_youtu_be_short(self) -> None:
"""YouTube short URL is natively resolved."""
got = PartConverter._is_gemini_native_url('https://youtu.be/abc123')
if not got:
pytest.fail(f'_is_gemini_native_url(youtu.be) = {got}, want True')
def test_files_api(self) -> None:
"""Gemini Files API URLs are natively resolved."""
got = PartConverter._is_gemini_native_url('https://generativelanguage.googleapis.com/v1beta/files/abc123')
if not got:
pytest.fail(f'_is_gemini_native_url(generativelanguage.googleapis.com) = {got}, want True')
def test_arbitrary_http_not_native(self) -> None:
"""Arbitrary HTTP URLs are NOT natively resolved."""
got = PartConverter._is_gemini_native_url('https://example.com/image.jpg')
if got:
pytest.fail(f'_is_gemini_native_url(example.com) = {got}, want False')
def test_wikipedia_not_native(self) -> None:
"""Wikipedia URLs are NOT natively resolved — they require download."""
got = PartConverter._is_gemini_native_url('https://upload.wikimedia.org/image.jpg')
if got:
pytest.fail(f'_is_gemini_native_url(wikimedia.org) = {got}, want False')
def test_invalid_url_returns_false(self) -> None:
"""Malformed URLs return False instead of raising."""
got = PartConverter._is_gemini_native_url('not-a-url')
if got:
pytest.fail(f'_is_gemini_native_url(not-a-url) = {got}, want False')
def test_empty_string_returns_false(self) -> None:
"""Empty string returns False."""
got = PartConverter._is_gemini_native_url('')
if got:
pytest.fail(f'_is_gemini_native_url("") = {got}, want False')
class TestToGeminiMediaPart:
"""Tests for to_gemini media part conversion with native URL handling."""
@pytest.mark.asyncio
async def test_youtube_url_uses_file_data(self) -> None:
"""YouTube URLs are passed as file_data, NOT downloaded."""
part = Part(root=MediaPart(media=Media(url='https://www.youtube.com/watch?v=abc', content_type='video/mp4')))
result = await PartConverter.to_gemini(part)
# Narrow to a single Part for attribute access.
assert isinstance(result, genai.types.Part)
# Must use file_data, not inline_data
assert result.file_data is not None, 'YouTube URL should produce file_data, not inline_data'
if result.inline_data is not None:
pytest.fail('YouTube URL should NOT produce inline_data')
if result.file_data.file_uri != 'https://www.youtube.com/watch?v=abc':
pytest.fail(f'file_uri = {result.file_data.file_uri}, want original URL')
if result.file_data.mime_type != 'video/mp4':
pytest.fail(f'mime_type = {result.file_data.mime_type}, want video/mp4')
@pytest.mark.asyncio
async def test_youtu_be_short_url_uses_file_data(self) -> None:
"""Short youtu.be URLs are passed as file_data."""
part = Part(root=MediaPart(media=Media(url='https://youtu.be/abc', content_type='video/mp4')))
result = await PartConverter.to_gemini(part)
assert isinstance(result, genai.types.Part)
assert result.file_data is not None, 'youtu.be URL should produce file_data'
if result.file_data.file_uri != 'https://youtu.be/abc':
pytest.fail(f'file_uri = {result.file_data.file_uri}, want original URL')
@pytest.mark.asyncio
async def test_files_api_url_uses_file_data(self) -> None:
"""Gemini Files API URLs are passed as file_data."""
url = 'https://generativelanguage.googleapis.com/v1beta/files/abc123'
part = Part(root=MediaPart(media=Media(url=url, content_type='video/mp4')))
result = await PartConverter.to_gemini(part)
assert isinstance(result, genai.types.Part)
assert result.file_data is not None, 'Files API URL should produce file_data'
if result.file_data.file_uri != url:
pytest.fail(f'file_uri = {result.file_data.file_uri}, want original URL')
@pytest.mark.asyncio
async def test_regular_http_url_downloads_inline(self) -> None:
"""Regular HTTP URLs are downloaded and sent as inline_data."""
part = Part(root=MediaPart(media=Media(url='https://example.com/photo.jpg', content_type='image/jpeg')))
mock_data = b'\x89PNG\r\n'
with patch.object(
PartConverter,
'_download_image',
new_callable=AsyncMock,
return_value=(mock_data, 'image/jpeg'),
) as mock_download:
result = await PartConverter.to_gemini(part)
mock_download.assert_called_once_with('https://example.com/photo.jpg')
assert isinstance(result, genai.types.Part)
assert result.inline_data is not None, 'Regular HTTP URL should produce inline_data'
if result.inline_data.data != mock_data:
pytest.fail('inline_data.data should contain downloaded bytes')
@pytest.mark.asyncio
async def test_gs_uri_uses_file_data(self) -> None:
"""gs:// URIs are passed through as file_data (not downloaded)."""
part = Part(root=MediaPart(media=Media(url='gs://bucket/video.mp4', content_type='video/mp4')))
result = await PartConverter.to_gemini(part)
assert isinstance(result, genai.types.Part)
assert result.file_data is not None, 'gs:// URI should produce file_data'
if result.file_data.file_uri != 'gs://bucket/video.mp4':
pytest.fail(f'file_uri = {result.file_data.file_uri}, want original URI')
@pytest.mark.asyncio
async def test_data_uri_uses_inline_data(self) -> None:
"""data: URIs are decoded and sent as inline_data."""
import base64
raw = b'hello'
b64 = base64.b64encode(raw).decode('utf-8')
url = f'data:text/plain;base64,{b64}'
part = Part(root=MediaPart(media=Media(url=url, content_type='text/plain')))
result = await PartConverter.to_gemini(part)
assert isinstance(result, genai.types.Part)
assert result.inline_data is not None, 'data: URI should produce inline_data'
if result.inline_data.data != raw:
pytest.fail(f'inline_data.data = {result.inline_data.data!r}, want {raw!r}')
if result.inline_data.mime_type != 'text/plain':
pytest.fail(f'mime_type = {result.inline_data.mime_type}, want text/plain')
