Need help with sarl?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

sarl
114 Stars 36 Forks Apache License 2.0 3.0K Commits 63 Opened issues

Description

SARL Agent-Oriented Programming Language http://www.sarl.io

Services available

!
?

Need anything else?

Contributors list

= SARL Agent Programming Language :toc: right :toc-placement!: :hide-uri-scheme:

image:http://www.sarl.io/images/SARL-logo.png[width=100]

SARL is a general-purpose agent-oriented language, http://www.sarl.io.

SARL aims at providing the fundamental abstractions for dealing with concurrency, distribution, interaction, decentralization, reactivity, autonomy and dynamic reconfiguration. These high-level features are now considered as the major requirements for an easy and practical implementation of modern complex software applications. We are convinced that the agent-oriented paradigm holds the keys to effectively meet this challenge.

Considering the variety of existing approaches and meta-models in the field of agent-oriented engineering and more generally multi-agent systems, our approach remains as generic as possible and highly extensible to easily integrate new concepts and features. The language is platform- and architecture-independent.

However, we provide a first set of tools to support its execution based on the new version 2.0 of the Janus (see http://www.janusproject.io) platform, but it can be linked with other existing agent platforms and frameworks.

image:http://www.sarl.io/images/compilation-process.png[align="center"]

image:https://img.shields.io/badge/Documentation-API-ff69b4.svg?style=flat-square[link=http://www.sarl.io/docs/api/index.html] image:https://img.shields.io/badge/Documentation-Reference-red.svg?style=flat-square[link=http://www.sarl.io/docs/official/index.html] image:https://badges.gitter.im/sarl/Lobby.svg[link=https://gitter.im/sarl/Lobby]

image:https://img.shields.io/badge/Requires-Java%208-yellowgreen.svg?style=flat-square[link=https://www.java.com] image:https://img.shields.io/badge/Interoperable%20with-Java-yellowgreen.svg?style=flat-square[link=https://www.java.com] image:https://img.shields.io/maven-central/v/io.sarl.maven/io.sarl.maven.sdk.svg?label=Available%20on%20Maven%20Central[link=http://search.maven.org/#search%7Cga%7C1%7Cio.sarl] image:https://img.shields.io/badge/Build%20with-Maven-blue.svg?style=flat-square[link=http://maven.apache.org]

image:https://img.shields.io/badge/Based%20on-Xtext-orange.svg?style=flat-square[link=https://eclipse.org/Xtext]

image:https://img.shields.io/github/license/sarl/sarl.svg?style=flat-square[link=https://opensource.org/licenses/Apache-2.0] image:https://cla-assistant.io/readme/badge/sarl/sarl?style=flat-square[link=https://cla-assistant.io/sarl/sarl]

[align="center",width="40%",frame="topbot",cols="2^",options="header"] |========================== 2+| Build Status | *Linux footnote:[Linux 4.15.0-102, OpenJDK 1.8, Maven 3.6.2]** | image:https://ci-ciad.utbm.fr/teamcity/app/rest/builds/buildType:(id:SarlBuild)/statusIcon[link=https://ci-ciad.utbm.fr/teamcity/viewType.html?buildTypeId=SarlBuild&guest=1] | Windows footnote:[Windows Server 2019, version 10.0, OpenJDK 1.8, Maven 3.6.2] | image:https://ci-ciad.utbm.fr/teamcity/app/rest/builds/buildType:(id:SarlGitBuildWindows)/statusIcon[link=https://ci-ciad.utbm.fr/teamcity/viewType.html?buildTypeId=SarlGitBuildWindows&guest=1] | OSX footnote:[OSX 10.12, Xcode 8.3, OracleJDK 1.8.0_112, Maven 3.6.3] | image:https://travis-ci.org/sarl/sarl.svg?branch=master[link=https://travis-ci.org/sarl/sarl] |==========================

toc::[]

== 1. Requirements

  • Java Development Toolkit (JDK) between 1.8 and 11.
  • You may encountering issues if your are using Java 12 or higher with SARL.

== 2. Using SARL

=== 2.1. Recommendations

For making your experience with SARL the best, we recommend you:

  • to enable the assertions at development time (with the
    -ea
    command line option).

=== 2.2. Use the stable version with Maven

The lastest stable version of SARL is available on link:http://search.maven.org/[Maven Central]. Consequently, you could directly include the SARL module into the Maven dependencies of your project:

    ...
    
      io.sarl.maven
      io.sarl.maven.sdk
      0.11.0
    
    ...

Please, replace Version

0.11.0
in the previous snipset by the number of the version you want to use.

=== 2.3. Use of the development version with Maven

New features, enhancements and bug fixes are available in the SNAPSHOT (development) version of SARL. For using this version, you must add the Maven Repository Server of SARL in your pom file:

    ...
    
      
        io.sarl.maven
        io.sarl.maven.sdk
        0.12.0-SNAPSHOT
      
    
    ...
    
      
        io.sarl-maven
        SARL Snapshots
        http://maven.sarl.io/
      
    
    
          
        io.sarl-maven
        SARL Snapshots
        http://maven.sarl.io/
        
          true
        
      
    
    ...

=== 2.4. Compile SARL code with Maven

For compiling SARL source files with Maven, you should use the provided plugin:

sarl-maven-plugin
. It invokes the SARL and Java compilers with a simpler interface than the standard Xtext maven plugin. For using the
sarl-maven-plugin
, you should add in your pom file:
    ...
    
      
        
          io.sarl.maven
          sarl-maven-plugin
          0.11.0
          true
          
            1.8
            1.8
            UTF-8
          
        
        ...
      
      ...
    
    ...

Please, replace Version

0.11.0
in the previous snipset by the number of the version you want to use.

CAUTION: Do not forget to set the

extensions
flag to
true
.

=== 2.5. Syntax highlighting with other tools

Several style specifications are provided for syntax highlighting in third party tools. Style specifications are provided for:

  • link:./formatting-styles/textmate/sarl.tmLanguageAtom
  • link:./formatting-styles/source-highlight/sarl.lang[GNU source-highlight]
  • link:./formatting-styles/prettify/lang-sarl.js[Google Prettify]
  • link:./formatting-styles/gtk/sarl.langGtk source view
  • LaTeX: ** LaTeX listing: link:./formatting-styles/latex/sarl-listing.sty[monochrom], link:./formatting-styles/latex/sarl-colorized-listing.sty[color] ** link:./formatting-styles/latex/sarl-beamer-listing.sty[LaTeX Beamer]
  • link:./formatting-styles/pygments/sarlexer/sarl.py[Pygments]
  • link:./formatting-styles/textmate/sarl.tmLanguageSublime Text
  • link:./formatting-styles/textmate/sarl.tmLanguageTextMate
  • link:./formatting-styles/vim/sarl.vim[Vim]

== 3. P2 Repository

A P2 repository is set up and accesible at the address:

http://updates.sarl.io
.

== 4. Issues

Issues related to SARL are tracked on link:https://github.com/sarl/sarl/issues[GitHub] You must use this issue tracker to report and follow your issues.

Additionally, you could have a look on the SARL developers' working plan on link:https://huboard.com/sarl/sarl[Huboard].

== 5. Contributions

Any contribution to the SARL is welcome. Please read the link:./CONTRIBUTING.adoc[guidelines for contributors].

== 6. Authors and Contributors

  • image:https://avatars.githubusercontent.com/klmp200[width="50px",link=https://github.com/klmp200] Antoine Bartuccio, fireworks and Sierpinski fractal examples.
  • image:https://avatars.githubusercontent.com/gb96[width="50px",link=https://github.com/gb96] Greg Bowering, fixes for localization support within the fireworks example.
  • image:https://avatars.githubusercontent.com/m-ezzat[width="50px",link=https://github.com/m-ezzat] Mohamed Ezzat, code cleaning and optimization.
  • image:https://avatars.githubusercontent.com/ThomasFarrenkopf[width="50px",link=https://github.com/ThomasFarrenkopf] Thomas Farrenkopf, documentation contributor.
  • image:https://avatars.githubusercontent.com/jgfoster[width="50px",link=https://github.com/jgfoster] James Foster, documentation contributor.
  • image:https://avatars.githubusercontent.com/gallandarakhneorg[width="50px",link=https://github.com/gallandarakhneorg] link:http://www.ciad-lab.fr/author-10836/[Stéphane GALLAND], founder, original and active author.
  • image:https://avatars.githubusercontent.com/ngaud[width="50px",link=https://github.com/ngaud] link:http://www.ciad-lab.fr/author-10834/[Nicolas GAUD], founder, original and active author.
  • image:https://avatars.githubusercontent.com/jjst[width="50px",link=https://github.com/jjst] Jeremie JOST, documentation contributor.
  • image:https://avatars.githubusercontent.com/RyuzakiKK[width="50px",link=https://github.com/RyuzakiKK] Ludovico de NITTIS, documentation contributor.
  • image:https://avatars.githubusercontent.com/tpiotrow[width="50px",link=https://github.com/tpiotrow] Thomas PIOTROWSKI, maven configuration.
  • image:https://avatars.githubusercontent.com/srodriguez[width="50px",link=https://github.com/srodriguez] link:http://www.sebastianrodriguez.com.ar[Sebastian RODRIGUEZ], founder, original and active author.

== 7. License of SARL

SARL is distributed under the link:./LICENSE[Apache v2 license], and is copyrigthed to the original authors and the other authors, as expressed in the link:./NOTICE[NOTICE].

== 8. Success Stories

The following projects have sucessfully used SARL:

  • link:https://github.com/gallandarakhneorg/jaak[Jaak Simulation Library]
  • link:https://bitbucket.org/sarlrmit/sarl-controller/src[SARL Elevator Simulator Controller]

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.