Enums names provides in schema

src/Simplify.Web.Swagger/ControllerActionsFactory.cs

@@ -164,4 +164,4 @@ private static OpenApiResponse CreateResponse(ProducesResponseAttribute produces
 
 		return response;
 	}
-}
+}

src/Simplify.Web.Swagger/EnumNamesSchemaFilter.cs

@@ -0,0 +1,29 @@
+using System;
+using System.Linq;
+using Microsoft.OpenApi.Any;
+using Microsoft.OpenApi.Models;
+using Swashbuckle.AspNetCore.SwaggerGen;
+
+namespace Simplify.Web.Swagger;
+
+/// <summary>
+/// Adds names extension and a human-readable description to enum schemas.
+/// </summary>
+public class EnumNamesSchemaFilter : ISchemaFilter
+{
+	/// <inheritdoc />
+	public void Apply(OpenApiSchema schema, SchemaFilterContext context)
+	{
+		if (!context.Type.IsEnum)
+			return;
+
+		var names = Enum.GetNames(context.Type);
+		var values = Enum.GetValues(context.Type).Cast<int>().ToArray();
+
+		var varnames = new OpenApiArray();
+		foreach (var name in names)
+			varnames.Add(new OpenApiString(name));
+
+		schema.Extensions["names"] = varnames;
+	}
+}

src/Simplify.Web.Swagger/RequestBodyAttribute.cs

@@ -29,4 +29,4 @@ public class RequestBodyAttribute(Type model, string contentType = "application/
 	/// The type of the content.
 	/// </value>
 	public string ContentType { get; private set; } = contentType;
-}
+}

src/Simplify.Web.Swagger/Simplify.Web.Swagger.csproj

@@ -9,7 +9,7 @@
 		<SymbolPackageFormat>snupkg</SymbolPackageFormat>
 		<GenerateDocumentationFile>true</GenerateDocumentationFile>
 
-		<Version>1.2</Version>
+		<Version>1.3</Version>
 
 		<Description>Swagger extensions for Simplify.Web web-framework</Description>
 		<Product>Simplify</Product>

src/Simplify.Web.Swagger/SimplifyWebSwaggerExtensions.cs

@@ -19,5 +19,7 @@ public static void AddSimplifyWebSwagger(this SwaggerGenOptions options, Simplif
 			options.DocumentFilter<SimplifyWebDocumentFilter>();
 		else
 			options.DocumentFilter<SimplifyWebDocumentFilter>(args);
+
+		options.SchemaFilter<EnumNamesSchemaFilter>();
 	}
 }

src/TesterApp/Controllers/Api/v1/Users/GetMultipleController.cs

@@ -19,12 +19,14 @@ public override ControllerResponse Invoke()
 			new()
 			{
 				UserName = "User 1",
-				CreationTime = DateTime.Now
+				CreationTime = DateTime.Now,
+				Role = UserRole.Admin
 			},
 			new()
 			{
 				UserName = "User 2",
-				CreationTime = DateTime.Now.Subtract(TimeSpan.FromDays(1))
+				CreationTime = DateTime.Now.Subtract(TimeSpan.FromDays(1)),
+				Role = UserRole.User
 			}
 		};
 

src/TesterApp/ViewModels/Users/UserRole.cs

@@ -0,0 +1,9 @@
+namespace TesterApp.ViewModels.Users;
+
+public enum UserRole
+{
+	Guest,
+	User,
+	Moderator,
+	Admin
+}

src/TesterApp/ViewModels/Users/UserViewModel.cs

@@ -4,4 +4,5 @@ public class UserViewModel
 {
 	public string UserName { get; set; }
 	public DateTime CreationTime { get; set; }
+	public UserRole Role { get; set; }
 }