Skip to content

Latest commit

 

History

History
57 lines (46 loc) · 1.86 KB

README.md

File metadata and controls

57 lines (46 loc) · 1.86 KB

Arr.ai tutorial

This tutorial will take you step by step through the arr.ai language. It will be light on theory, focusing more on learning by doing. If you want a more theoretical introduction to the features of the language, Introduction to Arr.ai is a good place to start.

The following chapters start with the basics of the language, and develop steadily towards the more advanced features.

To follow along, use arr.ai's interactive shell, which may be started with:

$ arrai i
@> _

or, if an appropriate symlink is set up (see the main README for instructions):

$ ai
@> _

Once you see the @> prompt, you can try the code examples in the following chapters.

  1. Arr.ai shell basics
  2. Values
  3. Name bindings
  4. Comparison operators
  5. Arithmetic and logical operators
  6. Set operators
  7. Relational operators
  8. (TODO) Functions and function calls
  9. Transforms
  10. (TODO) Standard library
  11. (TODO) Importing external code and data
  12. Writing tests
  13. (TODO) Expression strings
  14. (TODO) Templating with expression strings
  15. (TODO) Grammars
  16. Macros

Arr.ai command line

In addition to the interactive shell, arr.ai provides a range of additional commands to run programs, start an arr.ai server or client, etc.

  1. (TODO) run, r: evaluate an arrai file
  2. (TODO) eval, e: evaluate an arrai expression
  3. (TODO) observe, o: observe an expression on a server
  4. (TODO) serve, s: start arrai as a gRPC server
  5. (TODO) sync, s: sync local files to a server
  6. (TODO) transform, x: transform a stream of input data with an expression
  7. (TODO) update, u: update a server with an expression