SARL Documentation

• 1. Getting Started
• 2. Frequently Asked Questions (FAQ)
• 3. Tutorials
• 3.1. Base Exercises
• 3.2. Event Communication
• 3.3. Parallel Execution
• 3.4. Action Selection Architectures
• 3.5. Organizational Patterns
• 3.6. SARL Run-time Environment
• 4. Best Practices with SARL
• 5. Reference Documentation
• 5.1. General Syntax
• 5.2. Agent-Oriented Programming
• 5.3. Object-Oriented Programming
• 5.4. SARL Development Toolkit (SDK) and Programming Interface (API)
• 6. Compilation and Generation Infrastructure
• 7. Execution and Run-Time Environment
• 7.1. Run-time Behavior of SARL Programs
• 7.2. Janus SRE
• 8. Other Tools
• 8.1. Syntax Highlightning
• 8.2. Apache Maven
• 8.3. Command Line Tools
• 9. Documentation Format
• 10. Legal Notice

1. Getting Started

• Install SARL Tools
• Create First Project
• Agent Definition Introduction
• Run SARL Agent in the Eclipse IDE
• Run SARL Agent from the Command Line
• Run SARL Agent from a Java Program or a SARL class

2. Frequently Asked Questions (FAQ)

• General FAQ on SARL
• SARL Syntax FAQ
• Runtime Environment FAQ
• What are the deprecated and removed features?

3. Tutorials

3.1. Base Exercises

• Base of syntax
• Strings of characters
• Lists
• Maps or dictionaries
• Functions or actions
• Lambda Expressions
• Object-Oriented Classes

3.2. Event Communication

• Agent Communication with the ping-pong agents
• Agent Communication in sub-space with the ping-pong agents
• Override the agent event bus with the Behaviors capacity

3.3. Parallel Execution

• Parallel execution within the agents
• Initialization of a multiagent system

3.4. Action Selection Architectures

• Goal-oriented Action Selection from Video Game Field

3.5. Organizational Patterns

• English Auction with Holons

3.6. SARL Run-time Environment

• Creating a runnable application file with embedded SRE.
• Creating an extension for the Janus SRE

4. Best Practices with SARL

• Event Creation with a Builder
• Event Handler Overriding
• Creating Space with Operation User Accessibility

5. Reference Documentation

5.1. General Syntax

• General Syntax Reference
• Structural elements;
  • Script format
  • Function declaration
  • Synthetic Functions
• Type system:
  • Supported Types for Variables and Parameters
• Constant expressions:
  • Numerical, string, and collection literals
• Structuring expressions:
  • Block expression
  • If-then-else expression
  • Switch expression
  • Loops
  • Lambda expressions
• Standard expressions:
  • Variable and attribute declarations
  • Operators
  • Type casting
  • Access to object members
  • Extension methods
  • Synchronization expression
• Errors and exceptions:
  • Exceptions
  • Assertions
• Meta-programming:
  • Active annotations
• Compiler Errors
• Comparison between SARL and other Languages

5.2. Agent-Oriented Programming

• Event Reference
• Capacity Reference
• Skill Reference
• Agent Reference
• Behavior Reference
• Built-in Capacity Reference
• Space Reference
• Management of the Failures and Validation Errors
• Compiler Errors

5.3. Object-Oriented Programming

• Basic Object-Oriented Programming Support
• Comparison between SARL and other Languages
• Compiler Errors

5.4. SARL Development Toolkit (SDK) and Programming Interface (API)

• Programmatic Access to the SARL Run-time Environment
• Naming and Namespaces
• SRE Observation and Probes

6. Compilation and Generation Infrastructure

• Compiler Errors
• Basics of the SARL Compilation Process
• Generation to the Python Language

7. Execution and Run-Time Environment

7.1. Run-time Behavior of SARL Programs

• Run-time Behavior of SARL Programs

7.2. Janus SRE

• Janus SRE Official Page
• Creating extensions for Janus
• Official Janus Extensions:
  • Connecting Janus nodes over a computer network
• Command-line Tools:
  • janus: launching SARL agents with the Janus platform.
  • janusnode: launching SARL agents with the Janus platform over a computer network.

8. Other Tools

8.1. Syntax Highlightning

• Syntax highlighting styles for SARL inside other tools

8.2. Apache Maven

• maven-sarl-plugin: the Maven plugin for the SARL compiler.

8.3. Command Line Tools

• sarlc: command-line SARL compiler.
• sarldoc: command-line SARL documentation generator.

9. Documentation Format

• Specific Markdown format for the documentation

10. Legal Notice

• Specification: SARL General-purpose Agent-Oriented Programming Language (“Specification”)
• Version: 0.14
• Status: Draft Release
• Release: 2023-09-26

Copyright © 2014-2023 SARL.io, the Original Authors and Main Authors.

Documentation text and medias are licensed under the Creative Common CC-BY-SA-4.0; you may not use this file except in compliance with CC-BY-SA-4.0. You may obtain a copy of CC-BY-4.0.

Examples of SARL code are licensed under the Apache License, Version 2.0; you may not use this file except in compliance with the Apache License. You may obtain a copy of the Apache License.

You are free to reproduce the content of this page on copyleft websites such as Wikipedia.

Generated with the translator docs.generator 0.14.0-SNAPSHOT.