refactor(parser): add from __future__ import annotations (aws-powertools#4983)

* refactor(parser): add from __future__ import annotations

and update code according to ruff rules TCH, UP006, UP007, UP037 and
FA100.

* Fix type alias with Python 3.8

See https://bugs.python.org/issue45117

* Fix pydantic not working with Python 3.8

    TypeError: You have a type annotation 'str | None' which makes use
    of newer typing features than are supported in your version of Python.
    To handle this error, you should either remove the use of new syntax
    or install the `eval_type_backport` package.

* Update ruff.toml

Configure lint.per-file-ignores in ruff.toml instead of adding a

    # ruff: noqa: FA100

line to each file.

---------

Co-authored-by: Leandro Damascena <lcdama@amazon.pt>

Author: ericbn

aws_lambda_powertools/utilities/parser/functions.py

@@ -1,9 +1,13 @@
 from __future__ import annotations
 
+from typing import TYPE_CHECKING
+
 from pydantic import TypeAdapter
 
 from aws_lambda_powertools.shared.cache_dict import LRUDict
-from aws_lambda_powertools.utilities.parser.types import T
+
+if TYPE_CHECKING:
+    from aws_lambda_powertools.utilities.parser.types import T
 
 CACHE_TYPE_ADAPTER = LRUDict(max_items=1024)
 

aws_lambda_powertools/utilities/parser/models/apigw.py

@@ -1,11 +1,9 @@
 from datetime import datetime
-from typing import Any, Dict, List, Optional, Type, Union
+from typing import Any, Dict, List, Literal, Optional, Type, Union
 
 from pydantic import BaseModel, model_validator
 from pydantic.networks import IPvAnyNetwork
 
-from aws_lambda_powertools.utilities.parser.types import Literal
-
 
 class ApiGatewayUserCertValidity(BaseModel):
     notBefore: str

aws_lambda_powertools/utilities/parser/models/apigwv2.py

@@ -1,11 +1,9 @@
 from datetime import datetime
-from typing import Any, Dict, List, Optional, Type, Union
+from typing import Any, Dict, List, Literal, Optional, Type, Union
 
 from pydantic import BaseModel, Field
 from pydantic.networks import IPvAnyNetwork
 
-from aws_lambda_powertools.utilities.parser.types import Literal
-
 
 class RequestContextV2AuthorizerIamCognito(BaseModel):
     amr: List[str]

aws_lambda_powertools/utilities/parser/models/cloudformation_custom_resource.py

@@ -1,9 +1,7 @@
-from typing import Any, Dict, Union
+from typing import Any, Dict, Literal, Union
 
 from pydantic import BaseModel, Field, HttpUrl
 
-from aws_lambda_powertools.utilities.parser.types import Literal
-
 
 class CloudFormationCustomResourceBaseModel(BaseModel):
     request_type: str = Field(..., alias="RequestType")

aws_lambda_powertools/utilities/parser/models/dynamodb.py

@@ -1,10 +1,10 @@
+# ruff: noqa: FA100
 from datetime import datetime
-from typing import Any, Dict, List, Optional, Type, Union
+from typing import Any, Dict, List, Literal, Optional, Type, Union
 
 from pydantic import BaseModel, field_validator
 
 from aws_lambda_powertools.shared.dynamodb_deserializer import TypeDeserializer
-from aws_lambda_powertools.utilities.parser.types import Literal
 
 _DESERIALIZER = TypeDeserializer()
 

aws_lambda_powertools/utilities/parser/models/kafka.py

@@ -1,10 +1,9 @@
 from datetime import datetime
-from typing import Dict, List, Type, Union
+from typing import Dict, List, Literal, Type, Union
 
 from pydantic import BaseModel, field_validator
 
 from aws_lambda_powertools.shared.functions import base64_decode, bytes_to_string
-from aws_lambda_powertools.utilities.parser.types import Literal
 
 SERVERS_DELIMITER = ","
 

aws_lambda_powertools/utilities/parser/models/kinesis.py

@@ -1,14 +1,13 @@
 import json
 import zlib
-from typing import Dict, List, Type, Union
+from typing import Dict, List, Literal, Type, Union
 
 from pydantic import BaseModel, field_validator
 
 from aws_lambda_powertools.shared.functions import base64_decode
 from aws_lambda_powertools.utilities.parser.models.cloudwatch import (
     CloudWatchLogsDecode,
 )
-from aws_lambda_powertools.utilities.parser.types import Literal
 
 
 class KinesisDataStreamRecordPayload(BaseModel):

aws_lambda_powertools/utilities/parser/models/s3.py

@@ -1,13 +1,11 @@
 from datetime import datetime
-from typing import List, Optional
+from typing import List, Literal, Optional
 
 from pydantic import BaseModel, model_validator
 from pydantic.fields import Field
 from pydantic.networks import IPvAnyNetwork
 from pydantic.types import NonNegativeFloat
 
-from aws_lambda_powertools.utilities.parser.types import Literal
-
 from .event_bridge import EventBridgeModel
 
 

aws_lambda_powertools/utilities/parser/models/s3_batch_operation.py

@@ -1,9 +1,7 @@
-from typing import Any, Dict, List, Optional
+from typing import Any, Dict, List, Literal, Optional
 
 from pydantic import BaseModel, model_validator
 
-from aws_lambda_powertools.utilities.parser.types import Literal
-
 
 class S3BatchOperationTaskModel(BaseModel):
     taskId: str

aws_lambda_powertools/utilities/parser/models/ses.py

@@ -1,11 +1,9 @@
 from datetime import datetime
-from typing import List, Optional
+from typing import List, Literal, Optional
 
 from pydantic import BaseModel, Field
 from pydantic.types import PositiveInt
 
-from ..types import Literal
-
 
 class SesReceiptVerdict(BaseModel):
     status: Literal["PASS", "FAIL", "GRAY", "PROCESSING_FAILED"]