Skip to content

Commit

Permalink
Add changelog
Browse files Browse the repository at this point in the history
  • Loading branch information
shalvah committed Oct 24, 2020
1 parent 9b77c70 commit 4564805
Show file tree
Hide file tree
Showing 2 changed files with 100 additions and 84 deletions.
96 changes: 96 additions & 0 deletions CHANGELOG.1-2.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,96 @@
# Changelog
All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project aims to adhere to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## 1.9.1 (Monday, 19 October, 2020)
### Fixes
- Set correct base URL protocol for Postman collection (https://github.com/knuckleswtf/scribe/pull/114)

## 1.9.0 (Thursday, 1 October, 2020)
### Changes
- Start database transaction much earlier and close it much later for ApiResource and Transformer strategies. Also set current route properly when resolving (https://github.com/knuckleswtf/scribe/pull/104)

## 1.8.3 (Thursday, 17 September, 2020)
### Fixes
- Reverts 1.8.2 as it broke a few things (https://github.com/knuckleswtf/scribe/commit/5a2217513945bcb92ca26e463f7717c0efb99ac1)

## 1.8.2 (Thursday, 17 September, 2020)
### Fixes
- Regex in URL parameters shouldn't fuck the generated examples up anymore (https://github.com/knuckleswtf/scribe/commit/cf44fbbcd3643086859ba724f6e4d4315941b471)

## 1.8.1 (Thursday, 17 September, 2020)
### Fixes
- Printing form data body parameters no longer throws an error with nested arrays or objects (https://github.com/knuckleswtf/scribe/commit/33a58a18a8712d20ab90c06bf0bb087f6fb5869a)

## 1.8.0 (Tuesday, 15 September, 2020)
- Lumen 8 support
- Fixed Laravel 8 + legacy factories support
- Fixed the OpenAPI route for `laravel` type docs (https://github.com/knuckleswtf/scribe/pull/96)

## 1.7.0 (Saturday, 12 September, 2020)
Laravel 8 support

## 1.6.0 (Tuesday, 8 September, 2020)
### Additions
- New `description` field, where you can add a description of your API. This field will be used as the `info.description` field in the Postman collection and OpenAPI spec, and as the first paragraph under the "Introduction" section on the generated webpage, before the `intro_text`. (https://github.com/knuckleswtf/scribe/pull/90/commits/dc356f3f2b13732d567dbee88dad07fc0441f40e)
- Postman collection `auth` information is now populated from Scribe's auth info. (https://github.com/knuckleswtf/scribe/pull/90/commits/33c00a7a0b915e9cbedccdb13d7cb4fcc3c76dc5)

#### Changes
- Postman collection schema version has been updated to 2.1.0. (https://github.com/knuckleswtf/scribe/pull/90/commits/cc7e4cbfae08999f555f7a105ab3c2993fdbb2c1)
- The `float` type is now `number`: Previously, `float` was used in the generated webpage as the default type for non-integer numbers, in alignment with PHP's type system. We've changed this to `number`, to align with standards like OpenAPI and JSON types. You can still use `float` in your annotations, but it will be rendered as `number`. (https://github.com/knuckleswtf/scribe/pull/90/commits/66993d2d2c7a1a57806960dd4cc428068fb0f589)
- [Internal] Reworked PostmanCollectionWriter API: The `PostmanCollectionWriter` has been reworked to be more in line with the `OpenAPISpecWriter`. See the class for details.

#### Deprecations
- Deprecated `postman.auth` in favour of `postman.overrides`: It didn't make sense to have two ways of setting Postman-specific auth information (`postman.auth` and `postman.overrides`). Will be removed in v2.
- Deprecated Postman-specific `postman.description` in favour of `description`. Will be removed in v2.

## 1.5.0 (Thursday, 3 September, 2020)
### Additions
- Added `auth.placeholder` value so you can customise the placeholder API users will see in the example requests. (https://github.com/knuckleswtf/scribe/pull/84)
- Added `Generator::getRouteBeingProcessed()` method that returns the current route. (https://github.com/knuckleswtf/scribe/pull/79)

### Fixes
- Response calls should now properly start/stop database transactions for all connections (https://github.com/knuckleswtf/scribe/pull/89)
- Generated OpenAPI spec should now correctly use `"apiKey"` as the value of `type` in the security scheme (https://github.com/knuckleswtf/scribe/commit/896c2132ad3a2cfe89e0fba524aa489661823a11)

## 1.4.1 (Monday, 24 August, 2020)
### Fixed
- Set proper defaults for Postman overrides, handle empt array examples in OAS (https://github.com/knuckleswtf/scribe/pull/77)

## 1.4.0 (Sunday, 23 August, 2020)
### Added
- Support for resourceKey in Transformers(https://github.com/knuckleswtf/scribe/pull/73)
- OpenAPI (Swagger) spec generation (https://github.com/knuckleswtf/scribe/pull/75)
- Ability to override specific fields in generated Postman collection and OpenAPI spec (https://github.com/knuckleswtf/scribe/pull/76)

## 1.3.0 (Friday, 17 July, 2020)
### Fixed
- Provided option to bypass database drivers that don't support transactions (https://github.com/knuckleswtf/scribe/pull/55, https://github.com/knuckleswtf/scribe/pull/57)

## 1.2.0 (Sunday, 5 July, 2020)
### Added
- Include raw request URL in Postman collection (https://github.com/knuckleswtf/scribe/pull/43)

## 1.1.1 (Friday, 3 July, 2020)
### Fixed
- Support HEAD-only endpoints (https://github.com/knuckleswtf/scribe/pull/54)

## 1.1.0 (Monday, 1 June, 2020)
### Modified
- Added ability to set postman base_url independently (https://github.com/knuckleswtf/scribe/pull/31)

## 1.0.3 (Monday, 25 May, 2020)
### Modified
- Updated dependencies (https://github.com/knuckleswtf/scribe/pull/26)

## 1.0.2 (Sunday, 24 May, 2020)
### Fixed
- Set badge colour for OPTIONS method too. (https://github.com/knuckleswtf/scribe/commit/ccce82cf75502493d776a4ec2378de9cda1659f3)

## 1.0.1 (Saturday, 23 May, 2020)
### Fixed
- Pinned erusev/parsedown dependency (from mnapoli/front-yaml) to ^1.7.4 to fix incompatibilities. (https://github.com/knuckleswtf/scribe/commit/fd623238852dca0e77aa88e86220830d71a460d4)

## 1.0.0 (Saturday, 23 May, 2020)
See [what's new](https://scribe.readthedocs.io/en/latest/whats-new.html) and the [migration guide](https://scribe.readthedocs.io/en/latest/migrating.html).
88 changes: 4 additions & 84 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,94 +3,14 @@ All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project aims to adhere to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## 1.9.1 (Monday, 19 October, 2020)
## <Version> (<Release date>)
### Fixes
- Set correct base URL protocol for Postman collection (https://github.com/knuckleswtf/scribe/pull/114)

## 1.9.0 (Thursday, 1 October, 2020)
### Changes
- Start database transaction much earlier and close it much later for ApiResource and Transformer strategies. Also set current route properly when resolving (https://github.com/knuckleswtf/scribe/pull/104)

## 1.8.3 (Thursday, 17 September, 2020)
### Fixes
- Reverts 1.8.2 as it broke a few things (https://github.com/knuckleswtf/scribe/commit/5a2217513945bcb92ca26e463f7717c0efb99ac1)

## 1.8.2 (Thursday, 17 September, 2020)
### Fixes
- Regex in URL parameters shouldn't fuck the generated examples up anymore (https://github.com/knuckleswtf/scribe/commit/cf44fbbcd3643086859ba724f6e4d4315941b471)

## 1.8.1 (Thursday, 17 September, 2020)
### Fixes
- Printing form data body parameters no longer throws an error with nested arrays or objects (https://github.com/knuckleswtf/scribe/commit/33a58a18a8712d20ab90c06bf0bb087f6fb5869a)

## 1.8.0 (Tuesday, 15 September, 2020)
- Lumen 8 support
- Fixed Laravel 8 + legacy factories support
- Fixed the OpenAPI route for `laravel` type docs (https://github.com/knuckleswtf/scribe/pull/96)

## 1.7.0 (Saturday, 12 September, 2020)
Laravel 8 support

## 1.6.0 (Tuesday, 8 September, 2020)
### Additions
- New `description` field, where you can add a description of your API. This field will be used as the `info.description` field in the Postman collection and OpenAPI spec, and as the first paragraph under the "Introduction" section on the generated webpage, before the `intro_text`. (https://github.com/knuckleswtf/scribe/pull/90/commits/dc356f3f2b13732d567dbee88dad07fc0441f40e)
- Postman collection `auth` information is now populated from Scribe's auth info. (https://github.com/knuckleswtf/scribe/pull/90/commits/33c00a7a0b915e9cbedccdb13d7cb4fcc3c76dc5)

#### Changes
- Postman collection schema version has been updated to 2.1.0. (https://github.com/knuckleswtf/scribe/pull/90/commits/cc7e4cbfae08999f555f7a105ab3c2993fdbb2c1)
- The `float` type is now `number`: Previously, `float` was used in the generated webpage as the default type for non-integer numbers, in alignment with PHP's type system. We've changed this to `number`, to align with standards like OpenAPI and JSON types. You can still use `float` in your annotations, but it will be rendered as `number`. (https://github.com/knuckleswtf/scribe/pull/90/commits/66993d2d2c7a1a57806960dd4cc428068fb0f589)
- [Internal] Reworked PostmanCollectionWriter API: The `PostmanCollectionWriter` has been reworked to be more in line with the `OpenAPISpecWriter`. See the class for details.

#### Deprecations
- Deprecated `postman.auth` in favour of `postman.overrides`: It didn't make sense to have two ways of setting Postman-specific auth information (`postman.auth` and `postman.overrides`). Will be removed in v2.
- Deprecated Postman-specific `postman.description` in favour of `description`. Will be removed in v2.

## 1.5.0 (Thursday, 3 September, 2020)
### Additions
- Added `auth.placeholder` value so you can customise the placeholder API users will see in the example requests. (https://github.com/knuckleswtf/scribe/pull/84)
- Added `Generator::getRouteBeingProcessed()` method that returns the current route. (https://github.com/knuckleswtf/scribe/pull/79)

### Fixes
- Response calls should now properly start/stop database transactions for all connections (https://github.com/knuckleswtf/scribe/pull/89)
- Generated OpenAPI spec should now correctly use `"apiKey"` as the value of `type` in the security scheme (https://github.com/knuckleswtf/scribe/commit/896c2132ad3a2cfe89e0fba524aa489661823a11)

## 1.4.1 (Monday, 24 August, 2020)
### Fixed
- Set proper defaults for Postman overrides, handle empt array examples in OAS (https://github.com/knuckleswtf/scribe/pull/77)

## 1.4.0 (Sunday, 23 August, 2020)
### Added
- Support for resourceKey in Transformers(https://github.com/knuckleswtf/scribe/pull/73)
- OpenAPI (Swagger) spec generation (https://github.com/knuckleswtf/scribe/pull/75)
- Ability to override specific fields in generated Postman collection and OpenAPI spec (https://github.com/knuckleswtf/scribe/pull/76)

## 1.3.0 (Friday, 17 July, 2020)
### Fixed
- Provided option to bypass database drivers that don't support transactions (https://github.com/knuckleswtf/scribe/pull/55, https://github.com/knuckleswtf/scribe/pull/57)

## 1.2.0 (Sunday, 5 July, 2020)
### Added
- Include raw request URL in Postman collection (https://github.com/knuckleswtf/scribe/pull/43)

## 1.1.1 (Friday, 3 July, 2020)
### Fixed
- Support HEAD-only endpoints (https://github.com/knuckleswtf/scribe/pull/54)

## 1.1.0 (Monday, 1 June, 2020)
### Modified
- Added ability to set postman base_url independently (https://github.com/knuckleswtf/scribe/pull/31)

## 1.0.3 (Monday, 25 May, 2020)
### Modified
- Updated dependencies (https://github.com/knuckleswtf/scribe/pull/26)

## 1.0.2 (Sunday, 24 May, 2020)
### Fixed
- Set badge colour for OPTIONS method too. (https://github.com/knuckleswtf/scribe/commit/ccce82cf75502493d776a4ec2378de9cda1659f3)

## 1.0.1 (Saturday, 23 May, 2020)
### Fixed
- Pinned erusev/parsedown dependency (from mnapoli/front-yaml) to ^1.7.4 to fix incompatibilities. (https://github.com/knuckleswtf/scribe/commit/fd623238852dca0e77aa88e86220830d71a460d4)
### Removals

## 1.0.0 (Saturday, 23 May, 2020)
See [what's new](https://scribe.readthedocs.io/en/latest/whats-new.html) and the [migration guide](https://scribe.readthedocs.io/en/latest/migrating.html).
## 2.0.0 (Saturday, 24 October 2020)
See https://scribe.readthedocs.io/en/latest/migrating-v2.html

0 comments on commit 4564805

Please sign in to comment.