"""
This module provides classes for mapping rules used in a mapping system.
The mapping system allows for mapping tokens to specific objects based on predefined rules.
The module includes abstract base classes for mapping rules and several concrete implementations.
Classes:
- MappingRule: Abstract base class for mapping rules.
- LambdaMappingRule: Mapping rule defined by lambda functions.
- DirectMappingRule: Mapping rule for supported words.
- CharacterByCharacterMappingRule: Mapping rule for character-by-character mapping.
Each mapping rule class defines the behavior of the rule,
including applicability checks and actions to be taken when the rule is applied.
"""
from abc import ABC, abstractmethod
from typing import Any, Callable, Dict, List, Set
[docs]
class MappingRule(ABC):
"""
Abstract base class for mapping rules.
"""
@property
@abstractmethod
def priority(self) -> int:
"""
Priority of the mapping rule.
Returns:
int: The priority of the mapping rule.
"""
[docs]
@abstractmethod
def is_applicable(
self,
token: str,
tag: Any = None,
context: Any = None,
) -> bool:
"""
Check if the mapping rule is applicable for the given token, tag, and context.
Args:
token (str): The token to be checked.
tag (Any, optional): The tag associated with the token. Defaults to None.
context (Any, optional): The context in which the token appears. Defaults to None.
Returns:
bool: True if the mapping rule is applicable, False otherwise.
"""
[docs]
@abstractmethod
def apply(self, token: str) -> Any:
"""
Apply the mapping rule to the given token. (i.e. map the given token to something.)
Args:
token (str): The token to apply the mapping rule to.
Returns:
The result of applying the mapping rule.
"""
[docs]
class LambdaMappingRule(MappingRule):
"""Mapping rule based on lambda functions.
Args:
is_applicable_function (Callable[[str, Any, Any], bool]):
Function to check if the rule is applicable to the given token, tag & context.
apply_function (Callable[[str], Any]): Function to apply the rule to the token.
priority (int): Priority of the rule.
"""
def __init__(
self,
is_applicable_function: Callable[[str, Any, Any], bool],
apply_function: Callable[[str], Any],
priority: int,
) -> None:
super().__init__()
self.is_applicable_function = is_applicable_function
self.apply_function = apply_function
self._priority = priority
[docs]
def is_applicable(self, token, tag=None, context=None) -> bool:
return self.is_applicable_function(token, tag, context)
[docs]
def apply(self, token) -> Any:
return self.apply_function(token)
@property
def priority(self):
return self._priority
[docs]
class DirectMappingRule(MappingRule):
"""Mapping rule that directly maps keys to values.
Args:
token_to_object (Dict[str, Any]): Dictionary mapping tokens to some objects.
priority (int): Priority of the rule.
"""
def __init__(self, token_to_object: Dict[str, Any], priority: int) -> None:
super().__init__()
self.token_to_object = token_to_object
self._priority = priority
[docs]
def is_applicable(self, token, tag=None, context=None) -> bool:
return token in self.token_to_object
[docs]
def apply(self, token: str) -> Any:
return self.token_to_object[token]
@property
def priority(self):
return self._priority
[docs]
class CharacterByCharacterMappingRule(MappingRule):
"""Mapping rule which maps a token character-by-character.
Args:
token_to_object (Dict[str, Any]): Dictionary mapping tokens to some objects.
allowed_tags (Set[Any]): Set of allowed tags for the rule to be applicable.
priority (int): Priority of the rule.
"""
def __init__(
self,
token_to_object: Dict[str, Any],
allowed_tags: Set[Any],
priority: int,
) -> None:
super().__init__()
self.token_to_object = token_to_object
self.allowed_tags = allowed_tags
self._priority = priority
[docs]
def is_applicable(self, token, tag=None, context=None) -> bool:
return tag in self.allowed_tags and all(
char in self.token_to_object for char in token
)
[docs]
def apply(self, token) -> List[Any]:
"""Apply the mapping rule to the given token.
Args:
token (str): The token to apply the mapping rule to.
Returns:
List[Any]: list of results of applying the mapping rule to each character in the token.
"""
return [self.token_to_object[char] for char in token]
@property
def priority(self):
return self._priority