tag: 0.3.0-preview.1

.github/workflows/package_push_nuget.org.yml

@@ -0,0 +1,42 @@
+name: Package Push Nuget
+on:
+  release:
+    types: [ created ]
+
+jobs:
+  package-build:
+    name: packeg build and push
+    runs-on: ubuntu-latest
+    steps:
+    - name: git pull
+      uses: actions/checkout@v2
+
+    - name: run a one-line script
+      run: env
+
+    - name: setting dotnet version 
+      uses: actions/setup-dotnet@v1
+      with:
+        dotnet-version: '6.0.x'
+        include-prerelease: true
+    - name: dependencies
+    - run: git clone -b main https://github.com/masastack/MASA.BuildingBlocks.git ./src/BuildingBlocks
+
+    - name: restore
+      run: dotnet restore
+
+    - name: build
+      run: dotnet build --no-restore /p:ContinuousIntegrationBuild=true
+
+    - name: test
+      run: dotnet test --no-build --verbosity normal /p:CollectCoverage=true /p:CoverletOutputFormat=opencover /p:Exclude="[*.Tests]*"
+
+    - name: codecov
+      uses: codecov/codecov-action@v1
+
+    - name: pack
+      run: dotnet pack --include-symbols  -p:PackageVersion=$GITHUB_REF_NAME
+
+    - name: package push
+      run: dotnet nuget push "**/*.symbols.nupkg" -k  ${{secrets.NUGET_TOKEN}}  -s https://api.nuget.org/v3/index.json
+

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "src/BuildingBlocks/MASA.BuildingBlocks"]
+	path = src/BuildingBlocks/MASA.BuildingBlocks
+	url = https://github.com/masastack/MASA.BuildingBlocks.git

Directory.Build.props

@@ -0,0 +1,24 @@
+<Project>
+  <PropertyGroup>
+    <PackageId>$(AssemblyName)</PackageId>
+    <PackageIcon>packageIcon.png</PackageIcon>
+    <Authors>masastack</Authors>
+    <Copyright>© masastack Corporation. All rights reserved.</Copyright>
+    <PackageIconUrl>packageIcon.png</PackageIconUrl>
+    <RepositoryUrl>https://github.com/masastack/MASA.Contrib</RepositoryUrl>
+    <RepositoryType>git</RepositoryType>
+    <PublishRepositoryUrl>true</PublishRepositoryUrl>
+    <RepositoryRoot>$(MSBuildThisFileDirectory)</RepositoryRoot>
+    <PackageLicenseFile>LICENSE.txt</PackageLicenseFile>
+  </PropertyGroup>
+  <ItemGroup>
+    <None Include="$(RepositoryRoot)packageIcon.png">
+      <Pack>True</Pack>
+      <PackagePath></PackagePath>
+    </None>
+    <None Include="$(RepositoryRoot)LICENSE.txt">
+      <Pack>True</Pack>
+      <PackagePath></PackagePath>
+    </None>
+  </ItemGroup>
+</Project>

NuGet.Config

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<configuration>
+  <packageSources>
+    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" protocolVersion="3" />
+  </packageSources>
+</configuration>

README.md

@@ -1,32 +1,38 @@
 [中](README.zh-CN.md) | EN
 
