Feature/uv

.github/dependabot.yml

@@ -3,4 +3,4 @@ updates:
   - package-ecosystem: "pip"
     directory: "/"
     schedule:
-      interval: "weekly"
+      interval: "weekly"

.gitignore

@@ -16,4 +16,4 @@ appsettings.json
 .ruff_cache
 .tool-versions
 .tox
-coverage.xml
+coverage.xml

.pre-commit-config.yaml

@@ -3,7 +3,7 @@ default_language_version:
 
 repos:
 - repo: https://github.com/pre-commit/pre-commit-hooks
-  rev: v4.5.0
+  rev: v5.0.0
   hooks:
   - id: trailing-whitespace
   - id: end-of-file-fixer
@@ -12,35 +12,28 @@ repos:
   - id: check-symlinks
   - id: destroyed-symlinks
   - id: mixed-line-ending
-    args:
-      - "--fix=lf"
+  - id: check-case-conflict
+  - id: check-merge-conflict
 
 - repo: https://github.com/asottile/pyupgrade
-  rev: v3.15.1
+  rev: v3.19.0
   hooks:
     - id: pyupgrade
-      args: ["--py39-plus"]
+      args: ["--py311-plus"]
 
-- repo: https://github.com/python-poetry/poetry
-  rev: 1.8.0
+- repo: https://github.com/astral-sh/uv-pre-commit
+  # uv version.
+  rev: 0.5.2
   hooks:
-  - id: poetry-check
-  - id: poetry-lock
-  - id: poetry-export
-    args: [
-      "--with",
-      "dev",
-      "-f",
-      "requirements.txt",
-      "-o",
-      "./requirements/requirements_dev.txt",
-    ]
+    # Compile requirements
+    - id: pip-compile
+      args: [requirements-dev.in, -o, requirements-dev.txt]
+      files: ^requirements-dev\.(in|txt)$
 
 - repo: https://github.com/astral-sh/ruff-pre-commit
-  rev: v0.3.0
+  rev: v0.7.4
   hooks:
   - id: ruff
-    args:
-      - "--fix"
-      - "--fixable=ALL"
-      - "--exit-non-zero-on-fix"
+    args: [--exit-non-zero-on-fix, --config=pyproject.toml]
+  - id: ruff-format
+    args: [--config=pyproject.toml]

flunt/constants/__init__.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from .messages import (
     CNPJ,
     CONTAINS,
@@ -14,10 +16,11 @@
     EMAIL,
     EQUALS,
     EXACT_LENGTH,
+    GREATER_OR_EQUALS_THAN,
     GREATER_THAN,
-    GREATER_THAN_OR_EQUALS,
     IN_LIST,
     IP,
+    IS_BETWEEN,
     IS_CALLABLE,
     IS_DECIMAL,
     IS_DICT,
@@ -48,8 +51,8 @@
     IS_TRUE,
     IS_TYPE,
     IS_UUID,
-    LESS_THAN,
-    LESS_THAN_OR_EQUALS,
+    LOWER_OR_EQUALS_THAN,
+    LOWER_THAN,
     MAC_ADDRESS,
     MAX_LENGTH,
     MIN_LENGTH,
@@ -83,9 +86,9 @@
     "CNPJ",
     "PHONE",
     "GREATER_THAN",
-    "GREATER_THAN_OR_EQUALS",
-    "LESS_THAN",
-    "LESS_THAN_OR_EQUALS",
+    "GREATER_OR_EQUALS_THAN",
+    "LOWER_THAN",
+    "LOWER_OR_EQUALS_THAN",
     "EQUALS",
     "NOT_EQUALS",
     "IN_LIST",
@@ -122,4 +125,5 @@
     "IS_NOT_SET",
     "IS_STR",
     "IS_NOT_STR",
+    "IS_BETWEEN",
 ]

flunt/constants/messages.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 REQUIRED = "The field {0} is required"
 MAX_LENGTH = "The field {0} must be less than {1} characters"
 MIN_LENGTH = "The field {0} must be at least {1} characters"
@@ -20,9 +22,9 @@
 CNPJ = "The field {0} must be a valid CNPJ"
 PHONE = "The field {0} must be a valid phone number"
 GREATER_THAN = "The field {0} must be greater than {1}"
-GREATER_THAN_OR_EQUALS = "The field {0} must be greater than or equals {1}"
-LESS_THAN = "The field {0} must be less than {1}"
-LESS_THAN_OR_EQUALS = "The field {0} must be less than or equals {1}"
+GREATER_OR_EQUALS_THAN = "The field {0} must be greater or equals than {1}"
+LOWER_THAN = "The field {0} must be lower than {1}"
+LOWER_OR_EQUALS_THAN = "The field {0} must be lower or equals than {1}"
 EQUALS = "The field {0} must be equals {1}"
 NOT_EQUALS = "The field {0} must be different than {1}"
 IN_LIST = "The field {0} must be in the list {1}"
@@ -98,3 +100,4 @@
 IS_DATE_NOT_EQUAL = "The field {0} must not be a Date equal to {1}"
 IS_DATE_EQUAL = "The field {0} must be a Date equal to {1}"
 IS_DATE_NOT_EQUAL = "The field {0} must not be a Date equal to {1}"
+IS_BETWEEN = "The field {0} must be between {1} and {2}"

flunt/localization/flunt_regex_patterns.py

