Initial commit

Author: alessiovierti

.gitignore

@@ -0,0 +1,4 @@
+.DS_Store
+.idea
+.venv
+*.egg-info

LICENSE.txt

@@ -0,0 +1,15 @@
+1. Create a virtual environment:
+
+    `$ python3 -m venv .venv`
+
+2. Activate the created environment:
+
+    `$ source .venv/bin/activate`
+
+3. Upgrade `pip`:
+
+    `$ python3 -m pip install --upgrade pip`
+
+4. Install the requirements:
+
+    `$ pip install --upgrade -r requirements.txt`

README.md

@@ -0,0 +1,37 @@
+from abc import ABC, abstractmethod
+from logging import getLogger, INFO, Logger
+from typing import Any
+
+
+class LambdaHandler(ABC):
+
+    def __init__(self, logger: Logger = getLogger()):
+
+        self.logger = logger
+        self.logger.setLevel(INFO)
+
+    @abstractmethod
+    def run(self, event: Any, context: Any) -> Any:
+        """Handles a Lambda event
+
+        :param event:   Event information passed by AWS Lambda
+        :param context: Invocation, function, and environment information
+        :return:        May return some serializable data
+        """
+
+        pass
+
+    def walk(self, event: Any, context: Any) -> Any:
+        """Handles a Lambda event, but silently
+
+        All exceptions are caught and logged.
+
+        :param event:   Event information passed by AWS Lambda
+        :param context: Invocation, function, and environment information
+        :return:        May return some serializable data
+        """
+
+        try:
+            return self.run(event=event, context=context)
+        except Exception as logged:
+            self.logger.exception(logged)

lambda_handler/__init__.py

@@ -0,0 +1 @@
+-e .

requirements.txt

@@ -0,0 +1,37 @@
+import os
+import setuptools
+
+from typing import AnyStr
+
+
+GITHUB_PERSONAL_ACCESS_TOKEN = os.getenv('GITHUB_PERSONAL_ACCESS_TOKEN')
+
+
+def private_dependency(personal_access_token: AnyStr,
+                       repo_user: AnyStr, repo_name: AnyStr,
+                       package_name: AnyStr, package_version: AnyStr):
+    """Defines a dependency from a private Github repository
+
+    :param personal_access_token:   Github Personal Access Token
+    :param repo_user:               Dependency repository user
+    :param repo_name:               Dependency repository name
+    :param package_name:            Dependency package name
+    :param package_version:         Dependency repository release (tag)
+    :return:                        The dependency specification for the install_requires field
+    """
+
+    return f'{package_name} @ ' \
+           f'git+https://{personal_access_token}@github.com/' \
+           f'{repo_user}/{repo_name}.git/@{package_version}#egg={package_name}-0'
+
+
+with open('version', 'r') as version:
+
+    setuptools.setup(
+        name='lambda_handler',
+        version=version.readline(),
+        author='Alessio Vierti',
+        packages=setuptools.find_packages(exclude=['tests']),
+        install_requires=[],
+        python_requires='>=3.6'
+    )

setup.py

@@ -0,0 +1 @@
+1.0.0