Created TranslateTextTest class.

Closes #3488374

The provided Drupal unit test, TranslateTextTest, focuses on testing the functionality of two classes: TranslateTextInput and TranslateTextOutput. These classes are part of a module named ai, specifically within the OperationType\TranslateText namespace. The tests ensure that these classes can be properly created with valid input data and that their methods return expected results.

Here's a summary of each test case:

1. Test Case: testTranslateTextInputCreation

   • Purpose: This test verifies that an instance of TranslateTextInput is created correctly.
   • Input: A string 'Hello, world!', source language 'en', and target language 'es'.
   • Expected Output:
     • The toString() and (string) methods should return the original text `'Hello, world!'.
     • The getSourceLanguage() method should return the source language 'en'.
     • The getTargetLanguage() method should return the target language 'es'.
   • Additional Test: The test also checks that the source and target languages can be updated using the setSourceLanguage and setTargetLanguage methods.

2. Test Case: testTranslateTextOutputCreation

   • Purpose: This test verifies that an instance of TranslateTextOutput is created correctly.
   • Input:
     • A normalized string '¡Hola, mundo!', a raw output array containing the translated text, and metadata with a confidence level.
   • Expected Output:
     • The getNormalized() method should return the normalized text `'¡Hola, mundo!'.
     • The getRawOutput() method should return the raw output array.
     • The getMetadata() method should return the metadata.
   • Additional Test: The test also checks that the output can be converted to an associative array using the toArray method.

Summary

• The tests ensure that both TranslateTextInput and TranslateTextOutput classes handle their properties and methods as expected.
• They verify the proper creation of instances with correct data.
• Additional tests check for mutability of source/target languages in the input class and conversion to array format in the output class.

tests/src/Unit/OperationType/TranslateText/TranslateTextTest.php

+<?php
+
+declare(strict_types=1);
+
+namespace Drupal\Tests\ai\Unit\OperationType\TranslateText;
+
+use Drupal\Tests\UnitTestCase;
+use Drupal\ai\OperationType\TranslateText\TranslateTextInput;
+use Drupal\ai\OperationType\TranslateText\TranslateTextOutput;
+use PHPUnit\Framework\Attributes\Group;
+
+/**
+ * Tests the TranslateTextInput and TranslateTextOutput classes.
+ *
+ * @group ai
+ */
+#[Group('ai')]
+final class TranslateTextTest extends UnitTestCase {
+
+  /**
+   * Tests that a valid input object is created correctly.
+   */
+  public function testTranslateTextInputCreation(): void {
+    $text = 'Hello, world!';
+    $source_language = 'en';
+    $target_language = 'es';
+
+    $input = new TranslateTextInput($text, $source_language, $target_language);
+
+    $this->assertEquals($text, $input->toString());
+    $this->assertEquals($text, (string) $input);
+    $this->assertEquals($source_language, $input->getSourceLanguage());
+    $this->assertEquals($target_language, $input->getTargetLanguage());
+
+    // Test setting new values.
+    $new_source_language = 'fr';
+    $new_target_language = 'de';
+
+    $input->setSourceLanguage($new_source_language);
+    $input->setTargetLanguage($new_target_language);
+
+    $this->assertEquals($new_source_language, $input->getSourceLanguage());
+    $this->assertEquals($new_target_language, $input->getTargetLanguage());
+  }
+
+  /**
+   * Tests that the TranslateTextOutput class is created correctly.
+   */
+  public function testTranslateTextOutputCreation(): void {
+    $normalized = '¡Hola, munda!';
+    $raw_output = ['translated_text' => '¡Hola, munda!'];
+    $metadata = ['confidence' => 0.95];
+
+    $output = new TranslateTextOutput($normalized, $raw_output, $metadata);
+
+    $this->assertEquals($normalized, $output->getNormalized());
+    $this->assertEquals($raw_output, $output->getRawOutput());
+    $this->assertEquals($metadata, $output->getMetadata());
+
+    // Test converting to array.
+    $array_output = $output->toArray();
+    $this->assertArrayHasKey('normalized', $array_output);
+    $this->assertArrayHasKey('rawOutput', $array_output);
+    $this->assertArrayHasKey('metadata', $array_output);
+  }
+
+}