Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[2201.11.0] Update OpenAPI changes for U11 #9622

Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
27 commits
Select commit Hold shift + click to select a range
7e03fdc
Update the getting started guide
MaryamZi Nov 18, 2024
5b967ab
Address review suggestions
MaryamZi Nov 18, 2024
76276fa
Merge pull request #9599 from MaryamZi/getting-started-guide
anupama-pathirage Nov 20, 2024
1f2af73
Add 1.2.55 release notes
HindujaB Nov 21, 2024
6bdb2d8
Fix indentation
HindujaB Nov 21, 2024
94a6430
Fix indentation properly
HindujaB Nov 21, 2024
f7b429a
Remove vsix link
HindujaB Nov 21, 2024
a188531
Remove vsix link for 1.2.53
HindujaB Nov 21, 2024
6f16811
Merge pull request #9606 from HindujaB/master
sm1990 Nov 21, 2024
09da595
Fix json syntax error
HindujaB Nov 21, 2024
09e13f8
Merge pull request #9608 from HindujaB/master
sm1990 Nov 21, 2024
6929a6a
Update Ballerina Swan Lake by Examples
Nov 21, 2024
11e0547
Merge pull request #9610 from ballerina-platform/automate-bbes-09e13f…
sm1990 Nov 21, 2024
4278c76
Add release details for 2201.10.3
HindujaB Nov 23, 2024
0fbfb59
Merge pull request #9614 from HindujaB/release-2201.10.3
sm1990 Nov 25, 2024
00e80fe
Merge pull request #9616 from ballerina-platform/release-2201.10.3
keizer619 Nov 25, 2024
f771c2a
Update rl.json
sm1990 Nov 25, 2024
c3391e5
Merge pull request #9618 from ballerina-platform/sm1990-patch-1
sm1990 Nov 25, 2024
79b3778
Fix release details for 2201.10.3
HindujaB Nov 25, 2024
5b9e281
Merge pull request #9619 from HindujaB/release-2201.10.3
sm1990 Nov 25, 2024
2367cbe
Update release note with OpenAPI changes
lnash94 Nov 28, 2024
c5563ec
Add 2201.9.6 release details
HindujaB Nov 29, 2024
1428643
Merge pull request #9623 from HindujaB/release-2201.9.6
sm1990 Nov 29, 2024
bff9010
Merge pull request #9624 from ballerina-platform/release-2201.9.6
sm1990 Nov 29, 2024
d9cc7dc
Merge branch 'ballerina-platform:master' into u11-openapi-release-note
lnash94 Nov 29, 2024
2d42a4c
Fix review suggestions
lnash94 Nov 29, 2024
cc7ed9b
Update RELEASE_NOTE.md
lnash94 Nov 29, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
52 changes: 34 additions & 18 deletions _data/release_notes_versions.json
Original file line number Diff line number Diff line change
Expand Up @@ -1451,27 +1451,43 @@
"rpm-installer":"ballerina-linux-installer-x64-1.2.53.rpm",
"rpm-installer-size":"174mb",
"other-artefacts":[
"ballerina-1.2.53.zip",
"ballerina-1.2.53.vsix"
"ballerina-1.2.53.zip"
],
"api-docs":"ballerina-api-docs-1.2.53.zip",
"release-notes":"ballerina-release-notes-1.2.53.md"
},
{
"version":"1.2.54",
"release-date":"2024-07-26",
"windows-installer":"ballerina-windows-installer-x64-1.2.54.msi",
"windows-installer-size":"272K",
"linux-installer":"ballerina-linux-installer-x64-1.2.54.deb",
"linux-installer-size":"152mb",
"macos-installer":"ballerina-macos-installer-x64-1.2.54.pkg",
"macos-installer-size":"172mb",
"rpm-installer":"ballerina-linux-installer-x64-1.2.54.rpm",
"rpm-installer-size":"175mb",
"other-artefacts":[
"ballerina-1.2.54.zip"
],
"api-docs":"ballerina-api-docs-1.2.54.zip",
"release-notes":"ballerina-release-notes-1.2.54.md"
}
"version":"1.2.54",
"release-date":"2024-07-26",
"windows-installer":"ballerina-windows-installer-x64-1.2.54.msi",
"windows-installer-size":"272K",
"linux-installer":"ballerina-linux-installer-x64-1.2.54.deb",
"linux-installer-size":"152mb",
"macos-installer":"ballerina-macos-installer-x64-1.2.54.pkg",
"macos-installer-size":"172mb",
"rpm-installer":"ballerina-linux-installer-x64-1.2.54.rpm",
"rpm-installer-size":"175mb",
"other-artefacts":[
"ballerina-1.2.54.zip"
],
"api-docs":"ballerina-api-docs-1.2.54.zip",
"release-notes":"ballerina-release-notes-1.2.54.md"
},
{
"version":"1.2.55",
"release-date":"2024-11-20",
"windows-installer":"ballerina-windows-installer-x64-1.2.55.msi",
"windows-installer-size":"272K",
"linux-installer":"ballerina-linux-installer-x64-1.2.55.deb",
"linux-installer-size":"153mb",
"macos-installer":"ballerina-macos-installer-x64-1.2.55.pkg",
"macos-installer-size":"172mb",
"rpm-installer":"ballerina-linux-installer-x64-1.2.55.rpm",
"rpm-installer-size":"175mb",
"other-artefacts":[
"ballerina-1.2.55.zip"
],
"api-docs":"ballerina-api-docs-1.2.55.zip",
"release-notes":"ballerina-release-notes-1.2.55.md"
}
]
36 changes: 18 additions & 18 deletions _data/swanlake-latest/metadata.json
Original file line number Diff line number Diff line change
@@ -1,21 +1,21 @@
{
"version":"2201.10.2",
"short-version":"2201.10.2",
"display-version":"2201.10.2 (Swan Lake Update 10)",
"release-date":"2024-10-16",
"windows-installer":"ballerina-2201.10.2-swan-lake-windows-x64.msi",
"windows-installer-size":"183mb",
"linux-installer":"ballerina-2201.10.2-swan-lake-linux-x64.deb",
"linux-installer-size":"210mb",
"macos-installer":"ballerina-2201.10.2-swan-lake-macos-x64.pkg",
"version":"2201.10.3",
"short-version":"2201.10.3",
"display-version":"2201.10.3 (Swan Lake Update 10)",
"release-date":"2024-11-22",
"windows-installer":"ballerina-2201.10.3-swan-lake-windows-x64.msi",
"windows-installer-size":"182mb",
"linux-installer":"ballerina-2201.10.3-swan-lake-linux-x64.deb",
"linux-installer-size":"213mb",
"macos-installer":"ballerina-2201.10.3-swan-lake-macos-x64.pkg",
"macos-installer-size":"242mb",
"macos-arm-installer":"ballerina-2201.10.2-swan-lake-macos-arm-x64.pkg",
"macos-arm-installer-size":"241mb",
"rpm-installer":"ballerina-2201.10.2-swan-lake-linux-x64.rpm",
"rpm-installer-size":"244mb",
"other-artefacts":[
"ballerina-2201.10.2-swan-lake.zip"
],
"api-docs":"ballerina-api-docs-2201.10.2.zip",
"release-notes":"ballerina-release-notes-2201.10.2.md"
"macos-arm-installer":"ballerina-2201.10.3-swan-lake-macos-arm-x64.pkg",
"macos-arm-installer-size":"242mb",
"rpm-installer":"ballerina-2201.10.3-swan-lake-linux-x64.rpm",
"rpm-installer-size":"245mb",
"other-artefacts":[
"ballerina-2201.10.3-swan-lake.zip"
],
"api-docs":"ballerina-api-docs-2201.10.3.zip",
"release-notes":"ballerina-release-notes-2201.10.3.md"
}
42 changes: 42 additions & 0 deletions _data/swanlake_release_notes_versions.json
Original file line number Diff line number Diff line change
Expand Up @@ -1451,6 +1451,27 @@
"api-docs":"ballerina-api-docs-2201.9.5.zip",
"release-notes":"ballerina-release-notes-2201.9.5.md"
},
{
"version":"2201.9.6",
"short-version":"2201.9.6",
"display-version":"2201.9.6 (Swan Lake Update 9)",
"release-date":"2024-11-29",
"windows-installer":"ballerina-2201.9.6-swan-lake-windows-x64.msi",
"windows-installer-size":"175mb",
"linux-installer":"ballerina-2201.9.6-swan-lake-linux-x64.deb",
"linux-installer-size":"202mb",
"macos-installer":"ballerina-2201.9.6-swan-lake-macos-x64.pkg",
"macos-installer-size":"237mb",
"macos-arm-installer":"ballerina-2201.9.6-swan-lake-macos-arm-x64.pkg",
"macos-arm-installer-size":"236mb",
"rpm-installer":"ballerina-2201.9.6-swan-lake-linux-x64.rpm",
"rpm-installer-size":"239mb",
"other-artefacts":[
"ballerina-2201.9.6-swan-lake.zip"
],
"api-docs":"ballerina-api-docs-2201.9.6.zip",
"release-notes":"ballerina-release-notes-2201.9.6.md"
},
{
"version":"2201.10.0",
"short-version":"2201.10.0",
Expand Down Expand Up @@ -1492,5 +1513,26 @@
],
"api-docs":"ballerina-api-docs-2201.10.1.zip",
"release-notes":"ballerina-release-notes-2201.10.1.md"
},
{
"version":"2201.10.2",
"short-version":"2201.10.2",
"display-version":"2201.10.2 (Swan Lake Update 10)",
"release-date":"2024-10-16",
"windows-installer":"ballerina-2201.10.2-swan-lake-windows-x64.msi",
"windows-installer-size":"183mb",
"linux-installer":"ballerina-2201.10.2-swan-lake-linux-x64.deb",
"linux-installer-size":"210mb",
"macos-installer":"ballerina-2201.10.2-swan-lake-macos-x64.pkg",
"macos-installer-size":"242mb",
"macos-arm-installer":"ballerina-2201.10.2-swan-lake-macos-arm-x64.pkg",
"macos-arm-installer-size":"241mb",
"rpm-installer":"ballerina-2201.10.2-swan-lake-linux-x64.rpm",
"rpm-installer-size":"244mb",
"other-artefacts":[
"ballerina-2201.10.2-swan-lake.zip"
],
"api-docs":"ballerina-api-docs-2201.10.2.zip",
"release-notes":"ballerina-release-notes-2201.10.2.md"
}
]
32 changes: 32 additions & 0 deletions downloads/1.2.x-release-notes/1.2.55.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
---
layout: ballerina-left-nav-release-notes
title: 1.2.55
permalink: /downloads/1.2.x-release-notes/<RELEASE_VERSION>/
active: 1.2.55
---