@@ -1,17 +1,28 @@
 """Module Flunt Regex Patterns."""
 
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from re import Pattern
+
 REGEX_PATTERNS = {
     "email": r"(^[a-zA-Z0-9_.+-]+@[a-zA-Z0-9-]+\.[a-zA-Z0-9-.]+$)",
     "passport": r"^(?!^0+$)[a-zA-Z0-9]{3,20}$",
     "only_numbers": r"^\d+$",
     "only_letters_and_numbers": r"[A-Za-z0-9_-]",
     "url": r"^(http|https):(\/\/www\.|\/\/www\.|\/\/|\/\/)[a-z0-9]+([\-\.]{1}[a-z0-9]+)*\.[a-z]{2,5}(:[0-9]{1,5})?(\/.*)?$"
-           r"|(http|https):(\/\/localhost:\d*|\/\/127\.([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\.([0-9]|[1-9][0-9]"
-           r"|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\.([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5]))(:[0-9]{1,5})?(\/.*)?$",
+    r"|(http|https):(\/\/localhost:\d*|\/\/127\.([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\.([0-9]|[1-9][0-9]"
+    r"|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\.([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5]))(:[0-9]{1,5})?(\/.*)?$",
     "cpf": r"^\d{3}\.?\d{3}\.?\d{3}-?\d{2}$",
     "cnpj": r"^\d{2}\.?\d{3}\.?\d{3}/?\d{4}-?\d{2}$",
 }
 
-def get_pattern(name: str) -> str | None:
+
+def get_pattern(name: str) -> str | Pattern[str]:
     """Retrieve a regex pattern by its name."""
-    return REGEX_PATTERNS.get(name)
+    value = REGEX_PATTERNS.get(name)
+    if value is None:
+        return ""
+    return value

flunt/notifications/notifiable.py

@@ -1,11 +1,12 @@
 """Module Notifiable."""
 
-from abc import ABC
+from __future__ import annotations
 
 from flunt.notifications.notification import Notification
+from flunt.protocols.notifiable_protocol import NotifiableProtocol
 
 
-class Notifiable(ABC):  # noqa: B024
+class Notifiable(NotifiableProtocol):
     """
     A class representing an object that can be notified.
 

flunt/notifications/notification.py

@@ -1,5 +1,7 @@
 """Module Notification."""
 
+from __future__ import annotations
+
 from dataclasses import dataclass
 
 

flunt/protocols/notifiable_protocol.py

@@ -0,0 +1,181 @@
+"""Module Notifiable."""
+
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from flunt.notifications.notification import Notification
+
+
+class NotifiableProtocol(ABC):
+    """
+    A class representing an object that can be notified.
+
+    This class extends Notification and provides methods for managing notifications.
+
+    Attributes
+    ----------
+    notifications: list[Notification]
+            A list of notifications.
+    is_valid: bool
+            A boolean indicating if there are any notifications.
+
+    Methods
+    -------
+    - get_notification_instance
+    - add_notifications
+    - add_notification
+    - get_notifications
+    - clear
+
+    """
+
+    @abstractmethod
+    def __init__(self) -> None:
+        """Initialize the list of notifications."""
+
+    @property
+    @abstractmethod
+    def notifications(self) -> list[Notification]:
+        """
+        Return the list of notifications.
+
+        Returns
+        -------
+        `list[Notification]`
+                A list of notifications.
+
+        Examples
+        --------
+        ```python
+        obj = Notifiable()
+        obj.notifications  # []
+        ```
+
+        """
+
+    @property
+    @abstractmethod
+    def is_valid(self) -> bool:
+        """
+        Check if there are any notifications.
+
+        Returns
+        -------
+        `bool`
+                True if there are no notifications, False otherwise.
+
+        Examples
+        --------
+        ```python
+        obj = Notifiable()
+        obj.is_valid()  # True
+        ```
+
+        """
+
+    @abstractmethod
+    def add_notifications(self, notifications: list[Notification]) -> None:
+        """
+        Add notifications from a list of contracts to the list of notifications.
+
+        Parameters
+        ----------
+        `notifications`: list[Notification]
+                A list of notifications to be added.
+
+        Returns
+        -------
+        `None`
+
+        Examples
+        --------
+        ```python
+        obj = Notifiable()
+        obj.add_notifications([Notification("key", "message")])
+        obj.notifications  # [Notification("key", "message")]
+        ```
+
+        """
+
+    @abstractmethod
+    def add_notification(self, field: str, message: str) -> None:
+        """
+        Add a single notification to the list of notifications.
+
+        Parameters
+        ----------
+        `notification`: Notification
+                The notification to be added.
+
+        Returns
+        -------
+        `None`
+
+        Examples
+        --------
+        ```python
+        obj = Notifiable()
+        obj.add_notification("field", "message")
+        obj.notifications  # [Notification("field", "message")]
+        ```
+
+        """
+
+    @abstractmethod
+    def get_notifications(self) -> list[Notification]:
+        """
+        Return the list of notifications.
+
+        Returns
+        -------
+        `list[Notification]`
+                A list of notifications.
+
+        Examples
+        --------
+        ```python
+        obj = Notifiable()
+        obj.get_notifications()  # []
+        ```
+
+        """
+
+    @abstractmethod
+    def clear(self) -> None:
+        """
+        Clear the list of notifications.
+
+        Returns
+        -------
+        `None`
+
+        Examples
+        --------
+        ```python
+        obj = Notifiable()
+        obj.clear()  # []
+        ```
+
+        """
+
+    @abstractmethod
+    def __repr__(self) -> str:
+        """
+        Return a string representation of the list of notifications.
+
+        Returns
+        -------
+        `str`
+                A string representation of the list of notifications.
+
+        Examples
+        --------
+        ```python
+        obj = Notifiable()
+        repr(obj)  # "[]"
+        ```
+
+        """