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

coati_payroll/nomina_engine/validators/period_validator.py

@@ -1,16 +1,5 @@
-# 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.
 """Validator for payroll period."""
 
 from __future__ import annotations

coati_payroll/nomina_engine/validators/planilla_validator.py

@@ -1,16 +1,5 @@
-# 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.
 """Validator for Planilla."""
 
 from __future__ import annotations

coati_payroll/queue/__init__.py

@@ -1,16 +1,5 @@
-# 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.
 """Queue module for background job processing.
 
 This module provides a unified interface for background job processing

coati_payroll/queue/driver.py

@@ -1,16 +1,5 @@
-# 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.
 """Abstract base class for queue drivers."""
 
 from __future__ import annotations

coati_payroll/queue/drivers/__init__.py

@@ -1,16 +1,5 @@
-# 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.
 """Queue driver implementations."""
 
 from __future__ import annotations

coati_payroll/queue/drivers/dramatiq_driver.py

@@ -1,16 +1,5 @@
-# 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.
 """Dramatiq driver for high-performance queue processing with Redis."""
 
 from __future__ import annotations
@@ -20,6 +9,10 @@ from typing import Any, Callable
 from coati_payroll.log import log
 from coati_payroll.queue.driver import QueueDriver
 
+# Error messages
+ERROR_DRAMATIQ_NOT_AVAILABLE = "Dramatiq driver not available"
+ERROR_HUEY_NOT_AVAILABLE = "Huey driver not available"
+
 
 class DramatiqDriver(QueueDriver):
     """Queue driver using Dramatiq with Redis backend.
@@ -179,7 +172,7 @@ class DramatiqDriver(QueueDriver):
             Dictionary with queue statistics
         """
         if not self._available or not self._broker:
-            return {"error": "Dramatiq driver not available"}
+            return {"error": ERROR_DRAMATIQ_NOT_AVAILABLE}
 
         try:
             import redis
@@ -224,7 +217,7 @@ class DramatiqDriver(QueueDriver):
             Dictionary with task status (limited in Dramatiq without results backend)
         """
         if not self._available:
-            return {"status": "error", "error": "Dramatiq driver not available"}
+            return {"status": "error", "error": ERROR_DRAMATIQ_NOT_AVAILABLE}
 
         try:
             # Dramatiq messages don't have built-in result tracking
@@ -251,7 +244,7 @@ class DramatiqDriver(QueueDriver):
             Dictionary with aggregated status (limited without Results backend)
         """
         if not self._available:
-            return {"error": "Dramatiq driver not available"}
+            return {"error": ERROR_DRAMATIQ_NOT_AVAILABLE}
 
         total = len(task_ids)
 

coati_payroll/queue/drivers/huey_driver.py

@@ -1,16 +1,5 @@
-# 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.
 """Huey driver for filesystem-based queue processing (fallback mode)."""
 
 from __future__ import annotations

coati_payroll/queue/drivers/noop_driver.py

@@ -1,16 +1,5 @@
-# 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.
 
 """No-op queue driver for test environments.
 

coati_payroll/queue/selector.py

@@ -1,16 +1,5 @@
-# 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.
 """Automatic queue driver selection based on environment."""
 
 from __future__ import annotations

coati_payroll/queue/tasks.py

