AWS Lambda initial POC

docs/api/python.rst

@@ -28,6 +28,11 @@ and rich debugging and accessibility interfaces built-in.
 
    python/function
 
+.. toctree::
+   :maxdepth: 1
+
+   python/lambda_function
+
 .. toctree::
    :maxdepth: 1
 

docs/api/python/lambda_function.rst

@@ -0,0 +1,66 @@
+Lambda Function
+====================================
+
+.. note::
+
+    Lambda Function support is an alpha and under active development.
+    Please report any bugs and let us know of any feature requests.
+
+| A `Lambda Function <https://aws.amazon.com/lambda/>`_ is a serverless compute service provided by AWS. It allows  you
+ to run applications and backend services without provisioning or managing servers. Runhouse will allow you to
+ maintain, invoke and share your Lambda functions and their code. It is comprised of the entry point, configuration, and
+ dependencies necessary to run the service.
+
+
+| There are few core options to create an AWS Lambda using Runhouse:
+#. Pass a callable Python function to the factory method.
+#. Follow a typical Lambda creation flow (as if you are using AWS APIs). That includes passing to the constructor
+   path(s) to Python file(s) (containing the code) and a handler function name . Arguments such as runtime, Lambda name,
+   timeout and memory size are accepted by the factory method as well, but they are not mandatory and have default values.
+#. Create rh.function instance, and than send it over to AWS Lambdas. For example:
+   :code:`rh.function(summer).to(system=aws_lambda)`
+
+
+
+Lambda Function Factory Method
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. autofunction:: runhouse.aws_lambda_fn
+
+Lambda Function Class
+~~~~~~~~~~~~~~
+
+.. autoclass:: runhouse.LambdaFunction
+   :members:
+   :exclude-members: to
+
+    .. automethod:: __init__
+
+Lambda Hardware Setup
+~~~~~~~~~~~~~~
+
+To create an AWS Lambda, you must grant the necessary permissions to do so. They are provided by an IAM
+role, which should be attached to a certain AWS profile. This setup is made in the :code:`~/.aws/config` file.
+
+For example, your local :code:`~/.aws/config` contains:
+
+.. code-block:: ini
+
+    [profile lambda]
+    role_arn = arn:aws:iam::123456789:role/lambda-creation-role
+    region = us-east-1
+    source_profile = default
+
+There are several ways to provide the necessary credentials which enables Lambda creation:
+
+#. Specify the profile name in your code editor:
+
+    #. Install the `AWS Toolkit` extension.
+    #. Choose the relevant profile (e.g. `profile lambda`) and region (e.g `us-east-1`).
+
+#. Environment Variable: setting :code:`AWS_PROFILE` to :code:`"lambda"`
+
+.. note::
+    If no specific profile is provided, Runhouse will try using the default profile. Note if this default AWS identity
+    will not have the relevant IAM permissions for creating a Lambda, you will not be able to create a
+    Lambda.

runhouse/__init__.py

@@ -1,7 +1,8 @@
 from runhouse.resources.blobs import blob, Blob, file, File
 from runhouse.resources.envs import conda_env, CondaEnv, env, Env
 from runhouse.resources.folders import Folder, folder, GCSFolder, S3Folder
-from runhouse.resources.function import function, Function
+from runhouse.resources.functions.aws_lambda import aws_lambda_fn, LambdaFunction
+from runhouse.resources.functions.function import function, Function
 from runhouse.resources.hardware import (
     _current_cluster,
     cluster,

runhouse/resources/functions/__init__.py

@@ -0,0 +1,2 @@
+from .aws_lambda import aws_lambda_fn, LambdaFunction
+from .function import function, Function