milanperera/ballerina

Ballerina is a new programming language for integration built on a sequence diagram metaphor.

                           

Ballerina is a simple programming language whose syntax and runtime addresses the integration problems in an agile way. Ballerina is designed to make it easier to write programs that integrate with data sources, services, and network-connected APIs of all kinds. It is optimized primarily for such programs. While it can be used to program anything, it is not recommended to use Ballerina if a significant portion of the program is not related to integrating with data sources, services, or network-connected APIs.

Ballerina is created for and dedicated to developers who want to solve integration problems. Ballerina is inspired by Java, Go, and other languages, and leverages years of experience in the integration domain.

Table of contents

• Getting started
• Download and install
• Contributing to Ballerina
• License
• Useful links

Getting started

You can use one of the following options to try out Ballerina.

• Getting Started
• Quick Tour
• Ballerina by Example
• Ballerina by Guide
• Editors, IDEs and the Ballerina Composer
• Language Specification
• Package and API Documentation

Download and install

Download the binary

You can download the Ballerina distribution at http://ballerinalang.org.

Install from source

Alternatively, you can install Ballerina from the source using the following instructions.

Prerequisites

• Maven
• Node (v8.9.x or latest LTS release) + npm (v5.6.0 or later)
• Docker

Building the source

1. Clone this repository using the following command.

   git clone --recursive https://github.com/ballerinalang/ballerina

   If you download the sources, you need to update the git submodules using the following command.

   git submodule update --init 

2. Run the Maven command mvn clean install from the ballerina root directory.

3. Extract the Ballerina distribution created at distribution/zip/ballerina/target/ballerina-<version>-SNAPSHOT.zip.

Contributing to Ballerina

As an open source project, Ballerina welcomes contributions from the community. To start contributing, read these contribution guidelines for information on how you should go about contributing to our project.

Check the issue tracker for open issues that interest you. We look forward to receiving your contributions.

License

Ballerina code is distributed under Apache license 2.0.

Useful links

• The ballerina-dev@googlegroups.com mailing list is for discussing code changes to the Ballerina project.
• Reach out to us on our Slack channel and integrate with our community.