coati-payroll 0.0.12__py3-none-any.whl → 0.0.13__py3-none-any.whl

coati_payroll/formula_engine/exceptions.py

@@ -1,20 +1,20 @@
-# Copyright 2025 BMO Soluciones, S.A.
-#
-# 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.
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: 2025 - 2026 BMO Soluciones, S.A.
 """Exceptions for formula engine."""
 
 from __future__ import annotations
 
+# <-------------------------------------------------------------------------> #
+# Standard library
+# <-------------------------------------------------------------------------> #
+
+# <-------------------------------------------------------------------------> #
+# Third party packages
+# <-------------------------------------------------------------------------> #
+
+# <-------------------------------------------------------------------------> #
+# Local modules
+# <-------------------------------------------------------------------------> #
 from coati_payroll.schema_validator import ValidationError as _BaseValidationError
 
 

coati_payroll/formula_engine/execution/__init__.py

@@ -1,22 +1,24 @@
-# Copyright 2025 BMO Soluciones, S.A.
-#
-# 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.
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: 2025 - 2026 BMO Soluciones, S.A.
 """Execution context and step execution modules."""
 
+# <-------------------------------------------------------------------------> #
+# Standard library
+# <-------------------------------------------------------------------------> #
+
+
+# <-------------------------------------------------------------------------> #
+# Third party packages
+# <-------------------------------------------------------------------------> #
+
+# <-------------------------------------------------------------------------> #
+# Local modules
+# <-------------------------------------------------------------------------> #
 from .execution_context import ExecutionContext
 from .step_executor import StepExecutor
 from .variable_store import VariableStore
 
