vinay-thallam / Operational-Transformation

A collection of Algorithms to Synchronise changes across multiple clients using Operational Transformation

Operational Transformation

Description

Collection of Operation Transformation Algorithms and their respective clients to integrate with any existing system.

Package Name	Npm Version	Weekly Downloads	External Dependency
ace
firebase-ace
firebase-monaco
firebase-plaintext
monaco
plaintext			-
plaintext-editor			-
state-machine			-
types	-	-	-
utils	-	-	-

Installation

This repository uses monorepo architecture for hosting packages. We are using Lerna to manage workspaces and publishing of individual packages, where as Yarn is used as package manager to symlink and install 3rd Party Dependencies.

• To install using Lerna (recommended):

$ lerna bootstrap

• To install using Yarn:

$ yarn

Testing

We are using Jest extensively to form our Unit Test Suite as well as Integration Test Suites, along with test environment, stubs and test runner. Nyc (formerly known as Istanbul) is used for coverage reporting.

To run all the unit test suites in local dev environment, run the following after dependencies have been installed:

$ yarn test

To run unit tests in CI environment, run:

$ yarn test:ci

To run integration tests in CI environment, run:

$ yarn test:firebase
$ yarn test:monaco

To merge all the individual code coverage report and generate final test coverage report, run:

$ yarn coverage

To convert generated final coverage report into more human readable form (such as lcov), run:

$ yarn coverage:dev

Editor Integration

Most of the popular editors and IDEs have extensions to help with Code Coverage details. These tools often read lcov reports and not json format. So one must convert them into lcov using last command described above to make it work with the editor of their choice.

Metrics and Tracking

We are using codecov.io to track progress over Code Coverage and CodeQL for Code Quality Analysis.

Reporting a Bug

Head on to Discussion section to report a bug or to ask for any feature. Use this template to make it structural and helpful for the maintainer and the contributors. Feel to add your queries about using this library as well under Q & A section of it. Remember, do not create any Issues by yourself, maintainers of this repository will open one if deemed necessary.

Changelog

See CHANGELOG for more details.

Contributing

See Contributing Guidelines.

License

This project is licensed under the terms of the MIT license, see LICENSE for more details.