Design contracts v1

.github/workflows/publish.yml

@@ -36,6 +36,7 @@ jobs:
         dotnet-version: 10.x.x
 
     - name: Run Unit Tests on .Net 10
+      if: github.ref == 'refs/heads/master'
       run: dotnet test TestsOnly.sln -f net10.0 --verbosity quiet --filter "TestCategory!=IntegrationTest"
 
     - name: Install GitVersion
@@ -58,6 +59,7 @@ jobs:
         dotnet pack ./Configuration/AzureBlobJson/Odin.Configuration.AzureBlobJson.csproj --configuration $CONFIGURATION --output $PACKAGE_DIR
         dotnet pack ./Data/SqlScriptsRunner/Odin.Data.SqlScriptsRunner.csproj --configuration $CONFIGURATION --output $PACKAGE_DIR
         dotnet pack ./DesignContracts/Core/Odin.DesignContracts.csproj --configuration $CONFIGURATION --output $PACKAGE_DIR
+        dotnet pack ./DesignContracts/Tooling/Odin.DesignContracts.Tooling.csproj --configuration $CONFIGURATION --output $PACKAGE_DIR
         dotnet pack ./Email/Mailgun/Odin.Email.Mailgun.csproj --configuration $CONFIGURATION --output $PACKAGE_DIR
         dotnet pack ./Email/Office365/Odin.Email.Office365.csproj --configuration $CONFIGURATION --output $PACKAGE_DIR
         dotnet pack ./Email/Core/Odin.Email.csproj --configuration $CONFIGURATION --output $PACKAGE_DIR

.gitignore

@@ -27,7 +27,7 @@ bld/
 [Oo]bj/
 [Ll]og/
 
-# Locally provisioned build output to tools/ under DesignContracts
+# Locally provisioned tools
 tools/
 
 # Visual Studio 2015 cache/options directory

BackgroundProcessing/Abstractions/BackgroundProcessingProviders.cs

@@ -1,5 +1,4 @@
-using System.Collections.Specialized;
-using Odin.System;
+using Odin.System;
 
 namespace Odin.BackgroundProcessing
 {

BackgroundProcessing/Abstractions/JobDetails.cs

@@ -14,7 +14,7 @@ public sealed record JobDetails
         /// <param name="scheduledFor"></param>
         public JobDetails(string jobId, DateTimeOffset scheduledFor)
         {
-            Precondition.Requires(!string.IsNullOrWhiteSpace(jobId));
+            Contract.Requires(!string.IsNullOrWhiteSpace(jobId));
             JobId = jobId;
             ScheduledFor = scheduledFor;
         }

BackgroundProcessing/Core/BackgroundProcessingOptions.cs

@@ -18,7 +18,7 @@ public string Provider
             get => _provider;
             set
             {
-                Precondition.Requires(!string.IsNullOrWhiteSpace(value));
+                Contract.Requires(!string.IsNullOrWhiteSpace(value));
                 _provider = value.Replace("BackgroundProcessor", "", StringComparison.OrdinalIgnoreCase);   
             }
         }

BackgroundProcessing/Core/DependencyInjectionExtensions.cs

