feat: implement add_language in client

docs/api_coverage.md

@@ -5,7 +5,7 @@
 | `activate_survey`              | Yes         | Activate survey (RPC function)                                                    |
 | `activate_tokens`              | Yes         | Activate survey participants (RPC function)                                       |
 | `add_group`                    | Yes         | Add empty group with minimum details (RPC function)                               |
-| `add_language`                 | No          | Add a survey language (RPC function)                                              |
+| `add_language`                 | Yes         | Add a survey language (RPC function)                                              |
 | `add_participants`             | Yes         | Add participants to the survey.                                                   |
 | `add_response`                 | Yes         | Add a response to the survey responses collection.                                |
 | `add_survey`                   | No          | Add an empty survey with minimum details                                          |

src/citric/client.py

@@ -110,6 +110,19 @@ def activate_tokens(
         """
         return self.__session.activate_tokens(survey_id)
 
+    def add_language(self, survey_id: int, language: str) -> dict[str, Any]:
+        """Add a survey language.
+
+        Args:
+            survey_id: ID of the Survey for which a language will be added.
+            language: A valid language shortcut to add to the current Survey. If the
+                language already exists no error will be given.
+
+        Returns:
+            Status message.
+        """
+        return self.__session.add_language(survey_id, language)
+
     def add_participants(
         self,
         survey_id: int,

tests/test_client.py

@@ -172,6 +172,11 @@ def test_add_group(client: MockClient):
     )
 
 
+def test_add_language(client: MockClient):
+    """Test add_language client method."""
+    assert_client_session_call(client, "add_language", 1, "ru")
+
+
 def test_copy_survey(client: MockClient):
     """Test copy_survey client method."""
     assert_client_session_call(client, "copy_survey", 1, "New Survey")

tests/test_integration.py

@@ -57,13 +57,23 @@ def client() -> Generator[citric.Client, None, None]:
 def survey_id(client: citric.Client) -> Generator[int, None, None]:
     """Import a survey from a file and return its ID."""
     with open("./examples/survey.lss", "rb") as f:
-        survey_id = client.import_survey(f)
+        survey_id = client.import_survey(f, survey_id=98765)
 
     yield survey_id
 
     client.delete_survey(survey_id)
 
 
+@pytest.mark.integration_test
+def test_add_language(client: citric.Client, survey_id: int):
+    """Test adding a new language to a survey."""
+    client.add_language(survey_id, "es")
+    client.add_language(survey_id, "ru")
+
+    survey_props = client.get_survey_properties(survey_id)
+    assert survey_props["additional_languages"] == "es ru"
+
+
 @pytest.mark.integration_test
 def test_import_group(client: citric.Client, survey_id: int):
     """Test importing a group from an lsg file."""