Skip to content

Commit dbcaa0b

Browse files
authored
Merge branch 'main' into development
2 parents 57953e1 + 9ece0e8 commit dbcaa0b

1 file changed

Lines changed: 60 additions & 59 deletions

File tree

changelog.md

Lines changed: 60 additions & 59 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
1919

2020
### Fixed
2121

22-
* Fix `box.json` version of `swagger-sdk`
22+
- Fix `box.json` version of `swagger-sdk`
2323

2424
## [3.0.0] - 2024-05-30
2525

@@ -43,156 +43,157 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
4343

4444
### Added
4545

46-
* Added the ability to excludes routes by prefix
46+
- Added the ability to excludes routes by prefix
4747

4848
## [2.5.1] => 2021-MAY-12
4949

5050
### Fixed
5151

52-
* Regression on `@tags` being json syntax
52+
- Regression on `@tags` being json syntax
5353

5454
## [2.5.0] => 2021-MAY-10
5555

5656
### Added
5757

58-
* Added the ability to add `@tags` to annotations so they can show up on the operations metadata as array of `tags`
58+
- Added the ability to add `@tags` to annotations so they can show up on the operations metadata as array of `tags`
5959

6060
## [2.4.0] => 2021-MAY-04
6161

6262
### Removed
6363

64-
* Removed `externalDocs` from the `info` struct as it is not supported on the OpenApi Spec v3.
64+
- Removed `externalDocs` from the `info` struct as it is not supported on the OpenApi Spec v3.
6565

6666
### Changed
6767

68-
* `operationID` renamed to `x-coldbox-operation` since they are ColdBox centric. It was also causing issues using `operationID` as it needed to be unique across the entire swagger document.
68+
- `operationID` renamed to `x-coldbox-operation` since they are ColdBox centric. It was also causing issues using `operationID` as it needed to be unique across the entire swagger document.
6969

7070
## [2.3.0] => 2020-SEP-08
7171

7272
### Added
7373

74-
* Add CORS support for cbswagger endpoint #25
74+
- Add CORS support for cbswagger endpoint #25
7575

7676
## [2.2.1] => 2020-MAY-12
7777

7878
### Fixed
7979

80-
* On lucee the `displayName` defaults to `Component`, skipping this default to select the correct `operationId` for the resource
81-
* The `moduleName` hint for the `appendFunctionInfo` was mispelled
80+
- On lucee the `displayName` defaults to `Component`, skipping this default to select the correct `operationId` for the resource
81+
- The `moduleName` hint for the `appendFunctionInfo` was mispelled
8282

8383
## [2.2.0] => 2020-MAY-12
8484

8585
### Added
8686

87-
* When defining external files in annotations, you can now prefix them with `~` and this will expand to the module setting of `samplesPath`. This way you can write your annotations in a more cleaner manner.
88-
* Auto-publishing of changelog's to github
89-
* New changelog looks according to keepachangelog.com
87+
- When defining external files in annotations, you can now prefix them with `~` and this will expand to the module setting of `samplesPath`. This way you can write your annotations in a more cleaner manner.
88+
- Auto-publishing of changelog's to github
89+
- New changelog looks according to keepachangelog.com
9090

9191
## [2.1.1] => 2020-MAY-06
9292

93-
* Updates to support ColdBox 6
93+
- Updates to support ColdBox 6
9494

9595
## [2.1.0] => 2020-APR-16
9696

9797
### Features
9898

99-
* Allow `@security` annotation to override the security mechanisms defined in config. The value can be a JSON array of security directives, a file pointer, or for convenience the name of a security schema. See readme for examples.
100-
* Support for discovering responses and examples by conventions in the `resources/apidocs` folder convention. See readme for examples.
101-
* Ability to exclude routes from the generated spec via the `excludeRoutes` configuration key.
99+
- Allow `@security` annotation to override the security mechanisms defined in config. The value can be a JSON array of security directives, a file pointer, or for convenience the name of a security schema. See readme for examples.
100+
- Support for discovering responses and examples by conventions in the `resources/apidocs` folder convention. See readme for examples.
101+
- Ability to exclude routes from the generated spec via the `excludeRoutes` configuration key.
102102

103103
### Improvements
104104

105-
* Add default `samplesPath` config item to `resources/apidocs` in the ModuleConfig
106-
* Add convention samples parsing and refactor segment parsing to separate methods
105+
- Add default `samplesPath` config item to `resources/apidocs` in the ModuleConfig
106+
- Add convention samples parsing and refactor segment parsing to separate methods
107107

108108
### Bugs
109109

110-
* Fixes for new router syntax not parsing actions correctly or not taking into account actions attached to verbs
110+
- Fixes for new router syntax not parsing actions correctly or not taking into account actions attached to verbs
111111

112112
## [2.0.0] => 2019-SEP-02
113113

114-
* `feature`: Upgraded to swagger-sdk 2.0.0 to support OpenAPI 3.0.x. A great guide on migrating is here: <https://blog.readme.io/an-example-filled-guide-to-swagger-3-2/>
114+
- `feature`: Upgraded to swagger-sdk 2.0.0 to support OpenAPI 3.0.x. A great guide on migrating is here: <https://blog.readme.io/an-example-filled-guide-to-swagger-3-2/>
115115

116-
* Migrated `cbswagger` settings to the `moduleSettings` struct instead of top-level in the `config/ColdBox.cfc`. Make sure you move your settings.
117116

118-
* `feature` : You can now pass a `format` to the `/cbswagger` endpoint to either get the OpenAPI doc as `json` or `yml`. Eg: `/cbswagger?format=yml`
117+
- Migrated `cbSwagger` settings to the `moduleSettings` struct instead of top-level in the `config/ColdBox.cfc`. Make sure you move your settings.
119118

