# Acceleo

Acceleo is an open-source code generator from the Eclipse Foundation that allows people to use a model-driven approach to building applications. It is an implementation of the "MOFM2T" standard, from the Object Management Group (OMG), for performing model-to-text transformation.

## History and development
### Early versions

The Acceleo project is born in 2006 with the website Acceleo.org. Acceleo 1.0 was licensed under the GNU Public Licence (GPL) and it was compatible with Eclipse 3.0, 3.1 and several modelers based on EMF and UML 1.2. A few weeks later, Acceleo 1.1 brought the compatibility with Eclipse 3.2 and UML 1.3. Acceleo changed its licence with the release of Acceleo 1.2 to adopt the Eclipse Public Licence (EPL) used by the projects of the Eclipse Foundation. Acceleo 2 was available on June 5, 2007, after the launch of the website planet.acceleo.org which includes articles created by the members of the Acceleo community and the Acceleo modules repository which contains code generators based on Acceleo 2.

### Entrance in the Eclipse Foundation

In 2009, while moving to Acceleo 3, the project has been accepted in the Eclipse Foundation. During this transition, the language used by Acceleo to define a code generator has been changed to use the new standard from the OMG for model to text transformation, MOFM2T. With the release of Eclipse 3.6 Helios, Acceleo is included in the Eclipse simultaneous release train as an official project of the Eclipse Foundation. Acceleo is an Eclipse plugin and as such it is integrated in the Eclipse IDE. Acceleo is built on top of several key Eclipse technologies like EMF and, since the release of Acceleo 3, the Eclipse implementation of OCL. OCL is a standard language from the OMG to navigate in models and to define constraints on the elements of a model.

### Trademark

While the Acceleo source code is open source, the Acceleo trademark and its logo, integrated in Acceleo, are not open source. They were the trademark of the company Obeo, creator of Acceleo, and they were transferred to the Eclipse Foundation when Acceleo was accepted as an official project.

### Source code

Acceleo is an Eclipse project mostly developed in Java and available under the Eclipse Public Licence (EPL). The source code of Acceleo 1.x and 2.x is available on SVN on the website of the OW2 Consortium. With its entrance in the Eclipse Foundation in 2009, the source code of Acceleo 3 was transferred from SVN to a CVS based repository on the servers of the Eclipse Foundation. After the release of Eclipse 3.7 Indigo in 2011, the Acceleo project has migrated to Git following the migration started by several official project of the Eclipse Foundation and since July 2011, the Acceleo source code is available on GitHub.

### Releases

* First stable release: Acceleo 1.0.0 available since 1 April 2006
Legend: :
| Previous versions | Latest stable release | Next release |
| Version | Release date | Release log |
| 1.0 | 1 April 2006 | First version of Acceleo available under the GPL licence, code generation from EMF based models. |
| 1.1 | 20 October 2006 | Compatibility with Eclipse 3.2, support for models created with GMF, ArgoUML, Poseidon, Umbrello and Rational Rose. |
| 1.2 | 5 January 2007 | Switch to the Eclipse Public Licence (EPL), new indentation service, parameterized launcher, Ant compatibility. |
| 2.0 | 5 June 2007 | Language improvements, XML compatibility, export of generators as Eclipse plugin. |
| 2.1 | 12 July 2007 | Compatibility with Eclipse 3.3, code generator debugger. |
| 2.2 | 7 January 2008 | Localization support, support for different encoding of the templates, release of the following generators: JEE, PHP, Python and WISS. |
| 2.3 | 25 July 2008 | Compatibility with Eclipse 3.4, ability to call standard EOperations defined in the model, search references. |
| 2.4 | 25 September 2008 | Possibility to export a generator as a stand-alone module or as a RCP application. |
| 2.5 | 3 December 2008 | Generation profiler, actions on the outline. |
| 2.6 | 26 June 2009 | Compatibility with Eclipse 3.5 Galileo. |
| 2.7 | 6 April 2010 | Improvement of the profiler, compatibility with Enterprise Architect. |
| 3.0 | 15 June 2010 | New language to define code generators based on MOFM2T, support for OCL based queries, real time compilation with error detection. |
| 3.1 | 7 June 2011 | Support for documentation for generators, detection of potential errors with warning, Maven support, binary compilation of the generator. |
| 3.2 | 27 October 2011 | Next major release of Acceleo with the new "Interpreter" view to evaluate Acceleo expression on a given set of model element. |
| 3.3 | 29 May 2012 | Next major release of Acceleo. |
| 3.4 | 10 June 2013 | Next major release of Acceleo. |
| 3.5 | 10 June 2014 | Next major release of Acceleo. |
| 3.6 | 8 June 2015 | Next major release of Acceleo. |
| 3.7 | 15 October 2016 | Next major release of Acceleo. |

## Supported platforms

