aws-lambda-env-modeler 2.1.0__tar.gz → 4.0.0__tar.gz

{aws_lambda_env_modeler-2.1.0 → aws_lambda_env_modeler-4.0.0}/.gitignore

@@ -251,3 +251,5 @@ lib_requirements.txt
 .ruff_cache
 .poetry
 .pytest_cache
+node_modules
+package-lock.json

{aws_lambda_env_modeler-2.1.0 → aws_lambda_env_modeler-4.0.0}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Ran Isenberg
+Copyright (c) 2026 Ran Isenberg
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{aws_lambda_env_modeler-2.1.0 → aws_lambda_env_modeler-4.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: aws_lambda_env_modeler
-Version: 2.1.0
+Version: 4.0.0
 Summary: AWS-Lambda-Env-Modeler is a Python library designed to simplify the process of managing and validating environment variables in your AWS Lambda functions.
 Project-URL: Repository, https://github.com/ran-isenberg/aws-lambda-env-modeler
 Project-URL: Issue tracker, https://github.com/ran-isenberg/aws-lambda-env-modeler/issues
@@ -13,21 +13,20 @@ Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Natural Language :: English
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
-Requires-Python: <4,>=3.9.0
+Classifier: Programming Language :: Python :: 3.15
+Requires-Python: <4,>=3.11.0
 Requires-Dist: pydantic<3,>=2.12.0
 Description-Content-Type: text/markdown
 
 
 # AWS Lambda Environment Variables Modeler (Python)
 
-[![license](https://img.shields.io/github/license/ran-isenberg/aws-lambda-env-modeler)](https://github.com/ran-isenberg/aws-lambda-env-modeler/blob/master/LICENSE)
-![PythonSupport](https://img.shields.io/static/v1?label=python&message=%203.9|%203.10|%203.11|%203.12|%203.13|%203.14&color=blue?style=flat-square&logo=python)
+[![license](https://img.shields.io/github/license/ran-isenberg/aws-lambda-env-modeler)](https://github.com/ran-isenberg/aws-lambda-env-modeler/blob/main/LICENSE)
+![PythonSupport](https://img.shields.io/static/v1?label=python&message=%203.11|%203.12|%203.13|%203.14|%203.15&color=blue?style=flat-square&logo=python)
 ![PyPI version](https://badge.fury.io/py/aws-lambda-env-modeler.svg)
 ![PyPi monthly downloads](https://img.shields.io/pypi/dm/aws-lambda-env-modeler)
 [![PyPI Downloads](https://static.pepy.tech/badge/aws-lambda-env-modeler)](https://pepy.tech/projects/aws-lambda-env-modeler)
@@ -36,15 +35,15 @@ Description-Content-Type: text/markdown
 ![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/ran-isenberg/aws-lambda-env-modeler/badge)
 ![issues](https://img.shields.io/github/issues/ran-isenberg/aws-lambda-env-modeler)
 
-![alt text](https://github.com/ran-isenberg/aws-lambda-env-modeler/blob/main/docs/media/banner.png?raw=true)
+<a href="https://www.ranthebuilder.cloud/"><img alt="Ran The Builder - AI Adoption, Platform Engineering, AWS Serverless" src="https://ranthebuilder.cloud/images/og-image-v2.jpg" width="400" /></a>
 
 AWS-Lambda-Env-Modeler is a Python library designed to simplify the process of managing and validating environment variables in your AWS Lambda functions.
 
-It leverages the power of [Pydantic](https://pydantic-docs.helpmanual.io/) models to define the expected structure and types of the environment variables.
+It leverages the power of [Pydantic](https://docs.pydantic.dev/latest/) models to define the expected structure and types of the environment variables.
 
 This library is especially handy for serverless applications where managing configuration via environment variables is a common practice.
 
-**[📜Documentation](https://ran-isenberg.github.io/aws-lambda-env-modeler/)** | **[Blogs website](https://www.ranthebuilder.cloud)**
+**[📜Documentation](https://ran-isenberg.github.io/aws-lambda-env-modeler/)** | **[Website](https://www.ranthebuilder.cloud)**
 > **Contact details | ran.isenberg@ranthebuilder.cloud**
 
 
@@ -61,12 +60,12 @@ This usage may cause nasty bugs or even crashes in production.
 
 This library allows you to correctly parse, validate, and use your environment variables in your Python AWS Lambda code.
 
-Read more about it [here](https://www.ranthebuilder.cloud/post/aws-lambda-cookbook-environment-variables)
+Read more about it in the [AWS Lambda environment variables article on the Ran The Builder website](https://www.ranthebuilder.cloud/post/aws-lambda-cookbook-environment-variables).
 
 ### **Features**
 
 - Validates the environment variables against a Pydantic model: define both semantic and syntactic validation.
-- Serializes the string environment variables into complex classes and types.
+- Parses the string environment variables into complex classes and types.
 - Provides means to access the environment variables safely with a global getter function in every part of the function.
 - Provides a decorator to initialize the environment variables before executing a function.
 - Caches the parsed model for performance improvement for multiple 'get' calls.
@@ -74,14 +73,22 @@ Read more about it [here](https://www.ranthebuilder.cloud/post/aws-lambda-cookbo
 
 ## Installation
 
+Supported Python versions: 3.11, 3.12, 3.13, 3.14 and 3.15. Python 3.10 is no longer supported, as it is deprecated. See the [AWS Lambda runtimes](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html) page for further information.
+
 You can install it using pip:
 
 ```bash
 pip install aws-lambda-env-modeler
 ```
 
+or uv:
+
+```bash
+uv add aws-lambda-env-modeler
+```
+
 ## Getting started
-Head over to the complete project documentation pages at GitHub pages at [https://ran-isenberg.github.io/aws-lambda-env-modeler](https://ran-isenberg.github.io/aws-lambda-env-modeler/)
+Head over to the complete documentation at [https://ran-isenberg.github.io/aws-lambda-env-modeler](https://ran-isenberg.github.io/aws-lambda-env-modeler/)
 
 
 ## Usage
@@ -90,12 +97,13 @@ First, define a Pydantic model for your environment variables:
 ```python
 from pydantic import BaseModel, HttpUrl
 
+
 class MyEnvVariables(BaseModel):
     DB_HOST: str
     DB_PORT: int
     DB_USER: str
     DB_PASS: str
-    FLAG_X:  bool
+    FLAG_X: bool
     API_URL: HttpUrl
 ```
 
@@ -103,23 +111,22 @@ Before executing a function, you must use the `@init_environment_variables` deco
 
 The decorator guarantees that the function will run with the correct variable configuration.
 
-Then, you can fetch the environment variables using the global getter function, 'get_environment_variables,' and use them just like a data class. At this point, they are parsed and validated.
-
 ```python
 from aws_lambda_env_modeler import init_environment_variables
 
-@init_environment_variables(MyEnvVariables)
+
+@init_environment_variables(model=MyEnvVariables)
 def my_handler_entry_function(event, context):
     # At this point, environment variables are already validated and initialized
     pass
 ```
 
-Then, you can fetch and validate the environment variables with your model:
+Then, you can fetch the environment variables using the global getter function, 'get_environment_variables,' and use them just like a data class. At this point, they are parsed and validated.
 
 ```python
 from aws_lambda_env_modeler import get_environment_variables
 
-env_vars = get_environment_variables(MyEnvVariables)
+env_vars = get_environment_variables(model=MyEnvVariables)
 print(env_vars.DB_HOST)
 ```
 
@@ -127,20 +134,19 @@ print(env_vars.DB_HOST)
 
 By default, the modeler uses cache - the parsed model is cached for performance improvement for multiple 'get' calls.
 
-In some cases, such as during testing, you may want to turn off the cache. You can do this by setting the `LAMBDA_ENV_MODELER_DISABLE_CACHE` environment variable to 'True.'
+In some cases, such as during testing, you may want to turn off the cache. You can do this by setting the `LAMBDA_ENV_MODELER_DISABLE_CACHE` environment variable to `true`.
 
-This is especially useful in tests where you want to run multiple tests concurrently, each with a different set of environment variables.
+This is especially useful in tests where each test sets a different set of environment variables for the same model.
 
 Here's an example of how you can use this in a pytest test:
 
 ```python
 import json
 from http import HTTPStatus
-from typing import Any, Dict
+from typing import Any, Dict, Literal
 from unittest.mock import patch
 
 from pydantic import BaseModel
-from typing_extensions import Literal
 
 from aws_lambda_env_modeler import LAMBDA_ENV_MODELER_DISABLE_CACHE, get_environment_variables, init_environment_variables
 
@@ -176,7 +182,7 @@ Read our code of conduct [here.](https://github.com/ran-isenberg/aws-lambda-env-
 
 ## Connect
 * Email: [ran.isenberg@ranthebuilder.cloud](mailto:ran.isenberg@ranthebuilder.cloud)
-* Blog Website [RanTheBuilder](https://www.ranthebuilder.cloud)
+* Website [RanTheBuilder](https://www.ranthebuilder.cloud)
 * LinkedIn: [ranisenberg](https://www.linkedin.com/in/ranisenberg/)
 * Twitter: [RanBuilder](https://twitter.com/RanBuilder)
 * Bluesky: [@ranthebuilder.cloud](https://bsky.app/profile/ranthebuilder.cloud)

{aws_lambda_env_modeler-2.1.0 → aws_lambda_env_modeler-4.0.0}/README.md

@@ -1,8 +1,8 @@
 
 # AWS Lambda Environment Variables Modeler (Python)
 
-[![license](https://img.shields.io/github/license/ran-isenberg/aws-lambda-env-modeler)](https://github.com/ran-isenberg/aws-lambda-env-modeler/blob/master/LICENSE)
-![PythonSupport](https://img.shields.io/static/v1?label=python&message=%203.9|%203.10|%203.11|%203.12|%203.13|%203.14&color=blue?style=flat-square&logo=python)
+[![license](https://img.shields.io/github/license/ran-isenberg/aws-lambda-env-modeler)](https://github.com/ran-isenberg/aws-lambda-env-modeler/blob/main/LICENSE)
+![PythonSupport](https://img.shields.io/static/v1?label=python&message=%203.11|%203.12|%203.13|%203.14|%203.15&color=blue?style=flat-square&logo=python)
 ![PyPI version](https://badge.fury.io/py/aws-lambda-env-modeler.svg)
 ![PyPi monthly downloads](https://img.shields.io/pypi/dm/aws-lambda-env-modeler)
 [![PyPI Downloads](https://static.pepy.tech/badge/aws-lambda-env-modeler)](https://pepy.tech/projects/aws-lambda-env-modeler)
@@ -11,15 +11,15 @@
 ![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/ran-isenberg/aws-lambda-env-modeler/badge)
 ![issues](https://img.shields.io/github/issues/ran-isenberg/aws-lambda-env-modeler)
 
-![alt text](https://github.com/ran-isenberg/aws-lambda-env-modeler/blob/main/docs/media/banner.png?raw=true)
+<a href="https://www.ranthebuilder.cloud/"><img alt="Ran The Builder - AI Adoption, Platform Engineering, AWS Serverless" src="https://ranthebuilder.cloud/images/og-image-v2.jpg" width="400" /></a>
 
 AWS-Lambda-Env-Modeler is a Python library designed to simplify the process of managing and validating environment variables in your AWS Lambda functions.
 
-It leverages the power of [Pydantic](https://pydantic-docs.helpmanual.io/) models to define the expected structure and types of the environment variables.
+It leverages the power of [Pydantic](https://docs.pydantic.dev/latest/) models to define the expected structure and types of the environment variables.
 
 This library is especially handy for serverless applications where managing configuration via environment variables is a common practice.
 
-**[📜Documentation](https://ran-isenberg.github.io/aws-lambda-env-modeler/)** | **[Blogs website](https://www.ranthebuilder.cloud)**
+**[📜Documentation](https://ran-isenberg.github.io/aws-lambda-env-modeler/)** | **[Website](https://www.ranthebuilder.cloud)**
 > **Contact details | ran.isenberg@ranthebuilder.cloud**
 
 
@@ -36,12 +36,12 @@ This usage may cause nasty bugs or even crashes in production.
 
 This library allows you to correctly parse, validate, and use your environment variables in your Python AWS Lambda code.
 
-Read more about it [here](https://www.ranthebuilder.cloud/post/aws-lambda-cookbook-environment-variables)
+Read more about it in the [AWS Lambda environment variables article on the Ran The Builder website](https://www.ranthebuilder.cloud/post/aws-lambda-cookbook-environment-variables).
 
 ### **Features**
 
 - Validates the environment variables against a Pydantic model: define both semantic and syntactic validation.
-- Serializes the string environment variables into complex classes and types.
+- Parses the string environment variables into complex classes and types.
 - Provides means to access the environment variables safely with a global getter function in every part of the function.
 - Provides a decorator to initialize the environment variables before executing a function.
 - Caches the parsed model for performance improvement for multiple 'get' calls.
@@ -49,14 +49,22 @@ Read more about it [here](https://www.ranthebuilder.cloud/post/aws-lambda-cookbo
 
 ## Installation
 
+Supported Python versions: 3.11, 3.12, 3.13, 3.14 and 3.15. Python 3.10 is no longer supported, as it is deprecated. See the [AWS Lambda runtimes](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html) page for further information.
+
 You can install it using pip:
 
 ```bash
 pip install aws-lambda-env-modeler
 ```
 
+or uv:
+
+```bash
+uv add aws-lambda-env-modeler
+```
+
 ## Getting started
-Head over to the complete project documentation pages at GitHub pages at [https://ran-isenberg.github.io/aws-lambda-env-modeler](https://ran-isenberg.github.io/aws-lambda-env-modeler/)
+Head over to the complete documentation at [https://ran-isenberg.github.io/aws-lambda-env-modeler](https://ran-isenberg.github.io/aws-lambda-env-modeler/)
 
 
 ## Usage
@@ -65,12 +73,13 @@ First, define a Pydantic model for your environment variables:
 ```python
 from pydantic import BaseModel, HttpUrl
 
+
 class MyEnvVariables(BaseModel):
     DB_HOST: str
     DB_PORT: int
     DB_USER: str
     DB_PASS: str
-    FLAG_X:  bool
+    FLAG_X: bool
     API_URL: HttpUrl
 ```
 
@@ -78,23 +87,22 @@ Before executing a function, you must use the `@init_environment_variables` deco
 
 The decorator guarantees that the function will run with the correct variable configuration.
 
-Then, you can fetch the environment variables using the global getter function, 'get_environment_variables,' and use them just like a data class. At this point, they are parsed and validated.
-
 ```python
 from aws_lambda_env_modeler import init_environment_variables
 
-@init_environment_variables(MyEnvVariables)
+
+@init_environment_variables(model=MyEnvVariables)
 def my_handler_entry_function(event, context):
     # At this point, environment variables are already validated and initialized
     pass
 ```
 
-Then, you can fetch and validate the environment variables with your model:
+Then, you can fetch the environment variables using the global getter function, 'get_environment_variables,' and use them just like a data class. At this point, they are parsed and validated.
 
 ```python
 from aws_lambda_env_modeler import get_environment_variables
 
-env_vars = get_environment_variables(MyEnvVariables)
+env_vars = get_environment_variables(model=MyEnvVariables)
 print(env_vars.DB_HOST)
 ```
 
@@ -102,20 +110,19 @@ print(env_vars.DB_HOST)
 
 By default, the modeler uses cache - the parsed model is cached for performance improvement for multiple 'get' calls.
 
-In some cases, such as during testing, you may want to turn off the cache. You can do this by setting the `LAMBDA_ENV_MODELER_DISABLE_CACHE` environment variable to 'True.'
+In some cases, such as during testing, you may want to turn off the cache. You can do this by setting the `LAMBDA_ENV_MODELER_DISABLE_CACHE` environment variable to `true`.
 
-This is especially useful in tests where you want to run multiple tests concurrently, each with a different set of environment variables.
+This is especially useful in tests where each test sets a different set of environment variables for the same model.
 
 Here's an example of how you can use this in a pytest test:
 
 ```python
 import json
 from http import HTTPStatus
-from typing import Any, Dict
+from typing import Any, Dict, Literal
 from unittest.mock import patch
 
 from pydantic import BaseModel
-from typing_extensions import Literal
 
 from aws_lambda_env_modeler import LAMBDA_ENV_MODELER_DISABLE_CACHE, get_environment_variables, init_environment_variables
 
@@ -151,7 +158,7 @@ Read our code of conduct [here.](https://github.com/ran-isenberg/aws-lambda-env-
 
 ## Connect
 * Email: [ran.isenberg@ranthebuilder.cloud](mailto:ran.isenberg@ranthebuilder.cloud)
-* Blog Website [RanTheBuilder](https://www.ranthebuilder.cloud)
+* Website [RanTheBuilder](https://www.ranthebuilder.cloud)
 * LinkedIn: [ranisenberg](https://www.linkedin.com/in/ranisenberg/)
 * Twitter: [RanBuilder](https://twitter.com/RanBuilder)
 * Bluesky: [@ranthebuilder.cloud](https://bsky.app/profile/ranthebuilder.cloud)

{aws_lambda_env_modeler-2.1.0 → aws_lambda_env_modeler-4.0.0}/aws_lambda_env_modeler/modeler.py

@@ -8,7 +8,7 @@ from aws_lambda_env_modeler.types import Model
 def init_environment_variables(model: Type[Model]) -> Callable[[Callable[..., Any]], Callable[..., Any]]:
     """
     A decorator for AWS Lambda handler functions. It initializes and validates environment variables based on the provided Pydantic model before the execution of the decorated function.
-    It uses LRU Cache by model class type to optimize parsing time. Cache can be disabled by setting the environment variable 'LAMBDA_ENV_MODELER_DISABLE_CACHE' to FALSE (default: cache is enabled)
+    It uses LRU Cache by model class type to optimize parsing time. Cache can be disabled by setting the environment variable 'LAMBDA_ENV_MODELER_DISABLE_CACHE' to TRUE (default: cache is enabled)
 
     Args:
         model (Type[Model]): A Pydantic model that outlines the structure and types of the expected environment variables.
@@ -35,7 +35,7 @@ def init_environment_variables(model: Type[Model]) -> Callable[[Callable[..., An
 def get_environment_variables(model: Type[Model]) -> Model:
     """
     Retrieves and validates environment variables based on the provided Pydantic model.
-    It uses LRU Cache by model class type to optimize parsing time. Cache can be disabled by setting the environment variable 'LAMBDA_ENV_MODELER_DISABLE_CACHE' to FALSE (default: cache is enabled)
+    It uses LRU Cache by model class type to optimize parsing time. Cache can be disabled by setting the environment variable 'LAMBDA_ENV_MODELER_DISABLE_CACHE' to TRUE (default: cache is enabled)
     It's recommended to use anywhere in the function's after init_environment_variables decorator was used on the handler function.
 
     Args:

{aws_lambda_env_modeler-2.1.0 → aws_lambda_env_modeler-4.0.0}/pyproject.toml

@@ -4,10 +4,10 @@ build-backend = "hatchling.build"
 
 [project]
 name = "aws_lambda_env_modeler"
-version = "2.1.0"
+version = "4.0.0"
 description = "AWS-Lambda-Env-Modeler is a Python library designed to simplify the process of managing and validating environment variables in your AWS Lambda functions."
 authors = [{ name = "Ran Isenberg" }]
-requires-python = ">=3.9.0,<4"
+requires-python = ">=3.11.0,<4"
 readme = "README.md"
 license = "MIT-0"
 keywords = [
@@ -22,12 +22,11 @@ classifiers = [
     "Intended Audience :: Developers",
     "License :: OSI Approved :: MIT License",
     "Natural Language :: English",
-    "Programming Language :: Python :: 3.9",
-    "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
 ]
 dependencies = ["pydantic>=2.12.0,<3"]
 
@@ -50,8 +49,7 @@ dev = [
     "xenon",
     "pre-commit",
     "ruff",
-    "mkdocs-material",
-    "mkdocs-git-revision-date-plugin",
+    "zensical",
     "types-cachetools",
     "mypy",
     "types-requests",
@@ -102,8 +100,8 @@ exclude = [
 line-length = 150
 indent-width = 4
 
-# Assume Python 3.14
-target-version = "py314"
+# Minimum supported Python version
+target-version = "py311"
 
 [tool.ruff.lint]
 # Enable Pyflakes (`F`) and a subset of the pycodestyle (`E`)  codes by default.
@@ -118,6 +116,8 @@ select = [
 ignore = [ "E203", "E266", "E501", "W191"]
 
 [tool.ruff.format]
+# Markdown code blocks hold pymdownx snippet directives that are not valid Python
+exclude = ["docs/*.md"]
 quote-style = "single"
 
 # Like Black, indent with spaces, rather than tabs.