+# <==================[ Expose all varaibles and constants ]===================>
 __all__ = [
     "ExecutionContext",
     "StepExecutor",

coati_payroll/formula_engine/execution/execution_context.py

@@ -1,24 +1,23 @@
-# Copyright 2025 BMO Soluciones, S.A.
-#
-# 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.
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: 2025 - 2026 BMO Soluciones, S.A.
 """Execution context for formula engine."""
 
 from __future__ import annotations
 
+# <-------------------------------------------------------------------------> #
+# Standard library
+# <-------------------------------------------------------------------------> #
 from dataclasses import dataclass, field
 from decimal import Decimal
 from typing import Any, Callable
 
+# <-------------------------------------------------------------------------> #
+# Third party packages
+# <-------------------------------------------------------------------------> #
+
+# <-------------------------------------------------------------------------> #
+# Local modules
+# <-------------------------------------------------------------------------> #
 from ..ast.safe_operators import SAFE_FUNCTIONS, SAFE_OPERATORS
 
 

coati_payroll/formula_engine/execution/step_executor.py

@@ -1,24 +1,22 @@
-# Copyright 2025 BMO Soluciones, S.A.
-#
-# 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.
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: 2025 - 2026 BMO Soluciones, S.A.
 """Step executor for formula engine."""
 
 from __future__ import annotations
 
+# <-------------------------------------------------------------------------> #
+# Standard library
+# <-------------------------------------------------------------------------> #
 from typing import TYPE_CHECKING, Any
 
-from coati_payroll.i18n import _
+# <-------------------------------------------------------------------------> #
+# Third party packages
+# <-------------------------------------------------------------------------> #
 
+# <-------------------------------------------------------------------------> #
+# Local modules
+# <-------------------------------------------------------------------------> #
+from coati_payroll.i18n import _
 from ..exceptions import CalculationError
 from .execution_context import ExecutionContext
 

coati_payroll/formula_engine/execution/variable_store.py

@@ -1,23 +1,23 @@
-# Copyright 2025 BMO Soluciones, S.A.
-#
-# 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.
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: 2025 - 2026 BMO Soluciones, S.A.
 """Variable store for formula execution."""
 
 from __future__ import annotations
 
+# <-------------------------------------------------------------------------> #
+# Standard library
+# <-------------------------------------------------------------------------> #
 from decimal import Decimal
 from typing import Any
 
+# <-------------------------------------------------------------------------> #
+# Third party packages
+# <-------------------------------------------------------------------------> #
+
+# <-------------------------------------------------------------------------> #
+# Local modules
+# <-------------------------------------------------------------------------> #
+
 
 class VariableStore:
     """Manages variables during formula execution."""

coati_payroll/formula_engine/novelty_codes.py

@@ -1,22 +1,12 @@
-# Copyright 2025 BMO Soluciones, S.A.
-#
-# 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.
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: 2025 - 2026 BMO Soluciones, S.A.
 """Mapping of novelty codes to their calculation behavior.
 
 This module defines the mapping between novelty codes and their
 calculation behavior (perception/deduction, gravable, etc.).
 """
 
+# ................................ CONTANTES ................................ #
 NOVELTY_CODES = {
     "HORAS_EXTRA": {
         "tipo": "percepcion",

coati_payroll/formula_engine/results/__init__.py

@@ -1,20 +1,21 @@
-# Copyright 2025 BMO Soluciones, S.A.
-#
-# 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.
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: 2025 - 2026 BMO Soluciones, S.A.
 """Result DTOs for formula engine execution."""
 
+# <-------------------------------------------------------------------------> #
+# Standard library
+# <-------------------------------------------------------------------------> #
+
+# <-------------------------------------------------------------------------> #
+# Third party packages
+# <-------------------------------------------------------------------------> #
+
+# <-------------------------------------------------------------------------> #
+# Local modules
+# <-------------------------------------------------------------------------> #
 from .execution_result import ExecutionResult
 
+# <==================[ Expose all varaibles and constants ]===================>
 __all__ = [
     "ExecutionResult",
 ]

coati_payroll/formula_engine/results/execution_result.py

@@ -1,23 +1,23 @@
-# Copyright 2025 BMO Soluciones, S.A.
-#
-# 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.
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: 2025 - 2026 BMO Soluciones, S.A.
 """Execution result DTO."""
 
 from __future__ import annotations
 
-from decimal import Decimal
+# <-------------------------------------------------------------------------> #
+# Standard library
+# <-------------------------------------------------------------------------> #
+from decimal import Decimal, ROUND_HALF_UP
 from typing import Any
 
+# <-------------------------------------------------------------------------> #
+# Third party packages
+# <-------------------------------------------------------------------------> #
+
+# <-------------------------------------------------------------------------> #
+# Local modules
+# <-------------------------------------------------------------------------> #
+
 
 class ExecutionResult:
     """Result of formula execution."""
@@ -28,32 +28,44 @@ class ExecutionResult:
         step_results: dict[str, Any],
         final_output: Decimal,
     ):
-        """Initialize execution result.
-
-        Args:
-            variables: All variables after execution
-            step_results: Results from each step
-            final_output: Final output value
-        """
         self.variables = variables
         self.step_results = step_results
         self.final_output = final_output
 
     def to_dict(self) -> dict[str, Any]:
-        """Convert result to dictionary format.
+        """Convert result to dictionary format with 2 decimal places rounding."""
+
+        def _round_to_two(value: Decimal) -> float:
+            """Round Decimal to 2 decimal places."""
+            rounded = value.quantize(Decimal("0.01"), rounding=ROUND_HALF_UP)
+            return float(rounded)
+
+        # Procesar variables
+        processed_vars = {}
+        for key, value in self.variables.items():
+            if isinstance(value, Decimal):
+                processed_vars[key] = _round_to_two(value)
+            else:
+                processed_vars[key] = value
+
+        # Procesar step_results
+        processed_results = {}
+        for key, value in self.step_results.items():
+            if isinstance(value, Decimal):
+                processed_results[key] = _round_to_two(value)
+            elif isinstance(value, dict):
+                processed_dict = {}
+                for k, v in value.items():
+                    if isinstance(v, Decimal):
+                        processed_dict[k] = _round_to_two(v)
+                    else:
+                        processed_dict[k] = v
+                processed_results[key] = processed_dict
+            else:
+                processed_results[key] = value
 
-        Returns:
-            Dictionary representation of result
-        """
         return {
-            "variables": {k: float(v) for k, v in self.variables.items()},
-            "results": {
-                k: (
-                    float(v)
-                    if isinstance(v, Decimal)
-                    else ({kk: float(vv) for kk, vv in v.items()} if isinstance(v, dict) else v)
-                )
-                for k, v in self.step_results.items()
-            },
-            "output": float(self.final_output),
+            "variables": processed_vars,
+            "results": processed_results,
+            "output": _round_to_two(self.final_output),
         }

coati_payroll/formula_engine/steps/__init__.py

@@ -1,18 +1,18 @@
-# Copyright 2025 BMO Soluciones, S.A.
-#
-# 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.
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: 2025 - 2026 BMO Soluciones, S.A.
 """Step execution modules using Strategy pattern."""
 
+# <-------------------------------------------------------------------------> #
+# Standard library
+# <-------------------------------------------------------------------------> #
+
+# <-------------------------------------------------------------------------> #
+# Third party packages
+# <-------------------------------------------------------------------------> #
+
+# <-------------------------------------------------------------------------> #
+# Local modules
+# <-------------------------------------------------------------------------> #
 from .base_step import Step
 from .calculation_step import CalculationStep
 from .conditional_step import ConditionalStep
@@ -20,7 +20,7 @@ from .tax_lookup_step import TaxLookupStep
 from .assignment_step import AssignmentStep
 from .step_factory import StepFactory
 
-__all__ = [
+__all__ = [  # <==================[ Expose all varaibles and constants ]===================>
     "Step",
     "CalculationStep",
     "ConditionalStep",

coati_payroll/formula_engine/steps/assignment_step.py

@@ -1,23 +1,22 @@
-# Copyright 2025 BMO Soluciones, S.A.
-#
-# 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.
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: 2025 - 2026 BMO Soluciones, S.A.
 """Assignment step implementation."""
 
 from __future__ import annotations
 
+# <-------------------------------------------------------------------------> #
+# Standard library
+# <-------------------------------------------------------------------------> #
 from decimal import Decimal
 from typing import TYPE_CHECKING, Any
 
+# <-------------------------------------------------------------------------> #
+# Third party packages
+# <-------------------------------------------------------------------------> #
+
+# <-------------------------------------------------------------------------> #
+# Local modules
+# <-------------------------------------------------------------------------> #
 from ..ast.type_converter import to_decimal
 from .base_step import Step
 

coati_payroll/formula_engine/steps/base_step.py

@@ -1,23 +1,23 @@
-# Copyright 2025 BMO Soluciones, S.A.
-#
-# 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.
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: 2025 - 2026 BMO Soluciones, S.A.
 """Base step interface for Strategy pattern."""
 
 from __future__ import annotations
 
+# <-------------------------------------------------------------------------> #
+# Standard library
+# <-------------------------------------------------------------------------> #
 from abc import ABC, abstractmethod
 from typing import Any, TYPE_CHECKING
 
+# <-------------------------------------------------------------------------> #
+# Third party packages
+# <-------------------------------------------------------------------------> #
+
+# <-------------------------------------------------------------------------> #
+# Local modules
+# <-------------------------------------------------------------------------> #
+
 if TYPE_CHECKING:
     from ..execution.execution_context import ExecutionContext
 

coati_payroll/formula_engine/steps/calculation_step.py

@@ -1,23 +1,22 @@
-# Copyright 2025 BMO Soluciones, S.A.
-#
-# 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.
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: 2025 - 2026 BMO Soluciones, S.A.
 """Calculation step implementation."""
 
 from __future__ import annotations
 
+# <-------------------------------------------------------------------------> #
+# Standard library
+# <-------------------------------------------------------------------------> #
 from decimal import Decimal
 from typing import TYPE_CHECKING
 
+# <-------------------------------------------------------------------------> #
+# Third party packages
+# <-------------------------------------------------------------------------> #
+
+# <-------------------------------------------------------------------------> #
+# Local modules
+# <-------------------------------------------------------------------------> #
 from ..ast.expression_evaluator import ExpressionEvaluator
 from .base_step import Step
 

coati_payroll/formula_engine/steps/conditional_step.py

@@ -1,23 +1,22 @@
-# Copyright 2025 BMO Soluciones, S.A.
-#
-# 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.
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: 2025 - 2026 BMO Soluciones, S.A.
 """Conditional step implementation."""
 
 from __future__ import annotations
 
+# <-------------------------------------------------------------------------> #
+# Standard library
+# <-------------------------------------------------------------------------> #
 from decimal import Decimal
 from typing import TYPE_CHECKING, Any
 
+# <-------------------------------------------------------------------------> #
+# Third party packages
+# <-------------------------------------------------------------------------> #
+
+# <-------------------------------------------------------------------------> #
+# Local modules
+# <-------------------------------------------------------------------------> #
 from ..ast.expression_evaluator import ExpressionEvaluator
 from ..ast.safe_operators import COMPARISON_OPERATORS
 from ..ast.type_converter import to_decimal

coati_payroll/formula_engine/steps/step_factory.py

@@ -1,24 +1,22 @@
-# Copyright 2025 BMO Soluciones, S.A.
-#
-# 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.
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: 2025 - 2026 BMO Soluciones, S.A.
 """Factory for creating step instances."""
 
 from __future__ import annotations
 
+# <-------------------------------------------------------------------------> #
+# Standard library
+# <-------------------------------------------------------------------------> #
 from typing import Any
 
+# <-------------------------------------------------------------------------> #
+# Third party packages
+# <-------------------------------------------------------------------------> #
 from coati_payroll.enums import StepType
 
+# <-------------------------------------------------------------------------> #
+# Local modules
+# <-------------------------------------------------------------------------> #
 from ..exceptions import CalculationError
 from .assignment_step import AssignmentStep
 from .base_step import Step

coati_payroll/formula_engine/steps/tax_lookup_step.py

@@ -1,23 +1,22 @@
-# Copyright 2025 BMO Soluciones, S.A.
-#
-# 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.
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: 2025 - 2026 BMO Soluciones, S.A.
 """Tax lookup step implementation."""
 
 from __future__ import annotations
 
+# <-------------------------------------------------------------------------> #
+# Standard library
+# <-------------------------------------------------------------------------> #
 from decimal import Decimal
 from typing import TYPE_CHECKING
 
+# <-------------------------------------------------------------------------> #
+# Third party packages
+# <-------------------------------------------------------------------------> #
+
+# <-------------------------------------------------------------------------> #
+# Local modules
+# <-------------------------------------------------------------------------> #
 from ..tables.table_lookup import TableLookup
 from .base_step import Step
 

coati_payroll/formula_engine/tables/__init__.py

@@ -1,22 +1,23 @@
-# Copyright 2025 BMO Soluciones, S.A.
-#
-# 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.
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: 2025 - 2026 BMO Soluciones, S.A.
 """Tax table and bracket calculation modules."""
 
+# <-------------------------------------------------------------------------> #
+# Standard library
+# <-------------------------------------------------------------------------> #
+
+# <-------------------------------------------------------------------------> #
+# Third party packages
+# <-------------------------------------------------------------------------> #
+
+# <-------------------------------------------------------------------------> #
+# Local modules
+# <-------------------------------------------------------------------------> #
 from .tax_table import TaxTable
 from .bracket_calculator import BracketCalculator
 from .table_lookup import TableLookup
 
+# <==================[ Expose all varaibles and constants ]===================>
 __all__ = [
     "TaxTable",
     "BracketCalculator",