Skip to content

schoukri/LambdaSharpTool

 
 

Repository files navigation

λ#

LambdaSharp - Serverless .NET on AWS

Read what's new in the 0.6 "Favorinus" release.

λ# is a command line tool and a framework for serverless application development. λ# uses a simple declarative syntax to generate sophisticated CloudFormation templates that provide simple, yet flexible, deployment options.

The objective of λ# is to accelerate the development pace of serverless solutions while helping developers adhere consistently to best practices to create scalable, observable, and modular systems.

Give a Star! ⭐

If you like or are using this project, please give it a star. Make sure to also check out the documentation site. Thanks!

λ# CLI

Install λ# CLI

The λ# CLI is installed as a .NET Global Tool.

dotnet tool install -g LambdaSharp.Tool

Once installed, the λ# CLI needs to be configured.

lash config

Finally, a deployment tier must be initialized with the λ# Core.

lash init --tier Sandbox

Deploy a λ# Module

Creating modules with Lambda functions and deploying them only requires a few steps.

# Create a new λ# module
lash new module MySampleModule

# Add a function to the λ# module
lash new function MyFunction

# Deploy the λ# module
lash deploy

The λ# CLI uses a YAML file to compile the C# projects, upload assets, and deploy the CloudFormation stack in one step. The YAML file describes the entire module including the inputs, outputs, variables, resources, and functions.

Module: MySampleModule
Items:

 - Function: MyFunction
   Memory: 128
   Timeout: 30

The C# project contains the Lambda handler.

namespace MySampleModule.MyFunction {

    public class FunctionRequest {

        // add request fields
    }

    public class FunctionResponse {

        // add response fields
    }

    public class Function : ALambdaFunction<FunctionRequest, FunctionResponse> {

        //--- Methods ---
        public override Task InitializeAsync(LambdaConfig config)
            => Task.CompletedTask;

        public override async Task<FunctionResponse> ProcessMessageAsync(FunctionRequest request) {

            // add business logic

            return new FunctionResponse();
        }
    }
}

Learn More

Getting Started

  1. Setup λ#

Articles

  1. λ# — A Compiler for CloudFormation
  2. λ# — v0.5 Release Notes
  3. λ# — v0.5.0.1 Release Notes
  4. λ# — v0.5.0.2 Release Notes
  5. λ# — v0.5.0.3 Release Notes
  6. λ# — Constructors/Destructors for CloudFormation

Samples

  1. Create a Static Website with CloudFormation
  2. Create Animated GIFs from Videos with AWS Lambda
  3. Create a Web Chat with API Gateway Websockets
  4. Misc. λ# Samples

References

  1. λ# CLI Reference
  2. λ# .NET SDK Reference
  3. λ# Module Reference
  4. λ# Module IAM Short-hands
  5. Modules
    1. LambdaSharp.Core
    2. LambdaSharp.S3.IO
    3. LambdaSharp.S3.Subscriber
    4. LambdaSharp.Twitter.Query
  6. Resource Types
    1. LambdaSharp::S3::EmptyBucket
    2. LambdaSharp::S3::Subscription
    3. LambdaSharp::S3::Unzip
    4. LambdaSharp::S3::WriteJson

License

Copyright (c) 2018,2019 MindTouch

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

About

Serverless .NET on AWS - λ# is a CLI and Framework for Rapid Application Development using .NET Core on AWS

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C# 99.0%
  • Other 1.0%