@@ -1,16 +1,5 @@
-# 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.
 """Background tasks for payroll processing.
 
 This module defines tasks that can be executed in the background:
@@ -46,6 +35,10 @@ from coati_payroll.model import (
 from coati_payroll.nomina_engine import NominaEngine
 from coati_payroll.queue import get_queue_driver
 
+# Error messages
+ERROR_PLANILLA_NOT_FOUND = "Planilla not found"
+ERROR_NO_ACTIVE_EMPLOYEES = "No active employees found"
+
 # Get the queue driver
 queue = get_queue_driver()
 
@@ -169,7 +162,7 @@ def retry_failed_nomina(nomina_id: str, usuario: str | None = None) -> dict[str,
         if not planilla:
             return {
                 "success": False,
-                "error": "Planilla not found",
+                "error": ERROR_PLANILLA_NOT_FOUND,
             }
 
         # Reset nomina state for retry
@@ -325,7 +318,7 @@ def calculate_employee_payroll(
             return {
                 "empleado_id": empleado_id,
                 "success": False,
-                "error": "Planilla not found",
+                "error": ERROR_PLANILLA_NOT_FOUND,
             }
 
         # Initialize engine for single employee
@@ -414,7 +407,7 @@ def process_payroll_parallel(
         if not empleados:
             return {
                 "success": False,
-                "error": "No active employees found",
+                "error": ERROR_NO_ACTIVE_EMPLOYEES,
             }
 
         # Create nomina record first
@@ -518,11 +511,11 @@ def process_large_payroll(
         if not planilla:
             log.error(f"Planilla {planilla_id} not found")
             nomina.estado = NominaEstado.ERROR
-            nomina.errores_calculo = {"error": "Planilla not found"}
+            nomina.errores_calculo = {"error": ERROR_PLANILLA_NOT_FOUND}
             db.session.commit()
             return {
                 "success": False,
-                "error": "Planilla not found",
+                "error": ERROR_PLANILLA_NOT_FOUND,
             }
 
         # Get all active employees
@@ -531,11 +524,11 @@ def process_large_payroll(
         if not empleados:
             log.warning(f"No active employees found for planilla {planilla_id}")
             nomina.estado = NominaEstado.ERROR
-            nomina.errores_calculo = {"error": "No active employees found"}
+            nomina.errores_calculo = {"error": ERROR_NO_ACTIVE_EMPLOYEES}
             db.session.commit()
             return {
                 "success": False,
-                "error": "No active employees found",
+                "error": ERROR_NO_ACTIVE_EMPLOYEES,
             }
 
         # Initialize progress tracking

coati_payroll/rate_limiting.py

@@ -1,16 +1,5 @@
-# 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.
 """Rate limiting configuration for the application.
 
 This module configures rate limiting to protect against brute force attacks

coati_payroll/rbac.py

@@ -1,16 +1,5 @@
-# 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.
 """Role-Based Access Control (RBAC) utilities.
 
 This module provides decorators and utilities for implementing role-based
@@ -41,6 +30,10 @@ from flask_login import current_user
 from coati_payroll.enums import TipoUsuario
 from coati_payroll.i18n import _
 
+# Constants
+MESSAGE_LOGIN_REQUIRED = "Favor iniciar sesión para acceder al sistema."
+ROUTE_AUTH_LOGIN = "auth.login"
+
 
 def require_role(*allowed_roles: str):
     """Decorator to restrict access to specific user roles.
@@ -65,8 +58,8 @@ def require_role(*allowed_roles: str):
         @wraps(f)
         def decorated_function(*args, **kwargs):
             if not current_user.is_authenticated:
-                flash(_("Favor iniciar sesión para acceder al sistema."), "warning")
-                return redirect(url_for("auth.login"))
+                flash(_(MESSAGE_LOGIN_REQUIRED), "warning")
+                return redirect(url_for(ROUTE_AUTH_LOGIN))
 
             # Check if user has required role
             if current_user.tipo not in allowed_roles:
@@ -99,8 +92,8 @@ def require_read_access():
         @wraps(f)
         def decorated_function(*args, **kwargs):
             if not current_user.is_authenticated:
-                flash(_("Favor iniciar sesión para acceder al sistema."), "warning")
-                return redirect(url_for("auth.login"))
+                flash(_(MESSAGE_LOGIN_REQUIRED), "warning")
+                return redirect(url_for(ROUTE_AUTH_LOGIN))
 
             # All authenticated users can read
             return f(*args, **kwargs)
@@ -132,8 +125,8 @@ def require_write_access():
         @wraps(f)
         def decorated_function(*args, **kwargs):
             if not current_user.is_authenticated:
-                flash(_("Favor iniciar sesión para acceder al sistema."), "warning")
-                return redirect(url_for("auth.login"))
+                flash(_(MESSAGE_LOGIN_REQUIRED), "warning")
+                return redirect(url_for(ROUTE_AUTH_LOGIN))
 
             # Only admin and hhrr can write
             if current_user.tipo not in [TipoUsuario.ADMIN, TipoUsuario.HHRR]:

coati_payroll/report_engine.py

@@ -1,16 +1,5 @@
-# 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.
 """Report execution engine for system and custom reports.
 
 This module provides the core functionality for executing reports:

coati_payroll/report_export.py

@@ -1,16 +1,5 @@
-# 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.
 """Report export functionality for Excel format.
 
 Provides utilities to export report results to Excel files with proper

coati_payroll/schema_validator.py

@@ -1,16 +1,5 @@
-# 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.
 """Schema validation for formula engine calculation rules.
 
 This module provides validation functions for JSON schemas used by the

coati_payroll/security.py

@@ -1,16 +1,5 @@
-# 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.
 """Security module - HTTP Security Headers and Security Utilities.
 
 This module implements security best practices for Flask applications,