Liquid Application Framework

This repository contains Liquid Application Framework full code, samples, templates and documentation.

• This is the new major version of Liquid Application Framework, launched on April/2021.
• We've made significant breaking changes and a complete rearchitecture of our framework. So, this version isn't compatible and there is no easy conversion from the old one.
• We decided to deprecate the old version and it will not receive any kind of updates, not even bug fixes. But, for historical purposes and to allow anyone relying on it to fork the code and maintain its own version of it, we'll keep the old repository public.

What is Liquid?

Liquid is a multi-cloud framework designed to accelerate the development of cloud-native microservices while avoiding coupling your code to specific cloud providers.

When writing Liquid applications, you stop worrying about the technology and focus on your business logic - Liquid abstracts most of the boilerplate and let you just write domain code that looks great and gets the job done.

Feature

• Abstracts a number of services from cloud providers such as Azure, AWS and Google Cloud to enable you to write code that could run anywhere.
• Brings a directed programming model that will save you time on thinking how to structure your application, allowing you to focus on writing business code.

Getting Started

To use Liquid, you create a new base ASP.Net Core application and then download and install the following nuget packages:

Liquid Application Framework Binaries	Type	Version
Liquid.Core	mandatory
Liquid.Domain	desirable
Liquid.Repository	optional
Liquid.Cache	optional
Liquid.Messaging	optional
Liquid.Services	optional
Liquid.WebApi.Http	optional
Liquid.WebApi.Grpc	optional

And then choose the implementation cartridges you need to your project, for example:

• You can choose to expose an API using an HTTP endpoint (then install Liquid.WebApi.Http) or using the Grpc protocol (Liquid.WebApi.Grpc)
• You can choose to use MongoDB as your data repository (then install Liquid.Repository.MongoDB) or to use Entity Framework (Liquid.Repository.EntityFramework)
• You can choose to use Azure ServiceBus as your messaging platform (then install Liquid.Messaging.Azure) or to use AWS SQS (Liquid.Messaging.Aws)

Liquid Templates new

Now you can use Liquid Templates to get your microservice started faster!

To use it, just install the templates by running the following dotnet CLI command at the PowerShell prompt :

dotnet new --install Liquid.Templates

and run dotnet new command with the name and parameters of the following templates:

Sample:

To create an WebAPI solution with CRUD handlers, you must:

• execute command :

dotnet new liquidcrudsolution --projectName "some root namespace" --entityName "some entity" --entityIdType "type of your unique ID"

• open the folder where the command was executed, and open the project created in the IDE of your choice:

• follow the instructions found in the generated code TODOs, and run!

You can make changes in code, add more classes and project if you need, and also using others Liquid templates to do it!

Contribute

Some of the best ways to contribute are to try things out, file issues, and make pull-requests.

• You can provide feedback by filing issues on GitHub or open a discussion in Discussions tab. We accept issues, ideas and questions.
• You can contribute by creating pull requests for the issues that are listed. Look for issues marked as ready if you are new to the project.
• Avanade asks that all commits sign the Developer Certificate of Origin.

In any case, be sure to take a look at the contributing guide before starting, and see our security disclosure policy.

Useful Links

Who is Avanade?

Avanade is the leading provider of innovative digital, cloud and advisory services, industry solutions and design-led experiences across the Microsoft ecosystem.