| | | 1 | | using System.Reflection; |
| | | 2 | | using Scalar.AspNetCore; |
| | | 3 | | using Microsoft.OpenApi.Any; |
| | | 4 | | using Estud.Back.Auth.Schemes; |
| | | 5 | | using Microsoft.OpenApi.Models; |
| | | 6 | | using Microsoft.OpenApi.Interfaces; |
| | | 7 | | |
| | | 8 | | namespace Estud.Back.Configs; |
| | | 9 | | |
| | | 10 | | public static class DocsConfigs |
| | | 11 | | { |
| | | 12 | | public static void AddDocsConfigs(this WebApplicationBuilder builder) |
| | | 13 | | { |
| | 2 | 14 | | builder.Services.AddSwaggerGen(options => |
| | 2 | 15 | | { |
| | 2 | 16 | | options.SwaggerDoc("v1", new OpenApiInfo |
| | 2 | 17 | | { |
| | 2 | 18 | | Title = "Estud API Docs", |
| | 2 | 19 | | Description = ReadResource("api-intro.md"), |
| | 2 | 20 | | Extensions = new Dictionary<string, IOpenApiExtension> |
| | 2 | 21 | | { |
| | 2 | 22 | | { "x-logo", new OpenApiObject |
| | 2 | 23 | | { |
| | 2 | 24 | | { "url", new OpenApiString("/estud-logo.png") }, |
| | 2 | 25 | | }} |
| | 2 | 26 | | }, |
| | 2 | 27 | | }); |
| | 2 | 28 | | |
| | 2 | 29 | | options.EnableAnnotations(); |
| | 2 | 30 | | |
| | 2 | 31 | | options.TagActionsBy(api => |
| | 2 | 32 | | { |
| | 0 | 33 | | var group = api.RelativePath.Split("/")[0]; |
| | 0 | 34 | | if (group == "campi") return ["🏫 Campi"]; |
| | 0 | 35 | | if (group == "courses") return ["📚 Courses"]; |
| | 0 | 36 | | if (group == "course-curriculums") return ["📋 Curriculums"]; |
| | 0 | 37 | | if (group == "course-offerings") return ["🗓️ Offerings"]; |
| | 0 | 38 | | if (group == "disciplines") return ["📖 Disciplines"]; |
| | 0 | 39 | | if (group == "periods") return ["📅 Periods"]; |
| | 0 | 40 | | if (group == "students") return ["🎓 Students"]; |
| | 0 | 41 | | if (group == "teachers") return ["👨🏫 Teachers"]; |
| | 0 | 42 | | if (group == "identity") return ["🛡️ Identity"]; |
| | 0 | 43 | | if (group == "users") return ["👩🏻🎓 Users"]; |
| | 0 | 44 | | if (group == "webhooks") return ["🪝 Webhooks"]; |
| | 0 | 45 | | if (group == "classes") return ["👩🏻🏫 Classes"]; |
| | 0 | 46 | | if (group == "classrooms") return ["📈 Classrooms"]; |
| | 0 | 47 | | if (group == "notifications") return ["🔔 Notifications"]; |
| | 0 | 48 | | return ["🧱 Cross"]; |
| | 2 | 49 | | }); |
| | 2 | 50 | | options.DocInclusionPredicate((name, api) => true); |
| | 2 | 51 | | |
| | 2 | 52 | | options.SchemaFilter<EnumSchemaFilter>(); |
| | 2 | 53 | | options.OperationFilter<AuthOperationsFilter>(); |
| | 2 | 54 | | options.OperationFilter<IdParameterExamplesFilter>(); |
| | 2 | 55 | | options.OperationFilter<ExamplesOperationsFilterFilter>(); |
| | 2 | 56 | | options.DocumentFilter<HttpMethodSorterDocumentFilter>(); |
| | 2 | 57 | | |
| | 2 | 58 | | options.ExampleFilters(); |
| | 2 | 59 | | |
| | 2 | 60 | | options.AddSecurityDefinition( |
| | 2 | 61 | | JwtBearerScheme.Name, |
| | 2 | 62 | | new OpenApiSecurityScheme |
| | 2 | 63 | | { |
| | 2 | 64 | | In = ParameterLocation.Cookie, |
| | 2 | 65 | | Name = JwtBearerScheme.Cookie, |
| | 2 | 66 | | Type = SecuritySchemeType.ApiKey, |
| | 2 | 67 | | Description = "JWT enviado no cookie http only", |
| | 2 | 68 | | }); |
| | 2 | 69 | | |
| | 2 | 70 | | options.DescribeAllParametersInCamelCase(); |
| | 2 | 71 | | |
| | 2 | 72 | | var xmlPath = Path.Combine(AppContext.BaseDirectory, "Back.xml"); |
| | 2 | 73 | | options.IncludeXmlComments(xmlPath, includeControllerXmlComments: true); |
| | 4 | 74 | | }); |
| | | 75 | | |
| | 2 | 76 | | builder.Services.AddSwaggerExamplesFromAssemblyOf(typeof(Program)); |
| | 2 | 77 | | builder.Services.AddOpenApi(); |
| | 2 | 78 | | } |
| | | 79 | | |
| | | 80 | | public static void MapScalarDocs(this IEndpointRouteBuilder options) |
| | | 81 | | { |
| | 2 | 82 | | options.MapScalarApiReference("/docs", options => |
| | 2 | 83 | | { |
| | 2 | 84 | | options.WithModels(false); |
| | 2 | 85 | | options.WithTitle("Estud API Docs"); |
| | 2 | 86 | | options.WithDocumentDownloadType(DocumentDownloadType.Json); |
| | 2 | 87 | | options.WithOpenApiRoutePattern("/swagger/{documentName}/swagger.json"); |
| | 2 | 88 | | options |
| | 2 | 89 | | .AddPreferredSecuritySchemes("Bearer") |
| | 4 | 90 | | .AddHttpAuthentication("Bearer", x => x.Token = "your.bearer.token"); |
| | 2 | 91 | | |
| | 2 | 92 | | options.CustomCss = @" |
| | 2 | 93 | | :root { |
| | 2 | 94 | | --scalar-sidebar-width: 300px; |
| | 2 | 95 | | } |
| | 2 | 96 | | "; |
| | 4 | 97 | | }); |
| | 2 | 98 | | } |
| | | 99 | | |
| | | 100 | | public static void UseDocs(this IApplicationBuilder app) |
| | | 101 | | { |
| | 2 | 102 | | app.UseStaticFiles(); |
| | 2 | 103 | | app.UseSwagger(); |
| | 2 | 104 | | } |
| | | 105 | | |
| | | 106 | | private static string ReadResource(string name) |
| | | 107 | | { |
| | 2 | 108 | | var assembly = Assembly.GetExecutingAssembly(); |
| | 10 | 109 | | var resourcePath = assembly.GetManifestResourceNames().Single(str => str.EndsWith(name)); |
| | | 110 | | |
| | 2 | 111 | | using Stream stream = assembly.GetManifestResourceStream(resourcePath)!; |
| | 2 | 112 | | using StreamReader reader = new(stream); |
| | | 113 | | |
| | 2 | 114 | | return reader.ReadToEnd(); |
| | 2 | 115 | | } |
| | | 116 | | } |