@@ -80,7 +80,7 @@ public static void AddOdinBackgroundProcessing(
             this IServiceCollection serviceCollection, IConfiguration configuration,
             IConfigurationSection configurationSection, Func<IServiceProvider, string>? sqlServerConnectionStringFactory = null)
         {
-            Precondition.RequiresNotNull(configurationSection);
+            Contract.RequiresNotNull(configurationSection);
 
             BackgroundProcessingOptions options = new BackgroundProcessingOptions();
             configurationSection.Bind(options);
@@ -131,8 +131,8 @@ public static void AddOdinBackgroundProcessing(
         /// <param name="app"></param>
         public static IApplicationBuilder UseBackgroundProcessing(this IApplicationBuilder app, IServiceProvider appServices)
         {
-            Precondition.RequiresNotNull(appServices);
-            Precondition.RequiresNotNull(app);
+            Contract.RequiresNotNull(appServices);
+            Contract.RequiresNotNull(app);
 
             BackgroundProcessingOptions options = appServices.GetRequiredService<BackgroundProcessingOptions>();
             if (options.Provider == BackgroundProcessingProviders.Null)
@@ -142,7 +142,7 @@ public static IApplicationBuilder UseBackgroundProcessing(this IApplicationBuild
 
             string providerAssemblyName = $"{Constants.RootNamespace}.{options.Provider}";
             ResultValue<IBackgroundProcessorServiceInjector> serviceInjectorCreation =
-                Odin.System.Activator2.TryCreate<IBackgroundProcessorServiceInjector>($"{providerAssemblyName}ServiceInjector",providerAssemblyName);
+                Activator2.TryCreate<IBackgroundProcessorServiceInjector>($"{providerAssemblyName}ServiceInjector",providerAssemblyName);
 
             if (serviceInjectorCreation.IsSuccess)
             {

BackgroundProcessing/Hangfire/HangfireBackgroundProcessor.cs

@@ -25,9 +25,9 @@ public sealed class HangfireBackgroundProcessor : IBackgroundProcessor
         /// <param name="logger"></param>
         public HangfireBackgroundProcessor(IRecurringJobManagerV2 recurringJobManager, IBackgroundJobClient jobClient, ILoggerWrapper<HangfireBackgroundProcessor> logger)
         {
-            Precondition.RequiresNotNull(recurringJobManager);
-            Precondition.RequiresNotNull(jobClient);
-            Precondition.RequiresNotNull(logger);
+            Contract.RequiresNotNull(recurringJobManager);
+            Contract.RequiresNotNull(jobClient);
+            Contract.RequiresNotNull(logger);
             _recurringJobManager = recurringJobManager;
             _jobClient = jobClient;
             _logger = logger;

BackgroundProcessing/Hangfire/HangfirePolicyAuthorisationFilter.cs

@@ -20,7 +20,7 @@ public sealed class HangfirePolicyAuthorisationFilter : IDashboardAuthorizationF
         /// <param name="policyName"></param>
         public HangfirePolicyAuthorisationFilter(string policyName)
         {
-            Precondition.Requires(!string.IsNullOrWhiteSpace(policyName));
+            Contract.Requires(!string.IsNullOrWhiteSpace(policyName));
             _policyName = policyName.Trim();
         }
 

BackgroundProcessing/Hangfire/HangfireServiceInjector.cs

@@ -16,8 +16,8 @@ public class HangfireServiceInjector : IBackgroundProcessorServiceInjector
         public void TryAddBackgroundProcessor(IServiceCollection serviceCollection, IConfiguration configuration,
             IConfigurationSection backgroundProcessingSection, Func<IServiceProvider, string>? connectionStringFactory = null)
         {
-            Precondition.RequiresNotNull(serviceCollection);
-            Precondition.RequiresNotNull(backgroundProcessingSection);
+            Contract.RequiresNotNull(serviceCollection);
+            Contract.RequiresNotNull(backgroundProcessingSection);
             IConfigurationSection? providerSection =
                 backgroundProcessingSection.GetSection(BackgroundProcessingProviders.Hangfire);
             if (providerSection == null)

Data/SqlScriptsRunner/SqlScriptsRunner.cs

@@ -43,15 +43,15 @@ private SqlScriptsRunner(Assembly assemblyWithEmbeddedScripts)
         {
             // Contract.Requires(logger);
             // _logger = logger;
-            Precondition.Requires(assemblyWithEmbeddedScripts!=null!);
+            Contract.Requires(assemblyWithEmbeddedScripts!=null!);
             _assemblyWithEmbeddedScripts = assemblyWithEmbeddedScripts!;
         }
 
         public static ResultValue<SqlScriptsRunner> CreateFromConnectionStringName(string connectionStringName,
             Assembly assemblyWithEmbeddedScripts, IConfiguration configuration)
         {
-            Precondition.Requires(configuration!=null!);
-            Precondition.Requires(assemblyWithEmbeddedScripts!=null!);
+            Contract.Requires(configuration!=null!);
+            Contract.Requires(assemblyWithEmbeddedScripts!=null!);
             SqlScriptsRunner runner = new SqlScriptsRunner(assemblyWithEmbeddedScripts)
             {
                 ConnectionString = configuration.GetConnectionString(connectionStringName)!
@@ -76,8 +76,8 @@ public static ResultValue<SqlScriptsRunner> CreateFromConnectionStringName(strin
 
         public static ResultValue<SqlScriptsRunner> CreateFromConnectionString(string connectionString, Assembly assemblyWithEmbeddedScripts)
         {
-            Precondition.Requires(assemblyWithEmbeddedScripts!=null!);
-            Precondition.Requires(!string.IsNullOrWhiteSpace(connectionString));
+            Contract.Requires(assemblyWithEmbeddedScripts!=null!);
+            Contract.Requires(!string.IsNullOrWhiteSpace(connectionString));
             SqlScriptsRunner runner = new SqlScriptsRunner(assemblyWithEmbeddedScripts)
             {
                 ConnectionString = connectionString