Blog

Relax 4.1.0 Released

Jon Clausen May 07, 2020

Spread the word

Jon Clausen

May 07, 2020

Spread the word


Share your thoughts

We are so excited to bring you the release of Relax version 4.1.0 for Coldbox. Though the release version is minor, this version contains a number of enhancements to OpenAPI v3 support, including better formatting and display of the new-to-3.0 requestBody schema and properties. In addition the user experience has been greatly improved as the UI has been rewritten in VueJS and is now optimized for displaying large API documents with hundreds of routes and thousands of methods. Enjoy!

Relax v4.1.0

Improvements

  • Converts the UI from a BackboneJS implementation to VueJS
  • Performance improvements in rendering large APIs
  • Theme and nested objects updated for better meta/list rendering and display

Features

  • Adds additional support for OpenAPI v3 schema definitions ( content, items )
  • Adds auto-generation of examples from schema from examples defined within items/properties, when not explicitly provided
  • Adds a module setting to exclude APIs from display listings

Compat

  • Removes the direct export of PDF documents due to lack of HTML5 support w/in CFDocument. Export button now routes to HTML after providing PDF print instructions
  • Additional OpenAPI v3.x support

System Requirements

  • Lucee 5+
  • ColdFusion 2016+

Installation

Use CommandBox to install:

box install relax

Configuration

You will need to add ColdBox.cfc with a relax structure under the moduleSettings struct with your preferred settings for Relax.

moduleSettings = {
	relax = {
		// The location of the relaxed APIs, defaults to models.resources
		APILocation = "modules.relax.models.resources",
		// Default API to load, name of the directory inside of resources
		defaultAPI = "myapi",
		// APIs to be excluded from display - may be a list or an array and items may include Regex
		exclude         = "",
		// History stack size, the number of history items to retain in the Relaxer test tool
		maxHistory = 10
	}
};

Modeling

You can look at the samples inside of this module under the models/resources directory. To start you can copy the Relax.cfc into your own project folder and then start spicing up the API via the RelaxDSL methods.

Add Your Comment

Recent Entries

BoxLang: Available for Chromebook!

BoxLang: Available for Chromebook!

Chromebooks are fantastic for developers because they can install a Debian Linux container alongside Chrome OS. This makes running and developing BoxLang applications on your Chromebook simple. Chromebooks have gained popularity among developers and students due to their unique blend of affordability, portability, and robust integration with Linux. By bringing BoxLang to Chromebooks, we are creating a powerful platform for learning and development. Here’s why BoxLang on Chromebooks is a perfect match for students:

Maria Jose Herrera
Maria Jose Herrera
June 13, 2024
ColdBox 7 Workshop 2023: Mission Accomplished!

ColdBox 7 Workshop 2023: Mission Accomplished!

Our two-day ColdBox 7 Workshop of 2023 has concluded, and it was an exciting journey of knowledge and skill-building. Our attendees came, saw, and conquered, learning a treasure trove of materials, techniques, tools, and resources to enhance their projects with ColdBox 7 mastery. It was a fantastic ride, indeed!

Maria Jose Herrera
Maria Jose Herrera
June 13, 2024
May Newsletter 2024!

May Newsletter 2024!

May 2024 Updates & News

Welcome to Ortus Solutions’ monthly roundup, where we're thrilled to showcase cutting-edge advancements, product updates, and exciting events! Join us as we delve into the latest innovations shaping the future of technology. Let’s get started!

...

Maria Jose Herrera
Maria Jose Herrera
June 06, 2024