core/domain/param_domain_test.py - develop - githubmirror/oppia

core/domain/param_domain_test.py
158 строк6 KB
Gabriel Fuentes
Black formatter staging (#23456)
05 окт 2025, 06:15
05 окт 2025, 06:1562ec95a
# coding: utf-8
#
# Copyright 2014 The Oppia Authors. 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, softwar
# 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 parameter domain objects."""

from __future__ import annotations

from core import feconf, utils
from core.domain import object_registry, param_domain
from core.tests import test_utils


class ParameterDomainUnitTests(test_utils.GenericTestBase):
    """Tests for parameter domain objects."""

    def setUp(self) -> None:
        self.sample_customization_args: (
            param_domain.CustomizationArgsDictWithValue
        ) = {
            'value': '5',
            'parse_with_jinja': True,
        }

    def test_param_spec_validation(self) -> None:
        """Test validation of param specs."""

        param_spec = param_domain.ParamSpec('Real')
        with self.assertRaisesRegex(
            utils.ValidationError, 'is not among the supported object types'
        ):
            param_spec.validate()

        # Restore a valid parameter spec.
        param_spec.obj_type = 'UnicodeString'
        param_spec.validate()

    def test_supported_object_types_exist_in_registry(self) -> None:
        """Test the supported object types of param specs."""

        # Ensure that this object class exists.
        for obj_type in feconf.SUPPORTED_OBJ_TYPES:
            object_registry.Registry.get_object_class_by_type(obj_type)

    def test_param_change_validation(self) -> None:
        """Test validation of parameter changes."""
        # Raise an error because the name is invalid.
        with self.assertRaisesRegex(
            utils.ValidationError, 'Only parameter names'
        ):
            param_domain.ParamChange(
                '¡hola', 'Copier', self.sample_customization_args
            ).validate()

        # Raise an error because generator ID is not string.
        with self.assertRaisesRegex(
            utils.ValidationError, 'Expected generator ID to be a string'
        ):
            # TODO(#13059): Here we use MyPy ignore because after we fully type
            # the codebase we plan to get rid of the tests that intentionally
            # test wrong inputs that we can normally catch by typing.
            param_domain.ParamChange(
                'abc',
                123,  # type: ignore[arg-type]
                self.sample_customization_args,
            ).validate()

        # Raise an error because no such generator type exists.
        with self.assertRaisesRegex(
            utils.ValidationError, 'Invalid generator ID'
        ):
            param_domain.ParamChange(
                'abc', 'InvalidGenerator', self.sample_customization_args
            ).validate()

        # Raise an error because customization_args is not a dict.
        with self.assertRaisesRegex(utils.ValidationError, 'Expected a dict'):
            # TODO(#13059): Here we use MyPy ignore because after we fully type
            # the codebase we plan to get rid of the tests that intentionally
            # test wrong inputs that we can normally catch by typing.
            param_domain.ParamChange('abc', 'Copier', ['a', 'b']).validate()  # type: ignore[arg-type]

        # Raise an error because the param_change name is not a string.
        with self.assertRaisesRegex(
            utils.ValidationError,
            'Expected param_change name to be a string, received',
        ):
            # TODO(#13059): Here we use MyPy ignore because after we fully type
            # the codebase we plan to get rid of the tests that intentionally
            # test wrong inputs that we can normally catch by typing.
            param_domain.ParamChange(
                3,  # type: ignore[arg-type]
                'Copier',
                self.sample_customization_args,
            ).validate()

        # Raise an error because the arg names in customization_args are not
        # strings.
        with self.assertRaisesRegex(
            Exception, 'Invalid parameter change customization_arg name:'
        ):
            # TODO(#13059): Here we use MyPy ignore because after we fully type
            # the codebase we plan to get rid of the tests that intentionally
            # test wrong inputs that we can normally catch by typing.
            customization_args_dict = {1: '1'}
            param_domain.ParamChange(
                'abc', 'Copier', customization_args_dict  # type: ignore[arg-type]
            ).validate()

    def test_param_spec_to_dict(self) -> None:
        sample_dict = {'obj_type': 'UnicodeString'}
        param_spec = param_domain.ParamSpec(sample_dict['obj_type'])
        self.assertEqual(param_spec.to_dict(), sample_dict)

    def test_param_spec_from_dict(self) -> None:
        sample_dict: param_domain.ParamSpecDict = {'obj_type': 'UnicodeString'}
        param_spec = param_domain.ParamSpec.from_dict(sample_dict)
        self.assertEqual(param_spec.to_dict(), sample_dict)

    def test_param_change_class(self) -> None:
        """Test the ParamChange class."""
        param_change = param_domain.ParamChange(
            'abc', 'Copier', {'value': '3', 'parse_with_jinja': True}
        )
        param_change.validate()
        self.assertEqual(param_change.name, 'abc')
        self.assertEqual(param_change.generator.id, 'Copier')
        self.assertEqual(
            param_change.to_dict(),
            {
                'name': 'abc',
                'generator_id': 'Copier',
                'customization_args': {'value': '3', 'parse_with_jinja': True},
            },
        )
        self.assertEqual(param_change.get_value({}), '3')

    def test_param_change_from_dict(self) -> None:
        sample_dict: param_domain.ParamChangeDict = {
            'name': 'abc',
            'generator_id': 'Copier',
            'customization_args': self.sample_customization_args,
        }
        param_change = param_domain.ParamChange.from_dict(sample_dict)
        param_change.validate()
        self.assertEqual(param_change.to_dict(), sample_dict)