Skip to content
| Marketplace
Sign in
Visual Studio>Tools>RAML Tools for .NET
RAML Tools for .NET

RAML Tools for .NET

MuleSoft Inc

|
19,303 installs
| (8) | Free
RAML Tools for .NET allows developers to easily integrate and consume APIs that exposes a RAML or OAS (swagger) definitions, or generate a new ASP.NET Web API implementation from scratch using a contract-first approach from a previously created RAML or OAS (swagger) definition...
Download

RAML Tools for .NET allows developers to easily integrate and consume APIs that exposes a RAML or OAS (swagger) definition, or generate a new ASP.NET Web API implementation from scratch using a contract-first approach from a previously created RAML or OAS (swagger) definition. See http://raml.org for information on RAML (RESTful API Modeling Language).

Project home: https://github.com/mulesoft-labs/raml-dotnet-tools

A number of sample projects can be found under the /samples directory in this repository.

v 3.0.3 notes:

  • Support for OAS 3.0
  • Support for Asp.net Core 3.0
  • Update to API console 6.0.49
  • Update to AMF 4.0.5
  • Fixed issues #193, #203, #234, #210, #208, #168

v 3.0.2 notes:

  • Updated to AMF 4.0.3
  • Fixed issues #237, #239 and #240

v 3.0.1 notes: API Console v6

v 3.0.0 notes: Note: This a pre release version that uses a new parser with support for OAS / OpenAPI and has many bug fixed from the previous version Main new features:

  • Support for OAS (swagger) / OpenAPI
  • Support for Visual Studio 2019
  • Support for ASP.Net Core 2.2 and .Net framework 4.7.2
  • Generation of Unit Tests for Asp.Net Controllers
  • New Anypoint Exchange integration with login

Release 2.1.2 notes:

  • Bug Fixing

Release 2.1.1 notes:

  • Bug Fixing

Release 2.1.0 notes:

  • Visual Studio 2017 support

Release 2.0.6 notes:

- Adding Extract RAML for ASP .NET Core / MVC 6

- Include JSON schema parsing errors/warnings when adding a RAML contract

- Generate API Client Code from a RAML definition in .NET core projects

- Document how to update Generated Web API interface after RAML change

- Update js parser to latest version

- Fixed #111: String array properties not generated

- Fixed #112: Route incorrectly generated

- Fixed #121: Incorrect detection of "uses:" clause

- Fixed #131: Invalid Generated RAML 1.0

- Fixed #133: Unable to edit RAML files when Adding a RAML reference

- Fixed #134: Command line tools not picking up RAML include files in relative folders when referenced by a path in the command line

Release 2.0.5 notes:

- Fixed version number for the published VSIX file

Release 2.0.4 notes:

- Added possibility to allow customization of generated .Net primitive types

- Added model classes generation - CLI Tool

- Added support for DateTimeOffset

- Fixed #93: optional properties

- Fixed #94: integer types generating long type after last release

- Fixed #102: Resource types generating long type after last release

- Fixed #104: Two or more traits don't work if these traits contains responses

- Fixed #105: Duplicate names in enums error

For more information please click here.

Release 2.0.3 notes:

- Added possibility to customize output (folders / file names suffix)

- Added support for Asp.Net Core

- Added support for using C# long (System.Int64) in APIs

- Fixed #83: Wrong use of Route instead in Web Api 2 gernated code

- Fixed #84: Incorrect comments in Asp.Net 5 templates

- Fixed #87: Traits applied at incorrect level

- Fixed #88: Date type converted to object instead of DateTime

- Fixed #90: Outdated dependencies in CLI Tools

For more information please click here.

Release 2.0.2 notes:

- Fix issue with adding a new RAML contract

Release 2.0.1 notes:

- Fix issues with date / time data types in RAML 1.0

Release 2.0.0 notes:

- Added support for RAML 1.0 specification

* Note that this version of the tools will produce different model classes due to the new RAML type system.

Release 1.4.1 notes:

- Fixed #58: Collection of additionalProperties attached to wrong class

- Fixed #59: JSON schema not being resolved

- Fixed #61: Typo in generated comments

Release 1.4.0 notes:

- Added support for implementation of ASP.NET 5 based APIs

- Added support for query objects in RAML Metadata output

- Fixed #42: Support definition of root endpoint in RAML

- Fixed #44: Patch HTTP verb upper-cased to be compatible with API Gateway

- Fixed #46: Support for KeyValuePair collection

- Fixed #49: Ensure query parameter format is compatible with API Gateway

- Fixed #50: Include raw Location header value

- Fixed #52: Add correct using statement to import generated Models

- Fixed #54: Support multiple levels of hierarchy in properties

Release 1.3.0 notes:

- Transform JSON Schema validation attributes into Model DataAnnotations when scaffolding WebApi

- Transform Model Data Annotations into JSON Schema validation attributes when reversing RAML from WebAPI implementation

- RAML.Api.Core nuget package nows supports Core CLR

- Portability issues resolved for cross-platform development

Release 1.2.0 notes:

- Added support for XML Schema in addition to JSON Schema

- RAML.Api.Core is now portable, providing support for cross-platform app development (#14, #20)

- RAML included in project now uses relative paths, simplifying collaboration (#19)

- Added support for HTTP PATCH method in RAML and controllers (#32)

- Support for JSON Schema version 4 additionalProperties collection (#6)

- Fixed #23: Uri parameters metadata not inherited when nesting resources

- Fixed #24: Importing RAML reference does not add .ref file to project

- Fixed #28: Use request schema for PUT operation

- Fixed #29: Support optional JSON elements with Nullable

- Fixed #33: RAML metadata generator not correctly detecting concrete collection types

- Fixed #34: Tools not working with bare arrays

Release 1.1.1 notes:

- Add support for generating async method signatures for API implementation

- Show menu commands for Add RAML Reference and Add RAML Contract on API References and Contracts folders

- Add a RAML properties editor dialog to allow updating generation parameters

- Support for explicitly naming the client proxy class

- Verified compatibility with Visual Studio 2015

- Fixed #11: Handle JSON object with the same name but different properties

- Fixed #12: Separate JSON schema includes into their own subdirectory

- Fixed #13: Support for nested JSON schemas

- Fixed #15: Null reference when parsing bodyless traits

- Fixed #16: Support for resolving project paths on any drive

- Fixed #21: Handle properties that have no setters

Release 1.1.0 notes:

- Add RAML reference dialog now allows browsing Exchange for public and private APIs

- Ability to reverse engineer a RAML definition from an existing WebApi (Enable RAML metadata output)

- Compatibility with broader set of RAML definitions

- Improved support for complex JSON schemas (fstab sample)

- Support for enums in JSON schemas

- Collection types now implement IList rather than ICollection

- Sub-resources appear nested beneath parent resource to prevent conflicts

- Force boolean values to lowercase during serialization to provide compatibility with ApiKit

Release 1.0 has many improvements over 0.9:

- Support for schema validation in the WebApi implementation

- Allow T4 templates to be customized per project (and source controlled)

- Types declared by schema property are respected in model generation

- Support for complex schemas, including $ref properties (see example 2 from json-schema.org)

- Improved ability to drive model generation using custom parameters in RAML

- Collections are now implemented as IList rather than array types

- RAML comments are now included in the implementation class to make code required more obvious

- Sub-resources now appear nested beneath the parent resource in the model

- The API client proxy name is now different to the enclosing namespace to improve intellisense

- Bug fixes to support a wider set of RAML contracts

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
© 2025 Microsoft