Swashbuckle 10 Compatibility.

[niemyjski]

I just tried upgrading one of my apps and noticed that there are compatibility changes with this library:

Unable to load one or more of the requested types.
Method 'Apply' in type 'Unchase.Swashbuckle.AspNetCore.Extensions.Filters.AppendActionCountToTagSummaryDocumentFilter' from assembly 'Unchase.Swashbuckle.AspNetCore.Extensions, Version=2.7.2.0, Culture=neutral, PublicKeyToken=null' does not have an implementation.
Method 'Apply' in type 'Unchase.Swashbuckle.AspNetCore.Extensions.Filters.ChangeResponseByHttpStatusCodeDocumentFilter`1' from assembly 'Unchase.Swashbuckle.AspNetCore.Extensions, Version=2.7.2.0, Culture=neutral, PublicKeyToken=null' does not have an implementation.

I just wanted to log this in case any one else is running into this and has time to submit a pr.

[btastic]

We are facing the same Issue. We were only using the AddEnumsWithValuesFixFilters from this library. Removing this line of code makes our application work again.

[frederikstonge]

Same issue for me. I was looking at Microsoft.AspNetCore.OpenApi to see if there was a way to write a transformer to do the same, but I'm having issues.

[tankbob]

I've encountered the same issue in my own filters.
The problem is that OpenApiOperation has moved from Microsoft.OpenApi.Models to Microsoft.OpenApi. In fact models sub namespace has completely gone

So if you recompile against the latest swashbuckle and replace "using Micrsosoft.OpenApi.Models" with "using Microsoft.OpenApi" it "should" work. I'm not free this weekend to compile and submit a pull request with the changes. I will look at doing it next week unless someone beats me to it.

[btastic]

I've encountered the same issue in my own filters. The problem is that OpenApiOperation has moved from Microsoft.OpenApi.Models to Microsoft.OpenApi. In fact models sub namespace has completely gone

So if you recompile against the latest swashbuckle and replace "using Micrsosoft.OpenApi.Models" with "using Microsoft.OpenApi" it "should" work. I'm not free this weekend to compile and submit a pull request with the changes. I will look at doing it next week unless someone beats me to it.

Not that easy unfortunately. Microsoft heavily changed their API's. It is difficult to migrate to their new library if you don't know what you are doing.

[matthias-jauernig]

Up. Would be great to have this functionality working with Swashbuckle v10.

[rfcdejong]

Indeed, for now I had to create new classes and removed the Unchase nuget package

/// <summary>
/// Schema filter that adds enum value descriptions to the OpenAPI schema.
/// </summary>
// ReSharper disable once ClassNeverInstantiated.Global
public class EnumSchemaFilter : ISchemaFilter
{
    public void Apply(IOpenApiSchema schema, SchemaFilterContext context)
    {
        if (schema is not OpenApiSchema concreteSchema) return;

        var type = context.Type;
        if (!type.IsEnum) return;

        var enumValues = Enum.GetValues(type);
        var sb = new StringBuilder();

        if (!string.IsNullOrEmpty(concreteSchema.Description))
        {
            sb.AppendLine(concreteSchema.Description);
            sb.AppendLine();
        }

        sb.AppendLine("Possible values:");

        foreach (var enumValue in enumValues)
        {
            var name = enumValue.ToString()!;
            var intValue = Convert.ToInt32(enumValue);
            var description = GetEnumDescription(type, name);

            if (!string.IsNullOrEmpty(description))
            {
                sb.AppendLine($"- `{intValue}` = {name} - {description}");
            }
            else
            {
                sb.AppendLine($"- `{intValue}` = {name}");
            }
        }

        concreteSchema.Description = sb.ToString().TrimEnd();
    }

    private static string? GetEnumDescription(Type enumType, string enumValueName)
    {
        var memberInfo = enumType.GetMember(enumValueName).FirstOrDefault();
        if (memberInfo == null) return null;

        var descriptionAttribute = memberInfo.GetCustomAttribute<DescriptionAttribute>();
        return descriptionAttribute?.Description;
    }
}




/// <summary>
/// Extension methods for enum types.
/// </summary>
public static class EnumExtensions
{
    /// <summary>
    /// Gets the display name for an enum value. If no Display attribute is present,
    /// returns the enum member name.
    /// </summary>
    /// <typeparam name="T">The enum type.</typeparam>
    /// <param name="value">The enum value.</param>
    /// <returns>The display name or the enum member name.</returns>
    public static string GetDisplayName<T>(this T value) where T : Enum
    {
        var memberInfo = typeof(T).GetMember(value.ToString()).FirstOrDefault();
        if (memberInfo == null) return value.ToString();

        var displayAttribute = memberInfo.GetCustomAttribute<DisplayAttribute>();
        return displayAttribute?.Name ?? value.ToString();
    }
}

[CoreDX9]

Use CoreDX.Unchase.Swashbuckle.AspNetCore.Extensions instead before #45 merged.

[jerone]

Use CoreDX.Unchase.Swashbuckle.AspNetCore.Extensions instead before #45 merged.

Thanks. This works 👍

@unchase Can you please merge mentioned PR 🚀