## Overview of jBallerina 1.2.55

The jBallerina 1.2.55 patch release improves upon the 1.2.54 release by adding security fixes and support for Java 11 in Docker.

You can use the update tool to update to jBallerina 1.2.55 as follows.

**For existing users:**

If you are already using jBallerina version 1.2.14, or above, you can directly update your distribution to jBallerina 1.2.55 by executing the following command:

```
bal dist update
```

However, if you are using

- jBallerina 1.2.0 to 1.2.13, run `ballerina dist update` to update
- jBallerina 1.2.0 but being switched to a previous version, run `ballerina dist pull jballerina-1.2.55` to update
- a jBallerina version below 1.1.0, install via the [installers](https://ballerina.io/downloads/)

**For new users:**

If you have not installed jBallerina, then download the [installers](https://ballerina.io/downloads/) to install.

<style>.cGitButtonContainer, .cBallerinaTocContainer {display:none;}</style>
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
---
layout: ballerina-left-nav-release-notes
title: Swan Lake Update 10 (2201.10.3)
permalink: /downloads/swan-lake-release-notes/2201.10.3/
active: 2201.10.3
---

## Overview of Ballerina Swan Lake Update 10 (2201.10.3)

<em>Swan Lake Update 10 (2201.10.3) is the third patch release of Ballerina 2201.10.0 (Swan Lake Update 10) and it includes a new set of bug fixes to the developer tooling.</em>

## Update Ballerina

Run the command below to update your current Ballerina installation directly to 2201.10.3 by using the [Ballerina Update Tool](/learn/update-tool/).

```
$ bal dist pull 2201.10.3
```

## Install Ballerina

If you have not installed Ballerina, then, download the [installers](/downloads/#swanlake) to install.

## Developer tools updates

### Bug fixes

To view bug fixes, see the GitHub milestone for Swan Lake Update 8 (2201.10.3) of the repositories below.

- [Debugger](https://github.com/ballerina-platform/ballerina-lang/pulls?q=is%3Apr+label%3AArea%2FDebugger+label%3AType%2FBug+is%3Aclosed+milestone%3A2201.10.3)
- [OpenAPI](https://github.com/ballerina-platform/openapi-tools/pulls?q=is%3Apr+label%3AType%2FBug+is%3Aclosed+milestone%3A2201.10.3)
Original file line number Diff line number Diff line change
Expand Up @@ -63,6 +63,56 @@ To view bug fixes, see the [GitHub milestone for Swan Lake Update 11 (2201.11.0)
#### CLI

#### OpenAPI tool
- Introduced the `flatten` sub-command, which flattens the OpenAPI contract file by moving all the inline schemas to the components section. The output is a modified OpenAPI contract.

```
$ bal openapi flatten <openapi.yaml>
```
- Introduced the `sanitize` sub-command, which sanitizes the OpenAPI contract file according to Ballerina's best naming practices. The Ballerina name extensions are added to the schemas which can not be modified directly. The output is a modified OpenAPI contract.

```
$ bal openpai sanitize <openapi.yaml>
```
- Add code generation support with the new Ballerina name extensions. These extensions are mapped as relevant annotations in the generated types, parameters and record fields.

For example,
```yaml
...
paths:
/albums:
get:
tags:
- albums
operationId: getAlbums
parameters:
- name: _artists_
in: query
schema:
type: array
items:
type: string
default: []
x-ballerina-name: artists --->// Ballerina name extension
responses:
"200":
description: Ok
content:
application/json:
schema:
type: array
items:
$ref: "#/components/schemas/Album"
```
Generated Ballerina service type code,
```ballerina
...
resource function get albums(@http:Query {name: "_artists_"} string[] artists = []) returns Album[];
...
```
This code generation support is available for client, service implementation, and service type code generation.


- Added support for relaxed data binding on the client side payload. This enables, `nil` values are treated as optional, and absent fields are handled as `nilable` types.

### Improvements

Expand All @@ -73,7 +123,7 @@ To view bug fixes, see the [GitHub milestone for Swan Lake Update 11 (2201.11.0)
To view bug fixes, see the GitHub milestone for Swan Lake Update 11 (2201.11.0) of the repositories below.

- [Language server](https://github.com/ballerina-platform/ballerina-lang/issues?q=is%3Aissue+label%3ATeam%2FLanguageServer+milestone%3A2201.11.0+is%3Aclosed+label%3AType%2FBug+)
- [OpenAPI](https://github.com/ballerina-platform/openapi-tools/issues?q=is%3Aissue+label%3AType%2FBug+milestone%3A%22Swan+Lake+2201.11.0%22+is%3Aclosed)
- [OpenAPI](https://github.com/ballerina-platform/ballerina-library/issues?q=milestone%3A2201.11.0+is%3Aclosed+label%3Amodule%2Fopenapi-tools+label%3AType%2FBug)

## Ballerina packages updates

Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
---
layout: ballerina-left-nav-release-notes
title: Swan Lake Update 9 (2201.9.6)
permalink: /downloads/swan-lake-release-notes/2201.9.6/
active: 2201.9.6
---

## Overview of Ballerina Swan Lake Update 9 (2201.9.6)

<em>Swan Lake Update 9 (2201.9.6) is the sixth patch release of Ballerina 2201.9.0 (Swan Lake Update 9) and it includes a new set of bug fixes to the developer tooling.</em>

## Update Ballerina

Run the command below to update your current Ballerina installation directly to 2201.9.6 by using the [Ballerina Update Tool](/learn/update-tool/).

```
$ bal dist pull 2201.9.6
```

## Install Ballerina

If you have not installed Ballerina, then, download the [installers](/downloads/#swanlake) to install.

## Developer tools updates

### Bug fixes

To view bug fixes, see the GitHub milestone for Swan Lake Update 9 (2201.9.6) of the repositories below.

- [OpenAPI](https://github.com/ballerina-platform/openapi-tools/pulls?q=is%3Apr+label%3AType%2FBug+is%3Aclosed+milestone%3A2201.9.6)
- [Project API](https://github.com/ballerina-platform/ballerina-lang/pulls?q=is%3Apr+is%3Aclosed+label%3AArea%2FProjectAPI+milestone%3A2201.9.6)
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ export function JmsConsumerAcknowledgement({ codeSnippets }) {

return (
<Container className="bbeBody d-flex flex-column h-100">
<h1>JMS message producer - Manual acknowledgment</h1>
<h1>JMS message consumer - Manual acknowledgment</h1>

<p>
The <code>jms:MessageConsumer</code> allows manual acknowledgment for
Expand Down Expand Up @@ -210,7 +210,7 @@ export function JmsConsumerAcknowledgement({ codeSnippets }) {
<blockquote>
<p>
<strong>Tip:</strong> Run the JMS message producer given in the{" "}
<a href="/learn/by-example/jms-producer-produce-message-send">
<a href="/learn/by-example/jms-producer-produce-message">
JMS message producer - Produce message
</a>{" "}
example to produce a few sample messages to the queue.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ export function JmsConsumerConsumeMessage({ codeSnippets }) {

return (
<Container className="bbeBody d-flex flex-column h-100">
<h1>JMS message producer - Consume messages</h1>
<h1>JMS message consumer - Consume messages</h1>

<p>
The <code>jms:MessageConsumer</code> allows fetching individual messages
Expand Down Expand Up @@ -207,7 +207,7 @@ export function JmsConsumerConsumeMessage({ codeSnippets }) {
<blockquote>
<p>
<strong>Tip:</strong> Run the JMS message producer given in the{" "}
<a href="/learn/by-example/jms-producer-produce-message-send">
<a href="/learn/by-example/jms-producer-produce-message">
JMS message producer - Produce message
</a>{" "}
example to produce some messages to the queue.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -209,7 +209,7 @@ export function JmsServiceConsumeMessage({ codeSnippets }) {
<blockquote>
<p>
<strong>Tip:</strong> Run the JMS message producer given in the{" "}
<a href="/learn/by-example/jms-producer-produce-message-send">
<a href="/learn/by-example/jms-producer-produce-message">
JMS message producer - Produce message
</a>{" "}
example to produce some messages to the queue.
Expand Down
Loading