Language best practices

List of common Ballerina language best practices to follow.

Optionality and nil values

• Represent optionality
• Handle nil values

Values and types

• Use precise types
• Work with value ranges
• Avoid unnecessary type casts

Functions and parameters

• Using included record parameters
• Use expression-bodied functions
• Use tuples to return multiple values

Error handling

• Return errors and use the check
• Avoid unnecessary usage of panic

Records

• Use open vs closed records
• Simplify mapping constructor

Objects

• Avoid unnecessary objects

Working with constants and strings

• Using constants
• Handle unions of string constants
• Handle unions of integer constants
• Generate string by concatenating values

Conditionals

• Avoid parentheses in if statement
• Using match statement

Query expressions

• Using query expressions for iterations