+[![codecov](https://codecov.io/gh/masastack/MASA.Contrib/branch/develop/graph/badge.svg?token=87TPNHUHW2)](https://codecov.io/gh/masastack/MASA.Contrib)
+
 # MASA.Contrib
 
-MASA.Contrib is the best practice of MASA.BuildingBlocks
+The purpose of MASA.Contrib is based on [MASA.BuildingBlocks](https://github.com/masastack/MASA.BuildingBlocks) to provide open, community driven reusable components for building mesh applications.  These components will be used by the [MASA Stack](https://github.com/masastack) and [MASA Labs](https://github.com/masalabs) projects.
 
 ## Structure
 
 ```c#
 MASA.Contrib
-│──solution items
-│   ── nuget.config
-│──src
+├── solution items
+│   ├── nuget.config
+├── src
+│   ├── BasicAbility
+│   │   ├── MASA.Contrib.BasicAbility.Dcc                          ConfigurationAPI
+│   ├── Configuration
+│   │   ├── MASA.Contrib.Configuration
 │   ├── Data
-│   │   ├── MASA.Contrib.Data.Uow.EF                                         Unit of work
-│   │   └── MASA.Contribs.Data.Contracts.EF                                  Protocol EF version
+│   │   ├── MASA.Contrib.Data.UoW.EF                               Unit of work
+│   │   └── MASA.Contrib.Data.Contracts.EF                        Protocol EF version
 │   ├── DDD
-│   │   ├── MASA.Contribs.DDD.Domain                                         In-process and cross-process support
-│   │   └── MASA.Contribs.DDD.Domain.Repository.EF
+│   │   ├── MASA.Contrib.DDD.Domain                               In-process and cross-process support
+│   │   └── MASA.Contrib.DDD.Domain.Repository.EF
 │   ├── Dispatcher
-│   │   ├── MASA.Contrib.Dispatcher.Events									 In-process event
+│   │   ├── MASA.Contrib.Dispatcher.Events                         In-process event
 │   │   ├── MASA.Contrib.Dispatcher.IntegrationEvents.Dapr
-│   │   └── MASA.Contrib.Dispatcher.IntegrationEvents.EventLogs.EF			 Cross-process event
+│   │   └── MASA.Contrib.Dispatcher.IntegrationEvents.EventLogs.EF Cross-process event
 │   ├── ReadWriteSpliting
 │   │   └── CQRS
-│   │   │   └── MASA.Contrib.ReadWriteSpliting.CQRS							 CQRS
+│   │   │   └── MASA.Contrib.ReadWriteSpliting.CQRS                CQRS
 │   ├── Service
-│   │   └── MASA.Contrib.Service.MinimalAPIs								 Best practices for [MinimalAPI]
-│──test
+│   │   └── MASA.Contrib.Service.MinimalAPIs                       Best practices for [MinimalAPI]
+├── test
 │   ├── MASA.Contrib.Dispatcher.Events
 │   │   ├── MASA.Contrib.Dispatcher.Events.BenchmarkDotnetTest
 │   │   ├── MASA.Contrib.Dispatcher.Events.CheckMethodsParameter.Tests
@@ -36,25 +42,25 @@ MASA.Contrib
 │   │   ├── MASA.Contrib.Dispatcher.Events.OnlyCancelHandler.Tests
 │   │   ├── MASA.Contrib.Dispatcher.Events.CheckMethodsType.Tests
 │   │   ├── MASA.Contrib.Dispatcher.Events.Tests
-│   ├── MASA.Contrib.Data.Uow.EF.Tests
+│   ├── MASA.Contrib.Data.UoW.EF.Tests
 │   ├── MASA.Contrib.Dispatcher.IntegrationEvents.EventLogs.EF.Tests
-│   ├── MASA.Contribs.DDD.Domain.Tests
-│   ├── MASA.Contribs.DDD.Domain.Repository.EF.Tests
+│   ├── MASA.Contrib.DDD.Domain.Tests
+│   ├── MASA.Contrib.DDD.Domain.Repository.EF.Tests
 ```
 
 ## Feature
 
 ### 1. MinimalAPI
 
-What is [MinimalAPI](https://devblogs.microsoft.com/aspnet/asp-net-core-updates-in-net-6-preview-4/#introducing-minimal-apis)？[Usage introduction](http://gitlab-hz.lonsid.cn/MASA-Stack/Contribs/MASA.Contrib/-/tree/develop/src/Service/MASA.Contrib.Service.MinimalAPIs/README.md)
+What is [MinimalAPI](https://devblogs.microsoft.com/aspnet/asp-net-core-updates-in-net-6-preview-4/#introducing-minimal-apis)？[Usage introduction](/src/Service/MASA.Contrib.Service.MinimalAPIs/README.md)
 
 >  Advantage：
 >
 >  1.  Classify APIs and add them to different Services to make the Service structure clearer and get rid of running account programming
 
 ### 2. EventBus
 
-[Usage introduction](http://gitlab-hz.lonsid.cn/MASA-Stack/Contribs/MASA.Contrib/-/tree/develop/src/Dispatcher/MASA.Contrib.Dispatcher.Events/README.md)
+[Usage introduction](/src/Dispatcher/MASA.Contrib.Dispatcher.Events/README.md)
 
 > Advantage：
 >
@@ -73,22 +79,22 @@ What is [MinimalAPI](https://devblogs.microsoft.com/aspnet/asp-net-core-updates-
 
 ### 3. CQRS
 
-what is[CQRS](https://docs.microsoft.com/en-us/azure/architecture/patterns/cqrs)？[Usage introduction](http://gitlab-hz.lonsid.cn/MASA-Stack/Contribs/MASA.Contrib/-/tree/develop/src/ReadWriteSpliting/CQRS/MASA.Contrib.ReadWriteSpliting.CQRS/README.md)
+what is[CQRS](https://docs.microsoft.com/en-us/azure/architecture/patterns/cqrs)？[Usage introduction](/src/ReadWriteSpliting/CQRS/MASA.Contrib.ReadWriteSpliting.CQRS/README.md)
 
 ### 4. IntegrationEventBus
 
-Realize cross-process events based on Dapr。[Usage introduction](http://gitlab-hz.lonsid.cn/MASA-Stack/Contribs/MASA.Contrib/-/tree/develop/src/Dispatcher/MASA.Contrib.Dispatcher.IntegrationEvents.Dapr/README.md)
+Realize cross-process events based on Dapr。[Usage introduction](/src/Dispatcher/MASA.Contrib.Dispatcher.IntegrationEvents.Dapr/README.md)
 
 > Advantage：Use the same transaction to commit the user-defined context and the log to ensure atomicity and consistency
 
 ### 5. DomainEventBus
 
-[Usage introduction](http://gitlab-hz.lonsid.cn/MASA-Stack/Contribs/MASA.Contrib/-/tree/develop/src/DDD/MASA.Contribs.DDD.Domain/README.md)
+[Usage introduction](/src/DDD/MASA.Contrib.DDD.Domain/README.md)
 
 > Advantage：
 >
 > 1. CQRS
-> 2. Field Service
+> 2. Domain Service
 > 3. Support domain events (in-process), integrated domain events (cross-process)
 > 4. Support the unified sending of field events after being pushed onto the stack
 
@@ -99,35 +105,40 @@ Realize cross-process events based on Dapr。[Usage introduction](http://gitlab-
 
 ### 7. Contracts.EF
 
-Protocol based on EF implementation，[Usage introduction](http://gitlab-hz.lonsid.cn/MASA-Stack/Contribs/MASA.Contrib/-/tree/develop/Data/MASA.Contribs.Data.Contracts.EF/README.md)
+Protocol based on EF implementation，[Usage introduction](/Data/MASA.Contrib.Data.Contracts.EF/README.md)
 
 > Advantage：
 >
 > 1. Filter deleted information when querying
-> 2. Open transaction after query
-> 3. Soft delete
+> 2. Soft delete
 
 ```C#
-Install-Package MASA.Contribs.Data.Contracts.EF
+Install-Package MASA.Contrib.Data.Contracts.EF
 ```
 
 ```C#
-builder.Services
-    .AddUoW<CustomDbContext>(dbOptions =>
+builder.Services.AddEventBus(options => {
+    options.UseUoW<CustomDbContext>(dbOptions =>
     {
         dbOptions.UseSqlServer("server=localhost;uid=sa;pwd=P@ssw0rd;database=identity");
-        dbOptions.UseSoftDelete(builder.Services);//Start soft delete
-    })
+        dbOptions.UseSoftDelete(builder.Services);
+    });
+});
+
 ```
 
 > When the entity inherits ISoftware and is deleted, change the delete state to the modified state, and cooperate with the custom Remove operation to achieve soft deletion
 > Do not query the data marked as soft deleted when querying
 > When combined with EventBus, the transaction is opened after the first CUD, and the transaction rollback is supported when the entire Handler is abnormal.
 
+### 8. MASA.Contrib.Configuration
+
+Redefine Configuration, support the management of Local and ConfigurationAPI nodes, combine IOptions and IOptionsMonitor to complete configuration acquisition and configuration update subscription [Local Usage introduction](src/Configuration/MASA.Contrib.Configuration/README.md) 、[Dcc Usage introduction](src/BasicAbility/MASA.Contrib.BasicAbility.Dcc/README.md)
+
 ## Unit testing rules
 
 To ensure the reliability of the entire source code, the unit test coverage is at least 90%
 
 ## ☀️ License agreement
 
-[![MASA.Contrib](https://img.shields.io/badge/License-MIT-blue?style=flat-square)](http://gitlab-hz.lonsid.cn/MASA-Stack/Contribs/MASA.Contrib/-/tree/develop/LICENSE)
+[![MASA.Contrib](https://img.shields.io/badge/License-MIT-blue?style=flat-square)](/LICENSE.txt)