{"id":21769071,"url":"https://github.com/bing-framework/bing.extensions.swashbuckle","last_synced_at":"2025-04-13T16:22:03.641Z","repository":{"id":34028244,"uuid":"165986356","full_name":"bing-framework/Bing.Extensions.Swashbuckle","owner":"bing-framework","description":"Bing.Extensions.Swashbuckle是扩展Swashbuckle.AspNetCore一些常用操作，便于使用以及过滤。","archived":false,"fork":false,"pushed_at":"2024-05-28T09:58:39.000Z","size":582,"stargazers_count":22,"open_issues_count":0,"forks_count":6,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-27T07:11:58.778Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bing-framework.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-01-16T06:23:44.000Z","updated_at":"2024-05-28T09:56:06.000Z","dependencies_parsed_at":"2024-11-13T04:52:29.187Z","dependency_job_id":"65f82072-0bfe-4280-9d83-28c7912460bd","html_url":"https://github.com/bing-framework/Bing.Extensions.Swashbuckle","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bing-framework%2FBing.Extensions.Swashbuckle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bing-framework%2FBing.Extensions.Swashbuckle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bing-framework%2FBing.Extensions.Swashbuckle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bing-framework%2FBing.Extensions.Swashbuckle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bing-framework","download_url":"https://codeload.github.com/bing-framework/Bing.Extensions.Swashbuckle/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248741850,"owners_count":21154388,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-26T14:07:31.325Z","updated_at":"2025-04-13T16:22:03.614Z","avatar_url":"https://github.com/bing-framework.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bing.Extensions.Swashbuckle\n\n[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://mit-license.org/)\n\nBing.Extensions.Swashbuckle是扩展Swashbuckle.AspNetCore一些常用操作，便于使用以及过滤。\n\n## Nuget\n\n|Nuget|版本号|说明|\n|---|---|---|\n|Bing.Extensions.Swashbuckle|[![NuGet Badge](https://buildstats.info/nuget/Bing.Extensions.Swashbuckle?includePreReleases=true)](https://www.nuget.org/packages/Bing.Extensions.Swashbuckle)|\n\n## 功能\n\n- 支持多版本分组\n- 支持多API分组功能\n- 支持文件上传参数\n- 支持添加通用参数\n- 支持自定义请求头\n- 支持自定义响应头\n- 支持安全请求\n- 支持显示授权信息\n- 支持自定义Url显示模式。首字母小写、首字母大写、全小写、全大写\n- [支持显示枚举描述](#显示枚举描述)\n- 支持Swagger文档授权登录功能\n- 支持默认值设置\n- 支持控制器排序\n- 支持Token令牌存储\n- 支持控制器方法计数\n- 支持全局响应包装功能Bing.Extensions.Swashbuckle\n\n## 依赖类库\n\n- [Swashbuckle.AspNetCore](https://github.com/domaindrivendev/Swashbuckle.AspNetCore)\n\n## 使用方式\n\n### 显示枚举描述\n\n用于在请求实体与响应实体当中，显示枚举的描述信息，需要在枚举上面添加 `[Description(\"xxx\")]` 特性，方可在文档中显示每个枚举的注释信息。\n\n```csharp\n\npublic enum EnumSample\n{\n    [Description(\"老大\")]\n    One = 1,\n    [Description(\"老二\")]\n    Two = 2,\n    [Description(\"老三\")]\n    Three = 3\n}\n\n// Startup.cs\nservices.AddSwaggerGen(c =\u003e\n{\n    ...\n    c.ShowEnumDescription();\n});\n\n```\n\n## 作者\n\n简玄冰\n\n## 贡献与反馈\n\n\u003e 如果你在阅读或使用Bing中任意一个代码片断时发现Bug，或有更佳实现方式，请通知我们。\n\n\u003e 为了保持代码简单，目前很多功能只建立了基本结构，细节特性未进行迁移，在后续需要时进行添加，如果你发现某个类无法满足你的需求，请通知我们。\n\n\u003e 你可以通过github的Issue或Pull Request向我们提交问题和代码，如果你更喜欢使用QQ进行交流，请加入我们的交流QQ群。\n\n\u003e 对于你提交的代码，如果我们决定采纳，可能会进行相应重构，以统一代码风格。\n\n\u003e 对于热心的同学，将会把你的名字放到**贡献者**名单中。\n\n## 免责声明\n\n- 虽然我们对代码已经进行高度审查，并用于自己的项目中，但依然可能存在某些未知的BUG，如果你的生产系统蒙受损失，Bing 团队不会对此负责。\n- 出于成本的考虑，我们不会对已发布的API保持兼容，每当更新代码时，请注意该问题。\n\n## 开源地址\n\n[https://github.com/bing-framework/Bing.Extensions.Swashbuckle](https://github.com/bing-framework/Bing.Extensions.Swashbuckle)\n\n## License\n\n**MIT**\n\n\u003e 这意味着你可以在任意场景下使用 Bing 应用框架而不会有人找你要钱。\n\n\u003e Bing 会尽量引入开源免费的第三方技术框架，如有意外，还请自行了解。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbing-framework%2Fbing.extensions.swashbuckle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbing-framework%2Fbing.extensions.swashbuckle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbing-framework%2Fbing.extensions.swashbuckle/lists"}