https://github.com/rikulo/el

Rikulo EL (Expression Language) is an implementation of the Unified Expression Language specification plus some enhancements for and in Dart.
https://github.com/rikulo/el

Last synced: about 1 year ago
JSON representation

Rikulo EL (Expression Language) is an implementation of the Unified Expression Language specification plus some enhancements for and in Dart.

• Host: GitHub
• URL: https://github.com/rikulo/el
• Owner: rikulo
• License: other
• Created: 2012-09-04T05:56:25.000Z (almost 14 years ago)
• Default Branch: master
• Last Pushed: 2014-02-19T05:46:53.000Z (over 12 years ago)
• Last Synced: 2025-05-09T00:38:57.914Z (about 1 year ago)
• Language: Dart
• Homepage: http://rikulo.org
• Size: 608 KB
• Stars: 10
• Watchers: 7
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGES.md
  • License: LICENSE

Awesome Lists containing this project

README

          
#Rikulo EL

[Rikulo EL](http://rikulo.org) is an implementation of the [Unified Expression

 Language](http://en.wikipedia.org/wiki/Unified_Expression_Language) 

 specification plus enhancements for and in Dart. 

* [Home](http://rikulo.org)

* [Tutorial](http://blog.rikulo.org/posts/2012/Sep/tutorial/rikulo-el-an-expression-language-for-and-in-dart/)

* [API Reference](http://api.rikulo.org/el/latest/)

* [Discussion](http://stackoverflow.com/questions/tagged/rikulo)

* [Issues](https://github.com/rikulo/el/issues)

Rikulo EL is distributed under the Apache 2.0 License.

[![Build Status](https://drone.io/github.com/rikulo/el/status.png)](https://drone.io/github.com/rikulo/el/latest)

##Install from Dart Pub Repository

Add this to your `pubspec.yaml` (or create it):

    dependencies:

      rikulo_el:

Then run the [Pub Package Manager](http://pub.dartlang.org/doc) (comes with the Dart SDK):

    pub install

##Install from Github for Bleeding Edge Stuff

To install stuff that is still in development, add this to your `pubspec.yam`:

    dependencies:

      rikulo_el:

        git: git://github.com/rikulo/el.git

For more information, please refer to [Pub: Dependencies](http://pub.dartlang.org/doc/pubspec.html#dependencies).

##Usage

Using Rikulo EL is straightforward.

    import 'dart:mirrors' show reflect;

    import 'package:rikulo_el/el.dart';

    

    class Person {

      String name;

      Person(this.name);

    }

    void main() {

      //Prepare an expression factory.

      ExpressionFactory ef = new ExpressionFactory();

    

      //Prepare the expression script

      //expression inside #{...} is to be evaluated

      String script = 'Hello, #{person.name}!'; 

    

      //Prepare an expression context.

      ELContext ctx = new ELContext();

      ctx.variableMapper.setVariable('person',

          ef.createVariable(new Person('Rikulo')));

      

      //Parse the script and create a value expression which expect a String type

      ValueExpression ve = ef.createValueExpression(ctx, script, reflect('').type);

      

      //Evaluate the expression and return the evaluated result

      print(ve.getValue(ctx)); //'Hello, Rikulo!'

    }

For more examples, please refer to [here](https://github.com/rikulo/el/blob/master/test/ValueExpressionImpl_test.dart), [here](https://github.com/rikulo/el/blob/master/test/MethodExpressionImpl_test.dart) and [here](https://github.com/rikulo/el/blob/master/test/ELEval_test.dart).

##Notes to Contributors

###Test and Debug

You are welcome to submit [bugs and feature requests](https://github.com/rikulo/el/issues). Or even better if you can fix or implement them!

###Create Addons

Rikulo is easy to extend. The simplest way to enhance Rikulo is to [create a new repository](https://help.github.com/articles/create-a-repo) and add your own great widgets and libraries to it.

###Fork Rikulo

If you'd like to contribute back to the core, you can [fork this repository](https://help.github.com/articles/fork-a-repo) and send us a pull request, when it is ready.

Please be aware that one of Rikulo's design goals is to keep the sphere of API as neat and consistency as possible. Strong enhancement always demands greater consensus.

If you are new to Git or GitHub, please read [this guide](https://help.github.com/) first.