120-
* `feature` : You have two distinct routes for the json and yml formats: `/cbswagger/json` and `/cbswagger/yml`
119+
- `feature` : You can now pass a `format` to the `/cbSwagger` endpoint to either get the OpenAPI doc as `json` or `yml`. Eg: `/cbswagger?format=yml`
121120

122-
* You can choose your default output format via the module settings: `defaultFormat` setting. Valid options are `json` and `yml`
121+
- `feature` : You have two distinct routes for the json and yml formats: `/cbSwagger/json` and `/cbSwagger/yml`
123122

124-
* `features` : Support for ColdBox 5 event routing and response routing.
123+
- You can choose your default output format via the module settings: `defaultFormat` setting. Valid options are `json` and `yml`
125124

126-
* `improvement` : You can now tag your handlers with a `displayName` that will be used for operation ID building
125+
- `features` : Support for ColdBox 5 event routing and response routing.
127126

128-
* `improvement` : Improved the way operation Ids are reported so they can be unique when reusing handler actions.
127+
- `improvement` : You can now tag your handlers with a `displayName` that will be used for operation ID building
129128

130-
* `improvement` : Refactored `createLinkedHashMap()` -> `structNew( "ordered" )`
129+
- `improvement` : Improved the way operation Ids are reported so they can be unique when reusing handler actions.
131130

132-
* `improvement`: Removed lucee 4.5, acf11 support.
131+
- `improvement` : Refactored `createLinkedHashMap()` -> `structNew( "ordered" )`
132+
133+
- `improvement`: Removed lucee 4.5, acf11 support.
133134

134135
## 1.4.1
135136

136-
* Fix for detecting ColdBox 5
137+
- Fix for detecting ColdBox 5
137138

138139
## 1.4.0
139140

140-
* Update build process for new module standards
141-
* ColdBox 5 Compatiblity for inherited entry points
142-
* Non RESTFul action params where not being translated on routes.
143-
* Fixed `int32` to `integer` on examples and tests so they can validate in the schema
141+
- Update build process for new module standards
142+
- ColdBox 5 Compatiblity for inherited entry points
143+
- Non RESTFul action params where not being translated on routes.
144+
- Fixed `int32` to `integer` on examples and tests so they can validate in the schema
144145

145146
## 1.3.0
146147

147-
* Added Editor standards
148-
* Fix to modules invocation path on RouteParser when no cfmapping defined.
149-
* Updates to readme
150-
* Set the contact object and license object according to spec 2 defaults
151-
* Default the API schemes to http/s
152-
* Dropped cf10 from automated tests
153-
* Added API Docs to S3 via Travis
148+
- Added Editor standards
149+
- Fix to modules invocation path on RouteParser when no cfmapping defined.
150+
- Updates to readme
151+
- Set the contact object and license object according to spec 2 defaults
152+
- Default the API schemes to http/s
153+
- Dropped cf10 from automated tests
154+
- Added API Docs to S3 via Travis
154155

155156
## 1.2.1
156157

157-
* Fixes a bug where an error was thrown when an api route does not contain a handler
158-
* Implements parsing of Coldbox route parameter types
158+
- Fixes a bug where an error was thrown when an api route does not contain a handler
159+
- Implements parsing of Coldbox route parameter types
159160

160161
## 1.2.0
161162

162-
* Adds new function metadata handling for parameters and responses
163-
* Auto maps hints provided in function metadata to as method descriptions
163+
- Adds new function metadata handling for parameters and responses
164+
- Auto maps hints provided in function metadata to as method descriptions
164165

165166
## 1.1.2
166167

167-
* Add `$ref` sanitization and inherited metadata introspection
168-
* Add the ability to handle arrays returned from `$ref` keys. Prepends moudule routing to operation id
169-
* ACF syntax corrections and add better throw for attempts to parse component with syntax errors
168+
- Add `$ref` sanitization and inherited metadata introspection
169+
- Add the ability to handle arrays returned from `$ref` keys. Prepends moudule routing to operation id
170+
- ACF syntax corrections and add better throw for attempts to parse component with syntax errors
170171

171172
## 1.1.0
172173

173-
* Normalization to new module templates
174-
* HTTP Verbs should be lower case [#1](https://github.com/coldbox-modules/cbswagger/issues/1)
174+
- Normalization to new module templates
175+
- HTTP Verbs should be lower case [#1](https://github.com/coldbox-modules/cbSwagger/issues/1)
175176

176177
## 1.0.3
177178

178-
* Exception when `handler` or `module` does not exist in a route.
179+
- Exception when `handler` or `module` does not exist in a route.
179180

180181
## 1.0.2
181182

182-
* Overall syntax Ortus standards
183-
* Some var scoping issues
184-
* Added persistence and injections to services
185-
* Added more documentation to handler, services and readme
186-
* Added swagger-sdk as a module dependency
183+
- Overall syntax Ortus standards
184+
- Some var scoping issues
185+
- Added persistence and injections to services
186+
- Added more documentation to handler, services and readme
187+
- Added swagger-sdk as a module dependency
187188

188189
## 1.0.1
189190

190-
* Add module introspection
191-
* Forgebox integration updates
191+
- Add module introspection
192+
- Forgebox integration updates
192193

193194
## 1.0.0
194195

195-
* Initial Module Release
196+
- Initial Module Release
196197

197198
[Unreleased]: https://github.com/coldbox-modules/cbSwagger/compare/v3.1.2...HEAD
198199

0 commit comments

Comments
 (0)