COBPjs: A Context-Oriented Behavioral Programming Environment based on BPjs

This repository contains a javascript-based Context-Oriented Behavioral Programming (COBP) library.

License

COBPjs is open sourced under the MIT license. If you use it in a system, please provide a link to this page somewhere in the documentation/system about section.
COBPjs uses the BPjs. Project page and source code can be found here.
COBPjs uses the Mozilla Rhino JavaScript engine. Project page and source code can be found here.

Getting COBPjs

Creating a new Maven project

Add JitPack repository:

<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>

Also add COBPjs dependency. Note that the version number changes....

<dependencies>
    <dependency>
        <groupId>com.github.bThink-BGU</groupId>
        <artifactId>COBPjs</artifactId>
        <version>0.6.12</version>
    </dependency>
</dependencies>

Start from a template project

Clone SampleBPProject and change to the COBP branch.

git clone -b COBP https://github.com/achiyae/SampleBPProject.git

Writing COBP Programs

This section assumes that you are already familiar with the COBP paradigm. If this is not the case, you should start by reading the COBP Paper.

A COBP program usually includes at least two files:

dal.js: The specification of the context schema, the effect functions, the queries, and the initial contextual data.
bl.js: The specification of the context-dependent behaviors.

Examples for such programs are in the src/test directory.

Important

You must not use bp.sync and bp.registerBThread. Instead, use sync and bthread.

If you wish to bind a bthread to a context, use ctx.bthread.

Running a COBP Program

Running a COBP program is similar to the execution of a BP program:

BProgram bprog = new ContextBProgram("dal.js", "bl.js"); //you can change the files names...
BProgramRunner rnr = new BProgramRunner(bprog);

There is a full example for a main file - here.

Documentation & Relevant links

COBP Paper introducing COBP, COLSC, and COBPjs.
A presentation at MORSE18 introduces COLSC and the paper "A Context-Based Behavioral Language for IoT".
COLSC paper introduces the LCS implementation for COBP.
SampleProgram sample usage of many language idioms.
Tic-Tac-Toe introduces a COBP implementation of the game.
Hot-Cold introduces a COBP implementation of an extended hot cold example.
BPjs documentation and tutorials - a great starting point for BP.
Behavioral Programming - introduces behavioral programming.
BPjs Google group

Citation

To cite the paper on COBP:

@article{cobp,
title = {Context-Oriented Behavioral Programming},
journal = {Information and Software Technology},
volume = {133},
pages = {106504},
year = {2021},
issn = {0950-5849},
doi = {https://doi.org/10.1016/j.infsof.2020.106504},
url = {https://www.sciencedirect.com/science/article/pii/S095058492030094X},
author = {Achiya Elyasaf},
keywords = {Behavioral programming, Scenario-based programming, Programming paradigm, Context awareness, Context-oriented programming, Context-Oriented Behavioral Programming}
}

To cite this repository in publications:

@misc{cobpjs,
  author = {Achiya Elyasaf},
  title = {COBPjs: Context-oriented behavioral programming in JavaScript},
  year = {2021},
  publisher = {GitHub},
  journal = {GitHub repository},
  howpublished = {\url{https://github.com/bThink-BGU/COBPjs}},
}