[
{
"path": ".editorconfig",
"content": "[*.cs]\n\n# CS8618: Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable.\ndotnet_diagnostic.CS8618.severity = silent\n"
},
{
"path": ".github/dco.yml",
"content": "allowRemediationCommits:\n individual: true"
},
{
"path": ".github/workflows/base-liquid-ci-and-cd.yml",
"content": "# CI & CD workflow\nname: CI/CD - Base Reusable CI & CD workflow used by Liquid Application Framework components\n\non:\n # Allows this workflow to be called by other workflows\n workflow_call:\n inputs:\n component_name:\n description: 'The component name to build'\n required: true\n type: string\n secrets:\n sonar_token:\n required: true\n nuget_token:\n required: false\n\njobs:\n build:\n\n runs-on: ubuntu-latest\n\n steps:\n - name: Identify Job Type from workflow trigger event type\n run: |\n if [ \"$GITHUB_EVENT_NAME\" == \"push\" ]\n then\n echo \"Starting CD Job: Build, Test, Analyze, Pack and Publish library to Nuget.org...\"\n else\n echo \"Starting CI Job: Build, Test and Analyze...\"\n fi\n \n - name: (CI on PR) Checkout repo on Pull Request\n if: ${{ github.event_name == 'pull_request' }}\n uses: actions/checkout@v3\n with:\n ref: ${{github.event.pull_request.head.ref}}\n repository: ${{github.event.pull_request.head.repo.full_name}}\n fetch-depth: 0 # required to eliminate shallow clone warning in Sonarcloud analysis\n \n - name: (CI/CD) Checkout repo\n if: ${{ github.event_name != 'pull_request' }}\n uses: actions/checkout@v3\n with:\n fetch-depth: 0 # required to eliminate shallow clone warning in Sonarcloud analysis\n\n # required by sonarcloud scanner\n - name: (CI/CD) Setup Java JDK\n if: ${{ github.event_name != 'pull_request' || (github.event.pull_request.head.repo.full_name == github.repository && github.actor != 'dependabot[bot]') }}\n uses: actions/setup-java@v3\n with:\n # The Java version to make available on the path. Takes a whole or semver Java version, or 1.x syntax (e.g. 1.8 => Java 8.x). Early access versions can be specified in the form of e.g. 14-ea, 14.0.0-ea, or 14.0.0-ea.28\n distribution: 'microsoft'\n java-version: 17.x\n \n - name: (CI/CD) Setup .NET Core SDK\n uses: actions/setup-dotnet@v2\n with:\n # SDK version to use. Examples: 2.2.104, 3.1, 3.1.x\n dotnet-version: | \n 3.1.x\n 5.0.x\n 6.0.x\n 8.0.x\n # required by sonarcloud scanner\n - name: (CI/CD) Setup Sonar Scanner tool\n if: ${{ github.event_name != 'pull_request' || (github.event.pull_request.head.repo.full_name == github.repository && github.actor != 'dependabot[bot]') }}\n run: dotnet tool install --global dotnet-sonarscanner\n\n - name: (CI/CD) Install Test Reporting Tool\n run: dotnet tool install --global dotnet-reportgenerator-globaltool\n\n - name: (CI/CD) Restore dependencies\n run: dotnet restore src/${{ inputs.component_name }}/${{ inputs.component_name }}.csproj\n\n - name: (CI/CD) Build and Analyze Project\n env:\n GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} # Needed to get PR information, if any\n SONAR_TOKEN: ${{ secrets.sonar_token }}\n RUN_SONAR: ${{ github.event_name != 'pull_request' || (github.event.pull_request.head.repo.full_name == github.repository && github.actor != 'dependabot[bot]') }}\n run: |\n if [ \"$RUN_SONAR\" == \"true\" ]\n then\n if [[ -d test/${{ inputs.component_name }}.Tests && -f test/${{ inputs.component_name }}.Tests/${{ inputs.component_name }}.Tests.csproj ]]\n then \n dotnet sonarscanner begin /k:\"${{ inputs.component_name }}\" /o:\"avanade-1\" /d:sonar.login=\"${{ secrets.sonar_token }}\" /d:sonar.host.url=\"https://sonarcloud.io\" /d:sonar.cs.vstest.reportsPaths=$GITHUB_WORKSPACE/test/testresults/*.trx /d:sonar.coverageReportPaths=$GITHUB_WORKSPACE/test/coverlet/reports/SonarQube.xml\n else\n dotnet sonarscanner begin /k:\"${{ inputs.component_name }}\" /o:\"avanade-1\" /d:sonar.login=\"${{ secrets.sonar_token }}\" /d:sonar.host.url=\"https://sonarcloud.io\"\n fi\n fi\n \n dotnet build src/${{ inputs.component_name }}/${{ inputs.component_name }}.csproj --configuration Release --no-restore\n \n if [[ -d test/${{ inputs.component_name }}.Tests && -f test/${{ inputs.component_name }}.Tests/${{ inputs.component_name }}.Tests.csproj ]]\n then \n dotnet test test/${{ inputs.component_name }}.Tests/${{ inputs.component_name }}.Tests.csproj --collect:\"XPlat Code Coverage\" --logger trx --results-directory $GITHUB_WORKSPACE/test/testresults\n reportgenerator -reports:$GITHUB_WORKSPACE/test/testresults/**/coverage.cobertura.xml -targetdir:$GITHUB_WORKSPACE/test/coverlet/reports -reporttypes:\"SonarQube\"\n fi\n \n if [ \"$RUN_SONAR\" == \"true\" ]\n then\n dotnet sonarscanner end /d:sonar.login=\"${{ secrets.sonar_token }}\"\n fi\n\n - name: (CD) Nuget Pack & Push to Nuget.org\n if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/main' }}\n run: |\n dotnet pack --no-build --configuration Release src/${{ inputs.component_name }}/${{ inputs.component_name }}.csproj --output .\n dotnet nuget push *.nupkg --source https://api.nuget.org/v3/index.json --api-key ${{ secrets.nuget_token }} --skip-duplicate\n \n"
},
{
"path": ".github/workflows/liquid-ci-cd-cache-memory.yml",
"content": "# CI & CD workflow\nname: CI/CD - Liquid.Cache.Memory component for Liquid Application Framework\n\non:\n push:\n branches: [ main, releases/v2.X.X, releases/v6.X.X ]\n paths:\n - 'src/Liquid.Cache.Memory/**'\n \n pull_request:\n branches: [ main, releases/** ]\n types: [opened, synchronize, reopened]\n paths:\n - 'src/Liquid.Cache.Memory/**'\n\n # Allows you to run this workflow manually from the Actions tab\n workflow_dispatch:\n\njobs:\n call-reusable-build-workflow:\n uses: Avanade/Liquid-Application-Framework/.github/workflows/base-liquid-ci-and-cd.yml@main\n with:\n component_name: Liquid.Cache.Memory\n secrets:\n sonar_token: ${{ secrets.SONAR_TOKEN_CACHE_MEMORY }}\n nuget_token: ${{ secrets.PUBLISH_TO_NUGET_ORG }}\n"
},
{
"path": ".github/workflows/liquid-ci-cd-cache-ncache.yml",
"content": "# CI & CD workflow\nname: CI/CD - Liquid.Cache.NCache component for Liquid Application Framework\n\non:\n push:\n branches: [ main, releases/v2.X.X, releases/v6.X.X ]\n paths:\n - 'src/Liquid.Cache.NCache/**'\n \n pull_request:\n branches: [ main, releases/** ]\n types: [opened, synchronize, reopened]\n paths:\n - 'src/Liquid.Cache.NCache/**'\n\n # Allows you to run this workflow manually from the Actions tab\n workflow_dispatch:\n\njobs:\n call-reusable-build-workflow:\n uses: Avanade/Liquid-Application-Framework/.github/workflows/base-liquid-ci-and-cd.yml@main\n with:\n component_name: Liquid.Cache.NCache\n secrets:\n sonar_token: ${{ secrets.SONAR_TOKEN_CACHE_NCACHE }}\n nuget_token: ${{ secrets.PUBLISH_TO_NUGET_ORG }}\n"
},
{
"path": ".github/workflows/liquid-ci-cd-cache-redis.yml",
"content": "# CI & CD workflow\nname: CI/CD - Liquid.Cache.Redis component for Liquid Application Framework\n\non:\n push:\n branches: [ main, releases/v2.X.X, releases/v6.X.X ]\n paths:\n - 'src/Liquid.Cache.Redis/**'\n \n pull_request:\n branches: [ main, releases/** ]\n types: [opened, synchronize, reopened]\n paths:\n - 'src/Liquid.Cache.Redis/**'\n\n # Allows you to run this workflow manually from the Actions tab\n workflow_dispatch:\n\njobs:\n call-reusable-build-workflow:\n uses: Avanade/Liquid-Application-Framework/.github/workflows/base-liquid-ci-and-cd.yml@main\n with:\n component_name: Liquid.Cache.Redis\n secrets:\n sonar_token: ${{ secrets.SONAR_TOKEN_CACHE_REDIS }}\n nuget_token: ${{ secrets.PUBLISH_TO_NUGET_ORG }}\n"
},
{
"path": ".github/workflows/liquid-ci-cd-cache-sqlserver.yml",
"content": "# CI & CD workflow\nname: CI/CD - Liquid.Cache.SqlServer component for Liquid Application Framework\n\non:\n push:\n branches: [ main, releases/v2.X.X, releases/v6.X.X ]\n paths:\n - 'src/Liquid.Cache.SqlServer/**'\n \n pull_request:\n branches: [ main, releases/** ]\n types: [opened, synchronize, reopened]\n paths:\n - 'src/Liquid.Cache.SqlServer/**'\n\n # Allows you to run this workflow manually from the Actions tab\n workflow_dispatch:\n\njobs:\n call-reusable-build-workflow:\n uses: Avanade/Liquid-Application-Framework/.github/workflows/base-liquid-ci-and-cd.yml@main\n with:\n component_name: Liquid.Cache.SqlServer\n secrets:\n sonar_token: ${{ secrets.SONAR_TOKEN_CACHE_SQLSERVER }}\n nuget_token: ${{ secrets.PUBLISH_TO_NUGET_ORG }}\n"
},
{
"path": ".github/workflows/liquid-ci-cd-core-telemetry-elasticapm.yaml",
"content": "# CI & CD workflow\nname: CI/CD - Liquid.Core.Telemetry.ElasticApm component for Liquid Application Framework\n\non:\n push:\n branches: [ main, releases/v2.X.X, releases/v6.X.X ]\n paths:\n - 'src/Liquid.Core.Telemetry.ElasticApm/**'\n \n pull_request:\n branches: [ main ]\n types: [opened, synchronize, reopened]\n paths:\n - 'src/Liquid.Core.Telemetry.ElasticApm/**'\n\n # Allows you to run this workflow manually from the Actions tab\n workflow_dispatch:\n\njobs:\n call-reusable-build-workflow:\n uses: Avanade/Liquid-Application-Framework/.github/workflows/base-liquid-ci-and-cd.yml@main\n with:\n component_name: Liquid.Core.Telemetry.ElasticApm\n secrets:\n sonar_token: ${{ secrets.SONAR_TOKEN_ELASTICAPM }}\n nuget_token: ${{ secrets.PUBLISH_TO_NUGET_ORG }}\n"
},
{
"path": ".github/workflows/liquid-ci-cd-core.yml",
"content": "# CI & CD workflow\nname: CI/CD - Liquid.Core component for Liquid Application Framework\n\non:\n push:\n branches: [ main, releases/v2.X.X, releases/v6.X.X ]\n paths:\n - 'src/Liquid.Core/**'\n \n pull_request:\n branches: [ main, releases/** ]\n types: [opened, synchronize, reopened]\n paths:\n - 'src/Liquid.Core/**'\n\n # Allows you to run this workflow manually from the Actions tab\n workflow_dispatch:\n\njobs:\n call-reusable-build-workflow:\n uses: Avanade/Liquid-Application-Framework/.github/workflows/base-liquid-ci-and-cd.yml@main\n with:\n component_name: Liquid.Core\n secrets:\n sonar_token: ${{ secrets.SONAR_TOKEN_CORE }}\n nuget_token: ${{ secrets.PUBLISH_TO_NUGET_ORG }}\n"
},
{
"path": ".github/workflows/liquid-ci-cd-dataverse.yml",
"content": "# CI & CD workflow\nname: CI/CD - Liquid.Dataverse component for Liquid Application Framework\n\non:\n push:\n branches: [ main, releases/v2.X.X, releases/v6.X.X ]\n paths:\n - 'src/Liquid.Dataverse/**'\n \n pull_request:\n branches: [ main, releases/** ]\n types: [opened, synchronize, reopened]\n paths:\n - 'src/Liquid.Dataverse/**'\n\n # Allows you to run this workflow manually from the Actions tab\n workflow_dispatch:\n\njobs:\n call-reusable-build-workflow:\n uses: Avanade/Liquid-Application-Framework/.github/workflows/base-liquid-ci-and-cd.yml@main\n with:\n component_name: Liquid.Dataverse\n secrets:\n sonar_token: ${{ secrets.SONAR_TOKEN_DATAVERSE }}\n nuget_token: ${{ secrets.PUBLISH_TO_NUGET_ORG }}\n"
},
{
"path": ".github/workflows/liquid-ci-cd-genai-openai.yml",
"content": "# CI & CD workflow\nname: CI/CD - Liquid.GenAi.OpenAi component for Liquid Application Framework\n\non:\n push:\n branches: [ main ]\n paths:\n - 'src/Liquid.GenAi.OpenAi/**'\n \n pull_request:\n branches: [ main, releases/** ]\n types: [opened, synchronize, reopened]\n paths:\n - 'src/Liquid.GenAi.OpenAi/**'\n\n # Allows you to run this workflow manually from the Actions tab\n workflow_dispatch:\n\njobs:\n call-reusable-build-workflow:\n uses: Avanade/Liquid-Application-Framework/.github/workflows/base-liquid-ci-and-cd.yml@main\n with:\n component_name: Liquid.GenAi.OpenAi\n secrets:\n sonar_token: ${{ secrets.SONAR_TOKEN_OPENAI }}\n nuget_token: ${{ secrets.PUBLISH_TO_NUGET_ORG }}\n"
},
{
"path": ".github/workflows/liquid-ci-cd-http.yml",
"content": "# CI & CD workflow\nname: CI/CD - Liquid.WebApi.Http component for Liquid Application Framework\n\non:\n push:\n branches: [ main, releases/v2.X.X, releases/v6.X.X ]\n paths:\n - 'src/Liquid.WebApi.Http/**'\n \n pull_request:\n branches: [ main, releases/** ]\n types: [opened, synchronize, reopened]\n paths:\n - 'src/Liquid.WebApi.Http/**'\n\n # Allows you to run this workflow manually from the Actions tab\n workflow_dispatch:\n\njobs:\n call-reusable-build-workflow:\n uses: Avanade/Liquid-Application-Framework/.github/workflows/base-liquid-ci-and-cd.yml@main\n with:\n component_name: Liquid.WebApi.Http\n secrets:\n sonar_token: ${{ secrets.SONAR_TOKEN_HTTP }}\n nuget_token: ${{ secrets.PUBLISH_TO_NUGET_ORG }}\n"
},
{
"path": ".github/workflows/liquid-ci-cd-messaging-kafka.yaml",
"content": "# CI & CD workflow\nname: CI/CD - Liquid.Messaging.Kafka cartridge for Liquid Application Framework\n\non:\n push:\n branches: [ main, releases/v2.X.X, releases/v6.X.X ]\n paths:\n - 'src/Liquid.Messaging.Kafka/**'\n \n pull_request:\n branches: [ main, releases/** ]\n types: [opened, synchronize, reopened]\n paths:\n - 'src/Liquid.Messaging.Kafka/**'\n\n # Allows you to run this workflow manually from the Actions tab\n workflow_dispatch:\n\njobs:\n call-reusable-build-workflow:\n uses: Avanade/Liquid-Application-Framework/.github/workflows/base-liquid-ci-and-cd.yml@main\n with:\n component_name: Liquid.Messaging.Kafka\n secrets:\n sonar_token: ${{ secrets.SONAR_TOKEN_KAFKA }}\n nuget_token: ${{ secrets.PUBLISH_TO_NUGET_ORG }}\n"
},
{
"path": ".github/workflows/liquid-ci-cd-messaging-rabbitmq.yaml",
"content": "# CI & CD workflow\nname: CI/CD - Liquid.Messaging.RabbitMq cartridge for Liquid Application Framework\n\non:\n push:\n branches: [ main, releases/v2.X.X, releases/v6.X.X ]\n paths:\n - 'src/Liquid.Messaging.RabbitMq/**'\n \n pull_request:\n branches: [ main, releases/** ]\n types: [opened, synchronize, reopened]\n paths:\n - 'src/Liquid.Messaging.RabbitMq/**'\n\n # Allows you to run this workflow manually from the Actions tab\n workflow_dispatch:\n\njobs:\n call-reusable-build-workflow:\n uses: Avanade/Liquid-Application-Framework/.github/workflows/base-liquid-ci-and-cd.yml@main\n with:\n component_name: Liquid.Messaging.RabbitMq\n secrets:\n sonar_token: ${{ secrets.SONAR_TOKEN_RABBIT }}\n nuget_token: ${{ secrets.PUBLISH_TO_NUGET_ORG }}\n"
},
{
"path": ".github/workflows/liquid-ci-cd-messaging-servicebus.yaml",
"content": "# CI & CD workflow\nname: CI/CD - Liquid.Messaging.ServiceBus cartridge for Liquid Application Framework\n\non:\n push:\n branches: [ main, releases/v2.X.X, releases/v6.X.X ]\n paths:\n - 'src/Liquid.Messaging.ServiceBus/**'\n \n pull_request:\n branches: [ main, releases/** ]\n types: [opened, synchronize, reopened]\n paths:\n - 'src/Liquid.Messaging.ServiceBus/**'\n\n # Allows you to run this workflow manually from the Actions tab\n workflow_dispatch:\n\njobs:\n call-reusable-build-workflow:\n uses: Avanade/Liquid-Application-Framework/.github/workflows/base-liquid-ci-and-cd.yml@main\n with:\n component_name: Liquid.Messaging.ServiceBus\n secrets:\n sonar_token: ${{ secrets.SONAR_TOKEN_SB }}\n nuget_token: ${{ secrets.PUBLISH_TO_NUGET_ORG }}\n"
},
{
"path": ".github/workflows/liquid-ci-cd-repository-entityframework.yml",
"content": "# CI & CD workflow\nname: CI/CD - Liquid.Repository.EntityFramework Cartridge for Liquid Application Framework\n\non:\n push:\n branches: [ main, releases/v2.X.X, releases/v6.X.X ]\n paths:\n - 'src/Liquid.Repository.EntityFramework/**'\n \n pull_request:\n branches: [ main, releases/** ]\n types: [opened, synchronize, reopened]\n paths:\n - 'src/Liquid.Repository.EntityFramework/**'\n\n # Allows you to run this workflow manually from the Actions tab\n workflow_dispatch:\n\njobs:\n call-reusable-build-workflow:\n uses: Avanade/Liquid-Application-Framework/.github/workflows/base-liquid-ci-and-cd.yml@main\n with:\n component_name: Liquid.Repository.EntityFramework\n secrets:\n sonar_token: ${{ secrets.SONAR_TOKEN_EF }}\n nuget_token: ${{ secrets.PUBLISH_TO_NUGET_ORG }}\n"
},
{
"path": ".github/workflows/liquid-ci-cd-repository-mongodb.yml",
"content": "# CI & CD workflow\nname: CI/CD - Liquid.Repository.Mongo Cartridge for Liquid Application Framework\n\non:\n push:\n branches: [ main, releases/v2.X.X, releases/v6.X.X ]\n paths:\n - 'src/Liquid.Repository.Mongo/**'\n \n pull_request:\n branches: [ main, releases/** ]\n types: [opened, synchronize, reopened]\n paths:\n - 'src/Liquid.Repository.Mongo/**'\n\n # Allows you to run this workflow manually from the Actions tab\n workflow_dispatch:\n\njobs:\n call-reusable-build-workflow:\n uses: Avanade/Liquid-Application-Framework/.github/workflows/base-liquid-ci-and-cd.yml@main\n with:\n component_name: Liquid.Repository.Mongo\n secrets:\n sonar_token: ${{ secrets.SONAR_TOKEN_MONGO }}\n nuget_token: ${{ secrets.PUBLISH_TO_NUGET_ORG }}\n"
},
{
"path": ".github/workflows/liquid-ci-cd-repository-odata.yml",
"content": "# CI & CD workflow\nname: CI/CD - Liquid.Repository.OData Cartridge for Liquid Application Framework\n\non:\n push:\n branches: [ main, releases/v2.X.X, releases/v6.X.X ]\n paths:\n - 'src/Liquid.Repository.OData/**'\n \n pull_request:\n branches: [ main, releases/** ]\n types: [opened, synchronize, reopened]\n paths:\n - 'src/Liquid.Repository.OData/**'\n\n # Allows you to run this workflow manually from the Actions tab\n workflow_dispatch:\n\njobs:\n call-reusable-build-workflow:\n uses: Avanade/Liquid-Application-Framework/.github/workflows/base-liquid-ci-and-cd.yml@main\n with:\n component_name: Liquid.Repository.OData\n secrets:\n sonar_token: ${{ secrets.SONAR_TOKEN_ODATA }}\n nuget_token: ${{ secrets.PUBLISH_TO_NUGET_ORG }}\n"
},
{
"path": ".github/workflows/liquid-ci-cd-storage-azurestorage.yml",
"content": "# CI & CD workflow\nname: CI/CD - Liquid.Storage.AzureStorage component for Liquid Application Framework\n\non:\n push:\n branches: [ main, releases/v2.X.X, releases/v6.X.X ]\n paths:\n - 'src/Liquid.Storage.AzureStorage/**'\n \n pull_request:\n branches: [ main, releases/** ]\n types: [opened, synchronize, reopened]\n paths:\n - 'src/Liquid.Storage.AzureStorage/**'\n\n # Allows you to run this workflow manually from the Actions tab\n workflow_dispatch:\n\njobs:\n call-reusable-build-workflow:\n uses: Avanade/Liquid-Application-Framework/.github/workflows/base-liquid-ci-and-cd.yml@main\n with:\n component_name: Liquid.Storage.AzureStorage\n secrets:\n sonar_token: ${{ secrets.SONAR_TOKEN_STORAGE }}\n nuget_token: ${{ secrets.PUBLISH_TO_NUGET_ORG }}\n"
},
{
"path": ".github/workflows/liquid-ci-cd-templates.yaml",
"content": "# CI & CD workflow\nname: CI/CD - Liquid.Templates for Liquid Application Framework\n\non:\n push:\n branches: [ main, releases/v2.X.X, releases/v6.X.X ]\n paths:\n - 'templates/src/Liquid.Templates/**'\n \n pull_request:\n branches: [ main, releases/** ]\n types: [opened, synchronize, reopened]\n paths:\n - 'templates/src/Liquid.Templates/**'\n\n # Allows you to run this workflow manually from the Actions tab\n workflow_dispatch:\n\njobs:\n build:\n\n runs-on: ubuntu-latest\n\n steps:\n - name: Job Type\n run: |\n if [$GITHUB_EVENT_NAME == 'push']\n then\n echo \"Starting CD Job: Build, Test, Analyze, Pack and Publish library to Nuget.org...\"\n else\n echo \"Starting CI Job: Build, Test and Analyze...\"\n fi\n \n - name: (CI) Checkout repo on Pull Request\n if: ${{ github.event_name == 'pull_request' }}\n uses: actions/checkout@v2\n with:\n ref: ${{github.event.pull_request.head.ref}}\n repository: ${{github.event.pull_request.head.repo.full_name}}\n fetch-depth: 0 # required to eliminate shallow clone warning in Sonarcloud analysis\n \n - name: (CI/CD) Checkout repo\n if: ${{ github.event_name != 'pull_request' }}\n uses: actions/checkout@v2\n with:\n fetch-depth: 0 # required to eliminate shallow clone warning in Sonarcloud analysis\n \n - name: (CI/CD) Setup .NET Core SDK\n uses: actions/setup-dotnet@v1.7.2\n with:\n # SDK version to use. Examples: 2.2.104, 3.1, 3.1.x\n dotnet-version: 3.1.x\n\n - name: (CI/CD) Restore dependencies\n run: dotnet restore templates/src/Liquid.Templates/Liquid.Templates.csproj\n\n - name: (CI/CD) Build and Analyze Project\n run: |\n dotnet build templates/src/Liquid.Templates/Liquid.Templates.csproj --configuration Release --no-restore\n \n - name: (CD) Nuget Pack & Push to Nuget.org\n if: ${{ github.event_name == 'push' }}\n run: |\n dotnet pack --no-build --configuration Release templates/src/Liquid.Templates/Liquid.Templates.csproj --output .\n dotnet nuget push *.nupkg --source https://api.nuget.org/v3/index.json --api-key ${{secrets.PUBLISH_TO_NUGET_ORG}} --skip-duplicate\n"
},
{
"path": ".gitignore",
"content": "## Ignore Visual Studio temporary files, build results, and\n## files generated by popular Visual Studio add-ons.\n##\n## Get latest from https://github.com/github/gitignore/blob/master/VisualStudio.gitignore\n\n# User-specific files\n*.suo\n*.user\n*.userosscache\n*.sln.docstates\n\n# User-specific files (MonoDevelop/Xamarin Studio)\n*.userprefs\n\n# Build results\n[Dd]ebug/\n[Dd]ebugPublic/\n[Rr]elease/\n[Rr]eleases/\nx64/\nx86/\nbld/\n[Bb]in/\n[Oo]bj/\n[Ll]og/\n\n# Visual Studio 2015/2017 cache/options directory\n.vs/\n# Uncomment if you have tasks that create the project's static files in wwwroot\n#wwwroot/\n\n# Visual Studio 2017 auto generated files\nGenerated\\ Files/\n\n# MSTest test Results\n[Tt]est[Rr]esult*/\n[Bb]uild[Ll]og.*\n\n# NUNIT\n*.VisualState.xml\nTestResult.xml\n\n# Build Results of an ATL Project\n[Dd]ebugPS/\n[Rr]eleasePS/\ndlldata.c\n\n# Benchmark Results\nBenchmarkDotNet.Artifacts/\n\n# .NET Core\nproject.lock.json\nproject.fragment.lock.json\nartifacts/\n**/Properties/launchSettings.json\n\n# StyleCop\nStyleCopReport.xml\n\n# Files built by Visual Studio\n*_i.c\n*_p.c\n*_i.h\n*.ilk\n*.meta\n*.obj\n*.iobj\n*.pch\n*.pdb\n*.ipdb\n*.pgc\n*.pgd\n*.rsp\n*.sbr\n*.tlb\n*.tli\n*.tlh\n*.tmp\n*.tmp_proj\n*.log\n*.vspscc\n*.vssscc\n.builds\n*.pidb\n*.svclog\n*.scc\n\n# Chutzpah Test files\n_Chutzpah*\n\n# Visual C++ cache files\nipch/\n*.aps\n*.ncb\n*.opendb\n*.opensdf\n*.sdf\n*.cachefile\n*.VC.db\n*.VC.VC.opendb\n\n# Visual Studio profiler\n*.psess\n*.vsp\n*.vspx\n*.sap\n\n# Visual Studio Trace Files\n*.e2e\n\n# TFS 2012 Local Workspace\n$tf/\n\n# Guidance Automation Toolkit\n*.gpState\n\n# ReSharper is a .NET coding add-in\n_ReSharper*/\n*.[Rr]e[Ss]harper\n*.DotSettings.user\n\n# JustCode is a .NET coding add-in\n.JustCode\n\n# TeamCity is a build add-in\n_TeamCity*\n\n# DotCover is a Code Coverage Tool\n*.dotCover\n\n# AxoCover is a Code Coverage Tool\n.axoCover/*\n!.axoCover/settings.json\n\n# Visual Studio code coverage results\n*.coverage\n*.coveragexml\n\n# NCrunch\n_NCrunch_*\n.*crunch*.local.xml\nnCrunchTemp_*\n\n# MightyMoose\n*.mm.*\nAutoTest.Net/\n\n# Web workbench (sass)\n.sass-cache/\n\n# Installshield output folder\n[Ee]xpress/\n\n# DocProject is a documentation generator add-in\nDocProject/buildhelp/\nDocProject/Help/*.HxT\nDocProject/Help/*.HxC\nDocProject/Help/*.hhc\nDocProject/Help/*.hhk\nDocProject/Help/*.hhp\nDocProject/Help/Html2\nDocProject/Help/html\n\n# Click-Once directory\npublish/\n\n# Publish Web Output\n*.[Pp]ublish.xml\n*.azurePubxml\n# Note: Comment the next line if you want to checkin your web deploy settings,\n# but database connection strings (with potential passwords) will be unencrypted\n*.pubxml\n*.publishproj\n\n# Microsoft Azure Web App publish settings. Comment the next line if you want to\n# checkin your Azure Web App publish settings, but sensitive information contained\n# in these scripts will be unencrypted\nPublishScripts/\n\n# NuGet Packages\n*.nupkg\n# The packages folder can be ignored because of Package Restore\n**/[Pp]ackages/*\n# except build/, which is used as an MSBuild target.\n!**/[Pp]ackages/build/\n# Uncomment if necessary however generally it will be regenerated when needed\n#!**/[Pp]ackages/repositories.config\n# NuGet v3's project.json files produces more ignorable files\n*.nuget.props\n*.nuget.targets\n\n# Microsoft Azure Build Output\ncsx/\n*.build.csdef\n\n# Microsoft Azure Emulator\necf/\nrcf/\n\n# Windows Store app package directories and files\nAppPackages/\nBundleArtifacts/\nPackage.StoreAssociation.xml\n_pkginfo.txt\n*.appx\n\n# Visual Studio cache files\n# files ending in .cache can be ignored\n*.[Cc]ache\n# but keep track of directories ending in .cache\n!*.[Cc]ache/\n\n# Others\nClientBin/\n~$*\n*~\n*.dbmdl\n*.dbproj.schemaview\n*.jfm\n*.pfx\n*.publishsettings\norleans.codegen.cs\n\n# Including strong name files can present a security risk \n# (https://github.com/github/gitignore/pull/2483#issue-259490424)\n#*.snk\n\n# Since there are multiple workflows, uncomment next line to ignore bower_components\n# (https://github.com/github/gitignore/pull/1529#issuecomment-104372622)\n#bower_components/\n\n# RIA/Silverlight projects\nGenerated_Code/\n\n# Backup & report files from converting an old project file\n# to a newer Visual Studio version. Backup files are not needed,\n# because we have git ;-)\n_UpgradeReport_Files/\nBackup*/\nUpgradeLog*.XML\nUpgradeLog*.htm\nServiceFabricBackup/\n*.rptproj.bak\n\n# SQL Server files\n*.mdf\n*.ldf\n*.ndf\n\n# Business Intelligence projects\n*.rdl.data\n*.bim.layout\n*.bim_*.settings\n*.rptproj.rsuser\n\n# Microsoft Fakes\nFakesAssemblies/\n\n# GhostDoc plugin setting file\n*.GhostDoc.xml\n\n# Node.js Tools for Visual Studio\n.ntvs_analysis.dat\nnode_modules/\n\n# Visual Studio 6 build log\n*.plg\n\n# Visual Studio 6 workspace options file\n*.opt\n\n# Visual Studio 6 auto-generated workspace file (contains which files were open etc.)\n*.vbw\n\n# Visual Studio LightSwitch build output\n**/*.HTMLClient/GeneratedArtifacts\n**/*.DesktopClient/GeneratedArtifacts\n**/*.DesktopClient/ModelManifest.xml\n**/*.Server/GeneratedArtifacts\n**/*.Server/ModelManifest.xml\n_Pvt_Extensions\n\n# Paket dependency manager\n.paket/paket.exe\npaket-files/\n\n# FAKE - F# Make\n.fake/\n\n# JetBrains Rider\n.idea/\n*.sln.iml\n\n# CodeRush\n.cr/\n\n# Python Tools for Visual Studio (PTVS)\n__pycache__/\n*.pyc\n\n# Cake - Uncomment if you are using it\n# tools/**\n# !tools/packages.config\n\n# Tabs Studio\n*.tss\n\n# Telerik's JustMock configuration file\n*.jmconfig\n\n# BizTalk build output\n*.btp.cs\n*.btm.cs\n*.odx.cs\n*.xsd.cs\n\n# OpenCover UI analysis results\nOpenCover/\n\n# Azure Stream Analytics local run output \nASALocalRun/\n\n# MSBuild Binary and Structured Log\n*.binlog\n\n# NVidia Nsight GPU debugger configuration file\n*.nvuser\n\n# MFractors (Xamarin productivity tool) working folder \n.mfractor/\n"
},
{
"path": "CONTRIBUTING.md",
"content": "# How to contribute\n\nThis project welcomes contributions and suggestions. By contributing, you confirm that you have the right to, and actually do, grant us the rights to use your contribution. More information below.\n\nPlease feel free to contribute code, ideas, improvements, and patches - we've added some general guidelines and information below, and you can propose changes to this document in a pull request.\n\nThis project has adopted the [Contributor Covenant Code of Conduct](https://avanade.github.io/code-of-conduct/).\n\nOne of the easiest ways to contribute is to participate in discussions on GitHub issues. You can also contribute by submitting pull requests with code changes.\n\n## Rights to your contributions\nBy contributing to this project, you:\n- Agree that you have authored 100% of the content\n- Agree that you have the necessary rights to the content\n- Agree that you have received the necessary permissions from your employer to make the contributions (if applicable)\n- Agree that the content you contribute may be provided under the Project license(s)\n- Agree that, if you did not author 100% of the content, the appropriate licenses and copyrights have been added along with any other necessary attribution.\n\n## Code of Conduct\nThis project, and people participating in it, are governed by our [code of conduct](https://avanade.github.io/code-of-conduct/). By taking part, we expect you to try your best to uphold this code of conduct. If you have concerns about unacceptable behaviour, please contact the community leaders responsible for enforcement at\n[ospo@avanade.com](ospo@avanade.com).\n\n## Developer Certificate of Origin (DCO)\nAvanade asks that all commits sign the [Developer Certificate of Origin](https://developercertificate.org/), to ensure that every developer is confirming that they have the right to upload the code they submit.\n\nSign-offs are added to the commit. Git has a `-s` command line option to append this automatically to your commit message, and [sign offs can be added through the web interface](https://github.blog/changelog/2022-06-08-admins-can-require-sign-off-on-web-based-commits/).\n\n## General feedback and discussions?\n\nStart a discussion on the [repository issue tracker](https://github.com/Avanade/Liquid-Application-Framework/issues).\n\n## Bugs and feature requests?\n\nFor non-security related bugs, log a new issue in the GitHub repository.\n\n## Reporting security issues and bugs\n\nSecurity issues and bugs should be reported privately, via email, to a repository admin. You should receive a response within 24 hours. We also ask you to file via our [security disclosure](https://github.com/Avanade/avanade-template/blob/main/SECURITY.md) policy.\n\n## Contributing code and content\n\nWe accept fixes and features! Here are some resources to help you get started on how to contribute code or new content.\n\n* [\"Help wanted\" issues](https://github.com/Avanade/Liquid-Application-Framework/labels/help%20wanted) - these issues are up for grabs. Comment on an issue if you want to create a fix.\n* [\"Good first issue\" issues](https://github.com/Avanade/Liquid-Application-Framework/labels/good%20first%20issue) - we think these are a good for newcomers.\n\n### Identifying the scale\n\nIf you would like to contribute to one of our repositories, first identify the scale of what you would like to contribute. If it is small (grammar/spelling or a bug fix) feel free to start working on a fix. If you are submitting a feature or substantial code contribution, please discuss it with the team and ensure it follows the product roadmap. You might also read these two blogs posts on contributing code: [Open Source Contribution Etiquette](http://tirania.org/blog/archive/2010/Dec-31.html) by Miguel de Icaza and [Don't \"Push\" Your Pull Requests](https://www.igvita.com/2011/12/19/dont-push-your-pull-requests/) by Ilya Grigorik. All code submissions will be rigorously reviewed and tested by the team, and only those that meet an extremely high bar for both quality and design/roadmap appropriateness will be merged into the source.\n\n### Submitting a pull request\n\nIf you don't know what a pull request is read this article: https://help.github.com/articles/using-pull-requests. **Make sure the repository can build and all tests pass.** Familiarize yourself with the project workflow and our coding conventions. The coding, style, and general engineering guidelines are below on the topic [Engineering guidelines](#Engineering-guidelines).\n\n### Feedback\n\nYour pull request will now go through **extensive checks** by the subject matter experts on our team. Please be patient. Update your pull request according to feedback until it is approved by one of the ASP.NET team members. After that, one of our team members may adjust the branch you merge into based on the expected release schedule.\n\n# Engineering Guidelines\n\n## General\n\nWe try to hold our code to the higher standards. Every pull request must and will be scrutinized in order to maintain our standard. Every pull request should improve on quality, therefore any PR that decreases the quality will not be approved.\n\nWe follow coding best practices to make sure the codebase is clean and newcomers and seniors alike will understand the code. This document provides a guideline that should make most of our practices clear, but gray areas may arise and we might make a judgment call on your code, so, when in doubt, question ahead. Issues are a wonderful tool that should be used by every contributor to help us drive the project.\n\nAll the rules here are mandatory; however, we do not claim to hold all the answers - you can raise a question over any rule any time (through issues) and we'll discuss it.\n\nFinally, this is a new project and we are still learning how to work on a Open Source project. Please bear with us while we learn how to do it best.\n\n## External dependencies\n\nThis refers to dependencies on projects (i.e. NuGet packages) outside of the repo. Every dependency we add enlarges the package, and might have copyright issues that we may need to address.\n\nTherefore, adding or updating any external dependency requires approval. This can be discussed preferrabily on the issue related to the PR or on the PR itself.\n\n## Code reviews and checkins\n\nTo help ensure that only the highest quality code makes its way into the project, please submit all your code changes to GitHub as PRs. This includes runtime code changes, unit test updates, and updates to official samples. For example, sending a PR for just an update to a unit test might seem like a waste of time but the unit tests are just as important as the product code and as such, reviewing changes to them is also just as important. This also helps create visibility for your changes so that others can observe what is going on.\n\nThe advantages are numerous: improving code quality, more visibility on changes and their potential impact, avoiding duplication of effort, and creating general awareness of progress being made in various areas.\n\nTo commit the PR to the repo either use preferably GitHub's \"Squash and Merge\" button on the main PR page, or do a typical push that you would use with Git (e.g. local pull, rebase, merge, push).\n\n## Branching Strategy\n\nWe are using [Trunk-Based branching strategy](https://trunkbaseddevelopment.com/).\n\n## Assembly naming pattern\n\nThe general naming pattern is `Liquid..`.\n\n## Unit tests\n\nWe use NUnit for all unit testing. Additionally, you can use NSubstitute for mocks and such, and leverage AutoFixture for anonymous instances.\n\n## Code Style\n\n### General\n\nThe most general guideline is that we use all the VS default settings in terms of code formatting, except that we put System namespaces before other namespaces (this used to be the default in VS, but it changed in a more recent version of VS). Also, we are leveraging StyleCop to add to code standardization.\n\n1. Use four spaces of indentation (no tabs)\n1. Use `_camelCase` for private fields\n1. Avoid `this`. unless absolutely necessary\n1. Always specify member visibility, even if it's the default (i.e. `private string _foo;` not `string _foo;`)\n1. Open-braces (`{`) go on a new line\n1. Use any language features available to you (expression-bodied members, throw expressions, tuples, etc.) as long as they make for readable, manageable code.\nThis is pretty bad: `public (int, string) GetData(string filter) => (Data.Status, Data.GetWithFilter(filter ?? throw new ArgumentNullException(nameof(filter))));`\n\n### Usage of the var keyword\n\nThe var keyword is to be used as much as the compiler will allow. For example, these are correct:\n\n```csharp\nvar fruit = \"Lychee\";\nvar fruits = new List();\nvar flavor = fruit.GetFlavor();\nstring fruit = null; // can't use \"var\" because the type isn't known (though you could do (string)null, don't!)\nconst string expectedName = \"name\"; // can't use \"var\" with const\n```\n\nThe following are incorrect:\n\n```csharp\nstring fruit = \"Lychee\";\nList fruits = new List();\nFruitFlavor flavor = fruit.GetFlavor();\n```\n\n### Use C# type keywords in favor of .NET type names\n\nWhen using a type that has a C# keyword the keyword is used in favor of the .NET type name. For example, these are correct:\n\n```csharp\npublic string TrimString(string s) {\n return string.IsNullOrEmpty(s)\n ? null\n : s.Trim();\n}\n\n\nvar intTypeName = nameof(Int32); // can't use C# type keywords with nameof\n```\n\nThe following are incorrect:\n\n```csharp\npublic String TrimString(String s) {\n return String.IsNullOrEmpty(s)\n ? null\n : s.Trim();\n}\n```\n\n### Cross-platform coding\n\nOur frameworks should work on CoreCLR, which supports multiple operating systems. Don't assume we only run (and develop) on Windows. Code should be sensitive to the differences between OS's. Here are some specifics to consider.\n\n#### Line breaks\n\nWindows uses \\r\\n, OS X and Linux uses \\n. When it is important, use Environment.NewLine instead of hard-coding the line break.\n\nNote: this may not always be possible or necessary.\n\nBe aware that these line-endings may cause problems in code when using @\"\" text blocks with line breaks.\n\n#### Environment Variables\n\nOS's use different variable names to represent similar settings. Code should consider these differences.\n\nFor example, when looking for the user's home directory, on Windows the variable is USERPROFILE but on most Linux systems it is HOME.\n\n```csharp\nvar homeDir = Environment.GetEnvironmentVariable(\"USERPROFILE\")\n ?? Environment.GetEnvironmentVariable(\"HOME\");\n```\n\n#### File path separators\n\nWindows uses \\ and OS X and Linux use / to separate directories. Instead of hard-coding either type of slash, use Path.Combine() or Path.DirectorySeparatorChar.\n\nIf this is not possible (such as in scripting), use a forward slash. Windows is more forgiving than Linux in this regard.\n\n### When to use internals vs. public and when to use InternalsVisibleTo\n\nAs a modern set of frameworks, usage of internal types and members is allowed, but discouraged.\n\n`InternalsVisibleTo` is used only to allow a unit test to test internal types and members of its runtime assembly. We do not use `InternalsVisibleTo` between two runtime assemblies.\n\nIf two runtime assemblies need to share common helpers then we will use a \"shared source\" solution with build-time only packages.\n\nIf two runtime assemblies need to call each other's APIs, the APIs must be public. If we need it, it is likely that our customers need it.\n\n### Async method patterns\n\nBy default all async methods must have the Async suffix. There are some exceptional circumstances where a method name from a previous framework will be grandfathered in.\n\nPassing cancellation tokens is done with an optional parameter with a value of `default(CancellationToken)`, which is equivalent to `CancellationToken.None` (one of the few places that we use optional parameters). The main exception to this is in web scenarios where there is already an `HttpContext` being passed around, in which case the context has its own cancellation token that can be used when needed.\n\nSample async method:\n\n```csharp\npublic Task GetDataAsync(\n QueryParams query,\n int maxData,\n CancellationToken cancellationToken = default(CancellationToken))\n{\n ...\n}\n```\n\n### Extension method patterns\n\nThe general rule is: if a regular static method would suffice, avoid extension methods.\n\nExtension methods are often useful to create chainable method calls, for example, when constructing complex objects, or creating queries.\n\nInternal extension methods are allowed, but bear in mind the previous guideline: ask yourself if an extension method is truly the most appropriate pattern.\n\nThe namespace of the extension method class should generally be the namespace that represents the functionality of the extension method, as opposed to the namespace of the target type. One common exception to this is that the namespace for middleware extension methods is normally always the same is the namespace of IAppBuilder.\n\nThe class name of an extension method container (also known as a \"sponsor type\") should generally follow the pattern of `Extensions`, `Extensions`, or `Extensions`. For example:\n\n```csharp\nnamespace Food {\n class Fruit { ... }\n}\n\nnamespace Fruit.Eating {\n class FruitExtensions { public static void Eat(this Fruit fruit); }\n OR\n class FruitEatingExtensions { public static void Eat(this Fruit fruit); }\n OR\n class EatingFruitExtensions { public static void Eat(this Fruit fruit); }\n}\n```\n\nWhen writing extension methods for an interface the sponsor type name must not start with an I.\n\n### Analyzers\n\nCode style is usually enforced by Analyzers; any change to those rules must be discussed with the team before it's made. Also, any pull request that changes analyzers rules and commits code will be reproved immediately.\n\n### Good practices\n\nThe items below point out the good practices that all code should follow.\n\n#### Zero warnings\n\nCompiler warnings should usually be dealt with by correcting the code. Only discussed warnings may be allowed to be marked as exceptions.\n\n#### Inner documentation\n\nAll public members must be documented. Documentation should clarify the purpose and usage of code elements, so comments such as FooManager: \"manages foo\" will be rejected. Classes that implement interface may use comment inheritance `/// `, but use it sparingly.\n\nTry to use examples and such in classes to enable users to understand them more easily.\n\nIf you don't believe that a class or method deserves to be documents, ask yourself if it can be marked as non-public.\n\nIf should comment every non-public class or member that is complex enough.\n\nAll comments should be read-proof.\n\n> **Note**: Public means callable by a customer, so it includes protected APIs. However, some public APIs might still be \"for internal use only\" but need to be public for technical reasons. We will still have doc comments for these APIs but they will be documented as appropriate.\n\n## Tests\n\n- Tests need to be provided for every bug/feature that is completed.\n- Tests only need to be present for issues that need to be verified by QA (for example, not tasks)\n- Pull requests must strive to not reduce code coverage.\n- If there is a scenario that is far too hard to test there does not need to be a test for it.\n - \"Too hard\" is determined by the team as a whole.\n\n### Unit tests and functional tests\n\n#### Assembly naming\n\nThe unit tests for the `Liquid.Fruit` assembly live in the `Liquid.Fruit.Tests` assembly.\n\nThe functional tests for the `Liquid.Fruit` assembly live in the `Liquid.Fruit.AcceptanceTests` assembly.\n\nIn general there should be exactly one unit test assembly for each product runtime assembly. In general there should be one functional test assembly per repo. Exceptions can be made for both.\n\n#### Unit test class naming\n\nTest class names end with Test and live in the same namespace as the class being tested. For example, the unit tests for the Liquid.Fruit.Banana class would be in a Liquid.Fruit.BananaTest class in the test assembly.\n\n#### Unit test method naming\n\nUnit test method names must be descriptive about what is being tested, under what conditions, and what the expectations are. Pascal casing and underscores can be used to improve readability. We will try to follow [Roy Osherove's guidelines](https://osherove.com/blog/2005/4/3/naming-standards-for-unit-tests.html), therefore, the following test names are correct:\n`GetAttachmentWhenItWasInsertedReturnsInsertedData`\n`GetWhenAttachmentDoesntExistsThrows`\n\n> Notice how we use When and Returns / Throws to split the name into recognizable parts.\n\nThe following test names are incorrect:\n\n```csharp\nTest1\nConstructor\nFormatString\nGetData\n```\n\n#### Unit test structure\n\nThe contents of every unit test should be split into three distinct stages, optionally separated by these comments:\n\n```csharp\n// Arrange\n// Act\n// Assert\n```\n\nThe crucial thing here is that the Act stage is exactly one statement. That one statement is nothing more than a call to the one method that you are trying to test. Keeping that one statement as simple as possible is also very important. For example, this is not ideal:\n\n```csharp\nint result = myObj.CallSomeMethod(GetComplexParam1(), GetComplexParam2(), GetComplexParam3());\n```\n\nThis style is not recommended because way too many things can go wrong in this one statement. All the `GetComplexParamN()` calls can throw for a variety of reasons unrelated to the test itself. It is thus unclear to someone running into a problem why the failure occurred.\n\nThe ideal pattern is to move the complex parameter building into the Arrange section:\n\n```csharp\n// Arrange\nP1 p1 = GetComplexParam1();\nP2 p2 = GetComplexParam2();\nP3 p3 = GetComplexParam3();\n\n// Act\nint result = myObj.CallSomeMethod(p1, p2, p3);\n\n// Assert\nAssert.AreEqual(1234, result);\n```\n\nNow the only reason the line with `CallSomeMethod()` can fail is if the method itself blew up. This is especially important when you're using helpers such as ExceptionHelper, where the delegate you pass into it must fail for exactly one reason.\n\n#### Use NUnit's plethora of built-in assertions\n\nNUnit includes many kinds of assertions – please use the most appropriate one for your test. This will make the tests a lot more readable and also allow the test runner report the best possible errors (whether it's local or the CI machine). For example, these are bad:\n\n```csharp\nAssert.AreEqual(true, someBool);\n\nAssert.True(\"abc123\" == someString);\n\nAssert.True(list1.Length == list2.Length);\n\nfor (int i = 0; i < list1.Length; i++) {\n Assert.True(\n String.Equals\n list1[i],\n list2[i],\n StringComparison.OrdinalIgnoreCase));\n}\n```\n\nThese are good:\n\n```csharp\nAssert.True(someBool);\n\nAssert.AreEqual(\"abc123\", someString);\n\n// built-in collection assertions!\nAssert.AreEqual(list1, list2, StringComparer.OrdinalIgnoreCase);\n```\n\nIt's also possible (and recommended) to use the new ContraintModel of NUnit:\n\n```csharp\nAssert.That(condition, Is.True);\n\nint[] array = new int[] { 1, 2, 3 };\nAssert.That(array, Has.Exactly(1).EqualTo(3));\nAssert.That(array, Has.Exactly(2).GreaterThan(1));\nAssert.That(array, Has.Exactly(3).LessThan(100));\n```\n\n#### Parallel tests\n\nBy default all unit test assemblies should run in parallel mode, which is the default. Unit tests shouldn't depend on any shared state, and so should generally be runnable in parallel. If the tests fail in parallel, the first thing to do is to figure out why; do not just disable parallel tests!\n\nFor functional tests it is reasonable to disable parallel tests.\n\n### Use only complete words or common/standard abbreviations in public APIs\n\nPublic namespaces, type names, member names, and parameter names must use complete words or common/standard abbreviations.\n\nThese are correct:\n\n```csharp\npublic void AddReference(AssemblyReference reference);\npublic EcmaScriptObject SomeObject { get; }\n```\n\nThese are incorrect:\n\n```csharp\npublic void AddRef(AssemblyReference ref);\npublic EcmaScriptObject SomeObj { get; }\n```\n\nNote that abbreviations still follow camel/pascal casing. Use `Api` instead of `API` and `Ecma` instead of `ECMA`, to make your code more legible.\n\nAvoid abbreviations with only two characters because of the rule above.\n"
},
{
"path": "LICENSE",
"content": "MIT License\n\nCopyright (c) 2021 Avanade\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n"
},
{
"path": "Liquid.Adapters.sln",
"content": "\nMicrosoft Visual Studio Solution File, Format Version 12.00\n# Visual Studio Version 17\nVisualStudioVersion = 17.6.34202.202\nMinimumVisualStudioVersion = 10.0.40219.1\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.Adapter.Dataverse\", \"src\\Liquid.Adapter.Dataverse\\Liquid.Adapter.Dataverse.csproj\", \"{02191AB8-D13C-4CCC-8455-08813FB0C9C3}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.Adapter.Dataverse.Tests\", \"test\\Liquid.Adapter.Dataverse.Tests\\Liquid.Adapter.Dataverse.Tests.csproj\", \"{90D60966-6004-4705-907D-780503EBC141}\"\nEndProject\nProject(\"{2150E333-8FDC-42A3-9474-1A3956D46DE8}\") = \"Dataverse\", \"Dataverse\", \"{0E973865-5B87-43F2-B513-CD1DA96A2A3A}\"\nEndProject\nProject(\"{2150E333-8FDC-42A3-9474-1A3956D46DE8}\") = \"AzureStorage\", \"AzureStorage\", \"{81CB75D9-FC31-4533-9A2D-C9277DD4A33E}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.Adapter.AzureStorage\", \"src\\Liquid.Adapter.AzureStorage\\Liquid.Adapter.AzureStorage.csproj\", \"{E21AF05A-738E-4DA2-AEEE-9900D7534F7C}\"\nEndProject\nProject(\"{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}\") = \"Liquid.Adapter.AzureStorage.Tests\", \"test\\Liquid.Adapter.AzureStorage.Tests\\Liquid.Adapter.AzureStorage.Tests.csproj\", \"{A2A7E164-98DF-4953-9679-B35E109E8990}\"\nEndProject\nGlobal\n\tGlobalSection(SolutionConfigurationPlatforms) = preSolution\n\t\tDebug|Any CPU = Debug|Any CPU\n\t\tRelease|Any CPU = Release|Any CPU\n\tEndGlobalSection\n\tGlobalSection(ProjectConfigurationPlatforms) = postSolution\n\t\t{02191AB8-D13C-4CCC-8455-08813FB0C9C3}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{02191AB8-D13C-4CCC-8455-08813FB0C9C3}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{02191AB8-D13C-4CCC-8455-08813FB0C9C3}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{02191AB8-D13C-4CCC-8455-08813FB0C9C3}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{90D60966-6004-4705-907D-780503EBC141}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{90D60966-6004-4705-907D-780503EBC141}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{90D60966-6004-4705-907D-780503EBC141}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{90D60966-6004-4705-907D-780503EBC141}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{E21AF05A-738E-4DA2-AEEE-9900D7534F7C}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{E21AF05A-738E-4DA2-AEEE-9900D7534F7C}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{E21AF05A-738E-4DA2-AEEE-9900D7534F7C}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{E21AF05A-738E-4DA2-AEEE-9900D7534F7C}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{A2A7E164-98DF-4953-9679-B35E109E8990}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{A2A7E164-98DF-4953-9679-B35E109E8990}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{A2A7E164-98DF-4953-9679-B35E109E8990}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{A2A7E164-98DF-4953-9679-B35E109E8990}.Release|Any CPU.Build.0 = Release|Any CPU\n\tEndGlobalSection\n\tGlobalSection(SolutionProperties) = preSolution\n\t\tHideSolutionNode = FALSE\n\tEndGlobalSection\n\tGlobalSection(NestedProjects) = preSolution\n\t\t{02191AB8-D13C-4CCC-8455-08813FB0C9C3} = {0E973865-5B87-43F2-B513-CD1DA96A2A3A}\n\t\t{90D60966-6004-4705-907D-780503EBC141} = {0E973865-5B87-43F2-B513-CD1DA96A2A3A}\n\t\t{E21AF05A-738E-4DA2-AEEE-9900D7534F7C} = {81CB75D9-FC31-4533-9A2D-C9277DD4A33E}\n\t\t{A2A7E164-98DF-4953-9679-B35E109E8990} = {81CB75D9-FC31-4533-9A2D-C9277DD4A33E}\n\tEndGlobalSection\n\tGlobalSection(ExtensibilityGlobals) = postSolution\n\t\tSolutionGuid = {8105640B-39D2-4FFE-8BBD-D8E37F2A070D}\n\tEndGlobalSection\nEndGlobal\n"
},
{
"path": "Liquid.Application.Framework.sln",
"content": "\nMicrosoft Visual Studio Solution File, Format Version 12.00\n# Visual Studio Version 17\nVisualStudioVersion = 17.8.34408.163\nMinimumVisualStudioVersion = 10.0.40219.1\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.Core\", \"src\\Liquid.Core\\Liquid.Core.csproj\", \"{C33A89FC-4F4D-4274-8D0F-29456BA8F76B}\"\nEndProject\nProject(\"{2150E333-8FDC-42A3-9474-1A3956D46DE8}\") = \"Solution Items\", \"Solution Items\", \"{EE1C8DCF-EBC3-43B8-9E9C-433CDD57FB30}\"\n\tProjectSection(SolutionItems) = preProject\n\t\ttest\\CodeCoverage.runsettings = test\\CodeCoverage.runsettings\n\t\t.github\\workflows\\liquid-core-ci-cd-publish.yml = .github\\workflows\\liquid-core-ci-cd-publish.yml\n\t\tlogo.png = logo.png\n\t\tnuget.config = nuget.config\n\tEndProjectSection\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.Core.Tests\", \"test\\Liquid.Core.Tests\\Liquid.Core.Tests.csproj\", \"{69B34B22-198D-4BD0-AAFC-39A90F9ADAC2}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.Core.Telemetry.ElasticApm\", \"src\\Liquid.Core.Telemetry.ElasticApm\\Liquid.Core.Telemetry.ElasticApm.csproj\", \"{AD354CF6-C132-4B5D-944D-0DFE21509781}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.Core.Telemetry.ElasticApm.Tests\", \"test\\Liquid.Core.Telemetry.ElasticApm.Tests\\Liquid.Core.Telemetry.ElasticApm.Tests.csproj\", \"{8863A92B-E1A3-4203-8C08-C017E5B3D2CC}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.Cache.Memory\", \"src\\Liquid.Cache.Memory\\Liquid.Cache.Memory.csproj\", \"{C7DD9DB1-E287-4886-AA44-159C0AB4F041}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.Cache.NCache\", \"src\\Liquid.Cache.NCache\\Liquid.Cache.NCache.csproj\", \"{74D0605F-5466-423D-B5ED-E2C104BB3180}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.Cache.Redis\", \"src\\Liquid.Cache.Redis\\Liquid.Cache.Redis.csproj\", \"{6508D946-4B74-4629-B819-4C2C3F7AF8B5}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.Cache.SqlServer\", \"src\\Liquid.Cache.SqlServer\\Liquid.Cache.SqlServer.csproj\", \"{F24D06BE-E608-4DFD-B8F6-B02F87062323}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.Cache.Memory.Tests\", \"test\\Liquid.Cache.Memory.Tests\\Liquid.Cache.Memory.Tests.csproj\", \"{28747B1E-0784-4B7B-AE48-F5AD3C937262}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.Cache.NCache.Tests\", \"test\\Liquid.Cache.NCache.Tests\\Liquid.Cache.NCache.Tests.csproj\", \"{08A826AA-2C2E-4E21-A3D8-60BF8E57772E}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.Cache.SqlServer.Tests\", \"test\\Liquid.Cache.SqlServer.Tests\\Liquid.Cache.SqlServer.Tests.csproj\", \"{ED3C04BC-3DEF-4B5C-BF91-EE8F5C38F8E4}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.Cache.Redis.Tests\", \"test\\Liquid.Cache.Redis.Tests\\Liquid.Cache.Redis.Tests.csproj\", \"{2E8F3332-545A-4454-9F75-1498A9B7B9BF}\"\nEndProject\nProject(\"{2150E333-8FDC-42A3-9474-1A3956D46DE8}\") = \"test\", \"test\", \"{BDB77DF2-2D7D-4363-BB2B-D6A3A8A69C7B}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.Repository.Mongo.Tests\", \"test\\Liquid.Repository.Mongo.Tests\\Liquid.Repository.Mongo.Tests.csproj\", \"{400BD703-3E6F-41E6-929B-5FD888EFD00A}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.Repository.EntityFramework.Tests\", \"test\\Liquid.Repository.EntityFramework.Tests\\Liquid.Repository.EntityFramework.Tests.csproj\", \"{73A5230F-0A90-4D2C-8D5E-D95C40DEF310}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.Repository.EntityFramework\", \"src\\Liquid.Repository.EntityFramework\\Liquid.Repository.EntityFramework.csproj\", \"{376DEF77-CBE3-452A-890C-FF2728D90322}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.Repository.Mongo\", \"src\\Liquid.Repository.Mongo\\Liquid.Repository.Mongo.csproj\", \"{D7B0D4F0-756B-4038-9DB2-0A1AD65ED72A}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.Messaging.ServiceBus.Tests\", \"test\\Liquid.Messaging.ServiceBus.Tests\\Liquid.Messaging.ServiceBus.Tests.csproj\", \"{A61C6606-A884-47BC-BD9D-DD9A3E4BDCDA}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.Messaging.ServiceBus\", \"src\\Liquid.Messaging.ServiceBus\\Liquid.Messaging.ServiceBus.csproj\", \"{C00DA46C-9614-4C42-AA89-64A3520F4EE7}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.Messaging.Kafka\", \"src\\Liquid.Messaging.Kafka\\Liquid.Messaging.Kafka.csproj\", \"{605AB027-CB0A-4B8E-8E20-55258369C497}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.Messaging.Kafka.Tests\", \"test\\Liquid.Messaging.Kafka.Tests\\Liquid.Messaging.Kafka.Tests.csproj\", \"{0D7F5E5F-348D-4606-9CE4-F2FB220E12BA}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.Messaging.RabbitMq\", \"src\\Liquid.Messaging.RabbitMq\\Liquid.Messaging.RabbitMq.csproj\", \"{6CFF2DEC-50E9-417C-A6E1-A0EFCD1EB94C}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.Messaging.RabbitMq.Tests\", \"test\\Liquid.Messaging.RabbitMq.Tests\\Liquid.Messaging.RabbitMq.Tests.csproj\", \"{40E39D18-CEDF-4BA1-8D9D-60DECAA30C9C}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.WebApi.Http\", \"src\\Liquid.WebApi.Http\\Liquid.WebApi.Http.csproj\", \"{25D05D84-4DFB-4F3D-92A2-B06DFA244BA4}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.WebApi.Http.Tests\", \"test\\Liquid.WebApi.Http.Tests\\Liquid.WebApi.Http.Tests.csproj\", \"{DED98401-EAED-4BE0-84A9-494D77B0E70D}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.Storage.AzureStorage\", \"src\\Liquid.Storage.AzureStorage\\Liquid.Storage.AzureStorage.csproj\", \"{F599C512-7224-4A27-A474-3AA9510D2A14}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.Dataverse\", \"src\\Liquid.Dataverse\\Liquid.Dataverse.csproj\", \"{CD31C6F6-F8DD-4B56-B08C-D9E8D5BA3E73}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.Dataverse.Tests\", \"test\\Liquid.Dataverse.Tests\\Liquid.Dataverse.Tests.csproj\", \"{5B0DC38B-5BC9-4DAC-8527-8D1C33E97247}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.Storage.AzureStorage.Tests\", \"test\\Liquid.Storage.AzureStorage.Tests\\Liquid.Storage.AzureStorage.Tests.csproj\", \"{53341B04-6D30-4137-943B-20D8706351E8}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.GenAi.OpenAi\", \"src\\Liquid.GenAi.OpenAi\\Liquid.GenAi.OpenAi.csproj\", \"{CB199ED6-3D1D-4E12-A15F-597B6A0BA564}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.Repository.OData\", \"src\\Liquid.Repository.OData\\Liquid.Repository.OData.csproj\", \"{60AE2AF5-D84C-4A8B-AA36-FD58A6A423D7}\"\nEndProject\nProject(\"{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}\") = \"Liquid.Repository.OData.Tests\", \"test\\Liquid.Repository.OData.Tests\\Liquid.Repository.OData.Tests.csproj\", \"{70A43D24-4905-4A16-8CE2-165F73243B8D}\"\nEndProject\nProject(\"{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}\") = \"Liquid.GenAi.OpenAi.Tests\", \"test\\Liquid.GenAi.OpenAi.Tests\\Liquid.GenAi.OpenAi.Tests.csproj\", \"{ECDF1DD3-073D-4708-A20B-1F0F2D663065}\"\nEndProject\nGlobal\n\tGlobalSection(SolutionConfigurationPlatforms) = preSolution\n\t\tDebug|Any CPU = Debug|Any CPU\n\t\tRelease|Any CPU = Release|Any CPU\n\tEndGlobalSection\n\tGlobalSection(ProjectConfigurationPlatforms) = postSolution\n\t\t{C33A89FC-4F4D-4274-8D0F-29456BA8F76B}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{C33A89FC-4F4D-4274-8D0F-29456BA8F76B}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{C33A89FC-4F4D-4274-8D0F-29456BA8F76B}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{C33A89FC-4F4D-4274-8D0F-29456BA8F76B}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{69B34B22-198D-4BD0-AAFC-39A90F9ADAC2}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{69B34B22-198D-4BD0-AAFC-39A90F9ADAC2}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{69B34B22-198D-4BD0-AAFC-39A90F9ADAC2}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{69B34B22-198D-4BD0-AAFC-39A90F9ADAC2}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{AD354CF6-C132-4B5D-944D-0DFE21509781}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{AD354CF6-C132-4B5D-944D-0DFE21509781}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{AD354CF6-C132-4B5D-944D-0DFE21509781}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{AD354CF6-C132-4B5D-944D-0DFE21509781}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{8863A92B-E1A3-4203-8C08-C017E5B3D2CC}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{8863A92B-E1A3-4203-8C08-C017E5B3D2CC}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{8863A92B-E1A3-4203-8C08-C017E5B3D2CC}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{8863A92B-E1A3-4203-8C08-C017E5B3D2CC}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{C7DD9DB1-E287-4886-AA44-159C0AB4F041}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{C7DD9DB1-E287-4886-AA44-159C0AB4F041}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{C7DD9DB1-E287-4886-AA44-159C0AB4F041}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{C7DD9DB1-E287-4886-AA44-159C0AB4F041}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{74D0605F-5466-423D-B5ED-E2C104BB3180}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{74D0605F-5466-423D-B5ED-E2C104BB3180}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{74D0605F-5466-423D-B5ED-E2C104BB3180}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{74D0605F-5466-423D-B5ED-E2C104BB3180}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{6508D946-4B74-4629-B819-4C2C3F7AF8B5}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{6508D946-4B74-4629-B819-4C2C3F7AF8B5}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{6508D946-4B74-4629-B819-4C2C3F7AF8B5}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{6508D946-4B74-4629-B819-4C2C3F7AF8B5}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{F24D06BE-E608-4DFD-B8F6-B02F87062323}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{F24D06BE-E608-4DFD-B8F6-B02F87062323}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{F24D06BE-E608-4DFD-B8F6-B02F87062323}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{F24D06BE-E608-4DFD-B8F6-B02F87062323}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{28747B1E-0784-4B7B-AE48-F5AD3C937262}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{28747B1E-0784-4B7B-AE48-F5AD3C937262}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{28747B1E-0784-4B7B-AE48-F5AD3C937262}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{28747B1E-0784-4B7B-AE48-F5AD3C937262}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{08A826AA-2C2E-4E21-A3D8-60BF8E57772E}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{08A826AA-2C2E-4E21-A3D8-60BF8E57772E}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{08A826AA-2C2E-4E21-A3D8-60BF8E57772E}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{08A826AA-2C2E-4E21-A3D8-60BF8E57772E}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{ED3C04BC-3DEF-4B5C-BF91-EE8F5C38F8E4}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{ED3C04BC-3DEF-4B5C-BF91-EE8F5C38F8E4}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{ED3C04BC-3DEF-4B5C-BF91-EE8F5C38F8E4}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{ED3C04BC-3DEF-4B5C-BF91-EE8F5C38F8E4}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{2E8F3332-545A-4454-9F75-1498A9B7B9BF}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{2E8F3332-545A-4454-9F75-1498A9B7B9BF}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{2E8F3332-545A-4454-9F75-1498A9B7B9BF}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{2E8F3332-545A-4454-9F75-1498A9B7B9BF}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{400BD703-3E6F-41E6-929B-5FD888EFD00A}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{400BD703-3E6F-41E6-929B-5FD888EFD00A}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{400BD703-3E6F-41E6-929B-5FD888EFD00A}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{400BD703-3E6F-41E6-929B-5FD888EFD00A}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{73A5230F-0A90-4D2C-8D5E-D95C40DEF310}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{73A5230F-0A90-4D2C-8D5E-D95C40DEF310}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{73A5230F-0A90-4D2C-8D5E-D95C40DEF310}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{73A5230F-0A90-4D2C-8D5E-D95C40DEF310}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{376DEF77-CBE3-452A-890C-FF2728D90322}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{376DEF77-CBE3-452A-890C-FF2728D90322}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{376DEF77-CBE3-452A-890C-FF2728D90322}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{376DEF77-CBE3-452A-890C-FF2728D90322}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{D7B0D4F0-756B-4038-9DB2-0A1AD65ED72A}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{D7B0D4F0-756B-4038-9DB2-0A1AD65ED72A}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{D7B0D4F0-756B-4038-9DB2-0A1AD65ED72A}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{D7B0D4F0-756B-4038-9DB2-0A1AD65ED72A}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{A61C6606-A884-47BC-BD9D-DD9A3E4BDCDA}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{A61C6606-A884-47BC-BD9D-DD9A3E4BDCDA}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{A61C6606-A884-47BC-BD9D-DD9A3E4BDCDA}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{A61C6606-A884-47BC-BD9D-DD9A3E4BDCDA}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{C00DA46C-9614-4C42-AA89-64A3520F4EE7}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{C00DA46C-9614-4C42-AA89-64A3520F4EE7}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{C00DA46C-9614-4C42-AA89-64A3520F4EE7}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{C00DA46C-9614-4C42-AA89-64A3520F4EE7}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{605AB027-CB0A-4B8E-8E20-55258369C497}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{605AB027-CB0A-4B8E-8E20-55258369C497}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{605AB027-CB0A-4B8E-8E20-55258369C497}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{605AB027-CB0A-4B8E-8E20-55258369C497}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{0D7F5E5F-348D-4606-9CE4-F2FB220E12BA}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{0D7F5E5F-348D-4606-9CE4-F2FB220E12BA}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{0D7F5E5F-348D-4606-9CE4-F2FB220E12BA}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{0D7F5E5F-348D-4606-9CE4-F2FB220E12BA}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{6CFF2DEC-50E9-417C-A6E1-A0EFCD1EB94C}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{6CFF2DEC-50E9-417C-A6E1-A0EFCD1EB94C}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{6CFF2DEC-50E9-417C-A6E1-A0EFCD1EB94C}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{6CFF2DEC-50E9-417C-A6E1-A0EFCD1EB94C}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{40E39D18-CEDF-4BA1-8D9D-60DECAA30C9C}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{40E39D18-CEDF-4BA1-8D9D-60DECAA30C9C}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{40E39D18-CEDF-4BA1-8D9D-60DECAA30C9C}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{40E39D18-CEDF-4BA1-8D9D-60DECAA30C9C}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{25D05D84-4DFB-4F3D-92A2-B06DFA244BA4}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{25D05D84-4DFB-4F3D-92A2-B06DFA244BA4}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{25D05D84-4DFB-4F3D-92A2-B06DFA244BA4}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{25D05D84-4DFB-4F3D-92A2-B06DFA244BA4}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{DED98401-EAED-4BE0-84A9-494D77B0E70D}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{DED98401-EAED-4BE0-84A9-494D77B0E70D}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{DED98401-EAED-4BE0-84A9-494D77B0E70D}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{DED98401-EAED-4BE0-84A9-494D77B0E70D}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{F599C512-7224-4A27-A474-3AA9510D2A14}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{F599C512-7224-4A27-A474-3AA9510D2A14}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{F599C512-7224-4A27-A474-3AA9510D2A14}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{F599C512-7224-4A27-A474-3AA9510D2A14}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{CD31C6F6-F8DD-4B56-B08C-D9E8D5BA3E73}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{CD31C6F6-F8DD-4B56-B08C-D9E8D5BA3E73}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{CD31C6F6-F8DD-4B56-B08C-D9E8D5BA3E73}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{CD31C6F6-F8DD-4B56-B08C-D9E8D5BA3E73}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{5B0DC38B-5BC9-4DAC-8527-8D1C33E97247}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{5B0DC38B-5BC9-4DAC-8527-8D1C33E97247}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{5B0DC38B-5BC9-4DAC-8527-8D1C33E97247}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{5B0DC38B-5BC9-4DAC-8527-8D1C33E97247}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{53341B04-6D30-4137-943B-20D8706351E8}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{53341B04-6D30-4137-943B-20D8706351E8}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{53341B04-6D30-4137-943B-20D8706351E8}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{53341B04-6D30-4137-943B-20D8706351E8}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{CB199ED6-3D1D-4E12-A15F-597B6A0BA564}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{CB199ED6-3D1D-4E12-A15F-597B6A0BA564}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{CB199ED6-3D1D-4E12-A15F-597B6A0BA564}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{CB199ED6-3D1D-4E12-A15F-597B6A0BA564}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{60AE2AF5-D84C-4A8B-AA36-FD58A6A423D7}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{60AE2AF5-D84C-4A8B-AA36-FD58A6A423D7}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{60AE2AF5-D84C-4A8B-AA36-FD58A6A423D7}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{60AE2AF5-D84C-4A8B-AA36-FD58A6A423D7}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{70A43D24-4905-4A16-8CE2-165F73243B8D}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{70A43D24-4905-4A16-8CE2-165F73243B8D}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{70A43D24-4905-4A16-8CE2-165F73243B8D}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{70A43D24-4905-4A16-8CE2-165F73243B8D}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{ECDF1DD3-073D-4708-A20B-1F0F2D663065}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{ECDF1DD3-073D-4708-A20B-1F0F2D663065}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{ECDF1DD3-073D-4708-A20B-1F0F2D663065}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{ECDF1DD3-073D-4708-A20B-1F0F2D663065}.Release|Any CPU.Build.0 = Release|Any CPU\n\tEndGlobalSection\n\tGlobalSection(SolutionProperties) = preSolution\n\t\tHideSolutionNode = FALSE\n\tEndGlobalSection\n\tGlobalSection(NestedProjects) = preSolution\n\t\t{69B34B22-198D-4BD0-AAFC-39A90F9ADAC2} = {BDB77DF2-2D7D-4363-BB2B-D6A3A8A69C7B}\n\t\t{8863A92B-E1A3-4203-8C08-C017E5B3D2CC} = {BDB77DF2-2D7D-4363-BB2B-D6A3A8A69C7B}\n\t\t{28747B1E-0784-4B7B-AE48-F5AD3C937262} = {BDB77DF2-2D7D-4363-BB2B-D6A3A8A69C7B}\n\t\t{08A826AA-2C2E-4E21-A3D8-60BF8E57772E} = {BDB77DF2-2D7D-4363-BB2B-D6A3A8A69C7B}\n\t\t{ED3C04BC-3DEF-4B5C-BF91-EE8F5C38F8E4} = {BDB77DF2-2D7D-4363-BB2B-D6A3A8A69C7B}\n\t\t{2E8F3332-545A-4454-9F75-1498A9B7B9BF} = {BDB77DF2-2D7D-4363-BB2B-D6A3A8A69C7B}\n\t\t{400BD703-3E6F-41E6-929B-5FD888EFD00A} = {BDB77DF2-2D7D-4363-BB2B-D6A3A8A69C7B}\n\t\t{73A5230F-0A90-4D2C-8D5E-D95C40DEF310} = {BDB77DF2-2D7D-4363-BB2B-D6A3A8A69C7B}\n\t\t{A61C6606-A884-47BC-BD9D-DD9A3E4BDCDA} = {BDB77DF2-2D7D-4363-BB2B-D6A3A8A69C7B}\n\t\t{0D7F5E5F-348D-4606-9CE4-F2FB220E12BA} = {BDB77DF2-2D7D-4363-BB2B-D6A3A8A69C7B}\n\t\t{40E39D18-CEDF-4BA1-8D9D-60DECAA30C9C} = {BDB77DF2-2D7D-4363-BB2B-D6A3A8A69C7B}\n\t\t{DED98401-EAED-4BE0-84A9-494D77B0E70D} = {BDB77DF2-2D7D-4363-BB2B-D6A3A8A69C7B}\n\t\t{5B0DC38B-5BC9-4DAC-8527-8D1C33E97247} = {BDB77DF2-2D7D-4363-BB2B-D6A3A8A69C7B}\n\t\t{53341B04-6D30-4137-943B-20D8706351E8} = {BDB77DF2-2D7D-4363-BB2B-D6A3A8A69C7B}\n\t\t{70A43D24-4905-4A16-8CE2-165F73243B8D} = {BDB77DF2-2D7D-4363-BB2B-D6A3A8A69C7B}\n\t\t{ECDF1DD3-073D-4708-A20B-1F0F2D663065} = {BDB77DF2-2D7D-4363-BB2B-D6A3A8A69C7B}\n\tEndGlobalSection\n\tGlobalSection(ExtensibilityGlobals) = postSolution\n\t\tSolutionGuid = {1D003939-9797-4F37-B391-10047A780641}\n\tEndGlobalSection\nEndGlobal\n"
},
{
"path": "Liquid.WebApi.sln",
"content": "\nMicrosoft Visual Studio Solution File, Format Version 12.00\n# Visual Studio Version 17\nVisualStudioVersion = 17.0.31612.314\nMinimumVisualStudioVersion = 10.0.40219.1\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.WebApi.Http\", \"src\\Liquid.WebApi.Http\\Liquid.WebApi.Http.csproj\", \"{25D05D84-4DFB-4F3D-92A2-B06DFA244BA4}\"\nEndProject\nProject(\"{2150E333-8FDC-42A3-9474-1A3956D46DE8}\") = \"workflows\", \"workflows\", \"{7B0BC311-679F-4D1F-BE49-DF3E49863792}\"\n\tProjectSection(SolutionItems) = preProject\n\t\t.github\\workflows\\liquid-ci-cd-http-extensions-crud.yml = .github\\workflows\\liquid-ci-cd-http-extensions-crud.yml\n\t\t.github\\workflows\\liquid-ci-cd-http.yml = .github\\workflows\\liquid-ci-cd-http.yml\n\tEndProjectSection\nEndProject\nProject(\"{2150E333-8FDC-42A3-9474-1A3956D46DE8}\") = \"Http\", \"Http\", \"{13C213E0-722A-4CD5-9209-21E12FDA0CA8}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.WebApi.Http.Tests\", \"test\\Liquid.WebApi.Http.Tests\\Liquid.WebApi.Http.Tests.csproj\", \"{39DDC514-44CD-43BE-9E5B-C3B86665895E}\"\nEndProject\nGlobal\n\tGlobalSection(SolutionConfigurationPlatforms) = preSolution\n\t\tDebug|Any CPU = Debug|Any CPU\n\t\tRelease|Any CPU = Release|Any CPU\n\tEndGlobalSection\n\tGlobalSection(ProjectConfigurationPlatforms) = postSolution\n\t\t{25D05D84-4DFB-4F3D-92A2-B06DFA244BA4}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{25D05D84-4DFB-4F3D-92A2-B06DFA244BA4}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{25D05D84-4DFB-4F3D-92A2-B06DFA244BA4}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{25D05D84-4DFB-4F3D-92A2-B06DFA244BA4}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{39DDC514-44CD-43BE-9E5B-C3B86665895E}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{39DDC514-44CD-43BE-9E5B-C3B86665895E}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{39DDC514-44CD-43BE-9E5B-C3B86665895E}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{39DDC514-44CD-43BE-9E5B-C3B86665895E}.Release|Any CPU.Build.0 = Release|Any CPU\n\tEndGlobalSection\n\tGlobalSection(SolutionProperties) = preSolution\n\t\tHideSolutionNode = FALSE\n\tEndGlobalSection\n\tGlobalSection(NestedProjects) = preSolution\n\t\t{25D05D84-4DFB-4F3D-92A2-B06DFA244BA4} = {13C213E0-722A-4CD5-9209-21E12FDA0CA8}\n\t\t{39DDC514-44CD-43BE-9E5B-C3B86665895E} = {13C213E0-722A-4CD5-9209-21E12FDA0CA8}\n\tEndGlobalSection\n\tGlobalSection(ExtensibilityGlobals) = postSolution\n\t\tSolutionGuid = {83C46B4F-18D0-45CB-B7EC-9A5B8840F6A0}\n\tEndGlobalSection\nEndGlobal\n"
},
{
"path": "README.md",
"content": "# Liquid Application Framework\n\n\n\n\n[](https://avanade.github.io/code-of-conduct/)\n[](https://avanade.github.io/maturity-model/)\n\nThis repository contains Liquid Application Framework full code, samples, templates and [documentation](docs/About-Liquid.md).\n\n## What is Liquid?\n\nLiquid is a **multi-cloud** framework designed to **accelerate the development** of cloud-native microservices while avoiding coupling your code to specific cloud providers.\n\nWhen 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.\n\n## Feature\n\n- 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.\n- 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.\n\n| Liquid Application Framework Binaries | Version |\n| :-- | :--: |\n| [`Liquid.Core`](https://www.nuget.org/packages/Liquid.Core) |  |\n| [`Liquid.Repository.Mongo`](https://www.nuget.org/packages/Liquid.Repository.Mongo) |  |\n| [`Liquid.Repository.EntityFramework`](https://www.nuget.org/packages/Liquid.Repository.EntityFramework) |  |\n| [`Liquid.Repository.OData`](https://www.nuget.org/packages/Liquid.Repository.OData) |  |\n| [`Liquid.Cache.Memory`](https://www.nuget.org/packages/Liquid.Cache.Memory) |  |\n| [`Liquid.Cache.NCache`](https://www.nuget.org/packages/Liquid.Cache.NCache) |  |\n| [`Liquid.Cache.Redis`](https://www.nuget.org/packages/Liquid.Cache.Redis) |  |\n| [`Liquid.Cache.SqlServer`](https://www.nuget.org/packages/Liquid.Cache.SqlServer) |  |\n| [`Liquid.Messaging.Kafka`](https://www.nuget.org/packages/Liquid.Messaging.Kafka) |  |\n| [`Liquid.Messaging.RabbitMq`](https://www.nuget.org/packages/Liquid.Messaging.RabbitMq) |  |\n| [`Liquid.Messaging.ServiceBus`](https://www.nuget.org/packages/Liquid.Messaging.ServiceBus) |  |\n| [`Liquid.WebApi.Http`](https://www.nuget.org/packages/Liquid.WebApi.Http) |  |\n| [`Liquid.Dataverse`](https://www.nuget.org/packages/Liquid.Dataverse) |  |\n| [`Liquid.Storage.AzureStorage`](https://www.nuget.org/packages/Liquid.Storage.AzureStorage) |  |\n| [`Liquid.GenAi.OpenAi`](https://www.nuget.org/packages/Liquid.GenAi.OpenAi) |  |\n\n\n## Getting Started\n\nYou can use Liquid Templates to get your microservice started.\n\nInstall the templates by running the following dotnet CLI command at the PowerShell prompt :\n\n```Shell\ndotnet new install Liquid.Templates\n```\nand run dotnet new command with the name and parameters of the following templates:\n|Name|Description|\n| :-- | :-- |\n|`liquidcrudsolution` |Liquid WebAPI CRUD Solution (Domain and WebAPI projects) |\n|`liquidcrudaddentity` |Liquid entity class, CRUD mediator handlers and CRUD controller |\n|`liquiddomainaddhandler` |Liquid mediator command handler |\n|`liquiddomainproject` |Liquid Domain project (mediator command handler) |\n|`liquidwebapisolution` |Liquid WebAPI solution (Domain and WebAPI projects) |\n|`liquidwebapiaddentity` |Liquid entity class, mediator command handler and CRUD controller |\n|`liquidwebapiproject` |Liquid WebAPI project |\n|`liquidworkersolution` |Liquid WorkerService solution (Domain and WorkerService projects) |\n|`liquidworkerproject` |Liquid WorkerService project |\n|`liquidbcontextaddentity` |Liquid DbContext entity configuration class (for Entity Framework) |\n|`liquiddbcontextproject` |Liquid Repository project (EntityFramework DbContext configurations) |\n\n\n### Sample:\nTo create an WebAPI solution with CRUD handlers, you must:\n- execute command :\n```Shell\ndotnet new liquidcrudsolution --projectName \"some root namespace\" --entityName \"some entity\" --entityIdType \"type of your unique ID\"\n```\n\n- open the folder where the command was executed, and open the project created in the IDE of your choice:\n\n\n\n- follow the instructions found in the generated code TODOs, and run!\n\n> You can make changes in code, add more classes and project if you need, and also using others Liquid templates to do it!\n\n\n## Contribute\n\nSome of the best ways to contribute are to try things out, file issues, and make pull-requests.\n\n- You can provide feedback by filing issues on GitHub or open a discussion in [Discussions tab](https://github.com/Avanade/Liquid-Application-Framework/discussions). We accept issues, ideas and questions.\n- 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.\n- Avanade asks that all commits sign the [Developer Certificate of Origin](https://developercertificate.org/).\n\nIn any case, be sure to take a look at [the contributing guide](CONTRIBUTING.md) before starting, and see our [security disclosure](https://github.com/Avanade/avanade-template/blob/main/SECURITY.md) policy.\n\n## Who is Avanade?\n\n[Avanade](https://www.avanade.com) is the leading provider of innovative digital, cloud and advisory services, industry solutions and design-led experiences across the Microsoft ecosystem.\n"
},
{
"path": "docs/About-Lightweight-Architectures.md",
"content": "| [Main](About-Liquid.md) > About Lightweight Architectures |\n|----|\n\nSuccessful modern digital solutions, like startups, while starts small and agile, had to cope with accelerated growth, reaching hundreds of millions of concurrent users while still being able to compete and evolve rapidly.\n\nHence, those companies (startups) have set the bar (of technology competence) to a much higher level than traditional enterprises were used to.\n\nNow, a new set of styles, patterns and practices rules the modern application life-cycle, targeting enterprises that are in their way to digital transformation (and competition).\n\nSuch type of enterprise architecture is being so called lightweight, in the sense that it resembles the lightness of **\"born-digital\"** solutions when compared to what has been done in large traditional companies.\n\n## Learn from some thought leaders \n- ### [Microservice Architectural Style by **Martin Fowler, _et al._**](https://www.martinfowler.com/articles/microservices.html)\n\n- ### [Cloud Design Patterns by **Microsoft**](https://docs.microsoft.com/en-us/azure/architecture/patterns/)\n\n- ### [The Twelve-Factor App by **Adam Wiggins**](https://12factor.net/)\n"
},
{
"path": "docs/About-Liquid-Applications.md",
"content": "| [Main](About-Liquid.md) > About Liquid Applications |\n|----|\n\nAccenture uses the term [Liquid Applications](https://www.accenture.com/us-en/capability-rapid-application-development-studio) to emphasize the ever-changing aspect of a given solution, meant do deal with unpredictable yet presumable external pressure from users, clients, competitors and regulators.\n\nThus, for \"liquid application\", we should think about a custom business solution build on top of a [lightweight architecture](About-Lightweight-Architectures.md) and able to coexist and evolve in the digital environment.\n\nSuch kind of application should be developed using a cloud-first, mobile-first and API-first approach, using Agile & DevOps practices and tools.\n\nLiquid have many [resources to ease the development and operation of such applications](Using-Liquid-for-building-your-application.md).\n"
},
{
"path": "docs/About-Liquid.md",
"content": "The **Liquid Application Framework** is a set of pre-integrated, ready-to-use binding code that supports the creation of [liquid applications](About-Liquid-Applications.md).\n\nIt is based on reference [lightweight architectures](About-Lightweight-Architectures.md), cloud design patterns and [modern software engineering](https://www.avanade.com/en/technologies/modern-software-engineering) techniques.\n\nFor building business software, Liquid can be thought of as a set of pre-built parts that drives a faster, safer, cheaper development work, while delivering high quality products.\n\n#Liquid boosts the lifecycle of modern applications. How does it do that?\nThe framework increases the development productivity and quality, while eases operation, of business applications by reducing their complexity through use of pre-built and pre-integrated technical components.\n\nIt also adds architectural uniformity and governance by making it possible for software engineers to focus on business domain logic, leaving the technical issues with to the framework.\n\nLast, but not least, Liquid allows for easy and centralized replacement and/or extension of platform components (_e.g._ database server) so applications built on top of it are tech-agnostic, _i.e._ minimizes vendor/platform lock-in.\n\n# See more\n1. [**Introduction**](Introduction.md) \n1. [**Key concepts**](Key-Concepts.md)\n1. [**Using Liquid to build your application**](Using-Liquid-for-building-your-application.md)\n1. [**Sample application: xxx** ](Sample-application-xxx.md)\n\n# Contribute\nSome of the best ways to contribute are to try things out, file issues, and make pull-requests.\n\n- You can provide feedback by filing issues on GitHub. We accept issues, ideas and questions. \n- You can contribute by creating pull requests for the issues that are listed. Look for issues marked as _good first issue_ if you are new to the project.\n\nIn any case, be sure to take a look at [the contributing guide](https://github.com/Avanade/Liquid-Application-Framework/CONTRIBUTING.md) before starting.\n"
},
{
"path": "docs/Business-logic-seggregation.md",
"content": "| [Main](About-Liquid.md) > [Key Concepts](Key-Concepts.md) > Business Logic Separation |\n|----|\n\nFor the sake of productivity, is better to have source code clear and legible, as much as possible.\n\nHowever, current technology platforms contain many components to be integrated and too many aspects to consider beyond the (business) algorithm in question.\n\nIt is hard to deal with those technology matters in a isolated way, seggregated from the core business logic that is being written.\n\nLiquid seeks to do that, as good as possible, allowing to use only minimum and precise mentions to such technical capabilities in the business code.\n\nTake the following example showing how Liquid hides most of the complexity of connecting to a data repository to find and update some data and, in the same logic, publishing an event in a queue of a message/event bus:\n\nOn Startup.cs:\n```csharp\n...\n //Injects the Messaging Service\n services.AddProducersConsumers(typeof(ProductPriceChangedPublisher).Assembly);\n...\n```\nOn ChangeProductPriceCommandHandler.cs:\n```csharp\n public class ChangeProductPriceCommandHandler : RequestHandlerBase, IRequestHandler\n {\n private readonly IProductRepository _productRepository;\n private readonly ILightProducer _productPriceChangedPublisher;\n private readonly IMapper _mapper;\n private readonly IPostService _postService;\n\n public ChangeProductPriceCommandHandler(IMediator mediatorService, \n ILightContext contextService, \n ILightTelemetry telemetryService, \n IMapper mapperService,\n IProductRepository productRepository,\n ILightProducer productPriceChangedPublisher,\n IPostService postService) : base(mediatorService, contextService, telemetryService, mapperService)\n {\n }\n\n\n\n\n /// \n /// Handles the specified request.\n /// \n /// The request.\n /// The cancellation token.\n /// \n public async Task Handle(ChangeProductPriceCommand request, CancellationToken cancellationToken)\n {\n var product = await _productRepository.FindByIdAsync(new ObjectId(request.Id));\n if (product != null)\n {\n product.Price = request.Price;\n await _productRepository.UpdateAsync(product);\n var changeProductPriceMessage = _mapper.Map(request);\n await _productPriceChangedPublisher.SendMessageAsync(changeProductPriceMessage);\n return true;\n }\n throw new ProductDoesNotExistException();\n }\n }\n```\n\nThe method `public async Task Handle(...` above is responsible for doing the business logic. It should find Product data in a repository, change its price, persist it back to the repository and publish an event. The classes `_productRepository` and `_productPriceChangedPublisher` hides the technical complexity mentioned before. Besides that, since those classes are injected on this Command Handler, they can be substituted by any other classes implementing the same interfaces (`IProductRepository` and `ILightProducer` respectivelly), doing a complete isolation of the business logic and the underlying infrastructure components.\n\nIn this case, Liquid uses a common programming model in DDD hexagonal architectures, where external requests will be translated to Domain Commands or Domain Queries, and those will handle the business logic that responds to those requests. In that way, the requests can came from anywhere and in any format that could be handled outside the Domain. The same for the reponses.\n\nThis strategy is followed for all technology capabilities that Liquid abstracts and pre-integrates. \nFor instance, see bellow, how simple is to create the class to publish that event on a RAbbitMQ:\n```csharp\n [RabbitMqProducer(\"rabbitMqConnectionString\", \"ProductPriceChanged\")]\n public class ProductPriceChangedPublisher : RabbitMqProducer\n {\n /// \n /// Gets the rabbit mq settings.\n /// \n /// \n /// The rabbit mq settings.\n /// \n public override RabbitMqSettings RabbitMqSettings => new RabbitMqSettings\n {\n Durable = true,\n Persistent = true,\n Expiration = \"172800000\"\n };\n\n /// \n /// Initializes a new instance of the class.\n /// \n /// The context factory.\n /// The telemetry factory.\n /// The logger factory.\n /// The messaging settings.\n public ProductPriceChangedPublisher(ILightContextFactory contextFactory, \n ILightTelemetryFactory telemetryFactory, \n ILoggerFactory loggerFactory, \n ILightConfiguration> messagingSettings) : base(contextFactory, telemetryFactory, loggerFactory, messagingSettings)\n {\n }\n }\n```\nThe base class `RabbitMqProducer` will handle all the complexities inherent to connect to a RabbitMQ server and publish a message on a queue.\nThat is the beauty of using platform specific \"cartridges\". This way, it should be very easy to develop an application that could run on an on-premises environment using RabbitMQ as the message bus, and, also, the same application could be changed to run on Azure, using Azure ServiceBus as the message bus. In fact, the application could be created to dinamically switch between different platform implementations, in run time.\n\nIn contrast to what Liquid provides, see an example excerpt from the code of [.NET Core reference application](https://github.com/dotnet-architecture/eShopOnContainers/tree/dev/src/Services/Ordering/Ordering.BackgroundTasks):\n\n```\n...\n\nprivate void RegisterEventBus(IServiceCollection services)\n {\n var subscriptionClientName = Configuration[\"SubscriptionClientName\"];\n\n if (Configuration.GetValue(\"AzureServiceBusEnabled\"))\n {\n services.AddSingleton(sp =>\n {\n var serviceBusPersisterConnection = sp.GetRequiredService();\n var iLifetimeScope = sp.GetRequiredService();\n var logger = sp.GetRequiredService>();\n var eventBusSubcriptionsManager = sp.GetRequiredService();\n\n return new EventBusServiceBus(serviceBusPersisterConnection, logger,\n eventBusSubcriptionsManager, subscriptionClientName, iLifetimeScope);\n });\n }\n\n ...\n\n RegisterEventBus(services);\n\n //create autofac based service provider\n var container = new ContainerBuilder();\n container.Populate(services);\n\n return new AutofacServiceProvider(container.Build());\n}\n\n...\n\n private void ConfigureEventBus(IApplicationBuilder app)\n\n {\n var eventBus = app.ApplicationServices.GetRequiredService();\n \n ...\n\n eventBus.Subscribe();\n }\n\n...\n\n public class OrderStatusChangedToShippedIntegrationEventHandler : IIntegrationEventHandler\n {\n private readonly IHubContext _hubContext;\n\n public OrderStatusChangedToShippedIntegrationEventHandler(IHubContext hubContext)\n {\n _hubContext = hubContext ?? throw new ArgumentNullException(nameof(hubContext));\n }\n\n public async Task Handle(OrderStatusChangedToShippedIntegrationEvent @event)\n {\n ... \n }\n\n```\nThere are too many technical (platform specific) lines of code mixed with only a few application (business) ones: **OrderStatusChangedToShippedIntegrationEvent** and corresponding **Handle()**.\n\nIn this scenario, it is very hard to understand, refactor and evolve this code due to both technical and business demands.\n\nWith Liquid, the business logic will always be inside the domain, seggregated from the underlying technology, making it easier to understand. At same time, the underlying technology specifics will be outside the domain, abstracted in a way that makes possible to use different implementations that will work with the same business logic, while, also, allows to evolve these parts of code separatelly.\n"
},
{
"path": "docs/Introduction.md",
"content": "| [Main](About-Liquid.md) > Introduction | \n|----|\n\nIn the last years, the always challenging task of developing multi-hundred-line-of-code business applications has reached elevated sophistication and professionalism.\nA high-quality application life-cycle is not only for high-tech companies anymore. To be or to become digital demands distinguished software engineering skills for companies of any industry and any size.\nAvanade has historically helped several companies and professionals achieving proficiency in the development of modern applications during their digital transformation.\nNow Avanade provides Liquid, a framework envisioned to boost such engineering capabilities, available as an Open Source project, for anyone looking for quick, standardized, flexible, extensible and high quality microservices development.\n\n| Topics | \n| :-- | \n| [Technical Context](#Technical-Context)
[Avanade as a Thought Leader](#Avanade-as-a-Thought-Leader)
[Business Drivers](#Business-Drivers)
[Guiding Principles](#Guiding-Principles) | \n\n### Technical Context\n\nThe development of enterprise custom application has passed through several architectural waves in the last couple decades, with each new wave adding some complexity on top of the old ones.\nIn recent years, with the advent of modern architectural standards such as REST APIs, microservices on containers and single page applications as well as DevOps practices, the modern applications do have new strengths that are of great value to businesses and their customers. \nHowever, the complexity of designing, building and running such applications increased a lot, demanding great effort from architects, software and operation engineers to fully implement all the mandatory concepts and capabilities.\nMoreover, such effort is a repeating task while yet an error-prone one. That opens a great space for building a set of pre-built software components following a general-purpose technical design, thereby condensed as a framework for developing and running those so called modern applications.\n\n### Avanade as a Thought Leader\n\nBorn on the union of Microsoft and Accenture, Avanade has quickly become [a major competence center for the Microsoft's ecosystem of technology, services and partners](https://www.avanade.com/en-us/media-center/press-releases/2020-microsoft-global-alliance-si-partner-of-the-year), with a track record of hundreds of enterprise grade, innovative projects delivered.\nMicrosoft, in its transformation into a cloud service company, has made a complete rotation from a proprietary vendor to an open-source friendly company, thus naturally getting more and more influence on the evolution of the industry. \nIn particular, due to its influence in the Single Page Application (SPA) domain [with Angular & Typescript](https://techcrunch.com/2015/03/05/microsoft-and-google-collaborate-on-typescript-hell-has-not-frozen-over-yet/) and microservice architecture with [.NET Core & Docker](https://docs.microsoft.com/en-us/dotnet/standard/microservices-architecture/) (along with its open cloud offering such [Windows Azure](http://azure.microsoft.com) and VisualStudio.com) Microsoft has helped to pave the way for the building of modern digital applications.\nOn the other hand, Accenture is a top leader in technology consulting field and it continuously infuses Avanade with technical and methodological know-how in enterprise architecture and digital transformation.\nTherefore, Avanade is best positioned to advise methods, patterns and building blocks on top of mature stacks and tools such as Microsoft's as well as to materialize the usual tech-agnostic point of view of Accenture.\n\n### Business Drivers\n\nThe purpose of Liquid is to allow the building of modern applications with better quality in a more efficient way. Therefore, the following business drivers were stated:\n- **Reduce time-to-value with faster development and testing activities:** The learning curve is shorter if developers can abstract technical complexity and have their components easily and automatically put into a DevOps pipeline;\n- **Increase quality with code uniformity:** all application components can be written with the same high-level \"technical\" dialect thus promoting better code analysis, both static and dynamic;\n- **Improve application governance, maintenance and evolution:** a single point of technical decision for the entire code allows better standards implementation, code maintenance as well as easier introduction and/or replacement of technical components;\n- **Catalyze the use of delivery centers:** by getting most of the technical design out of the box, remote teams can focus on requirements (backlog) and on the design of the business solution (business logic on the application layer).\n\n### Guiding Principles\n\nFrom a technical perspective, the Liquid development was stressed toward the following principles:\n- **Prescriptive and non-intrusive programming model for business components:** frameworks and platform services (_e.g._ .NET Core and CosmosDB, respectively) are designed for broad use-case scenarios, very much broader than the vast majority of enterprise digital solutions actually demands. Liquid stands for the later scenarios and this is the high value space that it tries to fulfill. Therefore, Liquid [prescribes a \"light\" way of building business application](Key-Concepts.md/#prescriptive-programming-model) without compromising the capability of developers to use the underlying technology in any other ways, if this is a requirement;\n- **Multi platform based on workbench components replacement:** Liquid puts itself between application (business) components and underlying platform (technical) components to avoid (or, at least, minimize) vendor and/or technology lock-in of the application, during both building and execution time. Hence there ought to be a way of [simply replacing Liquid \"cartridges\"](Platform-Abstraction-Layer.md) of each type (_e.g._ database repository) from one specific technology to another (_e.g._ CosmosDB and DynamoDB) to seamlessly moving application (business) logic from one platform to another. This, obviously, will depend a lot on how the application development team will deal with specific features provided by the underlying technology being used. Most of the time, we only use a small subset of those features, making it very easy to substitute similar technologies. But, even when this is not the case, Liquid helps to isolate those specifics, allowing the creation of portable code with high control, avoiding spreaded infrastructure code that makes maintenance harder;\n- **Built-in lightweight patterns for technology domain:** There are many [design patterns](About-Lightweight-Architectures.md) that must be applied to develop a modern digital application. Many of them can be given to the (upper) application layer as an out-of-the box capability of Liquid;\n- **Abstract technical complexity from business software developer:** The true hard work of enterprise architects is (or should be) the structuring of millions of lines of code a large company has. Legacy code has probably grown over decades in an unsupervised manner. That should not be the case with the brand-new code of modern digital application. While dealing with technology (delta) innovation/rennovation is a task architects deal every new year, dealing with applications' structuring and refactoring is (or should be) their daily job. The same is valid for business software developers. Liquid helps engineers [to focus on their useful (business) code](Business-logic-seggregation.md).\n"
},
{
"path": "docs/Key-Concepts.md",
"content": "| [Main](About-Liquid) > Key Concepts |\n|----|\n\nA small group of core concepts balances the many aspects dealt by Liquid and determines its general shape and strengths.\n\n\n## Architectural Strategies\n- [**Platform abstraction layer:**](Platform-Abstraction-Layer.md) using the best from PaaS offerings while avoiding lock-in;\n\n- [**Business logic seggregation:**](Business-logic-seggregation.md) avoid mixing domain (business) logic along with underlying platform (technical) logic;\n\n- [**DevOps for microservices:**](DevOps-for-Microservices.md) giving this fine-grained unit of software an easier way of being built, deployed and tested in a continuous fashion.\n\n\n## Prescriptive Programming Model\n- [**APIs as (formal) object models:**](API-as-formal-Object-Model.md) leveraging the abstraction and formality of a well-formed API as a way to avoid code redundancy and error propensity;\n\n- [**Encapsulated domain (business) logic:**](Encapsulated-Domain-Logic.md) putting domain logic in a format (of classes) independent of the protocols used to access it;\n\n- [**Business error handling:**](Business-Error-Handling.md) defining a simple yet comprehensive way of dealing with business logic deviation;\n\n- [**Microservice sizing:**](Microservice-Sizing.md) giving shape to the various parameters of a well-designed microservice.\n"
},
{
"path": "docs/Platform-Abstraction-Layer.md",
"content": "| [Main](About-Liquid.md) > [Key Concepts](Key-Concepts.md) > Platform Abstraction Layer |\n|----|\n\nThe most fundamental strategy steering Liquid's design is its responsibility to decouple as much as possible the application components from the underlying platforms.\n\n  \n\nLiquid concentrates most of platform (technology) specific dependencies in one single point of code thus freeing up the many application (business) components to access pre-integrated, high abstraction primitives for doing their jobs.\n\nDoing such technology integration repetitive tasks, while error-prone and risky, can considerably increase costs on software projects. \n\nHence an abstraction layer like Liquid diminishes such costs as much as great is the number of business components written on top of it - without having to deal with those low levels details.\n\nAdditionally (and even more important), now there are only a handful of dependency points on a given set of technology components (_i.e._ on their SDKs and APIs).\n\nFollowing the Liquid guiding principle of [multi-platform components](Introduction.md/#guiding-principles), the pretty easy [replacement of one specific Liquid cartridge by another](Choose-platform-components.md) allows the avoidance of technology lock-in in a controlled and productive way.\n\nSee parts of a sample code that activates RabbitMQ as the message bus for asynchronous communication:\n\nOn Startup.cs:\n```csharp\n //Injects the Messaging Service\n services.AddProducersConsumers(typeof(ProductPriceChangedPublisher).Assembly);\n```\n\nOn ProductPriceChangedPublisher.cs:\n```csharp\n [RabbitMqProducer(\"messageBusConnectionString\", \"ProductPriceChanged\")]\n public class ProductPriceChangedPublisher : RabbitMqProducer\n```\n\nWhile you can easily change this code to use Azure ServiceBus, for sample, this approach makes possible to [use the best of breed from all platforms](Leveling-up-Platform-Providers.md), because you are able to implement specific technical functionalities of each platform on the specific cartridge (RabbitMqProducer in this case). Your point of maintenance in the code for such kind of change will not touch any business logic and will be very easy to do.\nFor use Azure ServiceBus instead of RabbitMQ, the only change would be on ProductPriceChangedPublisher.cs, as follows:\n```csharp\n [ServiceBusProducer(\"messageBusConnectionString\", \"ProductPriceChanged\")]\n public class ProductPriceChangedPublisher : ServiceBusProducer\n```\n\nActually, the corollary of a given market standard is to be a commodity technology.\n\nAccordingly, Liquid helps to transcend the classical trade-off between being open & commodity or being locked-in & differentiated.\n\nAdding new technology platform capabilities to all business application components can be done, once again, from a centralized point, in a controlled and agile way.\n\n"
},
{
"path": "docs/Using-Liquid-for-building-your-application.md",
"content": "# WIP - This tutorial is still a Work In Progress and should not be used yet\n - TODO: create the templates\n - TODO: create the documents for each step\n - TODO: confirm this step-by-step strawman\n\n\n| [Main](About-Liquid.md) > Using Liquid for building your application |\n|----|\n\nThe following are the basic instructions on how to build modern [liquid applications](About-Liquid-Applications.md) taking advantage of Liquid's features and [concepts](Key-Concepts.md).\n\n## Prepare your DevOps environment\n1. [Install Liquid project templates for starting](Install-project-templates.md)\n1. [Choose platform components to support your business code](Choose-platform-components.md)\n1. [Setup configurations per environment](Set-up-configurations-per-environment.md)\n1. [Configure CI, CD and CT](Configure-CI-CD-and-CT.md) \n1. [Deploy microservices on containers](Deploy-microservices.md)\n\n## Code your microservices\n6. [Define the APIs (and formats) exposed](Define-the-APIs.md) \n1. [Structure internal (business) logic](Structure-internal-logic.md)\n1. [Validate input parameters and data models](Validate-input-and-data.md)\n1. [Authenticate and authorize the API](Secure-the-APIs.md)\n1. [Persist and query data from repository](Persist-and-query-data.md)\n1. [Make calls to internal classes](Make-internal-calls.md)\n1. [Call other microservices ](Call-other-microservices.md)\n1. [Call third-party APIs](Call-third-party-APIs.md)\n\n# Connect your front-end to your APIs\n14. [Call the back-end](Calling-the-back-end.md)\n1. [Call third-party back-ends](Call-third-party-back-ends.md)\n1. [Add authentication to the front-end](Add-authentication-to-the-front-end.md)\n\n# Develop tests and mocks\n17. [Seed test data](Seeding-test-data.md)\n1. [Test APIs directly](Test-APIs-directly.md)\n1. [Mock authentication](Mock-authentication.md)\n1. [Mock calls to microservices](Mock-calls-to-microservices.md)\n\n# Add advanced behavior \n21. [Gather telemetry from front-ends and back-ends](Gather-telemetry.md)\n1. [Control state of changing data](Control-state-of-changing-data.md)\n1. [Querying and present data with pagination](Querying-data-with-pagination.md)\n1. [Building complex queries](Building-complex-queries.md)\n1. [Deal with multiple cultures](Deal-with-multiple-cultures.md)\n"
},
{
"path": "nuget.config",
"content": "\n\n \n \n \n"
},
{
"path": "samples/Liquid.Sample.Dataverse.sln",
"content": "\nMicrosoft Visual Studio Solution File, Format Version 12.00\n# Visual Studio Version 17\nVisualStudioVersion = 17.6.34202.202\nMinimumVisualStudioVersion = 10.0.40219.1\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.Sample.Dataverse.Function\", \"src\\Liquid.Sample.Dataverse.Function\\Liquid.Sample.Dataverse.Function.csproj\", \"{577C7D6D-566D-4EA2-8C32-039C2C4E17DF}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.Sample.Dataverse.Domain\", \"src\\Liquid.Sample.Dataverse.Domain\\Liquid.Sample.Dataverse.Domain.csproj\", \"{7C47775D-45C7-463E-84DA-5B5B264D55F0}\"\nEndProject\nGlobal\n\tGlobalSection(SolutionConfigurationPlatforms) = preSolution\n\t\tDebug|Any CPU = Debug|Any CPU\n\t\tRelease|Any CPU = Release|Any CPU\n\tEndGlobalSection\n\tGlobalSection(ProjectConfigurationPlatforms) = postSolution\n\t\t{577C7D6D-566D-4EA2-8C32-039C2C4E17DF}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{577C7D6D-566D-4EA2-8C32-039C2C4E17DF}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{577C7D6D-566D-4EA2-8C32-039C2C4E17DF}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{577C7D6D-566D-4EA2-8C32-039C2C4E17DF}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{7C47775D-45C7-463E-84DA-5B5B264D55F0}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{7C47775D-45C7-463E-84DA-5B5B264D55F0}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{7C47775D-45C7-463E-84DA-5B5B264D55F0}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{7C47775D-45C7-463E-84DA-5B5B264D55F0}.Release|Any CPU.Build.0 = Release|Any CPU\n\tEndGlobalSection\n\tGlobalSection(SolutionProperties) = preSolution\n\t\tHideSolutionNode = FALSE\n\tEndGlobalSection\n\tGlobalSection(ExtensibilityGlobals) = postSolution\n\t\tSolutionGuid = {FB41E555-2F25-4D02-8513-7EDC443A17D4}\n\tEndGlobalSection\nEndGlobal\n"
},
{
"path": "samples/Liquid.Sample.MessagingConsumer.sln",
"content": "\nMicrosoft Visual Studio Solution File, Format Version 12.00\n# Visual Studio Version 16\nVisualStudioVersion = 16.0.31410.357\nMinimumVisualStudioVersion = 10.0.40219.1\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.Sample.MessagingConsumer\", \"src\\Liquid.Sample.MessagingConsumer\\Liquid.Sample.MessagingConsumer.csproj\", \"{E4FE9A3E-4610-4EBF-AD0D-71A642B91282}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.Sample.Domain\", \"src\\Liquid.Sample.Domain\\Liquid.Sample.Domain.csproj\", \"{54EF1FE4-82A3-4D39-AB35-C589DC73413C}\"\nEndProject\nGlobal\n\tGlobalSection(SolutionConfigurationPlatforms) = preSolution\n\t\tDebug|Any CPU = Debug|Any CPU\n\t\tRelease|Any CPU = Release|Any CPU\n\tEndGlobalSection\n\tGlobalSection(ProjectConfigurationPlatforms) = postSolution\n\t\t{E4FE9A3E-4610-4EBF-AD0D-71A642B91282}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{E4FE9A3E-4610-4EBF-AD0D-71A642B91282}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{E4FE9A3E-4610-4EBF-AD0D-71A642B91282}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{E4FE9A3E-4610-4EBF-AD0D-71A642B91282}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{54EF1FE4-82A3-4D39-AB35-C589DC73413C}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{54EF1FE4-82A3-4D39-AB35-C589DC73413C}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{54EF1FE4-82A3-4D39-AB35-C589DC73413C}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{54EF1FE4-82A3-4D39-AB35-C589DC73413C}.Release|Any CPU.Build.0 = Release|Any CPU\n\tEndGlobalSection\n\tGlobalSection(SolutionProperties) = preSolution\n\t\tHideSolutionNode = FALSE\n\tEndGlobalSection\n\tGlobalSection(ExtensibilityGlobals) = postSolution\n\t\tSolutionGuid = {FD6C41A9-76DF-4FEE-98D9-154A31618D95}\n\tEndGlobalSection\nEndGlobal\n"
},
{
"path": "samples/Liquid.Sample.WebApi.sln",
"content": "\nMicrosoft Visual Studio Solution File, Format Version 12.00\n# Visual Studio Version 17\nVisualStudioVersion = 17.8.34408.163\nMinimumVisualStudioVersion = 10.0.40219.1\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Liquid.Sample.Domain\", \"src\\Liquid.Sample.Domain\\Liquid.Sample.Domain.csproj\", \"{68DCA206-AD43-4D44-AA1B-2F2E52DEE89A}\"\nEndProject\nProject(\"{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}\") = \"Liquid.Sample.Api\", \"src\\Liquid.Sample.Api\\Liquid.Sample.Api.csproj\", \"{356B2F4F-0846-42FD-A013-1B68E6C3D484}\"\nEndProject\nGlobal\n\tGlobalSection(SolutionConfigurationPlatforms) = preSolution\n\t\tDebug|Any CPU = Debug|Any CPU\n\t\tRelease|Any CPU = Release|Any CPU\n\tEndGlobalSection\n\tGlobalSection(ProjectConfigurationPlatforms) = postSolution\n\t\t{68DCA206-AD43-4D44-AA1B-2F2E52DEE89A}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{68DCA206-AD43-4D44-AA1B-2F2E52DEE89A}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{68DCA206-AD43-4D44-AA1B-2F2E52DEE89A}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{68DCA206-AD43-4D44-AA1B-2F2E52DEE89A}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{356B2F4F-0846-42FD-A013-1B68E6C3D484}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{356B2F4F-0846-42FD-A013-1B68E6C3D484}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{356B2F4F-0846-42FD-A013-1B68E6C3D484}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{356B2F4F-0846-42FD-A013-1B68E6C3D484}.Release|Any CPU.Build.0 = Release|Any CPU\n\tEndGlobalSection\n\tGlobalSection(SolutionProperties) = preSolution\n\t\tHideSolutionNode = FALSE\n\tEndGlobalSection\n\tGlobalSection(ExtensibilityGlobals) = postSolution\n\t\tSolutionGuid = {C37CEE66-2BB3-4FF4-970A-2B1518BE93CA}\n\tEndGlobalSection\nEndGlobal\n"
},
{
"path": "samples/src/Liquid.Sample.Api/Controllers/SampleController.cs",
"content": "using Liquid.Sample.Domain.Entities;\nusing Liquid.Sample.Domain.Handlers;\nusing Liquid.WebApi.Http.Controllers;\nusing MediatR;\nusing Microsoft.AspNetCore.Mvc;\nusing System.Net;\n\nnamespace Liquid.Sample.Api.Controllers\n{\n [ApiController]\n [Route(\"[controller]\")]\n public class SampleController : LiquidControllerBase\n {\n public SampleController(IMediator mediator) : base(mediator)\n {\n }\n\n [HttpGet(\"Sample\")]\n public async Task Get([FromQuery] string id) => await ExecuteAsync(new SampleRequest(id), HttpStatusCode.OK);\n\n [HttpPost]\n public async Task Post([FromBody] SampleMessageEntity entity)\n {\n await Mediator.Send(new SampleEventRequest(entity));\n\n return NoContent();\n }\n }\n}\n"
},
{
"path": "samples/src/Liquid.Sample.Api/Liquid.Sample.Api.csproj",
"content": "\n\n \n net6.0\n enable\n enable\n \n\n \n \n \n \n\n \n \n \n\n\n"
},
{
"path": "samples/src/Liquid.Sample.Api/Program.cs",
"content": "using Liquid.Messaging.ServiceBus.Extensions.DependencyInjection;\nusing Liquid.Repository.Mongo.Extensions;\nusing Liquid.Sample.Domain.Entities;\nusing Liquid.Sample.Domain.Handlers;\nusing Liquid.WebApi.Http.Extensions.DependencyInjection;\n\nvar builder = WebApplication.CreateBuilder(args);\n\n// Add services to the container.\nbuilder.Services.AddLiquidMongoRepository(\"Liquid:MyMongoDbSettings:Entities\");\n\nbuilder.Services.AddLiquidServiceBusProducer(\"Liquid:ServiceBus\", \"liquidoutput\", true);\n\nbuilder.Services.AddLiquidHttp(typeof(SampleRequest).Assembly);\nbuilder.Services.AddControllers();\n// Learn more about configuring Swagger/OpenAPI at https://aka.ms/aspnetcore/swashbuckle\nbuilder.Services.AddEndpointsApiExplorer();\nbuilder.Services.AddSwaggerGen();\n\nvar app = builder.Build();\n\n// Configure the HTTP request pipeline.\nif (app.Environment.IsDevelopment())\n{\n app.UseSwagger();\n app.UseSwaggerUI();\n}\n\napp.UseHttpsRedirection();\n\napp.UseAuthorization();\n\napp.MapControllers();\n\napp.Run();\n"
},
{
"path": "samples/src/Liquid.Sample.Api/appsettings.Development.json",
"content": "{\n \"Logging\": {\n \"LogLevel\": {\n \"Default\": \"Information\",\n \"Microsoft.AspNetCore\": \"Warning\"\n }\n }\n}\n"
},
{
"path": "samples/src/Liquid.Sample.Api/appsettings.json",
"content": "{\n \"Logging\": {\n \"LogLevel\": {\n \"Default\": \"Information\",\n \"Microsoft\": \"Warning\",\n \"Microsoft.Hosting.Lifetime\": \"Information\"\n },\n \"Console\": {\n \"IncludeScopes\": true\n }\n },\n \"AllowedHosts\": \"*\",\n \"Liquid\": {\n \"swagger\": {\n \"name\": \"v1\",\n \"host\": \"\",\n \"schemes\": [ \"http\", \"https\" ],\n \"title\": \"Liquidv2.SimpleApi\",\n \"version\": \"v1\",\n \"description\": \"Simple WebApi Sample.\",\n \"SwaggerEndpoint\": {\n \"url\": \"/swagger/v1/swagger.json\",\n \"name\": \"SimpleWebApiSample\"\n }\n },\n \"culture\": {\n \"defaultCulture\": \"pt-BR\"\n },\n \"MyMongoDbSettings\": {\n \"DefaultDatabaseSettings\": {\n \"connectionString\": \"\",\n \"databaseName\": \"MySampleDb\"\n },\n \"Entities\": {\n \"SampleEntity\": {\n \"CollectionName\": \"SampleCollection\",\n \"ShardKey\": \"id\"\n }\n }\n },\n \"ServiceBus\": {\n \"Settings\": [\n {\n \"ConnectionString\": \"\",\n \"EntityPath\": \"liquidoutput\"\n },\n {\n \"ConnectionString\": \"\",\n \"EntityPath\": \"liquidinput\"\n }\n ]\n }\n }\n}\n"
},
{
"path": "samples/src/Liquid.Sample.Dataverse.Domain/Liquid.Sample.Dataverse.Domain.csproj",
"content": "\n\n \n net6.0\n enable\n enable\n \n\n \n \n \n\n\n"
},
{
"path": "samples/src/Liquid.Sample.Dataverse.Domain/PostSampleService.cs",
"content": "using Liquid.Adapter.Dataverse;\nusing Liquid.Adapter.Dataverse.Extensions;\nusing Microsoft.Xrm.Sdk;\n\nnamespace Liquid.Sample.Dataverse.Domain\n{\n public class PostSampleService\n {\n private readonly ILiquidDataverseAdapter _adapter;\n\n private readonly ILiquidMapper _mapper;\n\n public PostSampleService(ILiquidDataverseAdapter adapter, ILiquidMapper mapper)\n {\n _adapter = adapter ?? throw new ArgumentNullException(nameof(adapter));\n _mapper = mapper ?? throw new ArgumentNullException(nameof(mapper));\n }\n\n public async Task PostSample(string body)\n {\n var bodyEntity = await _mapper.Map(body, \"sample\");\n\n var result = await _adapter.Create(bodyEntity);\n\n bodyEntity.Id = result;\n\n var response = bodyEntity.ToJsonString();\n\n return response;\n }\n }\n}"
},
{
"path": "samples/src/Liquid.Sample.Dataverse.Function/.gitignore",
"content": "## Ignore Visual Studio temporary files, build results, and\n## files generated by popular Visual Studio add-ons.\n\n# Azure Functions localsettings file\n#local.settings.json\n\n# User-specific files\n*.suo\n*.user\n*.userosscache\n*.sln.docstates\n\n# User-specific files (MonoDevelop/Xamarin Studio)\n*.userprefs\n\n# Build results\n[Dd]ebug/\n[Dd]ebugPublic/\n[Rr]elease/\n[Rr]eleases/\nx64/\nx86/\nbld/\n[Bb]in/\n[Oo]bj/\n[Ll]og/\n\n# Visual Studio 2015 cache/options directory\n.vs/\n# Uncomment if you have tasks that create the project's static files in wwwroot\n#wwwroot/\n\n# MSTest test Results\n[Tt]est[Rr]esult*/\n[Bb]uild[Ll]og.*\n\n# NUNIT\n*.VisualState.xml\nTestResult.xml\n\n# Build Results of an ATL Project\n[Dd]ebugPS/\n[Rr]eleasePS/\ndlldata.c\n\n# DNX\nproject.lock.json\nproject.fragment.lock.json\nartifacts/\n\n*_i.c\n*_p.c\n*_i.h\n*.ilk\n*.meta\n*.obj\n*.pch\n*.pdb\n*.pgc\n*.pgd\n*.rsp\n*.sbr\n*.tlb\n*.tli\n*.tlh\n*.tmp\n*.tmp_proj\n*.log\n*.vspscc\n*.vssscc\n.builds\n*.pidb\n*.svclog\n*.scc\n\n# Chutzpah Test files\n_Chutzpah*\n\n# Visual C++ cache files\nipch/\n*.aps\n*.ncb\n*.opendb\n*.opensdf\n*.sdf\n*.cachefile\n*.VC.db\n*.VC.VC.opendb\n\n# Visual Studio profiler\n*.psess\n*.vsp\n*.vspx\n*.sap\n\n# TFS 2012 Local Workspace\n$tf/\n\n# Guidance Automation Toolkit\n*.gpState\n\n# ReSharper is a .NET coding add-in\n_ReSharper*/\n*.[Rr]e[Ss]harper\n*.DotSettings.user\n\n# JustCode is a .NET coding add-in\n.JustCode\n\n# TeamCity is a build add-in\n_TeamCity*\n\n# DotCover is a Code Coverage Tool\n*.dotCover\n\n# NCrunch\n_NCrunch_*\n.*crunch*.local.xml\nnCrunchTemp_*\n\n# MightyMoose\n*.mm.*\nAutoTest.Net/\n\n# Web workbench (sass)\n.sass-cache/\n\n# Installshield output folder\n[Ee]xpress/\n\n# DocProject is a documentation generator add-in\nDocProject/buildhelp/\nDocProject/Help/*.HxT\nDocProject/Help/*.HxC\nDocProject/Help/*.hhc\nDocProject/Help/*.hhk\nDocProject/Help/*.hhp\nDocProject/Help/Html2\nDocProject/Help/html\n\n# Click-Once directory\npublish/\n\n# Publish Web Output\n*.[Pp]ublish.xml\n*.azurePubxml\n# TODO: Comment the next line if you want to checkin your web deploy settings\n# but database connection strings (with potential passwords) will be unencrypted\n#*.pubxml\n*.publishproj\n\n# Microsoft Azure Web App publish settings. Comment the next line if you want to\n# checkin your Azure Web App publish settings, but sensitive information contained\n# in these scripts will be unencrypted\nPublishScripts/\n\n# NuGet Packages\n*.nupkg\n# The packages folder can be ignored because of Package Restore\n**/packages/*\n# except build/, which is used as an MSBuild target.\n!**/packages/build/\n# Uncomment if necessary however generally it will be regenerated when needed\n#!**/packages/repositories.config\n# NuGet v3's project.json files produces more ignoreable files\n*.nuget.props\n*.nuget.targets\n\n# Microsoft Azure Build Output\ncsx/\n*.build.csdef\n\n# Microsoft Azure Emulator\necf/\nrcf/\n\n# Windows Store app package directories and files\nAppPackages/\nBundleArtifacts/\nPackage.StoreAssociation.xml\n_pkginfo.txt\n\n# Visual Studio cache files\n# files ending in .cache can be ignored\n*.[Cc]ache\n# but keep track of directories ending in .cache\n!*.[Cc]ache/\n\n# Others\nClientBin/\n~$*\n*~\n*.dbmdl\n*.dbproj.schemaview\n*.jfm\n*.pfx\n*.publishsettings\nnode_modules/\norleans.codegen.cs\n\n# Since there are multiple workflows, uncomment next line to ignore bower_components\n# (https://github.com/github/gitignore/pull/1529#issuecomment-104372622)\n#bower_components/\n\n# RIA/Silverlight projects\nGenerated_Code/\n\n# Backup & report files from converting an old project file\n# to a newer Visual Studio version. Backup files are not needed,\n# because we have git ;-)\n_UpgradeReport_Files/\nBackup*/\nUpgradeLog*.XML\nUpgradeLog*.htm\n\n# SQL Server files\n*.mdf\n*.ldf\n\n# Business Intelligence projects\n*.rdl.data\n*.bim.layout\n*.bim_*.settings\n\n# Microsoft Fakes\nFakesAssemblies/\n\n# GhostDoc plugin setting file\n*.GhostDoc.xml\n\n# Node.js Tools for Visual Studio\n.ntvs_analysis.dat\n\n# Visual Studio 6 build log\n*.plg\n\n# Visual Studio 6 workspace options file\n*.opt\n\n# Visual Studio LightSwitch build output\n**/*.HTMLClient/GeneratedArtifacts\n**/*.DesktopClient/GeneratedArtifacts\n**/*.DesktopClient/ModelManifest.xml\n**/*.Server/GeneratedArtifacts\n**/*.Server/ModelManifest.xml\n_Pvt_Extensions\n\n# Paket dependency manager\n.paket/paket.exe\npaket-files/\n\n# FAKE - F# Make\n.fake/\n\n# JetBrains Rider\n.idea/\n*.sln.iml\n\n# CodeRush\n.cr/\n\n# Python Tools for Visual Studio (PTVS)\n__pycache__/\n*.pyc"
},
{
"path": "samples/src/Liquid.Sample.Dataverse.Function/DataverseIntegration.cs",
"content": "using System;\nusing System.IO;\nusing System.Threading.Tasks;\nusing Microsoft.AspNetCore.Mvc;\nusing Microsoft.Azure.WebJobs;\nusing Microsoft.Azure.WebJobs.Extensions.Http;\nusing Microsoft.AspNetCore.Http;\nusing Microsoft.Extensions.Logging;\nusing Newtonsoft.Json;\nusing Liquid.Sample.Dataverse.Domain;\n\nnamespace Liquid.Sample.Dataverse.Function\n{\n public class DataverseIntegration\n {\n private readonly PostSampleService _service;\n\n public DataverseIntegration(PostSampleService service)\n {\n _service = service ?? throw new ArgumentNullException(nameof(service));\n }\n\n [FunctionName(\"PostSample\")]\n public async Task Run(\n [HttpTrigger(AuthorizationLevel.Function, \"post\", Route = null)] HttpRequest req,\n ILogger log)\n {\n log.LogInformation(\"C# HTTP trigger function processed a request.\");\n\n string requestBody = await new StreamReader(req.Body).ReadToEndAsync();\n\n dynamic data = JsonConvert.DeserializeObject(requestBody);\n\n string responseMessage = await _service.PostSample(data);\n\n return new OkObjectResult(responseMessage);\n }\n }\n}\n"
},
{
"path": "samples/src/Liquid.Sample.Dataverse.Function/Liquid.Sample.Dataverse.Function.csproj",
"content": "\n \n net6.0\n v4\n \n \n \n \n \n \n \n \n \n \n PreserveNewest\n \n \n PreserveNewest\n Never\n \n \n\n"
},
{
"path": "samples/src/Liquid.Sample.Dataverse.Function/Properties/serviceDependencies.json",
"content": "{\n \"dependencies\": {\n \"appInsights1\": {\n \"type\": \"appInsights\"\n },\n \"storage1\": {\n \"type\": \"storage\",\n \"connectionId\": \"AzureWebJobsStorage\"\n }\n }\n}"
},
{
"path": "samples/src/Liquid.Sample.Dataverse.Function/Properties/serviceDependencies.local.json",
"content": "{\n \"dependencies\": {\n \"appInsights1\": {\n \"type\": \"appInsights.sdk\"\n },\n \"storage1\": {\n \"type\": \"storage.emulator\",\n \"connectionId\": \"AzureWebJobsStorage\"\n }\n }\n}"
},
{
"path": "samples/src/Liquid.Sample.Dataverse.Function/Startup.cs",
"content": "using Liquid.Adapter.Dataverse.Extensions.DependencyInjection;\nusing Liquid.Sample.Dataverse.Function;\nusing Microsoft.Azure.Functions.Extensions.DependencyInjection;\nusing Microsoft.Extensions.Configuration;\nusing System.IO;\n\n[assembly: FunctionsStartup(typeof(Startup))]\n\nnamespace Liquid.Sample.Dataverse.Function\n{\n public class Startup : FunctionsStartup\n {\n public override void Configure(IFunctionsHostBuilder builder)\n {\n builder.Services.AddLiquidDataverseAdapter(\"DataverseClient\");\n }\n\n public override void ConfigureAppConfiguration(IFunctionsConfigurationBuilder builder)\n {\n FunctionsHostBuilderContext context = builder.GetContext();\n\n builder.ConfigurationBuilder\n .AddJsonFile(Path.Combine(context.ApplicationRootPath, $\"local.setttings.json\"), optional: true, reloadOnChange: true)\n .AddEnvironmentVariables();\n }\n }\n}\n"
},
{
"path": "samples/src/Liquid.Sample.Dataverse.Function/host.json",
"content": "{\n \"version\": \"2.0\",\n \"logging\": {\n \"applicationInsights\": {\n \"samplingSettings\": {\n \"isEnabled\": true,\n \"excludedTypes\": \"Request\"\n },\n \"enableLiveMetricsFilters\": true\n }\n }\n}"
},
{
"path": "samples/src/Liquid.Sample.Dataverse.Function/local.settings.json",
"content": "{\n \"IsEncrypted\": false,\n \"Values\": {\n \"AzureWebJobsStorage\": \"UseDevelopmentStorage=true\",\n \"FUNCTIONS_WORKER_RUNTIME\": \"dotnet\",\n \"DataverseClient:ClientId\": \"\",\n \"DataverseClient:ClientSecret\": \"\",\n \"DataverseClient:url\": \"\"\n }\n}"
},
{
"path": "samples/src/Liquid.Sample.Domain/Entities/SampleEntity.cs",
"content": "using Liquid.Repository;\nusing System;\n\nnamespace Liquid.Sample.Domain.Entities\n{\n public class SampleEntity : LiquidEntity\n {\n public string MyProperty { get; set; }\n }\n}\n"
},
{
"path": "samples/src/Liquid.Sample.Domain/Entities/SampleMessageEntity.cs",
"content": "using Liquid.Repository;\nusing System;\n\nnamespace Liquid.Sample.Domain.Entities\n{\n [Serializable]\n public class SampleMessageEntity\n {\n public string Id { get; set; }\n public string MyProperty { get; set; }\n }\n}\n"
},
{
"path": "samples/src/Liquid.Sample.Domain/Handlers/SampleGet/SampleCommandHandler.cs",
"content": "using Liquid.Repository;\nusing Liquid.Sample.Domain.Entities;\nusing MediatR;\nusing System;\nusing System.Linq;\nusing System.Threading;\nusing System.Threading.Tasks;\n\nnamespace Liquid.Sample.Domain.Handlers\n{\n public class SampleCommandHandler : IRequestHandler\n {\n private ILiquidRepository _repository;\n public SampleCommandHandler(ILiquidRepository repository)\n {\n _repository = repository;\n }\n\n ///\n public async Task Handle(SampleRequest request, CancellationToken cancellationToken)\n {\n var item = await _repository.FindByIdAsync(Guid.Parse(request.Id));\n\n var result = new SampleResponse(item);\n\n return result;\n }\n }\n}\n"
},
{
"path": "samples/src/Liquid.Sample.Domain/Handlers/SampleGet/SampleRequest.cs",
"content": "using MediatR;\nusing System;\n\nnamespace Liquid.Sample.Domain.Handlers\n{\n public class SampleRequest : IRequest\n {\n public string Id { get; set; }\n\n public SampleRequest(string id)\n {\n Id = id;\n }\n }\n}\n"
},
{
"path": "samples/src/Liquid.Sample.Domain/Handlers/SampleGet/SampleRequestValidator.cs",
"content": "using FluentValidation;\nusing System;\nusing System.Collections.Generic;\nusing System.Linq;\nusing System.Text;\nusing System.Threading.Tasks;\n\nnamespace Liquid.Sample.Domain.Handlers\n{\n public class SampleRequestValidator : AbstractValidator\n {\n public SampleRequestValidator()\n {\n RuleFor(request => request.Id).NotEmpty().NotNull();\n }\n }\n}\n"
},
{
"path": "samples/src/Liquid.Sample.Domain/Handlers/SampleGet/SampleResponse.cs",
"content": "using Liquid.Sample.Domain.Entities;\nusing System.Collections.Generic;\n\nnamespace Liquid.Sample.Domain.Handlers\n{\n public class SampleResponse\n {\n public SampleEntity Response { get; set; }\n\n\n public SampleResponse(SampleEntity response)\n {\n Response = response;\n }\n }\n}\n"
},
{
"path": "samples/src/Liquid.Sample.Domain/Handlers/SamplePost/SampleEventCommandHandler.cs",
"content": "using Liquid.Core.Implementations;\nusing Liquid.Core.Interfaces;\nusing Liquid.Messaging;\nusing Liquid.Messaging.Interfaces;\nusing Liquid.Repository;\nusing Liquid.Sample.Domain.Entities;\nusing MediatR;\nusing System;\nusing System.Linq;\nusing System.Threading;\nusing System.Threading.Tasks;\n\nnamespace Liquid.Sample.Domain.Handlers\n{\n public class SampleEventCommandHandler : IRequestHandler\n {\n private ILiquidProducer _producer;\n private readonly ILiquidRepository _repository;\n private readonly ILiquidContext _context;\n\n public SampleEventCommandHandler(ILiquidProducer producer, ILiquidContext context, ILiquidRepository repository)\n {\n _producer = producer;\n _context = context;\n _repository = repository;\n }\n\n public async Task Handle(SampleEventRequest request, CancellationToken cancellationToken)\n {\n await _repository.AddAsync(new SampleEntity()\n {\n Id = Guid.Parse(request.Entity.Id),\n MyProperty = request.Entity.MyProperty\n });\n\n await _producer.SendMessageAsync(request.Entity, _context.current);\n }\n }\n}\n"
},
{
"path": "samples/src/Liquid.Sample.Domain/Handlers/SamplePost/SampleEventRequest.cs",
"content": "using Liquid.Sample.Domain.Entities;\nusing MediatR;\n\nnamespace Liquid.Sample.Domain.Handlers\n{\n public class SampleEventRequest : IRequest\n {\n public SampleMessageEntity Entity { get; set; }\n\n public SampleEventRequest(SampleMessageEntity entity)\n {\n Entity = entity;\n }\n }\n}\n"
},
{
"path": "samples/src/Liquid.Sample.Domain/Handlers/SamplePost/SampleEventRequestValidator.cs",
"content": "using FluentValidation;\nusing System;\nusing System.Collections.Generic;\nusing System.Linq;\nusing System.Text;\nusing System.Threading.Tasks;\n\nnamespace Liquid.Sample.Domain.Handlers\n{\n public class SampleEventRequestValidator : AbstractValidator\n {\n public SampleEventRequestValidator()\n {\n RuleFor(request => request.Entity.Id).NotEmpty().NotNull();\n }\n }\n}\n"
},
{
"path": "samples/src/Liquid.Sample.Domain/Handlers/SamplePut/PutCommandHandler.cs",
"content": "using Liquid.Repository;\nusing Liquid.Sample.Domain.Entities;\nusing MediatR;\nusing System;\nusing System.Threading;\nusing System.Threading.Tasks;\n\nnamespace Liquid.Sample.Domain.Handlers.SamplePut\n{\n public class PutCommandHandler : IRequestHandler\n {\n private readonly ILiquidRepository _repository;\n\n public PutCommandHandler(ILiquidRepository repository)\n {\n _repository = repository;\n }\n\n public async Task Handle(PutCommandRequest request, CancellationToken cancellationToken)\n {\n await _repository.UpdateAsync(new SampleEntity()\n {\n Id = Guid.Parse(request.Message.Id),\n MyProperty = request.Message.MyProperty\n });\n }\n }\n}\n"
},
{
"path": "samples/src/Liquid.Sample.Domain/Handlers/SamplePut/PutCommandRequest.cs",
"content": "using Liquid.Sample.Domain.Entities;\nusing MediatR;\n\nnamespace Liquid.Sample.Domain.Handlers.SamplePut\n{\n public class PutCommandRequest : IRequest\n {\n public SampleMessageEntity Message { get; set; }\n\n public PutCommandRequest(SampleMessageEntity message)\n {\n Message = message;\n }\n }\n}\n"
},
{
"path": "samples/src/Liquid.Sample.Domain/Handlers/SamplePut/PutCommandRequestValidator.cs",
"content": "using FluentValidation;\n\nnamespace Liquid.Sample.Domain.Handlers.SamplePut\n{\n public class PutCommandRequestValidator : AbstractValidator\n {\n public PutCommandRequestValidator()\n {\n RuleFor(request => request.Message.Id).NotEmpty().NotNull();\n }\n }\n}\n"
},
{
"path": "samples/src/Liquid.Sample.Domain/Liquid.Sample.Domain.csproj",
"content": "\n\n \n net6.0\n \n\n \n \n \n \n \n \n\n\n"
},
{
"path": "samples/src/Liquid.Sample.MessagingConsumer/Liquid.Sample.MessagingConsumer.csproj",
"content": "\n\n \n net6.0\n dotnet-Liquid.Sample.MessagingConsumer-5B39CB3F-CC5C-4EBB-AB99-178E83416FC9\n \n\n \n \n \n\n \n \n \n\n"
},
{
"path": "samples/src/Liquid.Sample.MessagingConsumer/Program.cs",
"content": "using Liquid.Core.Extensions.DependencyInjection;\nusing Liquid.Messaging.ServiceBus.Extensions.DependencyInjection;\nusing Liquid.Repository.Mongo.Extensions;\nusing Liquid.Sample.Domain.Entities;\nusing Liquid.Sample.Domain.Handlers.SamplePut;\nusing Microsoft.Extensions.Hosting;\nusing System;\n\nnamespace Liquid.Sample.MessagingConsumer\n{\n public class Program\n {\n public static void Main(string[] args)\n {\n CreateHostBuilder(args).Build().Run();\n }\n\n public static IHostBuilder CreateHostBuilder(string[] args) =>\n Host.CreateDefaultBuilder(args)\n .ConfigureServices((hostContext, services) =>\n {\n services.AddLiquidConfiguration();\n services.AddLiquidMongoRepository(\"Liquid:MyMongoDbSettings:Entities\");\n services.AddLiquidServiceBusProducer(\"ServiceBus\", \"liquidoutput\", false);\n services.AddLiquidServiceBusConsumer (\"ServiceBus\", \"liquidinput\", false, typeof(PutCommandRequest).Assembly);\n });\n }\n}\n"
},
{
"path": "samples/src/Liquid.Sample.MessagingConsumer/Worker.cs",
"content": "using Liquid.Messaging;\nusing Liquid.Messaging.Interfaces;\nusing Liquid.Sample.Domain.Entities;\nusing Liquid.Sample.Domain.Handlers.SamplePut;\nusing MediatR;\nusing Microsoft.Extensions.Logging;\nusing System.Threading;\nusing System.Threading.Tasks;\n\nnamespace Liquid.Sample.MessagingConsumer\n{\n public class Worker : ILiquidWorker\n {\n private readonly ILogger _logger;\n private readonly IMediator _mediator;\n\n public Worker(ILogger logger, IMediator mediator)\n {\n _logger = logger;\n _mediator = mediator;\n }\n\n public async Task ProcessMessageAsync(ConsumerMessageEventArgs args, CancellationToken cancellationToken)\n {\n await _mediator.Send(new PutCommandRequest(args.Data));\n }\n }\n}\n"
},
{
"path": "samples/src/Liquid.Sample.MessagingConsumer/appsettings.Development.json",
"content": "{\n \"Logging\": {\n \"LogLevel\": {\n \"Default\": \"Information\",\n \"Microsoft\": \"Warning\",\n \"Microsoft.Hosting.Lifetime\": \"Information\"\n }\n }\n}\n"
},
{
"path": "samples/src/Liquid.Sample.MessagingConsumer/appsettings.json",
"content": "{\n \"Logging\": {\n \"LogLevel\": {\n \"Default\": \"Information\",\n \"Microsoft\": \"Warning\",\n \"Microsoft.Hosting.Lifetime\": \"Information\"\n }\n },\n \"Liquid\": {\n \"culture\": {\n \"defaultCulture\": \"pt-BR\"\n },\n \"ScopedContext\": {\n \"keys\": [\n {\n \"keyName\": \"Connection\",\n \"required\": false\n }\n ]\n },\n \"ScopedLogging\": {\n \"keys\": [\n {\n \"keyName\": \"Connection\",\n \"required\": false\n }\n ]\n },\n \"MyMongoDbSettings\": {\n \"DefaultDatabaseSettings\": {\n \"connectionString\": \"\",\n \"databaseName\": \"MySampleDb\"\n },\n \"Entities\": {\n \"SampleEntity\": {\n \"CollectionName\": \"SampleCollection\",\n \"ShardKey\": \"id\"\n }\n }\n }\n },\n \"ServiceBus\": {\n \"Settings\": [\n {\n \"ConnectionString\": \"\",\n \"EntityPath\": \"liquidoutput\"\n },\n {\n \"ConnectionString\": \"\",\n \"EntityPath\": \"liquidinput\"\n }\n ]\n }\n}\n"
},
{
"path": "src/Liquid.Cache.Memory/Extensions/DependencyInjection/IServiceCollectionExtension.cs",
"content": "using Liquid.Core.Extensions.DependencyInjection;\nusing Liquid.Core.Implementations;\nusing Microsoft.Extensions.Caching.Distributed;\nusing Microsoft.Extensions.Caching.Memory;\nusing Microsoft.Extensions.DependencyInjection;\nusing System;\n\nnamespace Liquid.Cache.Memory.Extensions.DependencyInjection\n{\n /// \n /// LiquidCache using Redis extensions class.\n /// \n public static class IServiceCollectionExtension\n {\n /// \n /// Registers service and decorator,\n /// with its .\n /// \n /// \n /// An System.Action`1 to configure the provided \n /// .\n /// Indicates if this method must register a \n public static IServiceCollection AddLiquidMemoryDistributedCache(this IServiceCollection services,\n Action setupAction, bool withTelemetry = true)\n {\n services.AddDistributedMemoryCache(setupAction);\n\n return services.AddLiquidDistributedCache(withTelemetry);\n }\n }\n}\n"
},
{
"path": "src/Liquid.Cache.Memory/Liquid.Cache.Memory.csproj",
"content": "\n\n \n net8.0\n\t Liquid.Cache.Memory\n\tenable\n\t MIT\n\t Avanade Brazil\n\t Avanade Inc.\n\t Liquid Application Framework\n\t Avanade 2019\n\t https://github.com/Avanade/Liquid-Application-Framework\n\t logo.png\n\t 8.0.0\n\t true\n\t true\n\t Full\n\t \n\t\t Distributed cache extension of Microsoft.Extensions.Caching.Memory.\n\t\t This component is part of Liquid Application Framework.\n\t \n \n\n \n \n \n True\n \n \n\n \n \n \n \n\n\n"
},
{
"path": "src/Liquid.Cache.NCache/Extensions/DependencyInjection/IServiceCollectionExtension.cs",
"content": "using Alachisoft.NCache.Caching.Distributed;\nusing Alachisoft.NCache.Caching.Distributed.Configuration;\nusing Liquid.Core.Extensions.DependencyInjection;\nusing Liquid.Core.Implementations;\nusing Microsoft.Extensions.DependencyInjection;\nusing System;\n\nnamespace Liquid.Cache.NCache.Extensions.DependencyInjection\n{\n /// \n /// LiquidCache using NCache extensions class.\n /// \n public static class IServiceCollectionExtension\n {\n /// \n /// Registers service and decorator,\n /// with its .\n /// \n /// \n /// An System.Action`1 to configure the provided\n /// .\n /// Indicates if this method must register a \n public static IServiceCollection AddLiquidNCacheDistributedCache(this IServiceCollection services,\n Action setupAction, bool withTelemetry = true)\n {\n services.AddNCacheDistributedCache(setupAction);\n\n return services.AddLiquidDistributedCache(withTelemetry);\n }\n }\n}\n"
},
{
"path": "src/Liquid.Cache.NCache/Liquid.Cache.NCache.csproj",
"content": "\n\n \n net8.0\n\t Liquid.Cache.NCache\n\t\tenable\n\t MIT\n\t Avanade Brazil\n\t Avanade Inc.\n\t Liquid Application Framework\n\t Avanade 2019\n\t https://github.com/Avanade/Liquid-Application-Framework\n\t logo.png\n\t 8.0.0\n\t true\n\t true\n\t Full\n\t \n\t\t Distributed cache extension of NCache.Microsoft.Extensions.Caching.\n\t\t This component is part of Liquid Application Framework.\n\t \n \n\n \n \n \n True\n \n \n\n \n \n \n \n \n \n \n Always\n \n \n Always\n \n \n Always\n \n \n\n\n"
},
{
"path": "src/Liquid.Cache.NCache/client.ncconf",
"content": "\n \n \n \n \n \n \n"
},
{
"path": "src/Liquid.Cache.NCache/config.ncconf",
"content": "\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n\n"
},
{
"path": "src/Liquid.Cache.NCache/tls.ncconf",
"content": "\n\tcertificate-name\n\tyour-thumbprint\n\tcertificate-name\n\tyour-thumbprint\n\tfalse\n\tfalse\n\tfalse\n\ttls12\n"
},
{
"path": "src/Liquid.Cache.Redis/Extensions/DependencyInjection/IServiceCollectionExtension.cs",
"content": "using Liquid.Core.Extensions.DependencyInjection;\nusing Liquid.Core.Implementations;\nusing Microsoft.Extensions.Caching.StackExchangeRedis;\nusing Microsoft.Extensions.DependencyInjection;\nusing System;\n\nnamespace Liquid.Cache.Redis.Extensions.DependencyInjection\n{\n /// \n /// LiquidCache using Redis extensions class.\n /// \n public static class IServiceCollectionExtension\n {\n /// \n /// Registers service and decorator,\n /// with its .\n /// \n /// \n /// An System.Action`1 to configure the provided\n /// Microsoft.Extensions.Caching.StackExchangeRedis.RedisCacheOptions.\n /// Indicates if this method must register a \n public static IServiceCollection AddLiquidRedisDistributedCache(this IServiceCollection services,\n Action setupAction, bool withTelemetry = true)\n {\n services.AddStackExchangeRedisCache(setupAction);\n\n return services.AddLiquidDistributedCache(withTelemetry);\n }\n }\n}\n"
},
{
"path": "src/Liquid.Cache.Redis/Liquid.Cache.Redis.csproj",
"content": "\n\n \n net8.0\n enable\n\t MIT\n\t Avanade Brazil\n\t Avanade Inc.\n\t Liquid Application Framework\n\t Avanade 2019\n\t https://github.com/Avanade/Liquid-Application-Framework\n\t logo.png\n\t 8.0.0\n\t true\n\t true\n\t Full\n\t \n\t\t Distributed cache extension of Microsoft.Extensions.Caching.StackExchangeRedis.\n\t\t This component is part of Liquid Application Framework.\n\t \n \n\n \n \n \n True\n \n \n\n \n \n \n \n \n\n\n"
},
{
"path": "src/Liquid.Cache.SqlServer/Extensions/DependencyInjection/IServiceCollectionExtension.cs",
"content": "using Liquid.Core.Extensions.DependencyInjection;\nusing Liquid.Core.Implementations;\nusing Microsoft.Extensions.Caching.SqlServer;\nusing Microsoft.Extensions.DependencyInjection;\nusing System;\n\nnamespace Liquid.Cache.SqlServer.Extensions.DependencyInjection\n{\n /// \n /// LiquidCache using SqlServer extensions class.\n /// \n public static class IServiceCollectionExtension\n {\n /// \n /// Registers service and decorator,\n /// with its .\n /// \n /// \n /// An System.Action`1 to configure the provided\n ///.\n /// Indicates if this method must register a \n public static IServiceCollection AddLiquidSqlServerDistributedCache(this IServiceCollection services,\n Action setupAction, bool withTelemetry = true)\n {\n services.AddDistributedSqlServerCache(setupAction);\n\n return services.AddLiquidDistributedCache(withTelemetry);\n }\n }\n}\n"
},
{
"path": "src/Liquid.Cache.SqlServer/Liquid.Cache.SqlServer.csproj",
"content": "\n\n \n net8.0\n Liquid.Cache.SqlServer\n\t enable\n\t MIT\n\t Avanade Brazil\n\t Avanade Inc.\n\t Liquid Application Framework\n\t Avanade 2019\n\t https://github.com/Avanade/Liquid-Application-Framework\n\t logo.png\n\t 8.0.0\n\t true\n\t true\n\t Full\n\t \n\t\t Distributed cache extension of Microsoft.Extensions.Caching.SqlServer.\n\t\t This component is part of Liquid Application Framework.\n\t \n \n\n \n \n \n True\n \n \n\n \n \n \n \n \n \n \n\n\n"
},
{
"path": "src/Liquid.Core/AbstractMappers/LiquidMapper.cs",
"content": "using Liquid.Core.Exceptions;\nusing Liquid.Core.Interfaces;\nusing System;\nusing System.Diagnostics.CodeAnalysis;\nusing System.Threading.Tasks;\n\nnamespace Liquid.Core.AbstractMappers\n{\n ///\n [ExcludeFromCodeCoverage]\n public abstract class LiquidMapper : ILiquidMapper\n {\n private readonly string _mapperName;\n\n /// \n /// Create a new instance of \n /// \n /// Mapper implementation name.\n protected LiquidMapper(string mapperName)\n {\n _mapperName = mapperName;\n }\n ///\n public async Task Map(TFrom dataObject, string entityName = null)\n {\n if (dataObject is null)\n {\n throw new ArgumentNullException(nameof(dataObject));\n }\n\n try\n {\n return await MapImpl(dataObject, entityName);\n }\n catch (Exception e)\n {\n var msg = $\"{_mapperName} throw data mapping error: '{e.Message}'\";\n\n throw new DataMappingException(msg, e);\n }\n }\n /// \n /// \n /// \n /// \n /// \n /// \n protected abstract Task MapImpl(TFrom dataObject, string entityName = null);\n }\n}\n"
},
{
"path": "src/Liquid.Core/AbstractMappers/OcrResultMapper.cs",
"content": "using Liquid.Core.Entities;\nusing Liquid.Core.Exceptions;\nusing Liquid.Core.Interfaces;\nusing System;\nusing System.Diagnostics.CodeAnalysis;\nusing System.Threading.Tasks;\n\nnamespace Liquid.Core.AbstractMappers\n{\n /// \n /// Defines object that map data between two instance types.\n /// \n /// type of data source object.\n [ExcludeFromCodeCoverage]\n public abstract class OcrResultMapper : ILiquidMapper\n {\n private readonly string _mapperName;\n\n /// \n /// Create a new instance of \n /// \n /// Mapper implementation name.\n public OcrResultMapper(string mapperName)\n {\n _mapperName = mapperName;\n }\n ///\n public async Task Map(TFrom dataObject, string entityName = null)\n {\n if (dataObject is null)\n {\n throw new ArgumentNullException(nameof(dataObject));\n }\n\n try\n {\n return await MapImpl(dataObject);\n }\n catch (Exception e)\n {\n var msg = $\"{_mapperName} throw data mapping error: '{e.Message}'\";\n\n throw new DataMappingException(msg, e);\n }\n }\n /// \n /// Create a new instance of \n /// with values obtained from . \n /// \n /// data source object instance.\n protected abstract Task MapImpl(TFrom dataObject);\n }\n}\n"
},
{
"path": "src/Liquid.Core/Attributes/LiquidSectionNameAttribute.cs",
"content": "using System;\n\nnamespace Liquid.Core.Attributes\n{\n /// \n /// Defines which configuration section, the custom configuration will read from json file.\n /// \n /// \n [AttributeUsage(AttributeTargets.Class)]\n public class LiquidSectionNameAttribute : Attribute\n {\n /// \n /// Gets the name of the section.\n /// \n /// \n /// The name of the section.\n /// \n public string SectionName { get; }\n\n /// \n /// Initializes a new instance of the class.\n /// \n /// Name of the section.\n public LiquidSectionNameAttribute(string sectionName)\n {\n SectionName = sectionName;\n }\n }\n}"
},
{
"path": "src/Liquid.Core/Base/Enumeration.cs",
"content": "using Liquid.Core.Exceptions;\nusing System;\nusing System.Collections.Generic;\nusing System.Diagnostics.CodeAnalysis;\nusing System.Linq;\nusing System.Reflection;\n\nnamespace Liquid.Core.Base\n{\n /// \n /// Enumeration Base Class.\n /// \n /// \n [ExcludeFromCodeCoverage]\n public abstract class Enumeration : IComparable\n {\n /// \n /// Initializes a new instance of the class.\n /// \n /// The value.\n /// The display name.\n protected Enumeration(int value, string displayName)\n {\n Value = value;\n DisplayName = displayName;\n }\n\n /// \n /// Gets the value.\n /// \n /// \n /// The value.\n /// \n public int Value { get; }\n\n /// \n /// Gets the display name.\n /// \n /// \n /// The display name.\n /// \n public string DisplayName { get; }\n\n /// \n /// Converts to string.\n /// \n /// \n /// A that represents this instance.\n /// \n public override string ToString()\n {\n return DisplayName;\n }\n\n /// \n /// Gets all.\n /// \n /// \n /// \n public static IEnumerable GetAll() where T : Enumeration, new()\n {\n var type = typeof(T);\n var fields = type.GetFields(BindingFlags.Public | BindingFlags.Static | BindingFlags.DeclaredOnly);\n\n foreach (var info in fields)\n {\n var instance = new T();\n\n if (info.GetValue(instance) is T locatedValue)\n {\n yield return locatedValue;\n }\n }\n }\n\n /// \n /// Determines whether the specified , is equal to this instance.\n /// \n /// The to compare with this instance.\n /// \n /// true if the specified is equal to this instance; otherwise, false.\n /// \n public override bool Equals(object obj)\n {\n var otherValue = obj as Enumeration;\n\n if (otherValue == null)\n {\n return false;\n }\n\n var typeMatches = GetType() == obj.GetType();\n var valueMatches = Value.Equals(otherValue.Value);\n\n return typeMatches && valueMatches;\n }\n\n /// \n /// Returns a hash code for this instance.\n /// \n /// \n /// A hash code for this instance, suitable for use in hashing algorithms and data structures like a hash table. \n /// \n public override int GetHashCode()\n {\n return Value.GetHashCode();\n }\n\n /// \n /// Absolutes the difference.\n /// \n /// The first value.\n /// The second value.\n /// \n public static int AbsoluteDifference(Enumeration firstValue, Enumeration secondValue)\n {\n var absoluteDifference = Math.Abs(firstValue.Value - secondValue.Value);\n return absoluteDifference;\n }\n\n /// \n /// Gets the enumeration from id value.\n /// \n /// \n /// The value.\n /// \n public static T FromValue(int value) where T : Enumeration, new()\n {\n var matchingItem = Parse(value, \"value\", item => item.Value == value);\n return matchingItem;\n }\n\n /// \n /// Gets the enumeration from display name.\n /// \n /// \n /// The display name.\n /// \n public static T FromDisplayName(string displayName) where T : Enumeration, new()\n {\n var matchingItem = Parse(displayName, \"display name\", item => item.DisplayName == displayName);\n return matchingItem;\n }\n\n /// \n /// Parses the specified value.\n /// \n /// \n /// \n /// The value.\n /// The description.\n /// The predicate.\n /// \n /// \n private static TEnumerable Parse(TValue value, string description, Func predicate) where TEnumerable : Enumeration, new()\n {\n var matchingItem = GetAll().FirstOrDefault(predicate);\n\n if (matchingItem != null) return matchingItem;\n var message = $\"'{value}' is not a valid {description} in {typeof(TEnumerable)}\";\n throw new LiquidException(message);\n }\n\n /// \n /// Compares to.\n /// \n /// The other object to be compared.\n /// \n public int CompareTo(object obj)\n {\n return Value.CompareTo(((Enumeration)obj).Value);\n }\n }\n}"
},
{
"path": "src/Liquid.Core/Base/LiquidInterceptorBase.cs",
"content": "using Castle.DynamicProxy;\nusing System;\nusing System.Threading.Tasks;\n\nnamespace Liquid.Core.Base\n{\n /// \n /// Base class to implement interceptors with actions after, before and on exception.\n /// \n public abstract class LiquidInterceptorBase : AsyncInterceptorBase\n {\n /// \n /// Initialize an instace of \n /// \n protected LiquidInterceptorBase()\n {\n }\n\n /// \n /// Traces start, stop and exception of the intercepted method.\n /// \n /// The method invocation.\n /// The Castle.DynamicProxy.IInvocationProceedInfo.\n /// The function to proceed the proceedInfo.\n protected override async Task InterceptAsync(IInvocation invocation, IInvocationProceedInfo proceedInfo, Func proceed)\n {\n try\n {\n await BeforeInvocation(invocation, proceedInfo);\n await proceed(invocation, proceedInfo).ConfigureAwait(false);\n }\n catch (Exception ex)\n {\n await OnExceptionInvocation(invocation, proceedInfo, ex);\n throw;\n }\n finally\n {\n await AfterInvocation(invocation, proceedInfo, default(object));\n }\n }\n\n /// \n /// Traces start, stop and exception of the intercepted method.\n /// \n /// The method invocation.\n /// The Castle.DynamicProxy.IInvocationProceedInfo.\n /// The function to proceed the proceedInfo.\n protected sealed override async Task InterceptAsync(IInvocation invocation, IInvocationProceedInfo proceedInfo, Func> proceed)\n {\n TResult result = default;\n try\n {\n await BeforeInvocation(invocation, proceedInfo);\n return await proceed(invocation, proceedInfo).ConfigureAwait(false);\n }\n catch (Exception ex)\n {\n await OnExceptionInvocation(invocation, proceedInfo, ex);\n throw;\n }\n finally\n {\n await AfterInvocation(invocation, proceedInfo, result).ConfigureAwait(false);\n }\n }\n\n /// \n /// Override in derived classes to intercept method invocations.\n /// \n /// The type of result object.\n /// The method invocation.\n /// The Castle.DynamicProxy.IInvocationProceedInfo.\n /// Result object.\n /// \n protected abstract Task AfterInvocation(IInvocation invocation, IInvocationProceedInfo proceedInfo, TResult result);\n\n /// \n /// Override in derived classes to intercept method invocations.\n /// \n /// The method invocation.\n /// The Castle.DynamicProxy.IInvocationProceedInfo.\n /// \n protected abstract Task BeforeInvocation(IInvocation invocation, IInvocationProceedInfo proceedInfo);\n\n /// \n /// Override in derived classes to intercept method invocations.\n /// \n /// The method invocation.\n /// The Castle.DynamicProxy.IInvocationProceedInfo.\n /// THe exception object.\n /// \n protected abstract Task OnExceptionInvocation(IInvocation invocation, IInvocationProceedInfo proceedInfo, Exception exception);\n }\n}\n"
},
{
"path": "src/Liquid.Core/Decorators/LiquidContextDecorator.cs",
"content": "using Liquid.Core.Entities;\nusing Liquid.Core.Exceptions;\nusing Liquid.Core.Interfaces;\nusing Liquid.Core.Settings;\nusing Microsoft.Extensions.Options;\nusing System;\nusing System.Globalization;\nusing System.Threading;\nusing System.Threading.Tasks;\n\nnamespace Liquid.Core.Decorators\n{\n /// \n /// Inserts configured context keys in LiquidContext service.\n /// Includes its behavior in worker service before process execution.\n /// \n public class LiquidContextDecorator : ILiquidWorker\n {\n private readonly ILiquidWorker _inner;\n private readonly ILiquidContext _context;\n private readonly IOptions _options;\n\n /// \n /// Initialize a new instance of \n /// \n /// Decorated service.\n /// Scoped Context service.\n /// Scoped context keys set.\n public LiquidContextDecorator(ILiquidWorker inner, ILiquidContext context, IOptions options)\n {\n _inner = inner ?? throw new ArgumentNullException(nameof(inner));\n _context = context ?? throw new ArgumentNullException(nameof(context));\n _options = options ?? throw new ArgumentNullException(nameof(options));\n }\n\n ///\n public async Task ProcessMessageAsync(ConsumerMessageEventArgs args, CancellationToken cancellationToken)\n {\n object value = default;\n\n foreach (var key in _options.Value.Keys)\n {\n args.Headers?.TryGetValue(key.KeyName, out value);\n\n if (value is null && key.Required)\n throw new MessagingMissingContextKeysException(key.KeyName);\n\n _context.Upsert(key.KeyName, value);\n }\n\n if (_options.Value.Culture)\n {\n _context.Upsert(\"culture\", CultureInfo.CurrentCulture.Name);\n }\n\n await _inner.ProcessMessageAsync(args, cancellationToken);\n }\n }\n}\n"
},
{
"path": "src/Liquid.Core/Decorators/LiquidCultureDecorator.cs",
"content": "using Liquid.Core.Entities;\nusing Liquid.Core.Interfaces;\nusing Liquid.Core.Settings;\nusing Microsoft.Extensions.Options;\nusing System;\nusing System.Globalization;\nusing System.Threading;\nusing System.Threading.Tasks;\n\nnamespace Liquid.Core.Decorators\n{\n /// \n /// Configures the culture in the current thread.\n /// Includes its behavior in worker service before process execution.\n /// \n public class LiquidCultureDecorator : ILiquidWorker\n {\n private const string _culture = \"culture\";\n private readonly IOptions _options;\n private readonly ILiquidWorker _inner;\n\n /// \n /// Initialize a new instance of \n /// \n /// Decorated service.\n /// Default culture configuration.\n public LiquidCultureDecorator(ILiquidWorker inner, IOptions options)\n {\n _inner = inner ?? throw new ArgumentNullException(nameof(inner));\n _options = options ?? throw new ArgumentNullException(nameof(options));\n }\n\n ///\n public async Task ProcessMessageAsync(ConsumerMessageEventArgs args, CancellationToken cancellationToken)\n {\n object cultureCode = default;\n\n args.Headers?.TryGetValue(_culture, out cultureCode);\n\n if (cultureCode is null && !string.IsNullOrEmpty(_options.Value.DefaultCulture))\n {\n cultureCode = _options.Value.DefaultCulture;\n }\n\n if (cultureCode != null)\n {\n CultureInfo.DefaultThreadCurrentCulture = new CultureInfo(cultureCode.ToString());\n CultureInfo.DefaultThreadCurrentUICulture = new CultureInfo(cultureCode.ToString());\n }\n\n await _inner.ProcessMessageAsync(args, cancellationToken);\n }\n }\n}\n"
},
{
"path": "src/Liquid.Core/Decorators/LiquidScopedLoggingDecorator.cs",
"content": "using Liquid.Core.Entities;\nusing Liquid.Core.Exceptions;\nusing Liquid.Core.Interfaces;\nusing Liquid.Core.Settings;\nusing Microsoft.Extensions.Logging;\nusing Microsoft.Extensions.Options;\nusing System;\nusing System.Collections.Generic;\nusing System.Threading;\nusing System.Threading.Tasks;\n\nnamespace Liquid.Core.Decorators\n{\n /// \n /// Inserts configured context keys in ILogger service scope.\n /// Includes its behavior in worker service before process execution.\n /// \n public class LiquidScopedLoggingDecorator : ILiquidWorker\n {\n private readonly ILogger> _logger;\n private readonly IOptions _options;\n private readonly ILiquidWorker _inner;\n\n /// \n /// Initialize a new instance of \n /// \n /// Decorated service.\n /// Default culture configuration.\n /// Logger service instance.\n public LiquidScopedLoggingDecorator(ILiquidWorker inner\n , IOptions options\n , ILogger> logger)\n {\n _inner = inner ?? throw new ArgumentNullException(nameof(inner));\n _options = options ?? throw new ArgumentNullException(nameof(options));\n _logger = logger ?? throw new ArgumentNullException(nameof(logger));\n }\n\n ///\n public async Task ProcessMessageAsync(ConsumerMessageEventArgs args, CancellationToken cancellationToken)\n {\n var scope = new List>();\n\n object value = default;\n\n foreach (var key in _options.Value.Keys)\n {\n args.Headers?.TryGetValue(key.KeyName, out value);\n\n if (value is null && key.Required)\n throw new MessagingMissingScopedKeysException(key.KeyName);\n\n scope.Add(new KeyValuePair(key.KeyName, value));\n }\n\n using (_logger.BeginScope(scope.ToArray()))\n {\n await _inner.ProcessMessageAsync(args, cancellationToken);\n }\n }\n }\n}\n"
},
{
"path": "src/Liquid.Core/Entities/ChatCompletionResult.cs",
"content": "namespace Liquid.Core.Entities\n{\n /// \n /// Chat completions result set.\n /// \n public class ChatCompletionResult\n {\n /// \n /// The content of the response message.\n /// \n public string Content { get; set; }\n\n /// \n /// The reason the model stopped generating tokens, together with any applicable details.\n /// \n public string FinishReason { get; set; }\n\n /// \n /// The total number of tokens processed for the completions request and response.\n /// \n public int Usage { get; set; }\n\n /// \n /// The number of tokens used by the prompt.\n /// \n public int PromptUsage { get; set; }\n\n /// \n /// The number of tokens used by the completion.\n /// \n public int CompletionUsage { get; set; }\n }\n}\n"
},
{
"path": "src/Liquid.Core/Entities/ClientDictionary.cs",
"content": "using System.Diagnostics.CodeAnalysis;\n\nnamespace Liquid.Core.Entities\n{\n /// \n /// Client dictionary to store client instances.\n /// \n /// Type of client service.\n [ExcludeFromCodeCoverage]\n public class ClientDictionary\n {\n /// \n /// Number of executions for this client.\n /// \n public int Executions { get; set; } = 1;\n\n\n /// \n /// Client connection alias.\n /// \n public string ClientId { get; set; }\n\n /// \n /// Client instance.\n /// \n public T Client { get; set; }\n\n /// \n /// Initialize a new instance of .\n /// \n /// Client connection alias.\n /// Client instance.\n public ClientDictionary(string clientId, T client)\n {\n ClientId = clientId;\n Client = client;\n }\n }\n}\n"
},
{
"path": "src/Liquid.Core/Entities/ConsumerErrorEventArgs.cs",
"content": "using System;\n\nnamespace Liquid.Core.Entities\n{\n /// \n /// Arguments for processing errors occurred during process execution.\n /// \n public class ConsumerErrorEventArgs\n {\n /// \n /// Represents errors that occur during process execution.\n /// \n public Exception Exception { get; set; }\n }\n}"
},
{
"path": "src/Liquid.Core/Entities/ConsumerMessageEventArgs.cs",
"content": "using System.Collections.Generic;\n\nnamespace Liquid.Core.Entities\n{\n /// \n /// \n /// \n /// \n public class ConsumerMessageEventArgs\n {\n /// \n /// \n /// \n public TEvent Data { get; set; }\n\n /// \n /// \n /// \n public IDictionary Headers { get; set; }\n }\n}"
},
{
"path": "src/Liquid.Core/Entities/FunctionBody.cs",
"content": "using System;\nusing System.Diagnostics.CodeAnalysis;\nusing System.Text.Json;\n\nnamespace Liquid.Core.Entities\n{\n /// \n /// The body of a function to be called.\n /// \n [ExcludeFromCodeCoverage]\n public class FunctionBody\n {\n\n /// The name of the function to be called. \n public string Name { get; set; }\n /// \n /// A description of what the function does. The model will use this description when selecting the function and\n /// interpreting its parameters.\n /// \n public string Description { get; set; }\n /// \n /// The parameters the function accepts, described as a JSON Schema object.\n /// \n /// To assign an object to this property use .\n /// \n /// \n /// To assign an already formatted json string to this property use .\n /// \n /// \n public BinaryData Parameters { get; set; }\n\n /// Initializes a new instance of . \n /// The name of the function to be called. \n /// \n /// A description of what the function does. The model will use this description when selecting the function and\n /// interpreting its parameters.\n /// \n /// The parameters the function accepts, described as a JSON Schema object. \n /// \n /// \n public FunctionBody(string name, string description, BinaryData parameters)\n {\n if (string.IsNullOrEmpty(name))\n {\n throw new ArgumentException($\"'{nameof(name)}' cannot be null or empty.\", nameof(name));\n }\n\n if (string.IsNullOrEmpty(description))\n {\n throw new ArgumentException($\"'{nameof(description)}' cannot be null or empty.\", nameof(description));\n }\n\n Name = name;\n Description = description;\n Parameters = parameters ?? throw new ArgumentNullException(nameof(parameters));\n\n }\n\n /// \n /// Initializes a new instance of .\n /// \n /// function definition JSON string. \n public FunctionBody(string functionBody)\n {\n var function = JsonSerializer.Deserialize(functionBody);\n\n Name = function.GetProperty(\"name\").ToString();\n Description = function.GetProperty(\"description\").ToString();\n Parameters = BinaryData.FromObjectAsJson(function.GetProperty(\"parameters\"));\n }\n }\n}\n"
},
{
"path": "src/Liquid.Core/Entities/LiquidBlob.cs",
"content": "using System.Collections.Generic;\nusing System.Diagnostics.CodeAnalysis;\n\nnamespace Liquid.Core.Entities\n{\n /// \n /// Set de propriedades referentes à um item do BlobStorage.\n /// \n [ExcludeFromCodeCoverage]\n public class LiquidBlob\n {\n /// \n /// Lista de tags referentes ao blob.\n /// \n public IDictionary Tags { get; set; } = new Dictionary();\n\n /// \n /// Conteúdo do blob.\n /// \n public byte[] Blob { get; set; }\n\n /// \n /// Nome do arquivo no Storage.\n /// \n public string Name { get; set; }\n\n /// \n /// Caminho do blob.\n /// \n public string AbsoluteUri { get; set; }\n\n }\n}\n"
},
{
"path": "src/Liquid.Core/Entities/LiquidEntity.cs",
"content": "using System.Diagnostics.CodeAnalysis;\n\nnamespace Liquid.Core.Entities\n{\n /// \n /// Represents the repository entity\n /// \n /// The type of the identifier.\n [ExcludeFromCodeCoverage]\n public class LiquidEntity\n {\n /// \n /// Gets or sets the identifier.\n /// \n /// \n /// The identifier.\n /// \n public virtual TIdentifier Id { get; set; }\n }\n}\n"
},
{
"path": "src/Liquid.Core/Entities/OcrResult.cs",
"content": "using System.Collections.Generic;\nusing System.Diagnostics.CodeAnalysis;\nusing System.Drawing;\n\nnamespace Liquid.Core.Entities\n{\n /// \n /// Optical Character Recognition result set.\n /// \n [ExcludeFromCodeCoverage]\n public class OcrResult\n {\n /// \n /// Recognition result content.\n /// \n public string Content { get; set; }\n\n /// \n ///Analyzed pages.\n /// \n public List Pages { get; set; }\n }\n /// \n /// Analyzed page content.\n /// \n [ExcludeFromCodeCoverage]\n public class PageInfo\n {\n /// \n /// recognition result page index.\n /// \n public int PageNumber { get; set; }\n\n /// \n /// The unit used by the words and lines data polygon properties.\n /// \n public string PolygonUnit { get; set; }\n\n /// \n /// Extracted words from the page.\n /// \n public List Words { get; set; } = new List();\n\n /// \n /// Extracted lines from the page.\n /// \n public List Lines { get; set; } = new List();\n }\n /// \n /// A word object consisting of a contiguous sequence of characters.\n /// \n [ExcludeFromCodeCoverage]\n public class WordData\n {\n /// \n /// Text content of the word.\n /// \n public string Content { get; set; }\n /// \n /// Confidence of correctly extracting the word.\n /// \n public float Confidence { get; set; }\n\n /// \n /// The polygon that outlines the content of this word. Coordinates are specified relative to the\n /// top-left of the page, and points are ordered clockwise from the left relative to the word\n /// orientation.\n /// \n public List Polygon { get; set; } = new List();\n }\n\n /// \n /// A content line object consisting of an adjacent sequence of content elements\n /// \n [ExcludeFromCodeCoverage]\n public class LineData\n {\n /// \n /// Concatenated content of the contained elements in reading order.\n /// \n public string Content { get; set; }\n\n /// \n /// The polygon that outlines the content of this line. Coordinates are specified relative to the\n /// top-left of the page, and points are ordered clockwise from the left relative to the line\n /// orientation.\n /// \n public List Polygon { get; set; } = new List();\n\n }\n}\n"
},
{
"path": "src/Liquid.Core/Exceptions/DataMappingException.cs",
"content": "using System;\nusing System.Diagnostics.CodeAnalysis;\n\nnamespace Liquid.Core.Exceptions\n{\n /// \n /// Occurs when an exception is raised during data mapping.\n /// \n [ExcludeFromCodeCoverage]\n public class DataMappingException : Exception\n {\n /// \n /// Initializes a new instance of the class.\n /// \n public DataMappingException()\n {\n }\n\n /// \n /// Initializes a new instance of the class with a specified error message.\n /// \n /// \n public DataMappingException(string message) : base(message)\n {\n }\n\n /// \n /// Initializes a new instance of the class with a specified error message and a reference to the inner exception that is the cause of this exception.\n /// \n /// \n /// \n public DataMappingException(string message, Exception innerException) : base(message, innerException)\n {\n }\n }\n}"
},
{
"path": "src/Liquid.Core/Exceptions/DatabaseContextException.cs",
"content": "using System;\nusing System.Diagnostics.CodeAnalysis;\nusing System.Runtime.Serialization;\n\nnamespace Liquid.Core.Exceptions\n{\n /// \n /// Occurs when a Repository database throw an error.\n /// \n [ExcludeFromCodeCoverage]\n [Serializable]\n public class DatabaseContextException : LiquidException\n {\n ///\n public DatabaseContextException(string message) : base(message)\n {\n }\n\n /// \n /// Initializes a new instance of the class.\n /// \n /// Error message custom text.\n /// Exception throwed by the client.\n public DatabaseContextException(string message, Exception innerException)\n : base(message, innerException)\n {\n }\n }\n}\n"
},
{
"path": "src/Liquid.Core/Exceptions/ExceptionCustomCodes.cs",
"content": "using Liquid.Core.Base;\nusing System.Diagnostics.CodeAnalysis;\n\nnamespace Liquid.Core.Exceptions\n{\n /// \n /// Contains Exceptions Custom Codes to be processed and converted to custom error codes.\n /// \n /// \n [ExcludeFromCodeCoverage]\n public class ExceptionCustomCodes : Enumeration\n {\n /// \n /// Indicates that the item is not found.\n /// \n public static readonly ExceptionCustomCodes NotFound = new ExceptionCustomCodes(404, \"NotFound\");\n\n /// \n /// Indicates that an internal error has occurred.\n /// \n public static readonly ExceptionCustomCodes InternalError = new ExceptionCustomCodes(500, \"InternalError\");\n\n /// \n /// Indicates that the request is bad formatted a validation error has occurred.\n /// \n public static readonly ExceptionCustomCodes BadRequest = new ExceptionCustomCodes(400, \"BadRequest\");\n\n /// \n /// Indicates a conflict.\n /// \n public static readonly ExceptionCustomCodes Conflict = new ExceptionCustomCodes(409, \"Conflict\");\n\n /// \n /// Indicates the resource is not accessible.\n /// \n public static readonly ExceptionCustomCodes Forbidden = new ExceptionCustomCodes(403, \"Forbidden\");\n\n /// \n /// Indicates a timeout error.\n /// \n public static readonly ExceptionCustomCodes Timeout = new ExceptionCustomCodes(408, \"Timeout\");\n\n /// \n /// Indicates the item is not authorized.\n /// \n public static readonly ExceptionCustomCodes Unauthorized = new ExceptionCustomCodes(401, \"Unauthorized\");\n\n /// \n /// Initializes a new instance of the class.\n /// \n /// The value.\n /// The display name.\n public ExceptionCustomCodes(int value, string displayName) : base(value, displayName)\n {\n }\n }\n}\n"
},
{
"path": "src/Liquid.Core/Exceptions/LiquidCustomException.cs",
"content": "using System;\nusing System.Diagnostics.CodeAnalysis;\nusing System.Runtime.Serialization;\n\nnamespace Liquid.Core.Exceptions\n{\n /// \n /// Class responsible for custom exception codes handling.\n /// \n /// \n [Serializable]\n [ExcludeFromCodeCoverage]\n public class LiquidCustomException : LiquidException\n {\n /// \n /// Gets the response code.\n /// \n /// \n /// The response code.\n /// \n public ExceptionCustomCodes ResponseCode { get; }\n\n /// \n /// Initializes a new instance of the class.\n /// \n /// The message.\n /// The response code.\n public LiquidCustomException(string message, ExceptionCustomCodes responseCode) : base(message)\n {\n ResponseCode = responseCode;\n }\n\n /// \n /// Initializes a new instance of the class.\n /// \n /// The message.\n /// The response code.\n /// The inner exception.\n public LiquidCustomException(string message, ExceptionCustomCodes responseCode, Exception innerException) : base(message, innerException)\n {\n ResponseCode = responseCode;\n }\n }\n}"
},
{
"path": "src/Liquid.Core/Exceptions/LiquidDatabaseSettingsDoesNotExistException.cs",
"content": "using System;\nusing System.Diagnostics.CodeAnalysis;\nusing System.Runtime.Serialization;\n\nnamespace Liquid.Core.Exceptions\n{\n /// \n /// Occurs when the database connection string is not found in appsettings file. Check the connection id and the configuration file.\n /// \n /// \n [ExcludeFromCodeCoverage]\n [Serializable]\n public class LiquidDatabaseSettingsDoesNotExistException : LiquidException\n {\n /// \n /// Initializes a new instance of the class.\n /// \n /// The connection identifier.\n public LiquidDatabaseSettingsDoesNotExistException(string databaseName)\n : base($\"The connection string for database '{databaseName}' does not exist.\")\n {\n }\n ///\n public LiquidDatabaseSettingsDoesNotExistException(string message, Exception innerException) : base(message, innerException)\n {\n }\n }\n}\n"
},
{
"path": "src/Liquid.Core/Exceptions/LiquidException.cs",
"content": "using System;\nusing System.Diagnostics.CodeAnalysis;\nusing System.Runtime.Serialization;\n\nnamespace Liquid.Core.Exceptions\n{\n /// \n /// Liquid Base Custom Exception Class. Derived from class.\n /// \n /// \n [Serializable]\n [ExcludeFromCodeCoverage]\n public class LiquidException : Exception\n {\n /// \n /// Initializes a new instance of the class.\n /// \n public LiquidException()\n {\n }\n\n /// \n /// Initializes a new instance of the class with a specified error message.\n /// \n /// The message that describes the error.\n public LiquidException(string message) : base(message)\n {\n }\n\n /// \n /// Initializes a new instance of the class with a specified error message and a reference to the inner exception that is the cause of this exception.\n /// \n /// The error message that explains the reason for the exception.\n /// The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified.\n public LiquidException(string message, Exception innerException) : base(message, innerException)\n {\n }\n\n /// \n /// Returns a that represents this instance.\n /// \n /// \n /// A that represents this instance.\n /// \n public override string ToString()\n {\n return $\"Liquid Exception -> {base.ToString()}\";\n }\n }\n}"
},
{
"path": "src/Liquid.Core/Exceptions/MessagingConsumerException.cs",
"content": "using System;\nusing System.Diagnostics.CodeAnalysis;\nusing System.Runtime.Serialization;\n\nnamespace Liquid.Core.Exceptions\n{\n /// \n /// Occurs when an exception is raised consuming a message.\n /// \n /// \n [Serializable]\n [ExcludeFromCodeCoverage]\n public class MessagingConsumerException : LiquidException\n {\n /// \n /// Initializes a new instance of the class.\n /// \n /// The inner exception.\n public MessagingConsumerException(Exception innerException) : base(\"An error has occurred consuming message. See inner exception for more detail.\", innerException)\n {\n }\n }\n}"
},
{
"path": "src/Liquid.Core/Exceptions/MessagingMissingConfigurationException.cs",
"content": "using System;\nusing System.Diagnostics.CodeAnalysis;\nusing System.Runtime.Serialization;\n\nnamespace Liquid.Core.Exceptions\n{\n /// \n /// Occurs when a Configuration in settings configuration does not exist.\n /// \n /// \n [Serializable]\n [ExcludeFromCodeCoverage]\n public class MessagingMissingConfigurationException : LiquidException\n {\n ///\n public MessagingMissingConfigurationException(Exception innerException, string settingsName)\n : base($\"The messaging configuration section {settingsName} is missing. See inner exception for more detail.\", innerException)\n {\n }\n\n ///\n public MessagingMissingConfigurationException(string message) : base(message)\n {\n }\n\n }\n}"
},
{
"path": "src/Liquid.Core/Exceptions/MessagingMissingContextKeysException.cs",
"content": "using System;\nusing System.Diagnostics.CodeAnalysis;\nusing System.Runtime.Serialization;\n\nnamespace Liquid.Core.Exceptions\n{\n ///\n [ExcludeFromCodeCoverage]\n [Serializable]\n public class MessagingMissingContextKeysException : LiquidException\n {\n ///\n public MessagingMissingContextKeysException()\n {\n }\n\n ///\n public MessagingMissingContextKeysException(string contextKey) : base($\"The value of required context key '{contextKey}' was not found in request.\")\n {\n }\n\n ///\n public MessagingMissingContextKeysException(string message, Exception innerException) : base(message, innerException)\n {\n }\n\n }\n}\n"
},
{
"path": "src/Liquid.Core/Exceptions/MessagingMissingScopedKeysException.cs",
"content": "using System;\nusing System.Diagnostics.CodeAnalysis;\nusing System.Runtime.Serialization;\n\nnamespace Liquid.Core.Exceptions\n{\n ///\n [ExcludeFromCodeCoverage]\n [Serializable]\n public class MessagingMissingScopedKeysException : LiquidException\n {\n ///\n public MessagingMissingScopedKeysException()\n {\n }\n\n ///\n public MessagingMissingScopedKeysException(string contextKey) : base($\"The value of required logging scoped key '{contextKey}' was not found in request.\")\n {\n }\n\n ///\n public MessagingMissingScopedKeysException(string message, Exception innerException) : base(message, innerException)\n {\n }\n }\n}\n"
},
{
"path": "src/Liquid.Core/Exceptions/MessagingMissingSettingsException.cs",
"content": "using System;\nusing System.Diagnostics.CodeAnalysis;\nusing System.Runtime.Serialization;\n\nnamespace Liquid.Core.Exceptions\n{\n /// \n /// Occurs when a Configuration in settings configuration does not exist.\n /// \n /// \n [Serializable]\n [ExcludeFromCodeCoverage]\n public class MessagingMissingSettingsException : LiquidException\n {\n /// \n /// Initializes a new instance of \n /// \n /// Configuration set name.\n public MessagingMissingSettingsException(string settingsName) : base($\"The messaging configuration settings name {settingsName} does not exist. Please check your configuration file.\")\n {\n }\n\n ///\n public MessagingMissingSettingsException(string message, Exception innerException) : base(message, innerException)\n {\n }\n }\n}\n"
},
{
"path": "src/Liquid.Core/Exceptions/MessagingProducerException.cs",
"content": "using System;\nusing System.Diagnostics.CodeAnalysis;\nusing System.Runtime.Serialization;\n\nnamespace Liquid.Core.Exceptions\n{\n /// \n /// Occurs when an exception occurs sending a message.\n /// \n /// \n [Serializable]\n [ExcludeFromCodeCoverage]\n public class MessagingProducerException : LiquidException\n {\n /// \n /// Initializes a new instance of the class.\n /// \n /// The inner exception.\n public MessagingProducerException(Exception innerException) : base(\"An error has occurred when sending message. See inner exception for more detail.\", innerException)\n {\n }\n\n }\n}"
},
{
"path": "src/Liquid.Core/Exceptions/SerializerFailException.cs",
"content": "using System;\nusing System.Diagnostics.CodeAnalysis;\nusing System.Runtime.Serialization;\n\nnamespace Liquid.Core.Exceptions\n{\n /// \n /// Occurs when the serialization fail.\n /// \n /// \n [Serializable]\n [ExcludeFromCodeCoverage]\n public class SerializerFailException : LiquidException\n {\n ///\n public SerializerFailException(string message) : base(message)\n {\n }\n\n ///\n public SerializerFailException(string nameOfContent, Exception innerException) : base($\"An error occurred whilst serializing of content {nameOfContent} : \", innerException)\n {\n }\n\n }\n}\n"
},
{
"path": "src/Liquid.Core/Exceptions/UnitOfWorkTransactionNotStartedException.cs",
"content": "using System;\nusing System.Diagnostics.CodeAnalysis;\nusing System.Runtime.Serialization;\n\nnamespace Liquid.Core.Exceptions\n{\n /// \n /// Occurs when the transaction is not started.\n /// \n /// \n [ExcludeFromCodeCoverage]\n [Serializable]\n public class UnitOfWorkTransactionNotStartedException : LiquidException\n {\n /// \n /// Initializes a new instance of the class.\n /// \n public UnitOfWorkTransactionNotStartedException() :\n base(\"The transaction has been not started. Please start the transaction\")\n {\n }\n\n ///\n public UnitOfWorkTransactionNotStartedException(string message) : base(message)\n {\n }\n\n ///\n public UnitOfWorkTransactionNotStartedException(string message, Exception innerException) : base(message, innerException)\n {\n }\n\n }\n}\n"
},
{
"path": "src/Liquid.Core/Exceptions/UnitOfWorkTransactionWithoutRepositoryException.cs",
"content": "using System;\nusing System.Diagnostics.CodeAnalysis;\nusing System.Runtime.Serialization;\n\nnamespace Liquid.Core.Exceptions\n{\n /// \n /// Occurs when the transaction is called before a repository method is called.\n /// \n /// \n [Serializable]\n [ExcludeFromCodeCoverage]\n public class UnitofWorkTransactionWithoutRepositoryException : LiquidException\n {\n /// \n /// Initializes a new instance of the class.\n /// \n public UnitofWorkTransactionWithoutRepositoryException() :\n base(\"You need to get a repository first to start an transaction. Use 'GetRepository' method.\")\n {\n }\n\n ///\n public UnitofWorkTransactionWithoutRepositoryException(string message) : base(message)\n {\n }\n\n ///\n public UnitofWorkTransactionWithoutRepositoryException(string message, Exception innerException) : base(message, innerException)\n {\n }\n }\n}\n"
},
{
"path": "src/Liquid.Core/Extensions/ByteExtension.cs",
"content": "using System;\nusing System.Diagnostics.CodeAnalysis;\nusing System.Text;\nusing System.Text.Json;\n\nnamespace Liquid.Core.Extensions\n{\n /// \n /// Byte Extensions Class.\n /// \n [ExcludeFromCodeCoverage]\n public static class ByteExtension\n {\n /// \n /// Gets the size of the kb.\n /// \n /// The bytes.\n /// \n public static double GetKbSize(this byte[] bytes)\n {\n if (bytes == null || bytes.Length == 0) return 0;\n return bytes.Length / 1024d;\n }\n\n /// \n /// Gets the size of the mb.\n /// \n /// The bytes.\n /// \n public static double GetMbSize(this byte[] bytes)\n {\n if (bytes == null || bytes.Length == 0) return 0;\n return bytes.Length / Math.Pow(1024, 2);\n }\n\n /// \n /// Gets the size of the gb.\n /// \n /// The bytes.\n /// \n public static double GetGbSize(this byte[] bytes)\n {\n if (bytes == null || bytes.Length == 0) return 0;\n return bytes.Length / Math.Pow(1024, 3);\n }\n\n /// \n /// Parses byte array json to a specific object type.\n /// \n /// type of object to be parsed.\n /// \n /// Provides options to be used with System.Text.Json.JsonSerializer.\n public static T ParseJson(this byte[] json, JsonSerializerOptions options = null)\n {\n if (json == null || json.Length == 0) return default;\n\n var result = JsonSerializer.Deserialize(Encoding.Default.GetString(json), options);\n return result;\n }\n }\n}"
},
{
"path": "src/Liquid.Core/Extensions/CommonExtensions.cs",
"content": "using System.Collections.Generic;\nusing System.Linq;\nnamespace Liquid.Core.Extensions\n{\n /// \n /// Util Extensions Class\n /// \n public static class CommonExtensions\n {\n /// \n /// The Gzip content type\n /// \n public const string GZipContentType = \"application/gzip\";\n\n /// \n /// The content type header\n /// \n public const string ContentTypeHeader = \"ContentType\";\n\n /// \n /// Adds the range from the elements dictionary to the source dictionary. If the element from elements dictionary alreads exists in source, it will be discarded.\n /// \n /// The source dictionary.\n /// The elements to be added to source.\n public static void AddRange(this IDictionary source, IDictionary elements)\n {\n if (elements == null || !elements.Any()) return;\n\n foreach (var element in elements)\n {\n if (!source.ContainsKey(element.Key)) source.Add(element);\n }\n }\n }\n}"
},
{
"path": "src/Liquid.Core/Extensions/DateTimeExtension.cs",
"content": "using System;\nusing System.Diagnostics.CodeAnalysis;\nusing System.Globalization;\n\nnamespace Liquid.Core.Extensions\n{\n /// \n /// Date time extensions class.\n /// \n [ExcludeFromCodeCoverage]\n public static class DateTimeExtension\n {\n /// \n /// Converts datetime to Iso 8601 format.\n /// \n /// The date.\n /// \n public static string ToIso8601(this DateTime date)\n {\n return date.ToString(\"o\", DateTimeFormatInfo.InvariantInfo);\n }\n\n /// \n /// Converts datetime to SQL invariant format.\n /// \n /// The date.\n /// \n public static string ToSql(this DateTime date)\n {\n return date.ToString(\"yyyy-MM-dd HH:mm:ss\", DateTimeFormatInfo.InvariantInfo);\n }\n\n /// \n /// To the Oracle SQL date.\n /// \n /// The date time.\n /// \n public static string ToOracleSql(this DateTime dateTime)\n {\n return $\"to_date('{dateTime:dd.MM.yyyy HH:mm:ss}','dd.mm.yyyy hh24.mi.ss')\";\n }\n\n /// \n /// Converts datetime to Unix format.\n /// \n /// The date.\n /// \n public static long ToUnix(this DateTime date)\n {\n var timeSpan = date - new DateTime(1970, 1, 1, 0, 0, 0);\n return (long)timeSpan.TotalSeconds;\n }\n\n /// \n /// Gets date time from unix format.\n /// \n /// The unix.\n /// \n public static DateTime FromUnix(this long unix)\n {\n var epoch = new DateTime(1970, 1, 1, 0, 0, 0, 0, DateTimeKind.Utc);\n return epoch.AddSeconds(unix);\n }\n\n /// \n /// Gets the age from the birth date.\n /// \n /// The birth date.\n /// \n public static int GetAge(this DateTime birthDate)\n {\n var today = DateTime.Today;\n var result = today.Year - birthDate.Year;\n\n if (today.DayOfYear < birthDate.DayOfYear)\n {\n result--;\n }\n\n return result;\n }\n\n /// \n /// Converts the datetime to a specific time zone.\n /// \n /// The date time.\n /// The time zone identifier.\n /// \n public static DateTime ToTimeZone(this DateTime dateTime, string timeZoneId)\n {\n var universalDateTime = dateTime.ToUniversalTime();\n var timeZone = TimeZoneInfo.FindSystemTimeZoneById(timeZoneId);\n var convertedDateTime = TimeZoneInfo.ConvertTimeFromUtc(universalDateTime, timeZone);\n return convertedDateTime;\n }\n\n /// \n /// Determines whether this date is weekend.\n /// \n /// The date.\n /// \n /// true if the specified d is weekend; otherwise, false.\n /// \n public static bool IsWeekend(this DateTime date)\n {\n return !date.IsWeekday();\n }\n\n /// \n /// Determines whether this instance is weekday.\n /// \n /// The date.\n /// \n /// true if the specified date is weekday; otherwise, false.\n /// \n public static bool IsWeekday(this DateTime date)\n {\n switch (date.DayOfWeek)\n {\n case DayOfWeek.Sunday:\n case DayOfWeek.Saturday:\n return false;\n default:\n return true;\n }\n }\n\n /// \n /// Adds the workdays.\n /// \n /// The date.\n /// The days.\n /// \n public static DateTime AddWorkdays(this DateTime date, int days)\n {\n while (date.IsWeekend()) date = date.AddDays(1.0);\n for (var i = 0; i < days; ++i)\n {\n date = date.AddDays(1.0);\n while (date.IsWeekend()) date = date.AddDays(1.0);\n }\n return date;\n }\n\n /// \n /// Gets the last day of month.\n /// \n /// The date time.\n /// \n public static DateTime GetLastDayOfMonth(this DateTime date)\n {\n return new DateTime(date.Year, date.Month, 1).AddMonths(1).AddDays(-1);\n }\n\n /// \n /// Gets the first day of month.\n /// \n /// The date.\n /// \n public static DateTime GetFirstDayOfMonth(this DateTime date)\n {\n return new DateTime(date.Year, date.Month, 1);\n }\n\n /// \n /// Get the elapsed time from date time now since the input DateTime\n /// \n /// Input DateTime\n /// Returns a TimeSpan value with the elapsed time since the input DateTime\n /// \n /// TimeSpan elapsed = dtStart.Elapsed();\n /// \n public static TimeSpan Elapsed(this DateTime date)\n {\n return DateTime.Now.Subtract(date);\n }\n }\n}"
},
{
"path": "src/Liquid.Core/Extensions/DependencyInjection/IServiceCollectionAutoMapperExtensions.cs",
"content": "using AutoMapper;\nusing Microsoft.Extensions.DependencyInjection;\nusing System;\nusing System.Collections.Generic;\nusing System.Diagnostics.CodeAnalysis;\nusing System.Linq;\nusing System.Reflection;\n\nnamespace Liquid.Core.Extensions.DependencyInjection\n{\n /// \n /// Extensions to scan for AutoMapper classes and register the configuration, mapping, and extensions with the service collection:\n /// \n /// - Finds classes and initializes a new ,
\n /// - Scans for , , and implementations and registers them as ,
\n /// - Registers as , and
\n /// - Registers as a configurable (default is )
\n ///
\n /// After calling LiquidAddAutoMapper you can resolve an instance from a scoped service provider, or as a dependency\n /// To use \n /// \n /// QueryableExtensions.Extensions.ProjectTo{TDestination}(IQueryable,IConfigurationProvider,\n /// System.Linq.Expressions.Expression{System.Func{TDestination, object}}[])\n /// \n /// \n /// you can resolve the instance directly for from an instance.\n /// \n [ExcludeFromCodeCoverage]\n public static class IServiceCollectionAutoMapperExtensions\n {\n /// \n /// Adds the automatic mapper.\n /// \n /// The services.\n /// The assemblies.\n /// \n public static IServiceCollection LiquidAddAutoMapper(this IServiceCollection services, params Assembly[] assemblies)\n => AddAutoMapperClasses(services, null, assemblies);\n\n /// \n /// Adds the automatic mapper.\n /// \n /// The services.\n /// The configuration action.\n /// The assemblies.\n /// \n public static IServiceCollection LiquidAddAutoMapper(this IServiceCollection services, Action configAction, params Assembly[] assemblies)\n => AddAutoMapperClasses(services, (sp, cfg) => configAction?.Invoke(cfg), assemblies);\n\n /// \n /// Adds the automatic mapper.\n /// \n /// The services.\n /// The configuration action.\n /// The assemblies.\n /// \n public static IServiceCollection AddAutoMapper(this IServiceCollection services, Action configAction, params Assembly[] assemblies)\n => AddAutoMapperClasses(services, configAction, assemblies);\n\n /// \n /// Adds the automatic mapper.\n /// \n /// The services.\n /// The configuration action.\n /// The assemblies.\n /// The service lifetime.\n /// \n public static IServiceCollection AddAutoMapper(this IServiceCollection services, Action configAction, IEnumerable assemblies, ServiceLifetime serviceLifetime = ServiceLifetime.Transient)\n => AddAutoMapperClasses(services, (sp, cfg) => configAction?.Invoke(cfg), assemblies, serviceLifetime);\n\n /// \n /// Adds the automatic mapper.\n /// \n /// The services.\n /// The configuration action.\n /// The assemblies.\n /// The service lifetime.\n /// \n public static IServiceCollection AddAutoMapper(this IServiceCollection services, Action configAction, IEnumerable assemblies, ServiceLifetime serviceLifetime = ServiceLifetime.Transient)\n => AddAutoMapperClasses(services, configAction, assemblies, serviceLifetime);\n\n /// \n /// Adds the automatic mapper.\n /// \n /// The services.\n /// The assemblies.\n /// The service lifetime.\n /// \n public static IServiceCollection AddAutoMapper(this IServiceCollection services, IEnumerable assemblies, ServiceLifetime serviceLifetime = ServiceLifetime.Transient)\n => AddAutoMapperClasses(services, null, assemblies, serviceLifetime);\n\n /// \n /// Adds the automatic mapper.\n /// \n /// The services.\n /// The profile assembly marker types.\n /// \n public static IServiceCollection AddAutoMapper(this IServiceCollection services, params Type[] profileAssemblyMarkerTypes)\n => AddAutoMapperClasses(services, null, profileAssemblyMarkerTypes.Select(t => t.GetTypeInfo().Assembly));\n\n /// \n /// Adds the automatic mapper.\n /// \n /// The services.\n /// The configuration action.\n /// The profile assembly marker types.\n /// \n public static IServiceCollection AddAutoMapper(this IServiceCollection services, Action configAction, params Type[] profileAssemblyMarkerTypes)\n => AddAutoMapperClasses(services, (sp, cfg) => configAction?.Invoke(cfg), profileAssemblyMarkerTypes.Select(t => t.GetTypeInfo().Assembly));\n\n /// \n /// Adds the automatic mapper.\n /// \n /// The services.\n /// The configuration action.\n /// The profile assembly marker types.\n /// \n public static IServiceCollection AddAutoMapper(this IServiceCollection services, Action configAction, params Type[] profileAssemblyMarkerTypes)\n => AddAutoMapperClasses(services, configAction, profileAssemblyMarkerTypes.Select(t => t.GetTypeInfo().Assembly));\n\n /// \n /// Adds the automatic mapper.\n /// \n /// The services.\n /// The configuration action.\n /// The profile assembly marker types.\n /// The service lifetime.\n /// \n public static IServiceCollection AddAutoMapper(this IServiceCollection services, Action configAction,\n IEnumerable profileAssemblyMarkerTypes, ServiceLifetime serviceLifetime = ServiceLifetime.Transient)\n => AddAutoMapperClasses(services, (sp, cfg) => configAction?.Invoke(cfg), profileAssemblyMarkerTypes.Select(t => t.GetTypeInfo().Assembly), serviceLifetime);\n\n /// \n /// Adds the automatic mapper.\n /// \n /// The services.\n /// The configuration action.\n /// The profile assembly marker types.\n /// The service lifetime.\n /// \n public static IServiceCollection AddAutoMapper(this IServiceCollection services, Action configAction,\n IEnumerable profileAssemblyMarkerTypes, ServiceLifetime serviceLifetime = ServiceLifetime.Transient)\n => AddAutoMapperClasses(services, configAction, profileAssemblyMarkerTypes.Select(t => t.GetTypeInfo().Assembly), serviceLifetime);\n\n /// \n /// Adds the automatic mapper classes.\n /// \n /// The services.\n /// The configuration action.\n /// The assemblies to scan.\n /// The service lifetime.\n /// \n private static IServiceCollection AddAutoMapperClasses(IServiceCollection services, Action configAction,\n IEnumerable assembliesToScan, ServiceLifetime serviceLifetime = ServiceLifetime.Transient)\n {\n // Just return if we've already added AutoMapper to avoid double-registration\n if (services.Any(sd => sd.ServiceType == typeof(IMapper)))\n return services;\n\n assembliesToScan = assembliesToScan as Assembly[] ?? assembliesToScan.ToArray();\n\n var toScan = (Assembly[])assembliesToScan;\n var allTypes = toScan\n .Where(a => !a.IsDynamic && a.GetName().Name != nameof(AutoMapper))\n .Distinct() // avoid AutoMapper.DuplicateTypeMapConfigurationException\n .SelectMany(a => a.DefinedTypes)\n .ToArray();\n\n void ConfigAction(IServiceProvider serviceProvider, IMapperConfigurationExpression cfg)\n {\n configAction?.Invoke(serviceProvider, cfg);\n\n cfg.AddMaps(toScan);\n }\n\n var openTypes = new[]\n {\n typeof(IValueResolver<,,>),\n typeof(IMemberValueResolver<,,,>),\n typeof(ITypeConverter<,>),\n typeof(IValueConverter<,>),\n typeof(IMappingAction<,>)\n };\n foreach (var type in openTypes.SelectMany(openType => allTypes\n .Where(t => t.IsClass\n && !t.IsAbstract\n && t.AsType().ImplementGenericInterface(openType))))\n {\n services.AddTransientAssemblies(type.AsType());\n }\n\n services.AddSingleton(sp => new MapperConfiguration(cfg => ConfigAction(sp, cfg)));\n services.Add(new ServiceDescriptor(typeof(IMapper),\n sp => new Mapper(sp.GetRequiredService(), sp.GetService), serviceLifetime));\n\n return services;\n }\n\n }\n}\n"
},
{
"path": "src/Liquid.Core/Extensions/DependencyInjection/IServiceCollectionCoreExtensions.cs",
"content": "using Liquid.Core.Implementations;\nusing Liquid.Core.Interfaces;\nusing Liquid.Core.PipelineBehaviors;\nusing MediatR;\nusing Microsoft.Extensions.DependencyInjection;\nusing System.Reflection;\nusing FluentValidation;\nusing Microsoft.Extensions.DependencyInjection.Extensions;\nusing System.Linq;\nusing System;\nusing Liquid.Core.Decorators;\n\nnamespace Liquid.Core.Extensions.DependencyInjection\n{\n /// \n /// LiquidCache extensions class.\n /// \n public static class IServiceCollectionCoreExtensions\n {\n /// \n /// Registers a service and its \n /// depending on the value of .\n /// \n /// Extended IServiceCollection.\n /// indicates if this method must register a \n /// \n public static IServiceCollection AddLiquidDistributedCache(this IServiceCollection services, bool withTelemetry)\n {\n if (withTelemetry)\n {\n services.AddScoped();\n services.AddScopedLiquidTelemetry();\n }\n else\n services.AddScoped();\n\n return services;\n }\n\n /// \n /// Injects mediator handler, validator and Liquid native telemetry for handlers.\n /// \n /// Extended service collection.\n /// Indicates if method should inject Liquid Telemetry Behavior.\n /// Indicates if method should inject Validators.\n /// List of assemblies that contains handlers and validators implemantations to be injected.\n public static void AddLiquidHandlers(this IServiceCollection services, bool withTelemetry, bool withValidators, params Assembly[] assemblies)\n {\n if (withValidators)\n {\n services.AddTransient(typeof(IPipelineBehavior<,>), typeof(LiquidValidationBehavior<,>));\n services.AddValidatorsFromAssemblies(assemblies);\n }\n\n if (withTelemetry)\n services.AddTransient(typeof(IPipelineBehavior<,>), typeof(LiquidTelemetryBehavior<,>));\n\n services.AddMediatR(cfg => cfg.RegisterServicesFromAssemblies(assemblies));\n }\n\n /// \n /// Register Liquid Worker Service \n /// with messaging pipeline ,\n /// and domain handlers \n /// that exists in , with telemetry and validators.\n /// \n /// Extended service collection instance.\n /// Array of assemblies that contains domain handlers implementation.\n /// \n public static IServiceCollection AddLiquidMessageConsumer(this IServiceCollection services, params Assembly[] assemblies)\n where TWorker : class, ILiquidWorker\n {\n services.AddLiquidWorkerService();\n services.AddLiquidPipeline();\n services.AddLiquidDomain(assemblies);\n return services;\n }\n /// \n /// Register implementation service \n /// and .\n /// \n /// implementation type.\n /// Type of entity that will be consumed by this service.\n /// Extended service collection instance.\n public static IServiceCollection AddLiquidWorkerService(this IServiceCollection services)\n where TWorker : class, ILiquidWorker\n {\n services.AddScoped, TWorker>();\n\n services.AddHostedService>();\n\n return services;\n }\n\n /// \n /// Register domain handlers and\n /// its mappers \n /// that exists in , with telemetry and validators.\n /// \n /// Extended service collection instance.\n /// Array of assemblies that contains domain handlers implementation.\n public static IServiceCollection AddLiquidDomain(this IServiceCollection services, params Assembly[] assemblies)\n {\n services.LiquidAddAutoMapper(assemblies);\n services.AddLiquidHandlers(withTelemetry: true, withValidators: true, assemblies);\n\n return services;\n }\n\n /// \n /// Register and aditional behaviors\n /// , \n /// and . These additional behaviors will be \n /// performed in the reverse order they were registered.\n /// \n /// Extended service collection instance.\n public static IServiceCollection AddLiquidPipeline(this IServiceCollection services)\n {\n services.AddScoped();\n services.Decorate, LiquidContextDecorator>();\n services.Decorate, LiquidScopedLoggingDecorator>();\n services.Decorate, LiquidCultureDecorator>();\n\n return services;\n }\n /// \n /// Changes the previously registered service descriptor \n /// to the service.\n /// \n /// Interface type of service that should be decorated.\n /// Type of decorator service implementation.\n /// Extended service collection instance.\n public static IServiceCollection Decorate(this IServiceCollection services)\n where TInterface : class\n where TDecorator : class, TInterface\n {\n ServiceDescriptor innerDescriptor = services.FirstOrDefault(s => s.ServiceType == typeof(TInterface));\n\n if (innerDescriptor == null) { throw new InvalidOperationException($\"{typeof(TInterface).Name} is not registered\"); }\n\n var objectFactory = ActivatorUtilities.CreateFactory(\n typeof(TDecorator),\n new[] { typeof(TInterface) });\n\n services.Replace(ServiceDescriptor.Describe(\n typeof(TInterface),\n s => (TInterface)objectFactory(s, new[] { s.CreateInstance(innerDescriptor) }), innerDescriptor.Lifetime)\n );\n\n return services;\n }\n\n private static object CreateInstance(this IServiceProvider services, ServiceDescriptor descriptor)\n {\n if (descriptor.ImplementationInstance != null)\n return descriptor.ImplementationInstance;\n\n if (descriptor.ImplementationFactory != null)\n return descriptor.ImplementationFactory(services);\n\n return ActivatorUtilities.GetServiceOrCreateInstance(services, descriptor.ImplementationType);\n }\n\n }\n}"
},
{
"path": "src/Liquid.Core/Extensions/DependencyInjection/IServiceCollectionLiquidExtension.cs",
"content": "using Castle.DynamicProxy;\nusing Liquid.Core.Implementations;\nusing Liquid.Core.Interfaces;\nusing Microsoft.Extensions.DependencyInjection;\nusing Microsoft.Extensions.DependencyInjection.Extensions;\nusing System;\nusing System.Linq;\n\nnamespace Liquid.Core.Extensions.DependencyInjection\n{\n /// \n /// Extends interface.\n /// \n public static class IServiceCollectionLiquidExtension\n {\n \n /// \n /// Register telemetry interceptor for defined services. \n /// \n /// Interface type of service that should be intercepted.\n /// Type of service that should be intercepted.\n /// Extended IServiceCollection instance.\n [Obsolete(\"This method will be removed in the next release. \" +\n \"Please use AddScopedLiquidTelemetry, AddTransientLiquidTelemetry or AddSingletonLiquidTelemetry.\")]\n public static IServiceCollection AddLiquidTelemetryInterceptor(this IServiceCollection services)\n where TInterface : class where TService : TInterface\n {\n services.TryAddTransient(typeof(IAsyncInterceptor), typeof(LiquidTelemetryInterceptor));\n\n services.TryAddSingleton(new ProxyGenerator());\n\n return services.AddTransient((provider) =>\n {\n var proxyGenerator = provider.GetService();\n var service = (TInterface)provider.GetRequiredService();\n\n return proxyGenerator.CreateInterfaceProxyWithTarget(service, provider.GetServices().ToArray());\n });\n }\n\n /// \n /// Register telemetry interceptor for defined services. \n /// \n /// Interface type of service that should be intercepted.\n /// Type of service that should be intercepted.\n /// Extended IServiceCollection instance.\n public static IServiceCollection AddScopedLiquidTelemetry(this IServiceCollection services)\n where TInterface : class where TService : TInterface\n {\n services.AddInterceptor();\n\n return services.AddScoped((provider) =>\n {\n var proxyGenerator = provider.GetService();\n var service = (TInterface)provider.GetRequiredService();\n\n return proxyGenerator.CreateInterfaceProxyWithTarget(service, provider.GetServices().ToArray());\n });\n }\n\n /// \n /// Register telemetry interceptor for defined services. \n /// \n /// Interface type of service that should be intercepted.\n /// Type of service that should be intercepted.\n /// Extended IServiceCollection instance.\n public static IServiceCollection AddTransientLiquidTelemetry(this IServiceCollection services)\n where TInterface : class where TService : TInterface\n {\n services.AddInterceptor();\n\n return services.AddTransient((provider) =>\n {\n var proxyGenerator = provider.GetService();\n var service = (TInterface)provider.GetRequiredService();\n\n return proxyGenerator.CreateInterfaceProxyWithTarget(service, provider.GetServices().ToArray());\n });\n }\n\n /// \n /// Register telemetry interceptor for defined services. \n /// \n /// Interface type of service that should be intercepted.\n /// Type of service that should be intercepted.\n /// Extended IServiceCollection instance.\n public static IServiceCollection AddSingletonLiquidTelemetry(this IServiceCollection services)\n where TInterface : class where TService : TInterface\n {\n services.AddInterceptor();\n\n return services.AddSingleton((provider) =>\n {\n var proxyGenerator = provider.GetService();\n var service = (TInterface)provider.GetRequiredService();\n\n return proxyGenerator.CreateInterfaceProxyWithTarget(service, provider.GetServices().ToArray());\n });\n }\n\n /// \n /// Register a service instance\n /// with service type.\n /// \n /// Service implementation type.\n /// Extended IServiceCollection instance.\n public static IServiceCollection AddInterceptor(this IServiceCollection services)\n {\n services.TryAddTransient(typeof(IAsyncInterceptor), typeof(TInterceptor));\n\n services.TryAddSingleton(new ProxyGenerator());\n\n return services;\n }\n\n /// \n /// Register Liquid implementation of Serializer services and Serializer provider. \n /// , and \n /// \n /// Extended IServiceCollection instance.\n public static IServiceCollection AddLiquidSerializers(this IServiceCollection services)\n {\n services.AddTransient();\n services.AddTransient();\n services.AddTransient();\n\n return services;\n }\n }\n}\n"
},
{
"path": "src/Liquid.Core/Extensions/DependencyInjection/IServiceCollectionTypeExtensions.cs",
"content": "using Liquid.Core.Utils;\nusing Microsoft.Extensions.DependencyInjection;\nusing System;\nusing System.Collections.Generic;\nusing System.Diagnostics.CodeAnalysis;\nusing System.Linq;\nusing System.Reflection;\n\nnamespace Liquid.Core.Extensions.DependencyInjection\n{\n /// \n /// Service Collection Extensions Class.\n /// \n [ExcludeFromCodeCoverage]\n public static class IServiceCollectionTypeExtensions\n {\n /// \n /// Adds a scoped service of the type specified in with an\n /// implementation of the types specified inside to the\n /// specified .\n /// \n /// The to add the service to.\n /// The type of the service to register.\n /// The assemblies that contains all implementation types.\n /// \n public static IServiceCollection AddScopedAssemblies(this IServiceCollection services, Type serviceType, params Assembly[] assemblies)\n {\n var typesToRegister = TypeUtils.GetTypesToRegister(serviceType, assemblies);\n\n foreach (var typeToRegister in typesToRegister)\n {\n var interfaces = typeToRegister.GetInterfaces();\n var interfaceToRegister = interfaces.FirstOrDefault(t => t.GetGenericTypeDefinition() == serviceType);\n\n if (interfaceToRegister != null)\n {\n services.AddScoped(interfaceToRegister, typeToRegister);\n }\n }\n return services;\n }\n\n /// \n /// Adds a scoped service of the type specified in with an\n /// implementation of the types specified in to the\n /// specified .\n /// \n /// The to add the service to.\n /// The type of the service to register.\n /// The implementation types.\n /// \n public static IServiceCollection AddScopedAssemblies(this IServiceCollection services, Type serviceType, IEnumerable implementationTypes)\n {\n foreach (var typeToRegister in implementationTypes)\n {\n var interfaces = typeToRegister.GetInterfaces();\n var interfaceToRegister = interfaces.FirstOrDefault(t => t.GetGenericTypeDefinition() == serviceType);\n\n if (interfaceToRegister != null)\n {\n services.AddScoped(interfaceToRegister, typeToRegister);\n }\n }\n return services;\n }\n\n /// \n /// Adds a transient service of the type specified in with an\n /// implementation of the types specified inside to the\n /// specified .\n /// \n /// The to add the service to.\n /// The type of the service to register.\n /// The assemblies that contains all implementation types.\n /// \n public static IServiceCollection AddTransientAssemblies(this IServiceCollection services, Type serviceType, params Assembly[] assemblies)\n {\n var typesToRegister = TypeUtils.GetTypesToRegister(serviceType, assemblies);\n\n foreach (var typeToRegister in typesToRegister)\n {\n var interfaces = typeToRegister.GetInterfaces();\n var interfaceToRegister = interfaces.FirstOrDefault(t => t.GetGenericTypeDefinition() == serviceType);\n\n if (interfaceToRegister != null)\n {\n services.AddTransient(interfaceToRegister, typeToRegister);\n }\n }\n return services;\n }\n\n /// \n /// Adds a transient service of the type specified in with an\n /// implementation of the types specified in to the\n /// specified .\n /// \n /// The to add the service to.\n /// The type of the service to register.\n /// The implementation types.\n /// \n public static IServiceCollection AddTransientAssemblies(this IServiceCollection services, Type serviceType, IEnumerable implementationTypes)\n {\n foreach (var typeToRegister in implementationTypes)\n {\n var interfaces = typeToRegister.GetInterfaces();\n var interfaceToRegister = interfaces.FirstOrDefault(t => t.GetGenericTypeDefinition() == serviceType);\n\n if (interfaceToRegister != null)\n {\n services.AddTransient(interfaceToRegister, typeToRegister);\n }\n }\n return services;\n }\n\n /// \n /// Adds a singleton service of the type specified in with an\n /// implementation of the types specified inside to the\n /// specified .\n /// \n /// The to add the service to.\n /// The type of the service to register.\n /// The assemblies that contains all implementation types.\n /// \n public static IServiceCollection AddSingletonAssemblies(this IServiceCollection services, Type serviceType, params Assembly[] assemblies)\n {\n var typesToRegister = TypeUtils.GetTypesToRegister(serviceType, assemblies);\n\n foreach (var typeToRegister in typesToRegister)\n {\n var interfaces = typeToRegister.GetInterfaces();\n var interfaceToRegister = interfaces.FirstOrDefault(t => t.GetGenericTypeDefinition() == serviceType);\n\n if (interfaceToRegister != null)\n {\n services.AddSingleton(interfaceToRegister, typeToRegister);\n }\n }\n return services;\n }\n\n /// \n /// Adds a singleton service of the type specified in with an\n /// implementation of the types specified in to the\n /// specified .\n /// \n /// The to add the service to.\n /// The type of the service to register.\n /// The implementation types.\n /// \n public static IServiceCollection AddSingletonAssemblies(this IServiceCollection services, Type serviceType, IEnumerable implementationTypes)\n {\n foreach (var typeToRegister in implementationTypes)\n {\n var interfaces = typeToRegister.GetInterfaces();\n var interfaceToRegister = interfaces.FirstOrDefault(t => t.GetGenericTypeDefinition() == serviceType);\n\n if (interfaceToRegister != null)\n {\n services.AddSingleton(interfaceToRegister, typeToRegister);\n }\n }\n return services;\n }\n }\n}"
},
{
"path": "src/Liquid.Core/Extensions/DependencyInjection/IServiceProviderExtensions.cs",
"content": "using Microsoft.Extensions.DependencyInjection;\nusing System;\nusing System.Collections;\nusing System.Collections.Generic;\nusing System.Diagnostics.CodeAnalysis;\n\nnamespace Liquid.Core.Extensions.DependencyInjection\n{\n /// \n /// Service Provider Extensions Class.\n /// \n [ExcludeFromCodeCoverage]\n public static class IServiceProviderExtensions\n {\n /// \n /// Get all registered \n /// \n /// \n /// \n public static Dictionary GetAllServiceDescriptors(this IServiceProvider provider)\n {\n if (provider is ServiceProvider serviceProvider)\n {\n var result = new Dictionary();\n\n var engine = serviceProvider.GetFieldValue(\"_engine\");\n var callSiteFactory = engine.GetPropertyValue(\"CallSiteFactory\");\n var descriptorLookup = callSiteFactory.GetFieldValue(\"_descriptorLookup\");\n if (descriptorLookup is IDictionary dictionary)\n {\n foreach (DictionaryEntry entry in dictionary)\n {\n result.Add((Type)entry.Key, (ServiceDescriptor)entry.Value.GetPropertyValue(\"Last\"));\n }\n }\n\n return result;\n }\n\n throw new NotSupportedException($\"Type '{provider.GetType()}' is not supported!\");\n }\n }\n}\n"
},
{
"path": "src/Liquid.Core/Extensions/EnumExtension.cs",
"content": "using System;\nusing System.ComponentModel;\nusing System.Diagnostics.CodeAnalysis;\nusing System.Linq;\n\nnamespace Liquid.Core.Extensions\n{\n /// \n /// Enum Extensions Class.\n /// \n [ExcludeFromCodeCoverage]\n public static class EnumExtension\n {\n /// \n /// Gets the description from enum value.\n /// \n /// The value.\n /// The enum description.\n public static string GetDescription(this Enum value)\n {\n var attribute = value.GetType()\n .GetField(value.ToString())\n .GetCustomAttributes(typeof(DescriptionAttribute), false)\n .SingleOrDefault() as DescriptionAttribute;\n return attribute == null ? value.ToString() : attribute.Description;\n }\n\n /// \n /// Gets the enum attribute.\n /// \n /// \n /// The value.\n /// the enum attribute.\n public static T GetAttribute(this Enum value) where T : Attribute\n {\n var type = value.GetType();\n var name = Enum.GetName(type, value);\n\n return type.GetField(name)\n .GetCustomAttributes(false)\n .OfType()\n .SingleOrDefault();\n }\n }\n}\n"
},
{
"path": "src/Liquid.Core/Extensions/IEnumerableExtension.cs",
"content": "using Liquid.Core.Exceptions;\nusing System;\nusing System.Collections.Generic;\nusing System.Diagnostics.CodeAnalysis;\nusing System.Linq;\nusing System.Text;\n\nnamespace Liquid.Core.Extensions\n{\n /// \n /// Extensions for IEnumerable class.\n /// \n [ExcludeFromCodeCoverage]\n public static class IEnumerableExtension\n {\n /// \n /// Executes the action in each specified item in enumerable.\n /// \n /// Type of element inside enumerable.\n /// The enumerable.\n /// The action.\n public static void Each(this IEnumerable enumerable, Action action)\n {\n foreach (var item in enumerable)\n {\n action(item);\n }\n }\n\n /// \n /// Produces a comma separated values of string out of an IEnumerable. \n /// This would be useful if you want to automatically generate a CSV out of integer, string, or any other primitive data type collection or array. \n /// \n /// Type of element inside enumerable.\n /// The instance.\n /// The separator.\n /// \n public static string ToSeparatedString(this IEnumerable instance, char separator)\n {\n var array = instance?.ToArray();\n if (array == null || !array.Any()) return null;\n\n var csv = new StringBuilder();\n array.Each(value => csv.AppendFormat(\"{0}{1}\", value, separator));\n return csv.ToString(0, csv.Length - 1);\n }\n\n /// \n /// Produces a comma separated values of string out of an IEnumerable. \n /// This would be useful if you want to automatically generate a CSV out of integer, string, or any other primitive data type collection or array. \n /// \n /// Type of element inside enumerable.\n /// The instance.\n /// \n public static string ToSeparatedString(this IEnumerable instance)\n {\n return instance.ToSeparatedString(',');\n }\n\n /// \n /// Determines whether this collection is null or empty.\n /// \n /// Type of element in collection.\n /// The collection.\n /// \n /// true if the specified collection is null or empty; otherwise, false.\n /// \n public static bool IsNullOrEmpty(this IEnumerable collection)\n {\n return collection == null || !collection.Any();\n }\n\n /// \n /// Determines whether a enumerable is not null or empty.\n /// \n /// \n /// The collection.\n /// \n /// true if [is not null or empty] [the specified collection]; otherwise, false.\n /// \n public static bool IsNotNullOrEmpty(this IEnumerable collection)\n {\n return collection != null && collection.Any();\n }\n\n /// \n /// Orders the enumerable based on a property ASC or DESC. Example \"OrderBy(\"Name desc\")\"\n /// \n /// \n /// The list.\n /// The sort expression.\n /// \n /// No property '\" + property + \"' in + \" + typeof(T).Name + \"'\n public static IEnumerable OrderBy(this IEnumerable list, string sortExpression)\n {\n sortExpression += \"\";\n var parts = sortExpression.Split(' ');\n var descending = false;\n\n if (parts.Length > 0 && parts[0] != \"\")\n {\n var property = parts[0];\n\n if (parts.Length > 1)\n {\n descending = parts[1].ToLower().Contains(\"desc\");\n }\n\n var prop = typeof(T).GetProperty(property);\n\n if (prop == null)\n {\n throw new LiquidException(\"No property '\" + property + \"' in + \" + typeof(T).Name + \"'\");\n }\n\n return descending ? list.OrderByDescending(x => prop.GetValue(x, null)) : list.OrderBy(x => prop.GetValue(x, null));\n }\n\n return list;\n }\n }\n\n}"
},
{
"path": "src/Liquid.Core/Extensions/IntExtension.cs",
"content": "using System;\nusing System.Diagnostics.CodeAnalysis;\n\nnamespace Liquid.Core.Utils\n{\n /// \n /// Number Extensions Class.\n /// \n [ExcludeFromCodeCoverage]\n public static class IntExtension\n {\n /// \n /// Determines whether a number is is prime number.\n /// \n /// The number.\n /// \n /// true if [is prime number] [the specified number]; otherwise, false.\n /// \n public static bool IsPrimeNumber(this int number)\n {\n if (number % 2 == 0)\n {\n return number == 2;\n }\n var sqrt = (int)Math.Sqrt(number);\n for (var t = 3; t <= sqrt; t += 2)\n {\n if (number % t == 0)\n {\n return false;\n }\n }\n return number != 1;\n }\n\n /// \n /// Determines whether a number is odd.\n /// \n /// The number.\n /// \n /// true if the specified number is odd; otherwise, false.\n /// \n public static bool IsOdd(this int number)\n {\n return number % 2 == 0;\n }\n\n /// \n /// Determines whether a number is even.\n /// \n /// The number.\n /// \n /// true if the specified number is even; otherwise, false.\n /// \n public static bool IsEven(this int number)\n {\n return number % 2 != 0;\n }\n\n /// \n /// Format a double using the local culture currency settings.\n /// \n /// The double to be formatted.\n /// The double formatted based on the local culture currency settings.\n public static string ToLocalCurrencyString(this double value)\n {\n return $\"{value:C}\";\n }\n }\n}"
},
{
"path": "src/Liquid.Core/Extensions/ObjectExtension.cs",
"content": "using Liquid.Core.Utils;\nusing System;\nusing System.Globalization;\nusing System.IO;\nusing System.Runtime.Serialization.Formatters.Binary;\nusing System.Text;\nusing System.Text.Json;\n\nnamespace Liquid.Core.Extensions\n{\n /// \n /// Object extensions class.\n /// \n public static class ObjectExtension\n {\n /// \n /// Determines whether [is of type] [the specified value].\n /// \n /// \n /// The value.\n /// \n /// true if [is of type] [the specified value]; otherwise, false.\n /// \n public static bool IsOfType(this object value)\n {\n return value is T;\n }\n\n /// \n /// Determines whether this instance is datetime.\n /// \n /// The expression.\n /// \n /// true if the specified expression is datetime; otherwise, false.\n /// \n public static bool IsDatetime(this object expression)\n {\n return expression.ToDatetime(out DateTime? _);\n }\n\n /// \n /// Converts object to date time.\n /// \n /// The expression.\n /// The outer.\n /// \n public static bool ToDatetime(this object expression, out DateTime? outer)\n {\n outer = null;\n if (expression == null)\n return false;\n\n if (expression.IsOfType())\n return true;\n\n if (DateTime.TryParseExact(\n Convert.ToString(expression, CultureInfo.InvariantCulture),\n DateTimeFormatInfo.CurrentInfo?.GetAllDateTimePatterns('d'),\n CultureInfo.CurrentCulture, DateTimeStyles.None, out var parsed))\n outer = parsed;\n\n return outer.HasValue;\n }\n\n /// \n /// Determines whether this instance is boolean.\n /// \n /// The expression.\n /// \n /// true if the specified expression is boolean; otherwise, false.\n /// \n public static bool IsBoolean(this object expression)\n {\n return expression.ToBoolean(out bool? _);\n }\n\n /// \n /// Converts object to boolean.\n /// \n /// The expression.\n /// The outer.\n /// \n public static bool ToBoolean(this object expression, out bool? outer)\n {\n outer = null;\n if (expression == null)\n return false;\n\n if (bool.TryParse(Convert.ToString(expression, CultureInfo.InvariantCulture), out var parsed))\n outer = parsed;\n return outer.HasValue;\n }\n\n /// \n /// Determines whether this instance is unique identifier.\n /// \n /// The expression.\n /// \n /// true if the specified expression is unique identifier; otherwise, false.\n /// \n public static bool IsGuid(this object expression)\n {\n return expression.ToGuid(out _);\n }\n\n /// \n /// Converts object to unique identifier.\n /// \n /// The expression.\n /// The outer.\n /// \n private static bool ToGuid(this object expression, out Guid? outer)\n {\n outer = null;\n if (expression == null)\n return false;\n\n if (Guid.TryParse(Convert.ToString(expression, CultureInfo.InvariantCulture), out var parsed))\n outer = parsed;\n return outer.HasValue;\n }\n\n /// \n /// Determines whether this instance is numeric.\n /// \n /// The expression.\n /// \n /// true if the specified expression is numeric; otherwise, false.\n /// \n public static bool IsNumeric(this object expression)\n {\n return expression != null && double.TryParse(expression.ToString(), out _);\n }\n\n /// \n /// Determines whether this instance is integer.\n /// \n /// The expression.\n /// \n /// true if the specified expression is integer; otherwise, false.\n /// \n public static bool IsInteger(this object expression)\n {\n return expression.ToInteger(out long? _);\n }\n\n /// \n /// Converts object to integer.\n /// \n /// The expression.\n /// The outer.\n /// \n public static bool ToInteger(this object expression, out long? outer)\n {\n outer = null;\n if (expression == null)\n return false;\n\n if (long.TryParse(Convert.ToString(expression, CultureInfo.InvariantCulture),\n NumberStyles.Integer | NumberStyles.AllowParentheses | NumberStyles.AllowThousands | NumberStyles.AllowTrailingSign,\n CultureInfo.InvariantCulture, out var parsed))\n outer = parsed;\n return outer.HasValue;\n }\n\n /// \n /// Determines whether this instance is double.\n /// \n /// The expression.\n /// \n /// true if the specified expression is double; otherwise, false.\n /// \n public static bool IsDouble(this object expression)\n {\n return expression.ToDouble(out double? _);\n }\n\n /// \n /// Converts object to double.\n /// \n /// The expression.\n /// The outer.\n /// \n public static bool ToDouble(this object expression, out double? outer)\n {\n outer = null;\n if (expression == null)\n return false;\n\n if (double.TryParse(Convert.ToString(expression, CultureInfo.InvariantCulture),\n NumberStyles.AllowThousands | NumberStyles.AllowTrailingSign | NumberStyles.Currency | NumberStyles.Float, CultureInfo.InvariantCulture, out var parsed))\n outer = parsed;\n return outer.HasValue;\n }\n\n /// \n /// Determines whether [is primitive type].\n /// \n /// The object.\n /// \n /// true if [is primitive type] [the specified object]; otherwise, false.\n /// \n public static bool IsPrimitiveType(this object obj)\n {\n return obj.GetType().IsPrimitive;\n }\n\n /// \n /// Converts the object to json string.\n /// \n /// \n /// Provides options to be used with System.Text.Json.JsonSerializer.\n public static string ToJsonString(this object source, JsonSerializerOptions options = null)\n {\n return source == null ? null : JsonSerializer.Serialize(source, options);\n }\n\n /// \n /// Converts the object to json bytes.\n /// \n /// \n /// Provides options to be used with System.Text.Json.JsonSerializer.\n public static byte[] ToJsonBytes(this object source, JsonSerializerOptions options = null)\n {\n if (source == null)\n return new byte[0];\n var instring = JsonSerializer.Serialize(source, options);\n\n return Encoding.Default.GetBytes(instring);\n }\n /// \n /// Gets the field value.\n /// \n /// The object.\n /// Name of the field.\n /// \n /// obj\n /// Couldn't find field {fieldName} in type {objType.FullName}\n public static object GetFieldValue(this object obj, string fieldName)\n {\n ArgumentNullException.ThrowIfNull(obj);\n\n Type objType = obj.GetType();\n var fieldInfo = TypeUtils.GetFieldInfo(objType, fieldName);\n if (fieldInfo == null)\n throw new ArgumentOutOfRangeException(fieldName,\n $\"Couldn't find field {fieldName} in type {objType.FullName}\");\n return fieldInfo.GetValue(obj);\n }\n\n /// \n /// Sets the field value.\n /// \n /// The object.\n /// Name of the field.\n /// The value.\n /// obj\n /// Couldn't find field {fieldName} in type {objType.FullName}\n public static void SetFieldValue(this object obj, string fieldName, object val)\n {\n ArgumentNullException.ThrowIfNull(obj);\n\n Type objType = obj.GetType();\n var fieldInfo = TypeUtils.GetFieldInfo(objType, fieldName);\n if (fieldInfo == null)\n throw new ArgumentOutOfRangeException(fieldName,\n $\"Couldn't find field {fieldName} in type {objType.FullName}\");\n fieldInfo.SetValue(obj, val);\n }\n\n /// \n /// Gets the property value.\n /// \n /// The object.\n /// Name of the property.\n /// \n /// obj\n /// Couldn't find property {propertyName} in type {objType.FullName}\n public static object GetPropertyValue(this object obj, string propertyName)\n {\n ArgumentNullException.ThrowIfNull(obj);\n\n Type objType = obj.GetType();\n var propertyInfo = TypeUtils.GetPropertyInfo(objType, propertyName);\n if (propertyInfo == null)\n throw new ArgumentOutOfRangeException(propertyName,\n $\"Couldn't find property {propertyName} in type {objType.FullName}\");\n return propertyInfo.GetValue(obj, null);\n }\n\n /// \n /// Sets the property value.\n /// \n /// The object.\n /// Name of the property.\n /// The value.\n /// obj\n /// Couldn't find property {propertyName} in type {objType.FullName}\n public static void SetPropertyValue(this object obj, string propertyName, object val)\n {\n ArgumentNullException.ThrowIfNull(obj);\n\n Type objType = obj.GetType();\n var propertyInfo = TypeUtils.GetPropertyInfo(objType, propertyName);\n if (propertyInfo == null)\n throw new ArgumentOutOfRangeException(propertyName,\n $\"Couldn't find property {propertyName} in type {objType.FullName}\");\n propertyInfo.SetValue(obj, val, null);\n }\n }\n}\n\n"
},
{
"path": "src/Liquid.Core/Extensions/StreamExtension.cs",
"content": "using System.Diagnostics.CodeAnalysis;\nusing System.IO;\nusing System.Text;\n\nnamespace Liquid.Core.Extensions\n{\n /// \n /// Stream extensions class.\n /// \n [ExcludeFromCodeCoverage]\n public static class StreamExtension\n {\n /// \n /// Gets the string from UTF8 stream.\n /// \n /// The stream source.\n /// The result string from stream.\n public static string AsStringUtf8(this Stream source)\n {\n if (source == null) return null;\n string documentContents;\n using (var readStream = new StreamReader(source, Encoding.UTF8))\n {\n documentContents = readStream.ReadToEnd();\n }\n\n return documentContents;\n }\n\n /// \n /// Gets the string from ASCII stream.\n /// \n /// The stream source.\n /// The result string from stream.\n public static string AsStringAscii(this Stream source)\n {\n if (source == null) return null;\n string documentContents;\n using (var readStream = new StreamReader(source, Encoding.ASCII))\n {\n documentContents = readStream.ReadToEnd();\n }\n\n return documentContents;\n }\n\n /// \n /// Gets the string from UNICODE stream.\n /// \n /// The stream source.\n /// The result string from stream.\n public static string AsStringUnicode(this Stream source)\n {\n if (source == null) return null;\n string documentContents;\n using (var readStream = new StreamReader(source, Encoding.Unicode))\n {\n documentContents = readStream.ReadToEnd();\n }\n return documentContents;\n }\n\n /// \n /// Converts a stream to byte array.\n /// \n /// The stream.\n /// \n public static byte[] ToByteArray(this Stream stream)\n {\n using var ms = new MemoryStream();\n stream.CopyTo(ms);\n return ms.ToArray();\n }\n }\n}"
},
{
"path": "src/Liquid.Core/Extensions/StringExtension.cs",
"content": "using System;\nusing System.Diagnostics.CodeAnalysis;\nusing System.IO;\nusing System.Security.Cryptography;\nusing System.Text;\nusing System.Text.Json;\nusing System.Text.RegularExpressions;\nusing System.Xml;\nusing System.Xml.Serialization;\n\nnamespace Liquid.Core.Extensions\n{\n /// \n /// String Extensions Class.\n /// \n /// \n [ExcludeFromCodeCoverage]\n public static class StringExtension\n { \n\n /// \n /// Determines whether a string contains a specified value.\n /// \n /// The string source.\n /// The value to compare.\n /// Type of the comparison.\n /// \n /// true if source contains the specified value; otherwise, false.\n /// \n public static bool Contains(this string source, string value, StringComparison comparisonType = StringComparison.InvariantCultureIgnoreCase)\n {\n return source.IndexOf(value, comparisonType) >= 0;\n }\n\n /// \n /// Removes the line endings.\n /// \n /// The string value.\n /// The string without line endings.\n public static string RemoveLineEndings(this string value)\n {\n if (string.IsNullOrEmpty(value)) { return value; }\n\n var lineSeparator = ((char)0x2028).ToString();\n var paragraphSeparator = ((char)0x2029).ToString();\n\n return value.Replace(\"\\r\\n\", string.Empty)\n .Replace(\"\\n\", string.Empty)\n .Replace(\"\\r\", string.Empty)\n .Replace(lineSeparator, string.Empty)\n .Replace(paragraphSeparator, string.Empty);\n }\n\n /// \n /// Converts the string representation of a Guid to its Guid \n /// equivalent. A return value indicates whether the operation \n /// succeeded. \n /// \n /// A string containing a Guid to convert.\n /// \n /// if was converted \n /// successfully; otherwise, .\n /// \n /// \n /// When this method returns, contains the Guid value equivalent to \n /// the Guid contained in , if the conversion \n /// succeeded, or if the conversion failed. \n /// The conversion fails if the parameter is a \n /// reference ( in \n /// Visual Basic), or is not of the correct format. \n /// \n public static bool IsGuid(this string guid)\n {\n return guid != null && Guid.TryParse(guid, out _);\n }\n\n /// \n /// Determines whether this string is a valid http url.\n /// \n /// The string.\n /// \n /// true if [is valid URL] [the specified text]; otherwise, false.\n /// \n public static bool IsValidHttpUrl(this string str)\n {\n return Uri.TryCreate(str, UriKind.Absolute, out _);\n }\n\n /// \n /// Appends to the string builder if matchers the condition.\n /// \n /// The builder.\n /// The value.\n /// if set to true appends to string builder.\n /// \n public static StringBuilder AppendIf(this StringBuilder builder, string value, bool condition)\n {\n if (condition) builder.Append(value);\n return builder;\n }\n\n /// \n /// Converts a string to guid.\n /// \n /// The string.\n /// \n public static Guid ToGuid(this string str)\n {\n Guid.TryParse(str, out var returnValue);\n return returnValue;\n }\n\n /// \n /// Converts string to enum object\n /// \n /// Type of enum\n /// String value to convert\n /// Returns enum object\n public static T ToEnum(this string value) where T : struct\n {\n return (T)Enum.Parse(typeof(T), value, true);\n }\n\n /// \n /// Computes the hash of the string using a specified hash algorithm\n /// \n /// The string to hash\n /// The hash key.\n /// The hash algorithm to use\n /// \n /// The resulting hash or an empty string on error\n /// \n public static string CreateHash(this string input, string key, HashType hashType)\n {\n try\n {\n var hash = GetComputedHash(input, key, hashType);\n var ret = new StringBuilder();\n\n foreach (var hashByte in hash)\n ret.Append(hashByte.ToString(\"x2\"));\n\n return ret.ToString();\n }\n catch\n {\n return string.Empty;\n }\n }\n\n /// \n /// Gets the hash.\n /// \n /// The input.\n /// The key.\n /// The hash.\n /// \n private static byte[] GetComputedHash(string input, string key, HashType hash)\n {\n var inputBytes = Encoding.UTF8.GetBytes(input);\n var inputKey = Encoding.UTF8.GetBytes(key);\n\n return hash switch\n {\n HashType.HMacSha256 => new HMACSHA256(inputKey).ComputeHash(inputBytes),\n HashType.HMacSha384 => new HMACSHA384(inputKey).ComputeHash(inputBytes),\n HashType.HMacSha512 => new HMACSHA512(inputKey).ComputeHash(inputBytes),\n HashType.Sha256 => SHA256.Create().ComputeHash(inputBytes),\n HashType.Sha384 => SHA384.Create().ComputeHash(inputBytes),\n HashType.Sha512 => SHA512.Create().ComputeHash(inputBytes),\n _ => inputBytes,\n };\n }\n\n /// \n /// Parses a string json to a specific object.\n /// \n /// type of object to be parsed.\n /// \n /// Provides options to be used with System.Text.Json.JsonSerializer.\n /// the object parsed from json.\n public static T ParseJson(this string json, JsonSerializerOptions options = null)\n {\n if (string.IsNullOrEmpty(json)) return default;\n var result = JsonSerializer.Deserialize(json, options);\n return result;\n }\n /// \n /// Gets the stream from string using UTF8 encoding.\n /// \n /// The string source.\n /// UTF8 encoded stream.\n public static Stream ToStreamUtf8(this string source)\n {\n if (source == null) return null;\n var stream = new MemoryStream(Encoding.UTF8.GetBytes(source));\n return stream;\n }\n\n /// \n /// Gets the stream from string using ASCII encoding.\n /// \n /// The string source.\n /// ASCII encoded stream.\n public static Stream ToStreamAscii(this string source)\n {\n if (source == null) return null;\n var stream = new MemoryStream(Encoding.ASCII.GetBytes(source));\n return stream;\n }\n\n /// \n /// Gets the stream from string using UTF8 encoding.\n /// \n /// The string source.\n /// Unicode encoded stream.\n public static Stream ToStreamUnicode(this string source)\n {\n if (source == null) return null;\n var stream = new MemoryStream(Encoding.Unicode.GetBytes(source));\n return stream;\n }\n\n /// \n /// Serializes an object to xml.\n /// \n /// The object.\n /// \n public static string ToXml(this object obj)\n {\n string retVal;\n using (var ms = new MemoryStream())\n {\n var xs = new XmlSerializer(obj.GetType());\n xs.Serialize(ms, obj);\n ms.Flush();\n ms.Position = 0;\n retVal = ms.AsStringUtf8();\n }\n return retVal;\n }\n\n /// \n /// Parse a xml to an object.\n /// \n /// type of object.\n /// The xml string.\n /// \n public static T ParseXml(this string str) where T : new()\n {\n var xs = new XmlSerializer(typeof(T));\n var stream = str.ToStreamUtf8();\n if (xs.CanDeserialize(new XmlTextReader(stream)))\n {\n stream.Position = 0;\n return (T)xs.Deserialize(stream);\n }\n return default;\n }\n\n /// \n /// \n /// \n public enum HashType\n {\n /// \n /// The HMACSHA256 Hash type.\n /// \n HMacSha256,\n /// \n /// The HMACSHA384 Hash type.\n /// \n HMacSha384,\n /// \n /// The HMACSHA512 Hash type.\n /// \n HMacSha512,\n /// \n /// The SHA256 Hash type.\n /// \n Sha256,\n /// \n /// The SHA384 Hash type.\n /// \n Sha384,\n /// \n /// The SHA512 Hash type.\n /// \n Sha512\n }\n }\n}"
},
{
"path": "src/Liquid.Core/Extensions/TypeExtensions.cs",
"content": "using System;\nusing System.Diagnostics.CodeAnalysis;\nusing System.Linq;\nusing System.Reflection;\n\nnamespace Liquid.Core.Extensions\n{\n /// \n /// \n /// \n [ExcludeFromCodeCoverage]\n public static class TypeExtensions\n {\n /// \n /// Implements the generic interface.\n /// \n /// The type.\n /// Type of the interface.\n /// \n public static bool ImplementGenericInterface(this Type type, Type interfaceType)\n => type.IsGenericType(interfaceType) || type.GetTypeInfo().ImplementedInterfaces.Any(@interface => @interface.IsGenericType(interfaceType));\n\n /// \n /// Determines whether [is generic type] [the specified generic type].\n /// \n /// The type.\n /// Type of the generic.\n /// \n /// true if [is generic type] [the specified generic type]; otherwise, false.\n /// \n public static bool IsGenericType(this Type type, Type genericType)\n => type.GetTypeInfo().IsGenericType && type.GetGenericTypeDefinition() == genericType;\n\n /// \n /// Determines whether [is generic type].\n /// \n /// The type.\n /// \n /// true if [is generic type] [the specified type]; otherwise, false.\n /// \n public static bool IsGenericType(this Type type)\n {\n return type.GetTypeInfo().IsGenericType;\n }\n\n /// \n /// Determines whether [is concrete type].\n /// \n /// The type.\n /// \n /// true if [is concrete type] [the specified type]; otherwise, false.\n /// \n public static bool IsConcreteType(this Type type)\n {\n return !type.IsAbstract() && !type.IsArray && type != typeof(object) && !typeof(Delegate).IsAssignableFrom(type);\n }\n\n /// \n /// Determines whether this instance is abstract.\n /// \n /// The type.\n /// \n /// true if the specified type is abstract; otherwise, false.\n /// \n public static bool IsAbstract(this Type type)\n {\n return type.GetTypeInfo().IsAbstract;\n }\n /// \n /// Determines whether [is generic type definition of] [the specified type to check].\n /// \n /// The generic type definition.\n /// The type to check.\n /// \n /// true if [is generic type definition of] [the specified type to check]; otherwise, false.\n /// \n public static bool IsGenericTypeDefinitionOf(this Type genericTypeDefinition, Type typeToCheck)\n {\n return typeToCheck.IsGenericType() && typeToCheck.GetGenericTypeDefinition() == genericTypeDefinition;\n } \n\n /// \n /// Determines whether [is generic implementation of] [the specified type].\n /// \n /// The type.\n /// Type of the service.\n /// \n /// true if [is generic implementation of] [the specified type]; otherwise, false.\n /// \n public static bool IsGenericImplementationOf(this Type type, Type serviceType)\n {\n if (type == serviceType || serviceType.IsVariantVersionOf(type))\n return true;\n return type.IsGenericType() && serviceType.IsGenericTypeDefinition() && type.GetGenericTypeDefinition() == serviceType;\n }\n\n /// \n /// Determines whether [is variant version of] [the specified other type].\n /// \n /// The type.\n /// Type of the other.\n /// \n /// true if [is variant version of] [the specified other type]; otherwise, false.\n /// \n public static bool IsVariantVersionOf(this Type type, Type otherType)\n {\n return type.IsGenericType() && otherType.IsGenericType() && type.GetGenericTypeDefinition() == otherType.GetGenericTypeDefinition() && type.IsAssignableFrom(otherType);\n }\n\n /// \n /// Determines whether [is generic type definition].\n /// \n /// The type.\n /// \n /// true if [is generic type definition] [the specified type]; otherwise, false.\n /// \n public static bool IsGenericTypeDefinition(this Type type)\n {\n return type.GetTypeInfo().IsGenericTypeDefinition;\n }\n\n /// \n /// Bases the type.\n /// \n /// The type.\n /// \n public static Type GetBaseType(this Type type)\n {\n return type.GetTypeInfo().BaseType;\n }\n }\n}\n"
},
{
"path": "src/Liquid.Core/GenAi/Entities/LiquidChatContent.cs",
"content": "using Liquid.Core.GenAi.Enums;\nusing System;\nusing System.Diagnostics.CodeAnalysis;\n\nnamespace Liquid.Core.GenAi.Entities\n{\n /// \n /// The content of the chat message.\n /// \n [ExcludeFromCodeCoverage]\n public class LiquidChatContent\n {\n /// \n /// The kind of content.\n /// \n public LiquidContentKind Kind { get; set; }\n\n /// \n /// The text content of the message.\n /// \n public string Text { get; set; }\n\n /// \n /// The image content url of the message.\n /// \n public Uri ImageUri { get; set; }\n\n }\n}"
},
{
"path": "src/Liquid.Core/GenAi/Entities/LiquidChatMessage.cs",
"content": "using Liquid.Core.GenAi.Enums;\nusing System;\nusing System.Collections.Generic;\nusing System.Diagnostics.CodeAnalysis;\n\nnamespace Liquid.Core.GenAi.Entities\n{\n /// \n /// Context message associated with a chat completions request.\n /// \n [ExcludeFromCodeCoverage]\n public class LiquidChatMessage\n {\n /// \n /// The chat role associated with this message.\n /// \n public LiquidMessageRole Role { get; set; }\n\n /// \n /// Initializes a new instance of the class with the specified role.\n /// \n /// The role associated with the chat message. This value cannot be null or empty.\n public LiquidChatMessage(LiquidMessageRole role)\n {\n Role = role;\n }\n\n /// \n /// The contents of the message.\n /// \n public LiquidChatContent[] Content { get; set; } = Array.Empty();\n\n\n /// \n /// Adds a text content item to the current collection of chat contents.\n /// \n /// This method appends the specified text as a new content item to the existing\n /// collection. If the collection is initially null, it initializes the collection with the new content\n /// item.\n /// The text content to add. Cannot be null, empty, or consist solely of whitespace.\n /// Thrown if is null, empty, or consists only of whitespace.\n public void AddContent(string text)\n {\n if (string.IsNullOrWhiteSpace(text))\n {\n throw new ArgumentException(\"Text content cannot be null or empty.\", nameof(text));\n }\n var content = new LiquidChatContent\n {\n Kind = LiquidContentKind.Text,\n Text = text\n };\n if (Content == null)\n {\n Content = new[] { content };\n }\n else\n {\n var contentList = new List(Content) { content };\n Content = contentList.ToArray();\n }\n }\n\n /// \n /// Adds an image content to the current collection of chat contents.\n /// \n /// If the content collection is initially empty, this method initializes it with the new\n /// image content. Otherwise, it appends the image content to the existing collection.\n /// The URI of the image to be added. Cannot be .\n /// Thrown if is .\n public void AddContent(Uri imageUri)\n {\n if (imageUri == null)\n {\n throw new ArgumentNullException(nameof(imageUri), \"Image URI cannot be null.\");\n }\n var content = new LiquidChatContent\n {\n Kind = LiquidContentKind.Image,\n ImageUri = imageUri\n };\n if (Content == null)\n {\n Content = new[] { content };\n }\n else\n {\n var contentList = new List(Content) { content };\n Content = contentList.ToArray();\n }\n }\n }\n}"
},
{
"path": "src/Liquid.Core/GenAi/Entities/LiquidChatMessages.cs",
"content": "using System.Collections.Generic;\nusing System.Diagnostics.CodeAnalysis;\n\nnamespace Liquid.Core.GenAi.Entities\n{\n /// \n /// The object of context messages associated with a chat completions request\n /// \n [ExcludeFromCodeCoverage]\n public class LiquidChatMessages\n {\n /// \n /// The collection of context messages associated with a chat completions request.\n /// \n public List Messages { get; set; } = new List();\n\n /// \n /// Adds a message to the collection of chat messages.\n /// \n /// The chat message to add. Cannot be .\n /// Thrown if is .\n public void AddMessage(LiquidChatMessage message)\n {\n if (message == null)\n {\n throw new System.ArgumentNullException(nameof(message), \"Message cannot be null\");\n }\n Messages.Add(message);\n }\n\n }\n}"
},
{
"path": "src/Liquid.Core/GenAi/Enums/LiquidContentKind.cs",
"content": "using System;\nusing System.Collections.Generic;\nusing System.Linq;\nusing System.Text;\nusing System.Threading.Tasks;\n\nnamespace Liquid.Core.GenAi.Enums\n{\n /// \n /// Represents the possibles of underlying data for a chat message's Content property.\n /// \n public enum LiquidContentKind\n {\n /// \n /// Text content\n /// \n Text,\n /// \n /// Image content\n /// \n Image\n }\n}\n"
},
{
"path": "src/Liquid.Core/GenAi/Enums/LiquidMessageRole.cs",
"content": "using System;\nusing System.Collections.Generic;\nusing System.Linq;\nusing System.Text;\nusing System.Threading.Tasks;\n\nnamespace Liquid.Core.GenAi.Enums\n{\n /// \n /// Specifies the role of a participant in a message exchange, such as a user, assistant, or system.\n /// \n public enum LiquidMessageRole\n {\n /// \n /// The user role, typically representing the end user or client.\n /// \n User,\n /// \n /// The assistant role, typically representing the AI or system responding to the user.\n /// \n Assistant,\n /// \n /// The system role, typically used for system-level messages or instructions.\n /// \n System\n }\n}\n"
},
{
"path": "src/Liquid.Core/GenAi/Interfaces/ILiquidGenAi.cs",
"content": "using Liquid.Core.Entities;\nusing Liquid.Core.GenAi.Entities;\nusing Liquid.Core.GenAi.Settings;\nusing Liquid.Core.Settings;\nusing System;\nusing System.Collections.Generic;\nusing System.Threading.Tasks;\n\nnamespace Liquid.Core.GenAi\n{\n /// \n /// This service is the hub of Liquid adapter custom completions for Generative AI.\n /// \n public interface ILiquidGenAi\n {\n /// \n /// Get chat completions for provided content and functions.\n /// \n /// Context messages associated with chat completions request.\n /// A list of functions the model may generate JSON inputs for.\n /// The options for chat completions request.\n Task FunctionCalling(LiquidChatMessages messages, List functions, CompletionsOptions settings);\n\n /// \n /// Get chat completions for provided chat context messages.\n /// \n /// A request chat message representing an input from the user.\n /// A request chat message containing system instructions that influence how the model will generate a chat completions\n /// response.\n /// The options for chat completions request.\n /// The collection of context messages associated with this chat completions request.\n /// Typical usage begins with a chat message for the System role that provides instructions for\n /// the behavior of the assistant, followed by alternating messages between the User and\n /// Assistant roles.\n Task CompleteChatAsync(string content, string prompt, CompletionsOptions settings, LiquidChatMessages chatHistory = null);\n\n /// \n /// Get chat completions for provided chat context messages and functions.\n /// \n /// Messages associated with chat completions request.\n /// A list of functions the model may generate JSON inputs for.\n /// The collection of context messages associated with this chat completions request. \n /// The options for chat completions request.\n Task CompleteChatAsync(LiquidChatMessages messages, CompletionsOptions settings, List functions = null, LiquidChatMessages chatHistory = null);\n }\n}\n"
},
{
"path": "src/Liquid.Core/GenAi/Interfaces/ILiquidGenAiHandler.cs",
"content": "using System;\nusing System.Net.WebSockets;\nusing System.Threading;\nusing System.Threading.Tasks;\n\nnamespace Liquid.Core.GenAi.Interfaces\n{\n /// \n /// This service is the hub of Liquid adapter audio stream handlers for Generative AI.\n /// \n public interface ILiquidGenAiHandler\n {\n /// \n /// The task that manages receipt of incoming simplified protocol messages from the frontend client.\n /// \n /// The WebSocket connection to the client.\n /// \n /// \n /// \n Task HandleInputMessagesAsync(WebSocket socket, CancellationToken cancellationToken = default);\n\n /// \n /// The task that manages the incoming updates from realtime API messages and model responses.\n /// \n /// The WebSocket connection to the client.\n /// \n /// \n /// \n Task HandleUpdatesFromServiceAsync(WebSocket socket, CancellationToken cancellationToken = default);\n }\n}\n"
},
{
"path": "src/Liquid.Core/GenAi/Settings/CompletionsOptions.cs",
"content": "using Liquid.Core.Settings;\nusing System;\nusing System.Collections.Generic;\nusing System.Diagnostics.CodeAnalysis;\nusing System.Linq;\nusing System.Text;\nusing System.Threading.Tasks;\n\nnamespace Liquid.Core.GenAi.Settings\n{\n /// \n /// The options for chat completions request.\n /// \n [ExcludeFromCodeCoverage]\n public class CompletionsOptions\n {\n /// \n /// Client connection alias to use for a chat completions request.\n /// This connection must be configured in application previously \n /// \n public string ClientId { get; set; }\n /// \n /// The deployment name to use for a chat completions request. \n /// \n public string DeploymentName { get; set; }\n\n /// \n /// The deployment name to use for an embeddings request. \n /// \n public string EmbeddingModelName { get; set; }\n\n /// \n /// Sampling temperature to use that controls the apparent creativity of generated\n /// completions.\n /// \n public float Temperature { get; set; } = (float)0.7;\n\n /// \n /// Gets the maximum number of tokens to generate. \n /// \n public int? MaxTokens { get; set; } = null;\n\n /// \n /// An alternative value to , called nucleus sampling, that causes\n /// the model to consider the results of the tokens with probability\n /// mass.\n /// \n public float TopP { get; set; } = (float)0.95;\n\n /// \n /// Gets or sets a value that influences the probability of generated tokens appearing based on their\n /// cumulative frequency in generated text.\n /// \n public int FrequencyPenalty { get; set; } = 0;\n\n /// \n /// Gets or sets a value that influences the probability of generated tokens appearing based on their\n /// existing presence in generated text.\n /// \n public int PresencePenalty { get; set; } = 0;\n }\n}\n"
},
{
"path": "src/Liquid.Core/Implementations/LiquidBackgroundService.cs",
"content": "using Liquid.Core.Entities;\nusing Liquid.Core.Interfaces;\nusing Microsoft.Extensions.DependencyInjection;\nusing Microsoft.Extensions.Hosting;\nusing System;\nusing System.Threading;\nusing System.Threading.Tasks;\n\nnamespace Liquid.Core.Implementations\n{\n /// \n /// Liquid BackgroundService implementation for message consumers.\n /// \n /// Type of message body.\n public class LiquidBackgroundService : BackgroundService\n {\n private readonly ILiquidConsumer _consumer;\n\n private readonly IServiceProvider _serviceProvider;\n\n /// \n /// Initialize a new instance of \n /// \n /// \n /// Consumer service with message handler definition for processing messages.\n public LiquidBackgroundService(IServiceProvider serviceProvider, ILiquidConsumer consumer)\n {\n _serviceProvider = serviceProvider;\n _consumer = consumer ?? throw new ArgumentNullException(nameof(consumer));\n }\n\n /// \n /// This method is called when the Microsoft.Extensions.Hosting.IHostedService starts.\n /// Its return a task that represents the lifetime of the long \n /// running operation(s) being performed.\n /// \n /// Triggered when Microsoft.Extensions.Hosting.IHostedService.StopAsync(System.Threading.CancellationToken) \n /// is called.\n protected override async Task ExecuteAsync(CancellationToken stoppingToken)\n {\n _consumer.ConsumeMessageAsync += ProcessMessageAsync;\n _consumer.RegisterMessageHandler(stoppingToken);\n\n await Task.CompletedTask;\n }\n\n /// \n /// This method is called when message handler gets a message.\n /// Return a task that represents the process to be executed \n /// by the message handler.\n /// \n /// \n /// \n public async Task ProcessMessageAsync(ConsumerMessageEventArgs args, CancellationToken cancellationToken)\n {\n using (IServiceScope scope = _serviceProvider.CreateScope())\n {\n var worker = scope.ServiceProvider.GetRequiredService>();\n await worker.ProcessMessageAsync(args, cancellationToken);\n }\n }\n }\n}\n"
},
{
"path": "src/Liquid.Core/Implementations/LiquidCache.cs",
"content": "using Liquid.Core.Extensions;\nusing Liquid.Core.Interfaces;\nusing Microsoft.Extensions.Caching.Distributed;\nusing System;\nusing System.Threading;\nusing System.Threading.Tasks;\n\nnamespace Liquid.Core.Implementations\n{\n ///\n public class LiquidCache : ILiquidCache\n {\n private readonly IDistributedCache _distributedCache;\n\n /// \n /// Initialize a new instance of \n /// \n /// \n /// \n public LiquidCache(IDistributedCache distributedCache)\n {\n _distributedCache = distributedCache ?? throw new ArgumentNullException(nameof(distributedCache));\n }\n\n ///\n public byte[] Get(string key)\n {\n return _distributedCache.Get(key);\n }\n\n ///\n public Task GetAsync(string key, CancellationToken token = default)\n {\n return _distributedCache.GetAsync(key, token);\n }\n\n ///\n public void Refresh(string key)\n {\n _distributedCache.Refresh(key);\n }\n\n ///\n public Task RefreshAsync(string key, CancellationToken token = default)\n {\n return _distributedCache.RefreshAsync(key, token);\n }\n\n ///\n public void Remove(string key)\n {\n _distributedCache.Remove(key);\n }\n\n ///\n public Task RemoveAsync(string key, CancellationToken token = default)\n {\n return _distributedCache.RemoveAsync(key, token);\n }\n\n ///\n public void Set(string key, byte[] value, DistributedCacheEntryOptions options)\n {\n _distributedCache.Set(key, value, options);\n }\n\n ///\n public Task SetAsync(string key, byte[] value, DistributedCacheEntryOptions options, CancellationToken token = default)\n {\n return _distributedCache.SetAsync(key, value, options, token);\n }\n\n ///\n public T Get(string key)\n {\n var response = _distributedCache.Get(key);\n return response.ParseJson();\n }\n\n ///\n public async Task GetAsync(string key, CancellationToken token = default)\n {\n var response = await _distributedCache.GetAsync(key, token);\n return response.ParseJson();\n }\n\n ///\n public void Set(string key, T value, DistributedCacheEntryOptions options)\n {\n _distributedCache.Set(key, value.ToJsonBytes(), options);\n }\n\n ///