Skip to content

armgit / camel

Public Imported from GitHub
0

🐫 CAMEL: The first and the best multi-agent framework. Finding the Scaling Law of Agents. https://www.camel-ai.org

8.7 KB
Raw Blame
# ========= Copyright 2023-2026 @ CAMEL-AI.org. All Rights Reserved. =========
# 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.
# ========= Copyright 2023-2026 @ CAMEL-AI.org. All Rights Reserved. =========
from unittest.mock import patch

import pytest

from camel.toolkits.resend_toolkit import ResendToolkit


@pytest.fixture(autouse=True)
def set_env_vars(monkeypatch):
    """Set up required environment variables for ResendToolkit tests."""
    monkeypatch.setenv("RESEND_API_KEY", "re_test_api_key_12345")


def test_send_email_html_only():
    """Test sending email with HTML content only."""
    toolkit = ResendToolkit()

    mock_email_response = {'id': 'email_12345_test_id'}

    with patch('resend.Emails.send') as mock_send:
        mock_send.return_value = mock_email_response

        result = toolkit.send_email(
            to=["[email protected]"],
            subject="Test HTML Email",
            from_email="[email protected]",
            html="<h1>Hello, World!</h1><p>This is a test email.</p>",
        )

        expected_result = (
            "Email sent successfully. Email ID: email_12345_test_id"
        )
        assert result == expected_result

        # Verify the API was called with correct parameters
        mock_send.assert_called_once()
        call_args = mock_send.call_args[0][0]
        assert call_args["from"] == "[email protected]"
        assert call_args["to"] == ["[email protected]"]
        assert call_args["subject"] == "Test HTML Email"
        assert (
            call_args["html"]
            == "<h1>Hello, World!</h1><p>This is a test email.</p>"
        )
        assert "text" not in call_args


def test_send_email_text_only():
    """Test sending email with plain text content only."""
    toolkit = ResendToolkit()

    mock_email_response = {'id': 'email_text_67890_test_id'}

    with patch('resend.Emails.send') as mock_send:
        mock_send.return_value = mock_email_response

        result = toolkit.send_email(
            to=["[email protected]"],
            subject="Test Text Email",
            from_email="[email protected]",
            text="Hello, World!\nThis is a plain text test email.",
        )

        expected_result = (
            "Email sent successfully. Email ID: email_text_67890_test_id"
        )
        assert result == expected_result

        # Verify the API was called with correct parameters
        mock_send.assert_called_once()
        call_args = mock_send.call_args[0][0]
        assert call_args["from"] == "[email protected]"
        assert call_args["to"] == ["[email protected]"]
        assert call_args["subject"] == "Test Text Email"
        assert (
            call_args["text"]
            == "Hello, World!\nThis is a plain text test email."
        )
        assert "html" not in call_args


def test_send_email_html_and_text():
    """Test sending email with both HTML and text content."""
    toolkit = ResendToolkit()

    mock_email_response = {'id': 'email_both_11111_test_id'}

    with patch('resend.Emails.send') as mock_send:
        mock_send.return_value = mock_email_response

        result = toolkit.send_email(
            to=["[email protected]"],
            subject="Test Both Content Email",
            from_email="[email protected]",
            html="<h1>Hello, World!</h1>",
            text="Hello, World!",
        )

        expected_result = (
            "Email sent successfully. Email ID: email_both_11111_test_id"
        )
        assert result == expected_result

        # Verify the API was called with correct parameters
        mock_send.assert_called_once()
        call_args = mock_send.call_args[0][0]
        assert call_args["html"] == "<h1>Hello, World!</h1>"
        assert call_args["text"] == "Hello, World!"


def test_send_email_with_all_optional_params():
    """Test sending email with all optional parameters."""
    toolkit = ResendToolkit()

    mock_email_response = {'id': 'email_full_22222_test_id'}

    with patch('resend.Emails.send') as mock_send:
        mock_send.return_value = mock_email_response

        result = toolkit.send_email(
            to=["[email protected]", "[email protected]"],
            subject="Test Full Email",
            from_email="[email protected]",
            html="<h1>Full Email Test</h1>",
            text="Full Email Test",
            cc=["[email protected]"],
            bcc=["[email protected]"],
            reply_to="[email protected]",
            tags=[{"name": "category", "value": "test"}],
            headers={"X-Custom-Header": "test-value"},
        )

        expected_result = (
            "Email sent successfully. Email ID: email_full_22222_test_id"
        )
        assert result == expected_result

        # Verify the API was called with correct parameters
        mock_send.assert_called_once()
        call_args = mock_send.call_args[0][0]
        assert call_args["to"] == [
            "[email protected]",
            "[email protected]",
        ]
        assert call_args["cc"] == ["[email protected]"]
        assert call_args["bcc"] == ["[email protected]"]
        assert call_args["reply_to"] == "[email protected]"
        assert call_args["tags"] == [{"name": "category", "value": "test"}]
        assert call_args["headers"] == {"X-Custom-Header": "test-value"}


def test_send_email_no_content_error():
    """Test that sending email without content raises ValueError."""
    toolkit = ResendToolkit()

    with pytest.raises(
        ValueError, match="Either 'html' or 'text' content must be provided"
    ):
        toolkit.send_email(
            to=["[email protected]"],
            subject="Test Email",
            from_email="[email protected]",
        )


def test_send_email_import_error():
    """Test handling of resend package import error."""
    toolkit = ResendToolkit()

    # Mock the import statement inside the send_email method
    with patch.dict('sys.modules', {'resend': None}):
        with pytest.raises(
            ImportError, match=r"Please install the resend package first\."
        ):
            toolkit.send_email(
                to=["[email protected]"],
                subject="Test Email",
                from_email="[email protected]",
                text="Test content",
            )


def test_send_email_api_error():
    """Test handling of API errors during email sending."""
    toolkit = ResendToolkit()

    with patch('resend.Emails.send') as mock_send:
        mock_send.side_effect = Exception("API Error: Invalid API key")

        result = toolkit.send_email(
            to=["[email protected]"],
            subject="Test Email",
            from_email="[email protected]",
            text="Test content",
        )

        expected_result = "Failed to send email: API Error: Invalid API key"
        assert result == expected_result


def test_send_email_no_id_in_response():
    """Test handling of API response without ID field."""
    toolkit = ResendToolkit()

    mock_email_response = {}  # Response without 'id' field

    with patch('resend.Emails.send') as mock_send:
        mock_send.return_value = mock_email_response

        result = toolkit.send_email(
            to=["[email protected]"],
            subject="Test Email",
            from_email="[email protected]",
            text="Test content",
        )

        expected_result = "Email sent successfully. Email ID: Unknown"
        assert result == expected_result


def test_get_tools():
    """Test that get_tools returns the correct FunctionTool objects."""
    toolkit = ResendToolkit()
    tools = toolkit.get_tools()

    assert len(tools) == 1
    assert tools[0].func == toolkit.send_email
    assert hasattr(tools[0], 'get_openai_tool_schema')


def test_send_email_api_key_setting():
    """Test that the API key is correctly set from environment variable."""
    toolkit = ResendToolkit()

    with (
        patch('resend.Emails.send') as mock_send,
        patch('resend.api_key', new=None),
    ):
        mock_send.return_value = {'id': 'test_id'}

        toolkit.send_email(
            to=["[email protected]"],
            subject="Test Email",
            from_email="[email protected]",
            text="Test content",
        )

        # The API key should have been set during the function call
        mock_send.assert_called_once()