lambda-api-decorators 0.1.0__py3-none-any.whl

lambda_api_decorators/__init__.py

@@ -0,0 +1 @@
+from .decorators import *

lambda_api_decorators/decorators.py

@@ -0,0 +1,119 @@
+def GET(path):
+    def decorator(fun):
+        def wrapper(*args,  **kwargs):
+            result = fun(*args, **kwargs)
+            return result
+        return wrapper
+    return decorator
+
+def PUT(path):
+    def decorator(fun):
+        def wrapper(*args,  **kwargs):
+            result = fun(*args, **kwargs)
+            return result
+        return wrapper
+    return decorator
+
+def POST(path):
+    def decorator(fun):
+        def wrapper(*args,  **kwargs):
+            result = fun(*args, **kwargs)
+            return result
+        return wrapper
+    return decorator
+
+def DELETE(path):
+    def decorator(fun):
+        def wrapper(*args,  **kwargs):
+            result = fun(*args, **kwargs)
+            return result
+        return wrapper
+    return decorator
+
+def ANY(path):
+    def decorator(fun):
+        def wrapper(*args,  **kwargs):
+            result = fun(*args, **kwargs)
+            return result
+        return wrapper
+    return decorator
+
+def memory_size(arg):
+    def decorator(fun):
+        def wrapper(*args,  **kwargs):
+            result = fun(*args, **kwargs)
+            return result
+        return wrapper
+    return decorator
+
+def timeout(arg):
+    def decorator(fun):
+        def wrapper(*args,  **kwargs):
+            result = fun(*args, **kwargs)
+            return result
+        return wrapper
+    return decorator
+
+def environment(*eargs,  **kwargs):
+    def decorator(fun):
+        def wrapper(*args,  **kwargs):
+            result = fun(*args, **kwargs)
+            return result
+        return wrapper
+    return decorator
+
+def layer(*largs,  **kwargs):
+    def decorator(fun):
+        def wrapper(*args,  **kwargs):
+            result = fun(*args, **kwargs)
+            return result
+        return wrapper
+    return decorator
+
+def runtime(arg):
+    def decorator(fun):
+        def wrapper(*args,  **kwargs):
+            result = fun(*args, **kwargs)
+            return result
+        return wrapper
+    return decorator
+
+def security_group(*sgargs):
+    def decorator(fun):
+        def wrapper(*wargs,  **kwargs):
+            result = fun(*wargs, **kwargs)
+            return result
+        return wrapper
+    return decorator
+
+def vpc(arg):
+    def decorator(fun):
+        def wrapper(*args,  **kwargs):
+            result = fun(*args, **kwargs)
+            return result
+        return wrapper
+    return decorator
+
+def role(arg):
+    def decorator(fun):
+        def wrapper(*args,  **kwargs):
+            result = fun(*args, **kwargs)
+            return result
+        return wrapper
+    return decorator
+
+def description(arg):
+    def decorator(fun):
+        def wrapper(*args,  **kwargs):
+            result = fun(*args, **kwargs)
+            return result
+        return wrapper
+    return decorator
+
+def name(arg):
+    def decorator(fun):
+        def wrapper(*args,  **kwargs):
+            result = fun(*args, **kwargs)
+            return result
+        return wrapper
+    return decorator

lambda_api_decorators-0.1.0.dist-info/METADATA

