TypeScript and JavaScript implementation of Dataspaces, Syndicate, and TypeScript language support for Syndicate. Targets both the browser and node.js.
Find a file
dependabot[bot] 7871021a1e
Bump y18n from 4.0.0 to 4.0.1
Bumps [y18n](https://github.com/yargs/y18n) from 4.0.0 to 4.0.1.
- [Release notes](https://github.com/yargs/y18n/releases)
- [Changelog](https://github.com/yargs/y18n/blob/master/CHANGELOG.md)
- [Commits](https://github.com/yargs/y18n/commits)

Signed-off-by: dependabot[bot] <support@github.com>
2021-04-01 06:16:09 +00:00
docker Split out socks package 2019-06-13 16:30:10 +01:00
packages Publish 2020-08-05 13:05:51 +02:00
.gitignore Webpack -> Rollup 2020-08-05 12:36:53 +02:00
.npmignore Switch to apenwarr's redo 2018-11-06 23:13:51 +00:00
all.do Cosmetic: print "Done." once build completes. 2018-11-11 15:23:28 +00:00
bootstrap Use all CPUs during bootstrap 2020-07-19 20:27:26 +02:00
clean.do Consolidate *.do files 2018-11-07 00:18:41 +00:00
do Switch to apenwarr's redo 2018-11-06 23:13:51 +00:00
gpl-3.0.txt README 2018-11-05 14:29:27 +00:00
lerna.json Initial monorepo commit 2018-11-02 10:49:03 +00:00
LICENCE README 2018-11-05 14:29:27 +00:00
package-lock.json Bump y18n from 4.0.0 to 4.0.1 2021-04-01 06:16:09 +00:00
package.json Update dependencies 2020-09-03 19:22:45 +02:00
README.md Tweak 2018-11-13 15:36:50 +00:00
rollup-redo Webpack -> Rollup 2020-08-05 12:36:53 +02:00
syndicate-babel Fix internal references to syndicate-babel 2020-07-19 20:20:50 +02:00
TODO.md Subprocess support 2018-11-26 15:45:32 +00:00
veryclean.do Don't automatically remove package-lock.json 2020-12-28 09:24:08 +01:00
watch-redo watch-redo 2020-07-19 20:27:35 +02:00

Syndicate/js

A new, efficient implementation of Syndicate for JavaScript in both node.js and the browser. The implementation techniques herein are the subject of a forthcoming paper.

Quickstart

Option 1. Create a new program/library using Syndicate/js.

Use npx @syndicate-lang/create DIRECTORY or npm init @syndicate-lang DIRECTORY:

npm init @syndicate-lang myprogram
cd myprogram
npm i .
npm run build
node lib/index.js

Option 2. Add Syndicate/js to an existing program/library.

Install a few packages from the @syndicate-lang scope on npmjs.com:

npm i --save-dev @syndicate-lang/syntax @babel/preset-env
npm i --save @syndicate-lang/core

Then, add the @syndicate-lang/syntax/plugin to your .babelrc. Use npx syndicate-babel in place of npx babel to compile your code.

Creating a new Syndicate/js project

Create a skeletal package.json:

{
  "main": "lib/index.js",
  "scripts": {
    "build": "npx syndicate-babel src --out-dir lib",
    "clean": "rm -rf lib"
  }
}

The entry point will be lib/index.js; the corresponding source file will be src/index.js.

Two npm run scripts are defined: one which compiles Syndicate/js source files in src to plain JavaScript in lib. The compiler uses Babel; we will configure Babel next.

Create a .babelrc file:

{
  "presets": [ "@babel/preset-env" ],
  "plugins": [ "@syndicate-lang/syntax/plugin" ]
}

Now, install the necessary dependencies. Babel and the Syndicate/js extensions are needed at build-time:

npm i --save-dev @syndicate-lang/syntax @babel/preset-env

The Syndicate/js runtime and as many drivers as you would like to use are needed at run-time:

npm i --save @syndicate-lang/core
npm i --save @syndicate-lang/driver-timer

Finally, create the main program file. Create a directory src, and then a file src/index.js:

const { TimeLaterThan } = activate require("@syndicate-lang/driver-timer");

spawn named 'ticker' {
  field this.counter = 0;
  field this.deadline = +(new Date());

  on start { console.log('ticker starting'); }
  on stop  { console.log('ticker stopping'); }

  on asserted TimeLaterThan(this.deadline) {
    this.counter++;
    console.log('tick', new Date(), this.counter);
    this.deadline += 1000;
  }

  stop on (this.counter == 5);
}

Now, compile the project:

npm run build

Finally, run the program:

node lib/index.js

The output should be something like:

ticker starting
tick 2018-11-05T14:23:27.713Z 1
tick 2018-11-05T14:23:28.705Z 2
tick 2018-11-05T14:23:29.706Z 3
tick 2018-11-05T14:23:30.706Z 4
tick 2018-11-05T14:23:31.707Z 5
ticker stopping

Licence

@syndicate-lang, an implementation of Syndicate for JS.
Copyright (C) 2016-2018 Tony Garnock-Jones tonyg@leastfixedpoint.com

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.