├── .gitattributes
├── .gitignore
├── LICENSE
├── README.md
├── Rabbit.Extensions.sln
├── build
├── common.props
└── version.props
├── samples
└── ConsoleApp
│ ├── ConsoleApp.csproj
│ ├── Program.cs
│ ├── UseCommandLineArgs.bat
│ ├── UseEnvironmentVariables.bat
│ └── appsettings.json
├── src
├── Configuration
│ ├── README.md
│ ├── Rabbit.Extensions.Configuration.Consul
│ │ ├── ConsulConfigurationExtensions.cs
│ │ ├── ConsulConfigurationProvider.cs
│ │ ├── ConsulConfigurationSource.cs
│ │ └── Rabbit.Extensions.Configuration.Consul.csproj
│ └── Rabbit.Extensions.Configuration
│ │ ├── Internal
│ │ ├── TemplateEntry.cs
│ │ └── TemplateRender.cs
│ │ ├── Rabbit.Extensions.Configuration.csproj
│ │ ├── TemplateRenderOptions.cs
│ │ ├── TemplateSupportExtensions.cs
│ │ ├── TemplateSupportOptions.cs
│ │ └── Utilities
│ │ └── TemplateUtil.cs
├── Rabbit.Extensions.Boot
│ ├── Microsoft.Extensions.Configuration
│ │ ├── ChainedBuilderExtensions.cs
│ │ ├── ChainedConfigurationProvider.cs
│ │ └── ChainedConfigurationSource.cs
│ ├── Microsoft.Extensions.Hosting.Abstractions
│ │ ├── BackgroundService.cs
│ │ ├── EnvironmentName.cs
│ │ ├── HostBuilderContext.cs
│ │ ├── HostDefaults.cs
│ │ ├── HostingAbstractionsHostBuilderExtensions.cs
│ │ ├── HostingAbstractionsHostExtensions.cs
│ │ ├── HostingEnvironmentExtensions.cs
│ │ ├── IApplicationLifetime.cs
│ │ ├── IHost.cs
│ │ ├── IHostBuilder.cs
│ │ ├── IHostLifetime.cs
│ │ ├── IHostedService.cs
│ │ ├── IHostingEnvironment.cs
│ │ └── baseline.netcore.json
│ ├── Microsoft.Extensions.Hosting
│ │ ├── ConsoleLifetimeOptions.cs
│ │ ├── HostBuilder.cs
│ │ ├── HostOptions.cs
│ │ ├── HostingHostBuilderExtensions.cs
│ │ └── Internal
│ │ │ ├── ApplicationLifetime.cs
│ │ │ ├── ConfigureContainerAdapter.cs
│ │ │ ├── ConsoleLifetime.cs
│ │ │ ├── Host.cs
│ │ │ ├── HostingEnvironment.cs
│ │ │ ├── HostingLoggerExtensions.cs
│ │ │ ├── IConfigureContainerAdapter.cs
│ │ │ ├── IServiceFactoryAdapter.cs
│ │ │ ├── LoggerEventIds.cs
│ │ │ ├── ProcessLifetime.cs
│ │ │ └── ServiceFactoryAdapter.cs
│ ├── Rabbit.Extensions.Boot.csproj
│ └── RabbitStarter.cs
└── Rabbit.Extensions.DependencyInjection
│ ├── Builder
│ ├── RabbitContainerBuilder.cs
│ ├── RabbitContainerBuilderExtensions.cs
│ ├── ServiceBuilder.cs
│ └── ServiceBuilderExtensions.cs
│ ├── IDependency.cs
│ ├── IServiceRegister.cs
│ ├── ISupportKeyedService.cs
│ ├── Internal
│ ├── RabbitServiceScopeFactory.cs
│ └── TypeKeyedUtilities.cs
│ ├── Rabbit.Extensions.DependencyInjection.csproj
│ ├── RabbitServiceDescriptor.cs
│ ├── RabbitServiceProvider.cs
│ ├── ServiceCollectionContainerBuilderExtensions.cs
│ ├── ServiceDependencyInjectionExtensions.cs
│ ├── ServiceDescriptorAttribute.cs
│ ├── ServiceProviderServiceExtensions.cs
│ ├── ServiceTypeMetadata.cs
│ └── ServiceTypeMetadataExtensions.cs
└── test
├── Configuration
└── Rabbit.Extensions.Configuration.Test
│ ├── Rabbit.Extensions.Configuration.Test.csproj
│ └── TemplateSupportTest.cs
└── Rabbit.Extensions.DependencyInjection.Test
├── DependencyInjectionTest.cs
└── Rabbit.Extensions.DependencyInjection.Test.csproj
/.gitattributes:
--------------------------------------------------------------------------------
1 | ###############################################################################
2 | # Set default behavior to automatically normalize line endings.
3 | ###############################################################################
4 | * text=auto
5 |
6 | ###############################################################################
7 | # Set default behavior for command prompt diff.
8 | #
9 | # This is need for earlier builds of msysgit that does not have it on by
10 | # default for csharp files.
11 | # Note: This is only used by command line
12 | ###############################################################################
13 | #*.cs diff=csharp
14 |
15 | ###############################################################################
16 | # Set the merge driver for project and solution files
17 | #
18 | # Merging from the command prompt will add diff markers to the files if there
19 | # are conflicts (Merging from VS is not affected by the settings below, in VS
20 | # the diff markers are never inserted). Diff markers may cause the following
21 | # file extensions to fail to load in VS. An alternative would be to treat
22 | # these files as binary and thus will always conflict and require user
23 | # intervention with every merge. To do so, just uncomment the entries below
24 | ###############################################################################
25 | #*.sln merge=binary
26 | #*.csproj merge=binary
27 | #*.vbproj merge=binary
28 | #*.vcxproj merge=binary
29 | #*.vcproj merge=binary
30 | #*.dbproj merge=binary
31 | #*.fsproj merge=binary
32 | #*.lsproj merge=binary
33 | #*.wixproj merge=binary
34 | #*.modelproj merge=binary
35 | #*.sqlproj merge=binary
36 | #*.wwaproj merge=binary
37 |
38 | ###############################################################################
39 | # behavior for image files
40 | #
41 | # image files are treated as binary by default.
42 | ###############################################################################
43 | #*.jpg binary
44 | #*.png binary
45 | #*.gif binary
46 |
47 | ###############################################################################
48 | # diff behavior for common document formats
49 | #
50 | # Convert binary document formats to text before diffing them. This feature
51 | # is only available from the command line. Turn it on by uncommenting the
52 | # entries below.
53 | ###############################################################################
54 | #*.doc diff=astextplain
55 | #*.DOC diff=astextplain
56 | #*.docx diff=astextplain
57 | #*.DOCX diff=astextplain
58 | #*.dot diff=astextplain
59 | #*.DOT diff=astextplain
60 | #*.pdf diff=astextplain
61 | #*.PDF diff=astextplain
62 | #*.rtf diff=astextplain
63 | #*.RTF diff=astextplain
64 |
--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
1 | ## Ignore Visual Studio temporary files, build results, and
2 | ## files generated by popular Visual Studio add-ons.
3 | ##
4 | ## Get latest from https://github.com/github/gitignore/blob/master/VisualStudio.gitignore
5 |
6 | # User-specific files
7 | *.suo
8 | *.user
9 | *.userosscache
10 | *.sln.docstates
11 |
12 | # User-specific files (MonoDevelop/Xamarin Studio)
13 | *.userprefs
14 |
15 | # Build results
16 | [Dd]ebug/
17 | [Dd]ebugPublic/
18 | [Rr]elease/
19 | [Rr]eleases/
20 | x64/
21 | x86/
22 | bld/
23 | [Bb]in/
24 | [Oo]bj/
25 | [Ll]og/
26 |
27 | # Visual Studio 2015 cache/options directory
28 | .vs/
29 | # Uncomment if you have tasks that create the project's static files in wwwroot
30 | #wwwroot/
31 |
32 | # MSTest test Results
33 | [Tt]est[Rr]esult*/
34 | [Bb]uild[Ll]og.*
35 |
36 | # NUNIT
37 | *.VisualState.xml
38 | TestResult.xml
39 |
40 | # Build Results of an ATL Project
41 | [Dd]ebugPS/
42 | [Rr]eleasePS/
43 | dlldata.c
44 |
45 | # .NET Core
46 | project.lock.json
47 | project.fragment.lock.json
48 | artifacts/
49 | **/Properties/launchSettings.json
50 |
51 | *_i.c
52 | *_p.c
53 | *_i.h
54 | *.ilk
55 | *.meta
56 | *.obj
57 | *.pch
58 | *.pdb
59 | *.pgc
60 | *.pgd
61 | *.rsp
62 | *.sbr
63 | *.tlb
64 | *.tli
65 | *.tlh
66 | *.tmp
67 | *.tmp_proj
68 | *.log
69 | *.vspscc
70 | *.vssscc
71 | .builds
72 | *.pidb
73 | *.svclog
74 | *.scc
75 |
76 | # Chutzpah Test files
77 | _Chutzpah*
78 |
79 | # Visual C++ cache files
80 | ipch/
81 | *.aps
82 | *.ncb
83 | *.opendb
84 | *.opensdf
85 | *.sdf
86 | *.cachefile
87 | *.VC.db
88 | *.VC.VC.opendb
89 |
90 | # Visual Studio profiler
91 | *.psess
92 | *.vsp
93 | *.vspx
94 | *.sap
95 |
96 | # TFS 2012 Local Workspace
97 | $tf/
98 |
99 | # Guidance Automation Toolkit
100 | *.gpState
101 |
102 | # ReSharper is a .NET coding add-in
103 | _ReSharper*/
104 | *.[Rr]e[Ss]harper
105 | *.DotSettings.user
106 |
107 | # JustCode is a .NET coding add-in
108 | .JustCode
109 |
110 | # TeamCity is a build add-in
111 | _TeamCity*
112 |
113 | # DotCover is a Code Coverage Tool
114 | *.dotCover
115 |
116 | # Visual Studio code coverage results
117 | *.coverage
118 | *.coveragexml
119 |
120 | # NCrunch
121 | _NCrunch_*
122 | .*crunch*.local.xml
123 | nCrunchTemp_*
124 |
125 | # MightyMoose
126 | *.mm.*
127 | AutoTest.Net/
128 |
129 | # Web workbench (sass)
130 | .sass-cache/
131 |
132 | # Installshield output folder
133 | [Ee]xpress/
134 |
135 | # DocProject is a documentation generator add-in
136 | DocProject/buildhelp/
137 | DocProject/Help/*.HxT
138 | DocProject/Help/*.HxC
139 | DocProject/Help/*.hhc
140 | DocProject/Help/*.hhk
141 | DocProject/Help/*.hhp
142 | DocProject/Help/Html2
143 | DocProject/Help/html
144 |
145 | # Click-Once directory
146 | publish/
147 |
148 | # Publish Web Output
149 | *.[Pp]ublish.xml
150 | *.azurePubxml
151 | # TODO: Comment the next line if you want to checkin your web deploy settings
152 | # but database connection strings (with potential passwords) will be unencrypted
153 | *.pubxml
154 | *.publishproj
155 |
156 | # Microsoft Azure Web App publish settings. Comment the next line if you want to
157 | # checkin your Azure Web App publish settings, but sensitive information contained
158 | # in these scripts will be unencrypted
159 | PublishScripts/
160 |
161 | # NuGet Packages
162 | *.nupkg
163 | # The packages folder can be ignored because of Package Restore
164 | **/packages/*
165 | # except build/, which is used as an MSBuild target.
166 | !**/packages/build/
167 | # Uncomment if necessary however generally it will be regenerated when needed
168 | #!**/packages/repositories.config
169 | # NuGet v3's project.json files produces more ignorable files
170 | *.nuget.props
171 | *.nuget.targets
172 |
173 | # Microsoft Azure Build Output
174 | csx/
175 | *.build.csdef
176 |
177 | # Microsoft Azure Emulator
178 | ecf/
179 | rcf/
180 |
181 | # Windows Store app package directories and files
182 | AppPackages/
183 | BundleArtifacts/
184 | Package.StoreAssociation.xml
185 | _pkginfo.txt
186 |
187 | # Visual Studio cache files
188 | # files ending in .cache can be ignored
189 | *.[Cc]ache
190 | # but keep track of directories ending in .cache
191 | !*.[Cc]ache/
192 |
193 | # Others
194 | ClientBin/
195 | ~$*
196 | *~
197 | *.dbmdl
198 | *.dbproj.schemaview
199 | *.jfm
200 | *.pfx
201 | *.publishsettings
202 | orleans.codegen.cs
203 |
204 | # Since there are multiple workflows, uncomment next line to ignore bower_components
205 | # (https://github.com/github/gitignore/pull/1529#issuecomment-104372622)
206 | #bower_components/
207 |
208 | # RIA/Silverlight projects
209 | Generated_Code/
210 |
211 | # Backup & report files from converting an old project file
212 | # to a newer Visual Studio version. Backup files are not needed,
213 | # because we have git ;-)
214 | _UpgradeReport_Files/
215 | Backup*/
216 | UpgradeLog*.XML
217 | UpgradeLog*.htm
218 |
219 | # SQL Server files
220 | *.mdf
221 | *.ldf
222 | *.ndf
223 |
224 | # Business Intelligence projects
225 | *.rdl.data
226 | *.bim.layout
227 | *.bim_*.settings
228 |
229 | # Microsoft Fakes
230 | FakesAssemblies/
231 |
232 | # GhostDoc plugin setting file
233 | *.GhostDoc.xml
234 |
235 | # Node.js Tools for Visual Studio
236 | .ntvs_analysis.dat
237 | node_modules/
238 |
239 | # Typescript v1 declaration files
240 | typings/
241 |
242 | # Visual Studio 6 build log
243 | *.plg
244 |
245 | # Visual Studio 6 workspace options file
246 | *.opt
247 |
248 | # Visual Studio 6 auto-generated workspace file (contains which files were open etc.)
249 | *.vbw
250 |
251 | # Visual Studio LightSwitch build output
252 | **/*.HTMLClient/GeneratedArtifacts
253 | **/*.DesktopClient/GeneratedArtifacts
254 | **/*.DesktopClient/ModelManifest.xml
255 | **/*.Server/GeneratedArtifacts
256 | **/*.Server/ModelManifest.xml
257 | _Pvt_Extensions
258 |
259 | # Paket dependency manager
260 | .paket/paket.exe
261 | paket-files/
262 |
263 | # FAKE - F# Make
264 | .fake/
265 |
266 | # JetBrains Rider
267 | .idea/
268 | *.sln.iml
269 |
270 | # CodeRush
271 | .cr/
272 |
273 | # Python Tools for Visual Studio (PTVS)
274 | __pycache__/
275 | *.pyc
276 |
277 | # Cake - Uncomment if you are using it
278 | # tools/**
279 | # !tools/packages.config
280 |
281 | # Telerik's JustMock configuration file
282 | *.jmconfig
283 |
284 | # BizTalk build output
285 | *.btp.cs
286 | *.btm.cs
287 | *.odx.cs
288 | *.xsd.cs
289 |
--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
1 | Apache License
2 | Version 2.0, January 2004
3 | http://www.apache.org/licenses/
4 |
5 | TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
6 |
7 | 1. Definitions.
8 |
9 | "License" shall mean the terms and conditions for use, reproduction,
10 | and distribution as defined by Sections 1 through 9 of this document.
11 |
12 | "Licensor" shall mean the copyright owner or entity authorized by
13 | the copyright owner that is granting the License.
14 |
15 | "Legal Entity" shall mean the union of the acting entity and all
16 | other entities that control, are controlled by, or are under common
17 | control with that entity. For the purposes of this definition,
18 | "control" means (i) the power, direct or indirect, to cause the
19 | direction or management of such entity, whether by contract or
20 | otherwise, or (ii) ownership of fifty percent (50%) or more of the
21 | outstanding shares, or (iii) beneficial ownership of such entity.
22 |
23 | "You" (or "Your") shall mean an individual or Legal Entity
24 | exercising permissions granted by this License.
25 |
26 | "Source" form shall mean the preferred form for making modifications,
27 | including but not limited to software source code, documentation
28 | source, and configuration files.
29 |
30 | "Object" form shall mean any form resulting from mechanical
31 | transformation or translation of a Source form, including but
32 | not limited to compiled object code, generated documentation,
33 | and conversions to other media types.
34 |
35 | "Work" shall mean the work of authorship, whether in Source or
36 | Object form, made available under the License, as indicated by a
37 | copyright notice that is included in or attached to the work
38 | (an example is provided in the Appendix below).
39 |
40 | "Derivative Works" shall mean any work, whether in Source or Object
41 | form, that is based on (or derived from) the Work and for which the
42 | editorial revisions, annotations, elaborations, or other modifications
43 | represent, as a whole, an original work of authorship. For the purposes
44 | of this License, Derivative Works shall not include works that remain
45 | separable from, or merely link (or bind by name) to the interfaces of,
46 | the Work and Derivative Works thereof.
47 |
48 | "Contribution" shall mean any work of authorship, including
49 | the original version of the Work and any modifications or additions
50 | to that Work or Derivative Works thereof, that is intentionally
51 | submitted to Licensor for inclusion in the Work by the copyright owner
52 | or by an individual or Legal Entity authorized to submit on behalf of
53 | the copyright owner. For the purposes of this definition, "submitted"
54 | means any form of electronic, verbal, or written communication sent
55 | to the Licensor or its representatives, including but not limited to
56 | communication on electronic mailing lists, source code control systems,
57 | and issue tracking systems that are managed by, or on behalf of, the
58 | Licensor for the purpose of discussing and improving the Work, but
59 | excluding communication that is conspicuously marked or otherwise
60 | designated in writing by the copyright owner as "Not a Contribution."
61 |
62 | "Contributor" shall mean Licensor and any individual or Legal Entity
63 | on behalf of whom a Contribution has been received by Licensor and
64 | subsequently incorporated within the Work.
65 |
66 | 2. Grant of Copyright License. Subject to the terms and conditions of
67 | this License, each Contributor hereby grants to You a perpetual,
68 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable
69 | copyright license to reproduce, prepare Derivative Works of,
70 | publicly display, publicly perform, sublicense, and distribute the
71 | Work and such Derivative Works in Source or Object form.
72 |
73 | 3. Grant of Patent License. Subject to the terms and conditions of
74 | this License, each Contributor hereby grants to You a perpetual,
75 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable
76 | (except as stated in this section) patent license to make, have made,
77 | use, offer to sell, sell, import, and otherwise transfer the Work,
78 | where such license applies only to those patent claims licensable
79 | by such Contributor that are necessarily infringed by their
80 | Contribution(s) alone or by combination of their Contribution(s)
81 | with the Work to which such Contribution(s) was submitted. If You
82 | institute patent litigation against any entity (including a
83 | cross-claim or counterclaim in a lawsuit) alleging that the Work
84 | or a Contribution incorporated within the Work constitutes direct
85 | or contributory patent infringement, then any patent licenses
86 | granted to You under this License for that Work shall terminate
87 | as of the date such litigation is filed.
88 |
89 | 4. Redistribution. You may reproduce and distribute copies of the
90 | Work or Derivative Works thereof in any medium, with or without
91 | modifications, and in Source or Object form, provided that You
92 | meet the following conditions:
93 |
94 | (a) You must give any other recipients of the Work or
95 | Derivative Works a copy of this License; and
96 |
97 | (b) You must cause any modified files to carry prominent notices
98 | stating that You changed the files; and
99 |
100 | (c) You must retain, in the Source form of any Derivative Works
101 | that You distribute, all copyright, patent, trademark, and
102 | attribution notices from the Source form of the Work,
103 | excluding those notices that do not pertain to any part of
104 | the Derivative Works; and
105 |
106 | (d) If the Work includes a "NOTICE" text file as part of its
107 | distribution, then any Derivative Works that You distribute must
108 | include a readable copy of the attribution notices contained
109 | within such NOTICE file, excluding those notices that do not
110 | pertain to any part of the Derivative Works, in at least one
111 | of the following places: within a NOTICE text file distributed
112 | as part of the Derivative Works; within the Source form or
113 | documentation, if provided along with the Derivative Works; or,
114 | within a display generated by the Derivative Works, if and
115 | wherever such third-party notices normally appear. The contents
116 | of the NOTICE file are for informational purposes only and
117 | do not modify the License. You may add Your own attribution
118 | notices within Derivative Works that You distribute, alongside
119 | or as an addendum to the NOTICE text from the Work, provided
120 | that such additional attribution notices cannot be construed
121 | as modifying the License.
122 |
123 | You may add Your own copyright statement to Your modifications and
124 | may provide additional or different license terms and conditions
125 | for use, reproduction, or distribution of Your modifications, or
126 | for any such Derivative Works as a whole, provided Your use,
127 | reproduction, and distribution of the Work otherwise complies with
128 | the conditions stated in this License.
129 |
130 | 5. Submission of Contributions. Unless You explicitly state otherwise,
131 | any Contribution intentionally submitted for inclusion in the Work
132 | by You to the Licensor shall be under the terms and conditions of
133 | this License, without any additional terms or conditions.
134 | Notwithstanding the above, nothing herein shall supersede or modify
135 | the terms of any separate license agreement you may have executed
136 | with Licensor regarding such Contributions.
137 |
138 | 6. Trademarks. This License does not grant permission to use the trade
139 | names, trademarks, service marks, or product names of the Licensor,
140 | except as required for reasonable and customary use in describing the
141 | origin of the Work and reproducing the content of the NOTICE file.
142 |
143 | 7. Disclaimer of Warranty. Unless required by applicable law or
144 | agreed to in writing, Licensor provides the Work (and each
145 | Contributor provides its Contributions) on an "AS IS" BASIS,
146 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
147 | implied, including, without limitation, any warranties or conditions
148 | of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
149 | PARTICULAR PURPOSE. You are solely responsible for determining the
150 | appropriateness of using or redistributing the Work and assume any
151 | risks associated with Your exercise of permissions under this License.
152 |
153 | 8. Limitation of Liability. In no event and under no legal theory,
154 | whether in tort (including negligence), contract, or otherwise,
155 | unless required by applicable law (such as deliberate and grossly
156 | negligent acts) or agreed to in writing, shall any Contributor be
157 | liable to You for damages, including any direct, indirect, special,
158 | incidental, or consequential damages of any character arising as a
159 | result of this License or out of the use or inability to use the
160 | Work (including but not limited to damages for loss of goodwill,
161 | work stoppage, computer failure or malfunction, or any and all
162 | other commercial damages or losses), even if such Contributor
163 | has been advised of the possibility of such damages.
164 |
165 | 9. Accepting Warranty or Additional Liability. While redistributing
166 | the Work or Derivative Works thereof, You may choose to offer,
167 | and charge a fee for, acceptance of support, warranty, indemnity,
168 | or other liability obligations and/or rights consistent with this
169 | License. However, in accepting such obligations, You may act only
170 | on Your own behalf and on Your sole responsibility, not on behalf
171 | of any other Contributor, and only if You agree to indemnify,
172 | defend, and hold each Contributor harmless for any liability
173 | incurred by, or claims asserted against, such Contributor by reason
174 | of your accepting any such warranty or additional liability.
175 |
176 | END OF TERMS AND CONDITIONS
177 |
178 | APPENDIX: How to apply the Apache License to your work.
179 |
180 | To apply the Apache License to your work, attach the following
181 | boilerplate notice, with the fields enclosed by brackets "{}"
182 | replaced with your own identifying information. (Don't include
183 | the brackets!) The text should be enclosed in the appropriate
184 | comment syntax for the file format. We also recommend that a
185 | file or class name and description of purpose be included on the
186 | same "printed page" as the copyright notice for easier
187 | identification within third-party archives.
188 |
189 | Copyright {yyyy} {name of copyright owner}
190 |
191 | Licensed under the Apache License, Version 2.0 (the "License");
192 | you may not use this file except in compliance with the License.
193 | You may obtain a copy of the License at
194 |
195 | http://www.apache.org/licenses/LICENSE-2.0
196 |
197 | Unless required by applicable law or agreed to in writing, software
198 | distributed under the License is distributed on an "AS IS" BASIS,
199 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
200 | See the License for the specific language governing permissions and
201 | limitations under the License.
202 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | # Extensions to .NET Core
2 | ## Configuration
3 | 1.Template Support
4 | 2.Consul Provider
5 | __[understand more](https://github.com/RabbitTeam/Rabbit-Extensions/tree/master/src/Configuration)__
6 |
--------------------------------------------------------------------------------
/Rabbit.Extensions.sln:
--------------------------------------------------------------------------------
1 |
2 | Microsoft Visual Studio Solution File, Format Version 12.00
3 | # Visual Studio 15
4 | VisualStudioVersion = 15.0.27130.0
5 | MinimumVisualStudioVersion = 10.0.40219.1
6 | Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Rabbit.Extensions.Configuration", "src\Configuration\Rabbit.Extensions.Configuration\Rabbit.Extensions.Configuration.csproj", "{6934D8D2-6993-4E8C-A118-8EDAFC8C6709}"
7 | EndProject
8 | Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Rabbit.Extensions.Configuration.Consul", "src\Configuration\Rabbit.Extensions.Configuration.Consul\Rabbit.Extensions.Configuration.Consul.csproj", "{81DB7700-4A63-45CB-8FC3-AD444689138B}"
9 | EndProject
10 | Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "src", "src", "{D4FCD154-5BBF-4996-AD71-CE87C5698F7E}"
11 | EndProject
12 | Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "test", "test", "{0FDEAFEB-7926-4A63-BC38-F6BC223CBADD}"
13 | EndProject
14 | Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{9147F8C9-9957-42CB-B854-C2E1010E7DFE}"
15 | ProjectSection(SolutionItems) = preProject
16 | build\common.props = build\common.props
17 | build\version.props = build\version.props
18 | EndProjectSection
19 | EndProject
20 | Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Configuration", "Configuration", "{765A2DE5-FC74-43A4-9A6D-3FC7BA467C2F}"
21 | EndProject
22 | Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Configuration", "Configuration", "{AAC81674-3B5C-4041-ABD0-2F37BCE69089}"
23 | EndProject
24 | Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Rabbit.Extensions.Configuration.Test", "test\Configuration\Rabbit.Extensions.Configuration.Test\Rabbit.Extensions.Configuration.Test.csproj", "{A023902F-6BEF-4DB9-A389-2CA4FB209F12}"
25 | EndProject
26 | Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "samples", "samples", "{76380790-B349-4C9F-868B-39F81582A114}"
27 | EndProject
28 | Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "ConsoleApp", "samples\ConsoleApp\ConsoleApp.csproj", "{89D4DDA4-5A85-4EC8-9D11-BBE20C9523C0}"
29 | EndProject
30 | Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Rabbit.Extensions.DependencyInjection", "src\Rabbit.Extensions.DependencyInjection\Rabbit.Extensions.DependencyInjection.csproj", "{3E5858AD-00F8-4AB6-ADFA-7EB55BFEA695}"
31 | EndProject
32 | Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Rabbit.Extensions.DependencyInjection.Test", "test\Rabbit.Extensions.DependencyInjection.Test\Rabbit.Extensions.DependencyInjection.Test.csproj", "{9E225D0C-5B7E-4FEA-8A07-D3B4FDB1BD8D}"
33 | EndProject
34 | Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Rabbit.Extensions.Boot", "src\Rabbit.Extensions.Boot\Rabbit.Extensions.Boot.csproj", "{A02F6865-8AFA-4493-9DA8-63A257274601}"
35 | EndProject
36 | Global
37 | GlobalSection(SolutionConfigurationPlatforms) = preSolution
38 | Debug|Any CPU = Debug|Any CPU
39 | Release|Any CPU = Release|Any CPU
40 | EndGlobalSection
41 | GlobalSection(ProjectConfigurationPlatforms) = postSolution
42 | {6934D8D2-6993-4E8C-A118-8EDAFC8C6709}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
43 | {6934D8D2-6993-4E8C-A118-8EDAFC8C6709}.Debug|Any CPU.Build.0 = Debug|Any CPU
44 | {6934D8D2-6993-4E8C-A118-8EDAFC8C6709}.Release|Any CPU.ActiveCfg = Release|Any CPU
45 | {6934D8D2-6993-4E8C-A118-8EDAFC8C6709}.Release|Any CPU.Build.0 = Release|Any CPU
46 | {81DB7700-4A63-45CB-8FC3-AD444689138B}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
47 | {81DB7700-4A63-45CB-8FC3-AD444689138B}.Debug|Any CPU.Build.0 = Debug|Any CPU
48 | {81DB7700-4A63-45CB-8FC3-AD444689138B}.Release|Any CPU.ActiveCfg = Release|Any CPU
49 | {81DB7700-4A63-45CB-8FC3-AD444689138B}.Release|Any CPU.Build.0 = Release|Any CPU
50 | {A023902F-6BEF-4DB9-A389-2CA4FB209F12}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
51 | {A023902F-6BEF-4DB9-A389-2CA4FB209F12}.Debug|Any CPU.Build.0 = Debug|Any CPU
52 | {A023902F-6BEF-4DB9-A389-2CA4FB209F12}.Release|Any CPU.ActiveCfg = Release|Any CPU
53 | {A023902F-6BEF-4DB9-A389-2CA4FB209F12}.Release|Any CPU.Build.0 = Release|Any CPU
54 | {89D4DDA4-5A85-4EC8-9D11-BBE20C9523C0}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
55 | {89D4DDA4-5A85-4EC8-9D11-BBE20C9523C0}.Debug|Any CPU.Build.0 = Debug|Any CPU
56 | {89D4DDA4-5A85-4EC8-9D11-BBE20C9523C0}.Release|Any CPU.ActiveCfg = Release|Any CPU
57 | {89D4DDA4-5A85-4EC8-9D11-BBE20C9523C0}.Release|Any CPU.Build.0 = Release|Any CPU
58 | {3E5858AD-00F8-4AB6-ADFA-7EB55BFEA695}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
59 | {3E5858AD-00F8-4AB6-ADFA-7EB55BFEA695}.Debug|Any CPU.Build.0 = Debug|Any CPU
60 | {3E5858AD-00F8-4AB6-ADFA-7EB55BFEA695}.Release|Any CPU.ActiveCfg = Release|Any CPU
61 | {3E5858AD-00F8-4AB6-ADFA-7EB55BFEA695}.Release|Any CPU.Build.0 = Release|Any CPU
62 | {9E225D0C-5B7E-4FEA-8A07-D3B4FDB1BD8D}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
63 | {9E225D0C-5B7E-4FEA-8A07-D3B4FDB1BD8D}.Debug|Any CPU.Build.0 = Debug|Any CPU
64 | {9E225D0C-5B7E-4FEA-8A07-D3B4FDB1BD8D}.Release|Any CPU.ActiveCfg = Release|Any CPU
65 | {9E225D0C-5B7E-4FEA-8A07-D3B4FDB1BD8D}.Release|Any CPU.Build.0 = Release|Any CPU
66 | {A02F6865-8AFA-4493-9DA8-63A257274601}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
67 | {A02F6865-8AFA-4493-9DA8-63A257274601}.Debug|Any CPU.Build.0 = Debug|Any CPU
68 | {A02F6865-8AFA-4493-9DA8-63A257274601}.Release|Any CPU.ActiveCfg = Release|Any CPU
69 | {A02F6865-8AFA-4493-9DA8-63A257274601}.Release|Any CPU.Build.0 = Release|Any CPU
70 | {3ADD4E05-2792-4392-A927-5F1C3D4011B2}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
71 | {3ADD4E05-2792-4392-A927-5F1C3D4011B2}.Debug|Any CPU.Build.0 = Debug|Any CPU
72 | {3ADD4E05-2792-4392-A927-5F1C3D4011B2}.Release|Any CPU.ActiveCfg = Release|Any CPU
73 | {3ADD4E05-2792-4392-A927-5F1C3D4011B2}.Release|Any CPU.Build.0 = Release|Any CPU
74 | EndGlobalSection
75 | GlobalSection(SolutionProperties) = preSolution
76 | HideSolutionNode = FALSE
77 | EndGlobalSection
78 | GlobalSection(NestedProjects) = preSolution
79 | {6934D8D2-6993-4E8C-A118-8EDAFC8C6709} = {765A2DE5-FC74-43A4-9A6D-3FC7BA467C2F}
80 | {81DB7700-4A63-45CB-8FC3-AD444689138B} = {765A2DE5-FC74-43A4-9A6D-3FC7BA467C2F}
81 | {765A2DE5-FC74-43A4-9A6D-3FC7BA467C2F} = {D4FCD154-5BBF-4996-AD71-CE87C5698F7E}
82 | {AAC81674-3B5C-4041-ABD0-2F37BCE69089} = {0FDEAFEB-7926-4A63-BC38-F6BC223CBADD}
83 | {A023902F-6BEF-4DB9-A389-2CA4FB209F12} = {AAC81674-3B5C-4041-ABD0-2F37BCE69089}
84 | {89D4DDA4-5A85-4EC8-9D11-BBE20C9523C0} = {76380790-B349-4C9F-868B-39F81582A114}
85 | {3E5858AD-00F8-4AB6-ADFA-7EB55BFEA695} = {D4FCD154-5BBF-4996-AD71-CE87C5698F7E}
86 | {9E225D0C-5B7E-4FEA-8A07-D3B4FDB1BD8D} = {0FDEAFEB-7926-4A63-BC38-F6BC223CBADD}
87 | {A02F6865-8AFA-4493-9DA8-63A257274601} = {D4FCD154-5BBF-4996-AD71-CE87C5698F7E}
88 | {3ADD4E05-2792-4392-A927-5F1C3D4011B2} = {D4FCD154-5BBF-4996-AD71-CE87C5698F7E}
89 | EndGlobalSection
90 | GlobalSection(ExtensibilityGlobals) = postSolution
91 | SolutionGuid = {7F196E64-EAAA-41FC-8420-C6112B2060AF}
92 | EndGlobalSection
93 | EndGlobal
94 |
--------------------------------------------------------------------------------
/build/common.props:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 | $([System.IO.Path]::GetDirectoryName('$(MSBuildProjectDirectory)'))
6 | $([System.IO.Path]::GetFileName('$(ProjectParentDirectory)'))
7 |
8 |
9 |
10 | $(NoWarn);CS1591
11 |
12 |
13 |
14 | Rabbit Extensions
15 | https://github.com/RabbitTeam/Rabbit-Extensions
16 | git
17 | An extension library for .NET Core.
18 | Copyright (c) 2017 RabbitTeam. All rights reserved.
19 | majian
20 | true
21 |
22 | http://www.rabbithub.com/icon.png
23 | https://github.com/RabbitTeam/Rabbit-Extensions
24 | http://www.apache.org/licenses/LICENSE-2.0
25 |
26 |
--------------------------------------------------------------------------------
/build/version.props:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | 1.0.0
5 | preview5
6 |
7 |
--------------------------------------------------------------------------------
/samples/ConsoleApp/ConsoleApp.csproj:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | Exe
5 | netcoreapp2.0
6 |
7 |
8 |
9 |
10 |
11 |
12 |
13 |
14 |
15 |
16 |
17 |
18 |
19 |
20 | PreserveNewest
21 |
22 |
23 | Never
24 |
25 |
26 | Never
27 |
28 |
29 |
30 |
31 |
--------------------------------------------------------------------------------
/samples/ConsoleApp/Program.cs:
--------------------------------------------------------------------------------
1 | using Microsoft.Extensions.Configuration;
2 | using Rabbit.Extensions.Configuration;
3 | using System;
4 |
5 | namespace ConsoleApp
6 | {
7 | internal class Program
8 | {
9 | private static void Main(string[] args)
10 | {
11 | var configuration = new ConfigurationBuilder()
12 | .AddJsonFile("appsettings.json")
13 | .AddEnvironmentVariables()
14 | .AddCommandLine(args)
15 | .Build()
16 | .EnableTemplateSupport();
17 |
18 | foreach (var section in configuration.GetSection("ServiceUrls").GetChildren())
19 | {
20 | Console.WriteLine(section.Value);
21 | }
22 | }
23 | }
24 | }
--------------------------------------------------------------------------------
/samples/ConsoleApp/UseCommandLineArgs.bat:
--------------------------------------------------------------------------------
1 | dotnet run --ServiceHost=localhost
2 | pause
--------------------------------------------------------------------------------
/samples/ConsoleApp/UseEnvironmentVariables.bat:
--------------------------------------------------------------------------------
1 | SET ServiceHost=localhost
2 | SET ServicePort=8080
3 | dotnet run
4 | pause
--------------------------------------------------------------------------------
/samples/ConsoleApp/appsettings.json:
--------------------------------------------------------------------------------
1 | {
2 | "ServicePort": 80,
3 | "Global": {
4 | "PathBase": "/api"
5 | },
6 | "ServiceUrls": {
7 | "UserServiceUrl": "http://${ServiceHost}:${ServicePort}${Global:PathBase}/User",
8 | "AccountServiceUrl": "http://${ServiceHost}:${ServicePort}${Global:PathBase}/Account"
9 | }
10 | }
--------------------------------------------------------------------------------
/src/Configuration/README.md:
--------------------------------------------------------------------------------
1 | # 配置文件模板支持
2 | ## 之前,我是这样的
3 | 
4 |
5 | 因为公司ip和家里机器的ip不一致,所以经常需要切换配置文件。
6 |
7 | 但根据这份配置文件,我更改健康检查的主机和端口就意味着我得改三个地方,然而一般情况下这三个地方都是一致的,如果这时候我能定义一个变量“ServiceHost”,然后这三个地方使用这个变量就好了。
8 | ## 现在,我是这样的
9 | 
10 |
11 | 如果有变更需要只需改动几个变量值就可以了,不需要在满屏的配置文件里面去查看、搜索替换了。
12 | ## 配置信息变更重新渲染
13 | 当配置文件变更,进行Reload时,模板会自动进行重新渲染,不用担心渲染之后配置监控不可用的问题。
14 | ## Samples
15 | 配置文件如下:
16 | 
17 | 代码如下:
18 | 
19 | 效果1(dotnet run):
20 | 
21 | 效果2(dotnet run --ServiceHost=localhost):
22 | 
23 | 效果3(dotnet run --ServiceHost=localhost --ServicePort=5000):
24 | 
25 | # 基于 Consul 的 Configuration Provider
26 |
--------------------------------------------------------------------------------
/src/Configuration/Rabbit.Extensions.Configuration.Consul/ConsulConfigurationExtensions.cs:
--------------------------------------------------------------------------------
1 | using Consul;
2 | using Microsoft.Extensions.Configuration;
3 | using System;
4 |
5 | namespace Rabbit.Extensions.Configuration.Consul
6 | {
7 | public static class ConsulConfigurationExtensions
8 | {
9 | public static IConfigurationBuilder AddConsul(this IConfigurationBuilder builder, string url, string path = "/", string datacenter = null)
10 | {
11 | return builder.AddConsul(new Uri(url), path, datacenter);
12 | }
13 |
14 | public static IConfigurationBuilder AddConsul(this IConfigurationBuilder builder, Uri address, string path = "/", string datacenter = null)
15 | {
16 | return builder.AddConsul(c =>
17 | {
18 | c.Address = address;
19 | c.Datacenter = datacenter;
20 | }, s =>
21 | {
22 | s.Path = path;
23 | });
24 | }
25 |
26 | public static IConfigurationBuilder AddConsul(this IConfigurationBuilder builder, ConsulClient consulClient, string path = "/")
27 | {
28 | return builder.AddConsul(s =>
29 | {
30 | s.ConsulClient = consulClient;
31 | });
32 | }
33 |
34 | public static IConfigurationBuilder AddConsul(this IConfigurationBuilder builder, Action clientConfigure, Action configureSource)
35 | {
36 | return builder.AddConsul(s =>
37 | {
38 | s.ConsulClient = new ConsulClient(clientConfigure);
39 | configureSource?.Invoke(s);
40 | });
41 | }
42 |
43 | public static IConfigurationBuilder AddConsul(this IConfigurationBuilder builder,
44 | Action configureSource) => builder.Add(configureSource);
45 | }
46 | }
--------------------------------------------------------------------------------
/src/Configuration/Rabbit.Extensions.Configuration.Consul/ConsulConfigurationProvider.cs:
--------------------------------------------------------------------------------
1 | using Consul;
2 | using Microsoft.Extensions.Configuration;
3 | using System;
4 | using System.Linq;
5 | using System.Net;
6 | using System.Threading;
7 | using System.Threading.Tasks;
8 |
9 | namespace Rabbit.Extensions.Configuration.Consul
10 | {
11 | public class ConsulConfigurationProvider : ConfigurationProvider
12 | {
13 | private readonly ConsulConfigurationSource _source;
14 |
15 | private ulong _lastIndex;
16 | private readonly ReaderWriterLockSlim _readerWriterLockSlim = new ReaderWriterLockSlim();
17 |
18 | public ConsulConfigurationProvider(ConsulConfigurationSource source)
19 | {
20 | _source = source;
21 | }
22 |
23 | #region Overrides of ConfigurationProvider
24 |
25 | ///
26 | ///
27 | /// Loads (or reloads) the data for this provider.
28 | ///
29 | public override void Load()
30 | {
31 | Task.Run(async () =>
32 | {
33 | _lastIndex = await Load(null);
34 | TryWatch(OnReload);
35 | }).GetAwaiter().GetResult();
36 | }
37 |
38 | ///
39 | ///
40 | /// Attempts to find a value with the given key, returns true if one is found, false otherwise.
41 | ///
42 | /// The key to lookup.
43 | /// The value found at key if one is found.
44 | /// True if key has a value, false otherwise.
45 | public override bool TryGet(string key, out string value)
46 | {
47 | try
48 | {
49 | _readerWriterLockSlim.EnterReadLock();
50 | return base.TryGet(key, out value);
51 | }
52 | finally
53 | {
54 | _readerWriterLockSlim.ExitReadLock();
55 | }
56 | }
57 |
58 | #endregion Overrides of ConfigurationProvider
59 |
60 | #region Private Method
61 |
62 | private void TryWatch(Action callback)
63 | {
64 | if (!_source.ReloadOnChange)
65 | return;
66 |
67 | Task.Factory.StartNew(async () =>
68 | {
69 | while (true)
70 | {
71 | var result = await Load(_lastIndex);
72 |
73 | //no modify return
74 | if (result == _lastIndex)
75 | continue;
76 |
77 | _lastIndex = result;
78 | callback();
79 | }
80 | }, TaskCreationOptions.LongRunning);
81 | }
82 |
83 | private async Task Load(ulong? index)
84 | {
85 | var result = await _source.ConsulClient.KV.List(_source.Path,
86 | index == null ? null : new QueryOptions { WaitIndex = index.Value });
87 |
88 | if (!_source.Optional && result.StatusCode == HttpStatusCode.NotFound)
89 | throw new ArgumentException($"node: '{_source.Path}' not found.");
90 |
91 | Set(result);
92 |
93 | return result.LastIndex;
94 | }
95 |
96 | private void Set(QueryResult result)
97 | {
98 | if (result?.Response == null)
99 | return;
100 | _readerWriterLockSlim.EnterWriteLock();
101 | try
102 | {
103 | Data = result.Response.ToDictionary(i => _source.KeyConver(i.Key), i => _source.ValueConver(i.Value));
104 | }
105 | finally
106 | {
107 | _readerWriterLockSlim.ExitWriteLock();
108 | }
109 | }
110 |
111 | #endregion Private Method
112 | }
113 | }
--------------------------------------------------------------------------------
/src/Configuration/Rabbit.Extensions.Configuration.Consul/ConsulConfigurationSource.cs:
--------------------------------------------------------------------------------
1 | using Consul;
2 | using Microsoft.Extensions.Configuration;
3 | using System;
4 | using System.Text;
5 |
6 | namespace Rabbit.Extensions.Configuration.Consul
7 | {
8 | public class ConsulConfigurationSource : IConfigurationSource
9 | {
10 | public ConsulClient ConsulClient { get; set; }
11 | public string Path { get; set; }
12 | public Func KeyConver { get; set; }
13 | public Func ValueConver { get; set; }
14 | public bool Optional { get; set; } = true;
15 | public bool ReloadOnChange { get; set; } = true;
16 |
17 | #region Implementation of IConfigurationSource
18 |
19 | ///
20 | ///
21 | /// Builds the for this source.
22 | ///
23 | /// The .
24 | /// An
25 | public IConfigurationProvider Build(IConfigurationBuilder builder)
26 | {
27 | EnsureDefaults();
28 | return new ConsulConfigurationProvider(this);
29 | }
30 |
31 | #endregion Implementation of IConfigurationSource
32 |
33 | public void EnsureDefaults()
34 | {
35 | if (KeyConver == null)
36 | KeyConver = key => key.Replace("/", ConfigurationPath.KeyDelimiter);
37 | if (ValueConver == null)
38 | ValueConver = bytes => bytes == null ? null : Encoding.UTF8.GetString(bytes);
39 |
40 | if (string.IsNullOrWhiteSpace(Path))
41 | Path = "/";
42 | }
43 | }
44 | }
--------------------------------------------------------------------------------
/src/Configuration/Rabbit.Extensions.Configuration.Consul/Rabbit.Extensions.Configuration.Consul.csproj:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 | netstandard2.0
6 | configuration config rabbit.extensions Microsoft.Extensions.Configuration consul
7 |
8 |
9 |
10 |
11 |
12 |
13 |
14 |
15 |
--------------------------------------------------------------------------------
/src/Configuration/Rabbit.Extensions.Configuration/Internal/TemplateEntry.cs:
--------------------------------------------------------------------------------
1 | using Rabbit.Extensions.Configuration.Utilities;
2 | using System;
3 | using System.Text;
4 |
5 | namespace Rabbit.Extensions.Configuration.Internal
6 | {
7 | public class TemplateEntry
8 | {
9 | public TemplateEntry(string key, string template)
10 | {
11 | Key = key;
12 | Template = template;
13 | }
14 |
15 | public string Key { get; }
16 | private string _template;
17 |
18 | public string Template
19 | {
20 | get => _template;
21 | set
22 | {
23 | _template = value;
24 | Builder = new StringBuilder(_template);
25 | Variables = TemplateUtil.GetVariables(value);
26 | }
27 | }
28 |
29 | public StringBuilder Builder { get; private set; }
30 | private string _value;
31 |
32 | public string Value
33 | {
34 | get => _value;
35 | private set
36 | {
37 | _value = value;
38 | Rendered = true;
39 | }
40 | }
41 |
42 | public bool Rendered { get; private set; }
43 | public string[] Variables { get; set; }
44 |
45 | public void Render(string[] variables, TemplateRenderOptions options)
46 | {
47 | if (Rendered)
48 | return;
49 |
50 | var target = options.Target;
51 | var source = options.Source;
52 |
53 | if (target == null)
54 | throw new ArgumentNullException(nameof(options.Target));
55 | if (source == null)
56 | throw new ArgumentNullException(nameof(options.Source));
57 |
58 | void Replace(string key)
59 | {
60 | var replaceText = TemplateUtil.GetReplaceText(key);
61 | var value = source[key];
62 | if (value == null)
63 | {
64 | switch (options.VariableMissingAction)
65 | {
66 | case VariableMissingAction.UseKey:
67 | value = replaceText;
68 | break;
69 |
70 | case VariableMissingAction.UseEmpty:
71 | value = null;
72 | break;
73 |
74 | case VariableMissingAction.ThrowException:
75 | throw new ArgumentException($"missing key '{key}'.");
76 | default:
77 | throw new ArgumentOutOfRangeException();
78 | }
79 | }
80 | Builder.Replace(replaceText, value);
81 | }
82 |
83 | foreach (var variable in variables)
84 | {
85 | Replace(variable);
86 | }
87 |
88 | Value = TemplateUtil.Escaped(Builder.ToString());
89 | target[Key] = Value;
90 | }
91 | }
92 | }
--------------------------------------------------------------------------------
/src/Configuration/Rabbit.Extensions.Configuration/Internal/TemplateRender.cs:
--------------------------------------------------------------------------------
1 | using Microsoft.Extensions.Configuration;
2 | using Rabbit.Extensions.Configuration.Utilities;
3 | using System;
4 | using System.Collections.Generic;
5 | using System.Linq;
6 |
7 | namespace Rabbit.Extensions.Configuration.Internal
8 | {
9 | public class TemplateRender
10 | {
11 | private readonly TemplateRenderOptions _options;
12 | private readonly IList _renders = new List();
13 |
14 | public TemplateRender(TemplateRenderOptions options)
15 | {
16 | _options = options;
17 | AddEntries(options.Target.GetChildren());
18 | }
19 |
20 | public void Render()
21 | {
22 | while (_renders.Any(i => !i.Rendered))
23 | {
24 | foreach (var render in _renders)
25 | {
26 | CheckDependencies(render, new List());
27 |
28 | var variables = FindVariables(render.Variables);
29 | if (variables == null || variables.All(i => i.Rendered))
30 | {
31 | render.Render(render.Variables, _options);
32 | }
33 | }
34 | }
35 | }
36 |
37 | #region Private Method
38 |
39 | private void AddEntries(IEnumerable sections)
40 | {
41 | foreach (var section in sections)
42 | {
43 | var key = section.Path;
44 | var value = section.Value;
45 |
46 | if (value == null)
47 | {
48 | AddEntries(section.GetChildren());
49 | }
50 | else if (TemplateUtil.NeedRender(value))
51 | {
52 | AddEntry(key, value);
53 | }
54 | }
55 | }
56 |
57 | private void AddEntry(string key, string template)
58 | {
59 | var needRender = TemplateUtil.NeedRender(template);
60 | if (!needRender)
61 | return;
62 |
63 | var entry = new TemplateEntry(key, template);
64 | _renders.Add(entry);
65 | }
66 |
67 | private void CheckDependencies(TemplateEntry entry, ICollection dependencies)
68 | {
69 | var variables = entry.Variables;
70 | if (variables == null || !variables.Any())
71 | return;
72 |
73 | foreach (var variable in variables)
74 | {
75 | var dependency = _renders.SingleOrDefault(i => i.Key == variable);
76 | if (dependency == null)
77 | continue;
78 |
79 | if (dependencies.Any(i => i.Key == dependency.Key))
80 | throw new ArgumentException($"cyclic dependency '{entry.Key} > {string.Join(" > ", dependencies.Select(i => i.Key))}'.", entry.Key);
81 |
82 | dependencies.Add(dependency);
83 |
84 | if (dependency.Variables != null && dependency.Variables.Any())
85 | {
86 | CheckDependencies(dependency, dependencies);
87 | }
88 | }
89 | }
90 |
91 | private TemplateEntry[] FindVariables(string[] variables)
92 | {
93 | return variables == null ? null : _renders.Where(i => variables.Contains(i.Key)).ToArray();
94 | }
95 |
96 | #endregion Private Method
97 | }
98 | }
--------------------------------------------------------------------------------
/src/Configuration/Rabbit.Extensions.Configuration/Rabbit.Extensions.Configuration.csproj:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 | netstandard2.0
6 | configuration config rabbit.extensions Microsoft.Extensions.Configuration configurationtemplate configtemplate
7 |
8 |
9 |
10 |
11 |
12 |
13 |
14 |
--------------------------------------------------------------------------------
/src/Configuration/Rabbit.Extensions.Configuration/TemplateRenderOptions.cs:
--------------------------------------------------------------------------------
1 | using Microsoft.Extensions.Configuration;
2 |
3 | namespace Rabbit.Extensions.Configuration
4 | {
5 | ///
6 | /// Can not find the replacement behavior of the variable.
7 | ///
8 | public enum VariableMissingAction
9 | {
10 | ///
11 | /// not replace.
12 | ///
13 | UseKey,
14 |
15 | ///
16 | /// replace empty.
17 | ///
18 | UseEmpty,
19 |
20 | ///
21 | /// throw exception.
22 | ///
23 | ThrowException
24 | }
25 |
26 | public class TemplateRenderOptions
27 | {
28 | ///
29 | /// Can not find the replacement behavior of the variable.
30 | ///
31 | public VariableMissingAction VariableMissingAction { get; set; } = VariableMissingAction.UseKey;
32 |
33 | ///
34 | /// handle target.
35 | ///
36 | public IConfiguration Target { get; set; }
37 |
38 | ///
39 | /// variable value source.
40 | ///
41 | public IConfiguration Source { get; set; }
42 | }
43 | }
--------------------------------------------------------------------------------
/src/Configuration/Rabbit.Extensions.Configuration/TemplateSupportExtensions.cs:
--------------------------------------------------------------------------------
1 | using Microsoft.Extensions.Configuration;
2 | using Rabbit.Extensions.Configuration.Internal;
3 | using System;
4 |
5 | namespace Rabbit.Extensions.Configuration
6 | {
7 | public static class TemplateSupportExtensions
8 | {
9 | ///
10 | /// enable configuration template support.
11 | ///
12 | /// need enable configuration.
13 | /// options configure.
14 | /// configuration.
15 | public static T EnableTemplateSupport(this T target, Action configure = null)
16 | where T : IConfiguration
17 | {
18 | var options = new TemplateSupportOptions
19 | {
20 | Target = target,
21 | Source = target
22 | };
23 |
24 | configure?.Invoke(options);
25 |
26 | EnableTemplateSupport(options);
27 |
28 | return target;
29 | }
30 |
31 | #region Private Method
32 |
33 | ///
34 | /// enable configuration template support.
35 | ///
36 | private static void EnableTemplateSupport(TemplateSupportOptions options)
37 | {
38 | if (options.Source == null)
39 | throw new ArgumentNullException(nameof(options.Source));
40 | if (options.Source == null)
41 | throw new ArgumentNullException(nameof(options.Target));
42 |
43 | var target = options.Target;
44 |
45 | //register rerender listen
46 | if (options.RerenderOnChange)
47 | target.GetReloadToken().RegisterChangeCallback(s =>
48 | {
49 | EnableTemplateSupport(options);
50 | }, null);
51 |
52 | var render = new TemplateRender(options);
53 | render.Render();
54 | }
55 |
56 | #endregion Private Method
57 | }
58 | }
--------------------------------------------------------------------------------
/src/Configuration/Rabbit.Extensions.Configuration/TemplateSupportOptions.cs:
--------------------------------------------------------------------------------
1 | namespace Rabbit.Extensions.Configuration
2 | {
3 | public class TemplateSupportOptions : TemplateRenderOptions
4 | {
5 | ///
6 | /// render the child configuration.
7 | ///
8 | public bool EnableChildren { get; set; } = true;
9 |
10 | ///
11 | /// configure source changes to render again.
12 | ///
13 | public bool RerenderOnChange { get; set; } = true;
14 | }
15 | }
--------------------------------------------------------------------------------
/src/Configuration/Rabbit.Extensions.Configuration/Utilities/TemplateUtil.cs:
--------------------------------------------------------------------------------
1 | using System.Collections.Generic;
2 | using System.Text.RegularExpressions;
3 |
4 | namespace Rabbit.Extensions.Configuration.Utilities
5 | {
6 | public static class TemplateUtil
7 | {
8 | public static bool NeedRender(string template)
9 | {
10 | return !string.IsNullOrEmpty(template) && template.Contains("${");
11 | }
12 |
13 | public static string[] GetVariables(string template)
14 | {
15 | var matches = Regex.Matches(template, @"[\\]?\${([^}]+)}");
16 | var list = new List();
17 | foreach (Match match in matches)
18 | {
19 | if (match.Groups[0].Value.StartsWith("\\"))
20 | continue;
21 | list.Add(match.Groups[1].Value);
22 | }
23 | return list.ToArray();
24 | }
25 |
26 | public static string Escaped(string template)
27 | {
28 | return template.Replace("\\", "");
29 | }
30 |
31 | public static string GetReplaceText(string key)
32 | {
33 | return $"${{{key}}}";
34 | }
35 | }
36 | }
--------------------------------------------------------------------------------
/src/Rabbit.Extensions.Boot/Microsoft.Extensions.Configuration/ChainedBuilderExtensions.cs:
--------------------------------------------------------------------------------
1 | using System;
2 | using System.Collections.Generic;
3 | using System.Text;
4 |
5 | namespace Microsoft.Extensions.Configuration
6 | {
7 | ///
8 | /// IConfigurationBuilder extension methods for the chaind configuration provider.
9 | ///
10 | public static class ChainedBuilderExtensions
11 | {
12 | ///
13 | /// Adds an existing configuration to .
14 | ///
15 | /// The to add to.
16 | /// The to add.
17 | /// The .
18 | public static IConfigurationBuilder AddConfiguration(this IConfigurationBuilder configurationBuilder, IConfiguration config)
19 | {
20 | if (configurationBuilder == null)
21 | {
22 | throw new ArgumentNullException(nameof(configurationBuilder));
23 | }
24 | if (config == null)
25 | {
26 | throw new ArgumentNullException(nameof(config));
27 | }
28 |
29 | configurationBuilder.Add(new ChainedConfigurationSource { Configuration = config });
30 | return configurationBuilder;
31 | }
32 | }
33 | }
--------------------------------------------------------------------------------
/src/Rabbit.Extensions.Boot/Microsoft.Extensions.Configuration/ChainedConfigurationProvider.cs:
--------------------------------------------------------------------------------
1 | using System;
2 | using System.Collections.Generic;
3 | using System.Linq;
4 | using Microsoft.Extensions.Primitives;
5 |
6 | namespace Microsoft.Extensions.Configuration
7 | {
8 | ///
9 | /// Chained implementation of
10 | ///
11 | public class ChainedConfigurationProvider : IConfigurationProvider
12 | {
13 | private readonly IConfiguration _config;
14 |
15 | ///
16 | /// Initialize a new instance from the source configuration.
17 | ///
18 | /// The source configuration.
19 | public ChainedConfigurationProvider(ChainedConfigurationSource source)
20 | {
21 | if (source == null)
22 | {
23 | throw new ArgumentNullException(nameof(source));
24 | }
25 | if (source.Configuration == null)
26 | {
27 | throw new ArgumentNullException(nameof(source.Configuration));
28 | }
29 |
30 | _config = source.Configuration;
31 | }
32 |
33 | ///
34 | /// Tries to get a configuration value for the specified key.
35 | ///
36 | /// The key.
37 | /// The value.
38 | /// True if a value for the specified key was found, otherwise false.
39 | public bool TryGet(string key, out string value)
40 | {
41 | value = _config[key];
42 | return !string.IsNullOrEmpty(value);
43 | }
44 |
45 | ///
46 | /// Sets a configuration value for the specified key.
47 | ///
48 | /// The key.
49 | /// The value.
50 | public void Set(string key, string value) => _config[key] = value;
51 |
52 | ///
53 | /// Returns a change token if this provider supports change tracking, null otherwise.
54 | ///
55 | ///
56 | public IChangeToken GetReloadToken() => _config.GetReloadToken();
57 |
58 | ///
59 | /// Loads configuration values from the source represented by this .
60 | ///
61 | public void Load() { }
62 |
63 | ///
64 | /// Returns the immediate descendant configuration keys for a given parent path based on this
65 | /// 's data and the set of keys returned by all the preceding
66 | /// s.
67 | ///
68 | /// The child keys returned by the preceding providers for the same parent path.
69 | /// The parent path.
70 | /// The child keys.
71 | public IEnumerable GetChildKeys(
72 | IEnumerable earlierKeys,
73 | string parentPath)
74 | {
75 | var section = parentPath == null ? _config : _config.GetSection(parentPath);
76 | var children = section.GetChildren();
77 | var keys = new List();
78 | keys.AddRange(children.Select(c => c.Key));
79 | return keys.Concat(earlierKeys)
80 | .OrderBy(k => k, ConfigurationKeyComparer.Instance);
81 | }
82 | }
83 | }
--------------------------------------------------------------------------------
/src/Rabbit.Extensions.Boot/Microsoft.Extensions.Configuration/ChainedConfigurationSource.cs:
--------------------------------------------------------------------------------
1 | using System;
2 | using System.Collections.Generic;
3 | using System.Text;
4 | namespace Microsoft.Extensions.Configuration
5 | {
6 | ///
7 | /// Represents a chained IConfiguration as an .
8 | ///
9 | public class ChainedConfigurationSource : IConfigurationSource
10 | {
11 | ///
12 | /// The chained configuration.
13 | ///
14 | public IConfiguration Configuration { get; set; }
15 |
16 | ///
17 | /// Builds the for this source.
18 | ///
19 | /// The .
20 | /// A
21 | public IConfigurationProvider Build(IConfigurationBuilder builder)
22 | => new ChainedConfigurationProvider(this);
23 | }
24 | }
--------------------------------------------------------------------------------
/src/Rabbit.Extensions.Boot/Microsoft.Extensions.Hosting.Abstractions/BackgroundService.cs:
--------------------------------------------------------------------------------
1 | // Copyright (c) .NET Foundation. All rights reserved.
2 | // Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
3 |
4 | using System;
5 | using System.Threading;
6 | using System.Threading.Tasks;
7 |
8 | namespace Microsoft.Extensions.Hosting
9 | {
10 | ///
11 | /// Base class for implementing a long running .
12 | ///
13 | public abstract class BackgroundService : IHostedService, IDisposable
14 | {
15 | private Task _executingTask;
16 | private readonly CancellationTokenSource _stoppingCts = new CancellationTokenSource();
17 |
18 | ///
19 | /// This method is called when the starts. The implementation should return a task that represents
20 | /// the lifetime of the long running operation(s) being performed.
21 | ///
22 | /// Triggered when is called.
23 | /// A that represents the long running operations.
24 | protected abstract Task ExecuteAsync(CancellationToken stoppingToken);
25 |
26 | ///
27 | /// Triggered when the application host is ready to start the service.
28 | ///
29 | /// Indicates that the start process has been aborted.
30 | public virtual Task StartAsync(CancellationToken cancellationToken)
31 | {
32 | // Store the task we're executing
33 | _executingTask = ExecuteAsync(_stoppingCts.Token);
34 |
35 | // If the task is completed then return it, this will bubble cancellation and failure to the caller
36 | if (_executingTask.IsCompleted)
37 | {
38 | return _executingTask;
39 | }
40 |
41 | // Otherwise it's running
42 | return Task.CompletedTask;
43 | }
44 |
45 | ///
46 | /// Triggered when the application host is performing a graceful shutdown.
47 | ///
48 | /// Indicates that the shutdown process should no longer be graceful.
49 | public virtual async Task StopAsync(CancellationToken cancellationToken)
50 | {
51 | // Stop called without start
52 | if (_executingTask == null)
53 | {
54 | return;
55 | }
56 |
57 | try
58 | {
59 | // Signal cancellation to the executing method
60 | _stoppingCts.Cancel();
61 | }
62 | finally
63 | {
64 | // Wait until the task completes or the stop token triggers
65 | await Task.WhenAny(_executingTask, Task.Delay(Timeout.Infinite, cancellationToken));
66 | }
67 |
68 | }
69 |
70 | public virtual void Dispose()
71 | {
72 | _stoppingCts.Cancel();
73 | }
74 | }
75 | }
76 |
--------------------------------------------------------------------------------
/src/Rabbit.Extensions.Boot/Microsoft.Extensions.Hosting.Abstractions/EnvironmentName.cs:
--------------------------------------------------------------------------------
1 | // Copyright (c) .NET Foundation. All rights reserved.
2 | // Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
3 |
4 | namespace Microsoft.Extensions.Hosting
5 | {
6 | ///
7 | /// Commonly used environment names.
8 | ///
9 | public static class EnvironmentName
10 | {
11 | public static readonly string Development = "Development";
12 | public static readonly string Staging = "Staging";
13 | public static readonly string Production = "Production";
14 | }
15 | }
--------------------------------------------------------------------------------
/src/Rabbit.Extensions.Boot/Microsoft.Extensions.Hosting.Abstractions/HostBuilderContext.cs:
--------------------------------------------------------------------------------
1 | // Copyright (c) .NET Foundation. All rights reserved.
2 | // Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
3 |
4 | using System.Collections.Generic;
5 | using Microsoft.Extensions.Configuration;
6 |
7 | namespace Microsoft.Extensions.Hosting
8 | {
9 | ///
10 | /// Context containing the common services on the . Some properties may be null until set by the .
11 | ///
12 | public class HostBuilderContext
13 | {
14 | public HostBuilderContext(IDictionary