Awesome
Ballerina - AsyncAPI Tools
The AsyncAPI Specification is a specification, which creates an event driven architecture based contract for APIs detailing all of its resources and channels in both human and machine-readable format for easy development, discovery, and integration. AsyncAPI tools currently s the following capabilities.
- Generate Ballerina client code from a given AsyncAPI contract with
http
andws
protocols. - Export the AsyncAPI definition of a Ballerina service using the
ws
protocol. - The asyncapi command in Ballerina is used for AsyncAPI to Ballerina and Ballerina to AsyncAPI code generations.
The asyncapi
command in Ballerina is used for AsyncAPI to Ballerina and Ballerina to AsyncAPI code generations.
Building from the Source
Setting Up the Prerequisites
-
OpenJDK 21 (Adopt OpenJDK or any other OpenJDK distribution)
Info: You can also use Oracle JDK. Set the JAVA_HOME environment variable to the pathname of the directory into which you installed JDK.
-
Export GitHub Personal access token with read package permissions as follows,
export packageUser=<Username> export packagePAT=<Personal access token>
Building the Source
Execute the commands below to build from the source.
-
To build the library:
./gradlew clean build
-
To run the integration tests:
./gradlew clean test
-
To build the module without the tests:
./gradlew clean build -x test
-
To publish to maven local:
./gradlew clean build publishToMavenLocal
Contributing to Ballerina
As an open-source project, Ballerina welcomes contributions from the community.
For more information, go to the contribution guidelines.
Code of Conduct
All contributors are encouraged to read the Ballerina Code of Conduct.
Useful Links
- Chat live with us via our Discord server.
- Post all technical questions on Stack Overflow with the #ballerina tag.