Acceleo is written in Java and is deployed as a plugin in the Eclipse IDE. Acceleo is supported on Java 5+ based environments, on the following platforms:
* Linux
* macOS
* Windows XP, Windows Vista, Windows 7

## The language

Starting with Acceleo 3, the language used to define an Acceleo code generator is an implementation of the MOFM2T standard. This code generation language uses a template based approach. With this approach, a template is a text containing dedicated part where the text will be computed from elements provided by the inputs models. Those dedicated parts are most of the time expressions specified on the entity of the input models used to select and extract information from those models. Within Acceleo, those expression are based on the Eclipse implementation of the OCL language.

## Features

Acceleo provides tools for code generation from EMF based models. Thanks to those tools, Acceleo allows, for example, incremental generation. Incremental generation gives people the ability to generate a piece of code and then modify the generated code and finally regenerating the code once again without losing the previous modifications.
Acceleo also allows:
* code generation from any kind of metamodel compatible with EMF like UML 1, UML 2 and even custom metamodels (DSLs)
* customization of the generation with user defined templates
* generation of any textual language (C, Java, Python, etc.)

### Editor

Acceleo contains a code generation modules editor with syntax highlighting, completion, real time error detection and refactoring.

### Debugger

The Acceleo debugger gives the possibility to keep an eye on the progression of a generation. It let the user pause a generation with a break point, check the state of the variables and move step by step during a generation to identify problems.

### Profiler

The profiler allow the user to figure out all the instructions executed during the generation, the number of time that those instructions have been executed and the time taken by each of those instructions. Profiling data are available in an EMF models after a generation launched with the profiler. It gives the user the ability to find bottleneck in the code generator created.

### Traceability

The Acceleo engine can compute traceability information of all the elements involved in the generation of a file. This system allows, for example, to determine the elements from the input models that have been used to generate a specific piece of text and the part of the code generator that has been involved.

## Stand-alone use

The parser and the generation engine, critical components of Acceleo, can also be used in "stand-alone", without being deployed on Eclipse. Acceleo generates a Java class to launch the generation programmatically thus allowing the integration of an Acceleo generator in any Java application. This Java launcher can also be called from Ant or Maven.

## Compatibility

The latest release of Acceleo is compatible with:
* Stand alone Java 6 runtime
* Eclipse 3.7 Indigo
* Eclipse 3.8 Juno
* Eclipse 4.3 Kepler
* Eclipse 4.4 Luna
* Eclipse 4.5 Mars
* Eclipse 4.6 Neon
Acceleo is based on the modeling framework EMF. Thus it is compatible with any tool that can produce EMF compatible models.

## Example

Acceleo can use any EMF compatible models defined from any kind of metamodel like UML or even a custom DSLs. From this metamodel, the user can define a code generator that will produce any kind of textual language from a model using the metamodel.
| A simple EMF model | A simple Acceleo module | The code generated |
Here we are using the following elements: EClass, EAttribute and EOperation from EMF. Thanks to the simple module and this input model, Acceleo can generate the former code. The module defined in this example is parameterized to generate Java but the MOFM2T standard is independent of the generated code. When the generator is created, the user can use another model to generate a piece of code with a similar appearance but with a different content. Acceleo integrates several code generation examples to generate Java and Python.

## Awards

Awards received by Acceleo :
| Title | Author | Date | Link |
| Best Open Source Eclipse-Based Developer Tool 2009 | Eclipse Foundation | 1 March 2009 | (in English) Eclipse Community Awards Winners Announced |
| Open Innovation Award 2010 | Open World Forum | 1 November 2010 | (in English) Open World Forum Awards |

## Community and communication

The Acceleo community is gathered around the Acceleo part of the website of the Eclipse Foundation. The Acceleo documentation is accessible online on the Eclipse Help Center and on the wiki of the Acceleo project.

### Conferences

The developers of Acceleo are also communicating with the community thanks to presentation realized in MDA or Eclipse conferences.
| Name | Date | Location | Title of the presentation |
| MDA approach conference | 23 November 2006 | Geneva | |
| SOA/MDA | 2006-30-11 | Luxembourg | |
| EclipseCon 2007 | 6 March 2007 | Los Angeles | |
| Eclipse Summit Europe 2008 | 10 October 2008 | Ludwigsburg | |
| EclipseCon 2009 | 25 March 2009 | Los Angeles | Eclipse MTL: a Real Standard Alternative for Code Generation |
| Eclipse Summit Europe 2009 | 28 August 2009 | Ludwigsburg | From Acceleo.org to Eclipse Modeling |
| Eclipse Con 2010 | 22 March 2010 | Los Angeles | Acceleo Code Generation: Let's start with an Android example |
| Eclipse Summit Europe 2010 | 3 November 2010 | Ludwigsburg | Creating a Language for Android Apps with Eclipse Modeling |
| Topcased Days 2011 | 4 February 2011 | Toulouse | Acceleo |
| Code Generation 2011 | 26 May 2011 | Cambridge | And you thought you knew template based code generator? |