@@ -0,0 +1,233 @@
+Metadata-Version: 2.4
+Name: lambda-api-decorators
+Version: 0.1.0
+Summary: Python decorators for defining AWS Lambda API routes and configuration.
+Author: Mateo Marcos, Emanuel Arguinarena, Lucas Picchi
+License: MIT License
+        
+        Copyright (c) 2024 Lambda API Decorators
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/lambda-api-decorators/lambda-api-decorators
+Project-URL: Repository, https://github.com/lambda-api-decorators/lambda-api-decorators
+Project-URL: Bug Reports, https://github.com/lambda-api-decorators/lambda-api-decorators/issues
+Keywords: cdk,lambda,aws,api gateway,ast,decorators
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Framework :: AWS CDK :: 2
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Lambda API Decorators
+
+**Define AWS Lambda API routes and configuration directly in your Python code using decorators.**
+
+Lambda API Decorators provides Python decorators for defining API routes and AWS Lambda configuration alongside your Lambda handlers.
+
+Instead of maintaining route and function configuration separately from your application code, you can declare HTTP methods, paths, runtimes, timeouts, memory, environment variables, layers, networking, and other Lambda settings directly on the handler.
+
+Combined with **Lambda API Decorators CDK**, these definitions are used to automatically generate the corresponding AWS Lambda and Amazon API Gateway infrastructure with AWS CDK.
+
+```python
+from lambda_api_decorators import GET, runtime, name, memory_size
+import json
+
+
+@GET("/dogs")
+@runtime("python3.11")
+@name("LBD-DOGS-GET")
+@memory_size(256)
+def lambda_handler(event, context):
+    return {
+        "statusCode": 200,
+        "body": json.dumps({
+            "message": "Hello World from /dogs!"
+        })
+    }
+```
+
+## Installation
+
+Install Lambda API Decorators from PyPI:
+
+```bash
+pip install lambda-api-decorators
+```
+
+To generate AWS infrastructure from the decorated Lambda handlers, install the CDK integration:
+
+```bash
+pip install lambda-api-decorators-cdk
+```
+
+## Available Decorators
+
+### API Routes
+
+Every Lambda API handler must define an HTTP method and endpoint path.
+
+Available route decorators:
+
+* `GET`
+* `POST`
+* `PUT`
+* `DELETE`
+* `ANY`
+
+For example:
+
+```python
+@GET("/dogs")
+def lambda_handler(event, context):
+    ...
+```
+
+The route definition is used by the CDK integration to configure the corresponding Amazon API Gateway endpoint and Lambda integration.
+
+### Lambda Configuration
+
+Lambda API Decorators also allows Lambda configuration to be declared directly on the handler.
+
+#### `timeout`
+
+Defines the Lambda function timeout in seconds.
+
+```python
+@timeout(30)
+```
+
+#### `memory_size`
+
+Defines the amount of memory allocated to the Lambda function.
+
+```python
+@memory_size(512)
+```
+
+#### `name`
+
+Defines a custom name for the Lambda function.
+
+```python
+@name("LBD-DOGS-GET")
+```
+
+#### `description`
+
+Defines the Lambda function description.
+
+```python
+@description("Returns the list of dogs")
+```
+
+#### `runtime`
+
+References a runtime configuration defined by Lambda API Decorators CDK.
+
+```python
+@runtime("python3.11")
+```
+
+#### `role`
+
+References an IAM role defined by Lambda API Decorators CDK.
+
+```python
+@role("api-role")
+```
+
+#### `vpc`
+
+References a VPC configuration defined by Lambda API Decorators CDK.
+
+```python
+@vpc("application-vpc")
+```
+
+#### `environment`
+
+Associates one or more environment configurations with the Lambda function.
+
+```python
+@environment("database", "application")
+```
+
+#### `layer`
+
+Associates one or more Lambda Layers with the function.
+
+```python
+@layer("common-dependencies")
+```
+
+#### `security_group`
+
+Associates one or more security group configurations with the Lambda function.
+
+```python
+@security_group("lambda-security-group")
+```
+
+The referenced runtimes, IAM roles, VPCs, environment configurations, layers, and security groups are defined in the AWS CDK application using **Lambda API Decorators CDK**.
+
+## How It Works
+
+Lambda API Decorators keeps API and Lambda configuration close to the application code:
+
+```text
+Python Lambda handlers
+        │
+        │  @GET, @POST, @runtime,
+        │  @timeout, @memory_size, ...
+        ▼
+Lambda API Decorators
+        │
+        ▼
+Lambda API Decorators CDK
+        │
+        ▼
+AWS CDK
+        │
+        ├── AWS Lambda
+        ├── Amazon API Gateway
+        ├── IAM
+        ├── VPC configuration
+        └── other AWS resources
+```
+
+This allows your Lambda handlers to become the source of the API definition while AWS CDK remains responsible for generating and deploying the infrastructure.
+
+## Related Projects
+
+* **Lambda API Decorators CDK** — AWS CDK integration that generates Lambda and API Gateway infrastructure from decorated Python handlers.
+* **Lambda API Decorators Examples** — Example applications demonstrating how to use Lambda API Decorators.
+
+## License
+
+See the repository license for details.

lambda_api_decorators-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+lambda_api_decorators/__init__.py,sha256=FXs_TA9H6e1iMspQ-HFtVFv59q9Bfw0k5HpxhgLovJM,26
+lambda_api_decorators/decorators.py,sha256=FGS3c5AiPEB9BmdVg6Rv_xObbhbkNK2YAljDMljjeBg,2939
+lambda_api_decorators-0.1.0.dist-info/licenses/LICENSE,sha256=E9RhjRL38P23iXHzNiN9s4KK0_xto3eUu-V-qJ5uJXM,1078
+lambda_api_decorators-0.1.0.dist-info/METADATA,sha256=OMRqke5HGp-W_rPIfqlTwajmwf5k4PSupPbotmRf7oc,6616
+lambda_api_decorators-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+lambda_api_decorators-0.1.0.dist-info/top_level.txt,sha256=gfwH7c72QGh98BsLEexv-enLG5dLboIZjA0fSGY2TZE,22
+lambda_api_decorators-0.1.0.dist-info/RECORD,,

lambda_api_decorators-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

lambda_api_decorators-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Lambda API Decorators
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

lambda_api_decorators-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+lambda_api_decorators