Programming language for distributed systems & p2p
Go to file
2022-01-20 07:08:26 +03:00
.github/workflows Fix publishing (#392) 2021-12-28 12:32:16 +03:00
.vscode Add support for the new features of JS SDK API (#251) 2021-09-08 13:16:59 +03:00
aqua-src Join expression (#402) 2022-01-13 13:58:20 +03:00
backend Model/raw refactoring (#398) 2022-01-13 10:32:59 +03:00
cli VarModel -> VarRaw in collect functions (#405) 2022-01-20 07:08:26 +03:00
compiler/src/main/scala/aqua/compiler Model/raw refactoring (#398) 2022-01-13 10:32:59 +03:00
linker/src Module and Use expressions (#245) 2021-08-20 18:03:47 +03:00
model Scalar index access (#401) 2022-01-13 13:39:43 +03:00
npm Network info services for aqua CLI (#393) 2021-12-30 13:44:31 +03:00
parser/src Join expression (#402) 2022-01-13 13:58:20 +03:00
project #370 #377 #378 Builtin as default import and minor changes (#384) 2021-12-03 20:30:00 +03:00
semantics/src Join expression (#402) 2022-01-13 13:58:20 +03:00
types/src #321 restricted stream scopes (#359) 2021-11-17 08:25:06 +03:00
.gitignore CLI: Implement create_keypair (#375) 2021-11-26 14:05:24 +03:00
.jvmopts Upper cased constants (#260) 2021-09-07 11:09:48 +03:00
.scalafmt.conf VarModel -> VarRaw in collect functions (#405) 2022-01-20 07:08:26 +03:00
build.sbt Scalar index access (#401) 2022-01-13 13:39:43 +03:00
README.md Readme updates (#295) 2021-09-10 17:36:21 +03:00

Aqua

release npm

Aqua is a new-gen language for distributed systems.

Aqua programs are executed on many peers, sequentially or in parallel, forming a single-use coordination network.

Aqua's runtime is heterogeneous: it includes browsers, servers, devices, all involved in solving a single task. Therefore, Aqua scripts are compiled into several targets at once, with AIR and Typescript as a default.

Please refer to Aqua Book to learn more about Aqua language.

Install and run

The easiest way to use Aqua is to download the latest build from npm: @fluencelabs/aqua.

npm i -g @fluencelabs/aqua
aqua --input src/aqua --output src/generated

Input directory should contain files with .aqua scripts.

Build from sources

If you want to build Aqua compiler from the sourcecode, you need Scala's sbt installed.

Aqua compiler itself can be compiled to and distributed either as JavaScript or Java file.

Build to JS

Run sbt cliJS/fullLinkOpt to build JavaScript file. You can find the compiled file in: cli/.js/target/scala-%scala-version%/cli-opt.

Then run it with node:

node aqua-%version_number%.js -i path/to/input/dir -o path/to/output/dir

Javascript build is the default for Aqua.

Build to JVM

Run sbt cli/assembly to build JAR file. It is located in cli/.jvm/target/scala-%scala-version%/

It requires java to run Aqua compiler in .jar file from the command line:

java -jar aqua-%version_number%.jar -i path/to/input/dir -o path/to/output/dir

Repository structure

  • types data types, arrows, stream types definitions and variance
  • parser - parser, takes source text and produces a source AST
  • model - middle-end, internal representation of the code, optimizations and transfromations
  • model/transform - optimizations and transfromations, converting model to the result, ready to be rendered
  • model/test-kit - tests and test helpers for the model and transformations
  • semantics - rules to convert source AST into the model
  • linker - checks dependencies between modules, builds and combines an abstract dependencies tree
  • backend - compilation backend interface
  • compiler - compiler as a pure function made from linker, semantics and backend
  • backend/air generates AIR code from the middle-end model
  • backend/ts - generates AIR code and Typescript wrappers for use with Fluence JS SDK
  • cli - CLI interface

References