Merge pull request #27 from beheshty/bugfix/cannot-use-for-a-reference-library

fix: change missing source file error to warning and improve context

Author: beheshty

CHANGELOG.md

@@ -5,6 +5,11 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.1.0] - 2025-09-26
+### Changed
+- The diagnostic for a missing source file has been changed from a build-halting error to a non-blocking warning. The generator now continues without generating code instead of failing the compilation.
+- The warning for a missing source file now includes the name of the calling assembly to provide better context in multi-project solutions.
+
 ## [3.0.0] - 2025-08-19
 ### Breaking Change
 - **Generator configuration has been moved from `appsettings.json` to MSBuild properties in the `.csproj` file.** The `SetSharp` section within `appsettings.json` is no longer read. Users upgrading to this version **must** migrate their settings to their project file to continue configuring the generator.

src/SetSharp/AnalyzerReleases.Shipped.md

@@ -7,4 +7,4 @@ Rule ID | Category | Severity | Notes
 SSG001 | Error     | Error     | App settings parsing failed. Triggered when internal parsing logic throws or fails due to invalid structure or unsupported types.
 SSG002 | Usage     | Error     | Missing reference to 'Microsoft.Extensions.Options.ConfigurationExtensions' required for generating IOptions extensions.
 SSG003 | Usage     | Error     | Missing reference(s) to 'Microsoft.Extensions.Configuration.Abstractions' and/or 'System.Collections.Immutable' required for basic functionality.
-SSG004 | Configuration     | Error     | The source file specified via MSBuild property was not found as an 'AdditionalFile' in the project.
+SSG004 | Configuration     | Warning     | The source file specified via MSBuild property was not found as an 'AdditionalFile' in the project.

src/SetSharp/Diagnostics/DiagnosticDescriptors.cs

@@ -28,12 +28,12 @@ internal static class DiagnosticDescriptors
              DiagnosticSeverity.Error,
              true);
 
-        internal static readonly DiagnosticDescriptor SourceFileNotFoundError = new(
+        internal static readonly DiagnosticDescriptor SourceFileNotFoundWarning = new(
             "SSG004",
             "Source File Not Found",
-            "The specified source file '{0}' was not found. Ensure the file is included in your project as an 'AdditionalFiles' item in the .csproj.",
+            "The specified source file '{0}' was not found for assembly '{1}'. Ensure the file is included in your project as an 'AdditionalFiles' item in the .csproj.",
             "Configuration",
-            DiagnosticSeverity.Error,
+            DiagnosticSeverity.Warning,
             true);
     }
 }

src/SetSharp/SetSharp.csproj

@@ -10,7 +10,7 @@
 		<GeneratePackageOnBuild>true</GeneratePackageOnBuild>
 
 		<PackageId>SetSharp</PackageId>
-		<Version>3.0.1</Version>
+		<Version>3.1.0</Version>
 		<PackageIcon>icon.png</PackageIcon>
 		<Authors>Amirhossein Beheshti</Authors>
 		<Description>Generates strongly typed settings classes from appsettings.json using Source Generators.</Description>

src/SetSharp/SetSharpSourceGenerator.cs

@@ -28,7 +28,7 @@ public void Initialize(IncrementalGeneratorInitializationContext context)
 
                 if (sourceFile is null)
                 {
-                    var diagnostic = Diagnostic.Create(DiagnosticDescriptors.SourceFileNotFoundError, Location.None, settings.SourceFile);
+                    var diagnostic = Diagnostic.Create(DiagnosticDescriptors.SourceFileNotFoundWarning, Location.None, settings.SourceFile, "unknown");
                     return new SourceGenerationModel(null, settings, diagnostic);
                 }
 
@@ -58,7 +58,17 @@ public void Initialize(IncrementalGeneratorInitializationContext context)
             {
                 var (model, compilation) = source;
 
-                if (model.Diagnostic != null)
+                if (model.Diagnostic?.Id == DiagnosticDescriptors.SourceFileNotFoundWarning.Id)
+                {
+                    var warning = Diagnostic.Create(
+                        DiagnosticDescriptors.SourceFileNotFoundWarning,
+                        Location.None,
+                        model.SetSharpSettings.SourceFile,
+                        compilation.AssemblyName);
+
+                    spc.ReportDiagnostic(warning);
+                }
+                else if (model.Diagnostic != null)
                 {
                     spc.ReportDiagnostic(model.Diagnostic);
                     return;