当前位置: 首页 > 软件库 > 程序开发 > 常用工具包 >

NSwag

Swagger/OpenAPI 工具链
授权协议 MIT
开发语言 C# TypeScript
所属分类 程序开发、 常用工具包
软件类型 开源软件
地区 不详
投 递 者 荆哲
操作系统 跨平台
开源组织
适用人群 未知
 软件概览

NSwag 是一个 Swagger/OpenAPI 2.0 和 3.0 工具链,用于.NET、.NET Core、Web API、ASP.NET Core、TypeScript(jQuery、AngularJS、Angular 2+、Aurelia、KnockoutJS 等)和其他平台,用 C# 编写。OpenAPI/Swagger 规范使用 JSON 和 JSON Schema 来描述一个 RESTful web API。NSwag 项目提供了从现有的ASP.NET Web API 控制器生成 OpenAPI 规范的工具,以及从这些 OpenAPI 规范生成的客户端代码。

该项目将 Swashbuckle(OpenAPI/Swagger generation)和AutoRest(client generation)的功能结合在一个工具链中(不需要这两个库)。这样就可以避免很多不兼容的情况,并且可以更好地支持OpenAPI规范或JSON Schema没有很好描述的功能(例如继承、枚举和引用处理)。NSwag 项目大量使用NJsonSchema for .NET来处理JSON Schema和生成C#/TypeScript类/接口。

特性:

  • 从 C# ASP.NET(Core) controllers 生成 Swagger 2.0 和 OpenAPI 3.0 规范
  • 通过 ASP.NET (Core)中间件提供规范,可选择使用 Swagger UI或ReDoc
  • 从这些规范中生成C#或TypeScript客户端/代理。
  • 一切都可以通过CLI实现自动化(通过NuGet工具或构建目标分发;或NPM)。
  • CLI通过JSON文件或NSwagStudio Windows UI进行配置
  • https://blog.rsuter.com/nswag-tutorial-integrate-the-nswag-toolchain-into-your-asp-net-web-api-project/ This tutorial shows how to integrate NSwag (Swagger toolchain for .NET) so that you can access y

  • https://www.reddit.com/r/dotnet/comments/a2181x/swashbuckle_vs_nswag/   Swashbuckle https://github.com/aspnet/Docs/issues/4258 在官方的文档中引入NSwag的时机   https://github.com/domaindrivendev/Swashbuckle  这个项目不

  • 参考http://petstore.swagger.io   给controller加上description https://github.com/RSuter/NSwag/issues/1803   xml summary https://github.com/RSuter/NJsonSchema/wiki/XML-Documentation   WebApiToSwaggerGenerato

  • nswag下来适用了下,但用NSwag.Demo.Client 生成自己写的api时报错:正在运行转换: System.IO.FileNotFoundException: 未能加载文件或程序集“NSwag.CodeGeneration, Version=2.40.5996.26175 需要在自己的api中加入NSWAG的四个项目引用,之后就没这个问题了。

  • Swagger 是一款RESTFUL接口的、基于YAML、JSON语言的文档在线自动生成、代码自动生成的工具。swagger不仅能提供接口文档,还能提供简单的传参测试。Swagger是用于描述REST API 的语言不可知的规范。Swagger项目捐赠给了OpenAPI Initiative,现在称为OpenAPI。这两个名称可以互换使用。但是,首选OpenAPI。本文主要简单介绍认识Swagge

  • 本文主要介绍ASP.NET Core中,API接口文档生成工具NSwag(Swagger)的介绍,安装引用NSwag的方法,能利用Swagger UI和Swagger生成器,还能灵活的代码生成。以及使用和配置方法及示例。使用NSwag,您不需要现有的API,您可以使用包含Swagger并生成客户端实现的第三方API。NSwag允许您加快开发周期并轻松适应API更改。 原文地址:ASP.NET Co

  • GitHub地址 使用 ASP.NET Core 和 MongoDB 创建 Web API Swagger

 相关资料
  • 我迷失在依赖和工具中:我以前使用以下工具为我昂首阔步的网络服务生成代码。 大摇大摆 https://mvnrepository.com/artifact/io.swagger.codegen.v3/swagger-codegen-cli/3.0.13 https://github.com/swagger-api/swagger-codegen 然后我注意到以下工具,并认为这是一个继任者: Open

  • 我很难让这个工作。我已经开始了一个工作的SpringBoot(v2.2.2)应用程序与一个工作@RestController。为了让springdoc工作,我在pom中包含了以下依赖项: 然后我建立并开始我的服务。然后我浏览到api文档endpoint,我得到: 我漏了一步吗?我假设在运行时它会扫描我的代码,找到@RestController,找到@刚需映射方法并从中生成api。 作为第二次尝试,

  • 龙虎牛熊多头合约池 接口名称 long_pool 接口描述 龙虎牛熊多头合约池接口 请求参数 参数名 说明 举例 date 查询日期 2018-08-08 返回参数 参数名 类型 说明 symbol string 品种编码 code string 合约代号 示例代码 from akshare import pro_api pro = pro_api(token="在此处输入您的token,可以通过

  • 工具 客户端 客户端分为三种:完整客户端、轻量级客户端和在线客户端。 完整客户端:存储所有的交易历史记录,功能完备; 轻量级客户端:不保存交易副本,交易需要向别人查询; 在线客户端:通过网页模式来浏览第三方服务器提供的服务。 钱包 矿机 专门为“挖矿”设计的硬件,包括基于 GPU 和 ASIC 的芯片。 脚本 比特币交易支持一种比较简单的脚本语言(类 Forth 的栈脚本语言),可以写入 UTXO

  • 工具 以下的一些工具可以帮助你自动检查项目中的 Ruby 代码是否符合这份指南。 RuboCop [RuboCop][] 是一个基于本指南的 Ruby 代码风格检查工具。RuboCop 涵盖了本指南相当大的部分,其同时支持 MRI 1.9 和 MRI 2.0,且与 Emacs 整合良好。 RubyMine RubyMine 的代码检查部分基于本指南。

  • 10.7. 工具 本章剩下的部分将讨论Go语言工具箱的具体功能,包括如何下载、格式化、构建、测试和安装Go语言编写的程序。 Go语言的工具箱集合了一系列的功能的命令集。它可以看作是一个包管理器(类似于Linux中的apt和rpm工具),用于包的查询、计算包的依赖关系、从远程版本控制系统下载它们等任务。它也是一个构建系统,计算文件的依赖关系,然后调用编译器、汇编器和链接器构建程序,虽然它故意被设计成

  • vse命令行工具 yocode扩展生成器 范例

  • 提供各种支付需要的配置生成方法。 配置 <?php use EasyWeChat\Pay\Application; $config = [...]; $app = new Application($config); $utils = $app->getUtils(); 注意 生成支付 JS 配置 有四种发起支付的方式:WeixinJSBridge, JSSDK, 小程序支付, APP We