romulus-js/README.md

57 lines
1.7 KiB
Markdown
Raw Normal View History

2022-01-29 10:57:04 +00:00
# Romulus-JS
2022-01-29 14:02:24 +00:00
[![Build Status](https://drone.jacknet.io/api/badges/TerribleCodeClub/romulus-js/status.svg)](https://drone.jacknet.io/TerribleCodeClub/romulus-js) [![JavaScript Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://standardjs.com)
2022-01-29 10:31:20 +00:00
2022-01-29 10:57:04 +00:00
An implementation of the Romulus-M cryptography specification.
## Build
2022-01-29 11:33:05 +00:00
To build the Romulus-JS library, first clone this repository.
Run the following commands from the root of the repository:
```bash
$ npm install
$ npm run build
```
2022-01-29 14:02:24 +00:00
The build output will be saved to the `dist` directory.
2022-01-29 11:33:05 +00:00
2022-01-29 14:02:24 +00:00
## Development instructions
2022-01-29 10:57:04 +00:00
2022-01-29 14:02:24 +00:00
Requirements:
- The latest LTS builds of Node and npm.
2022-01-29 10:57:04 +00:00
2022-01-29 14:02:24 +00:00
Follow the instructions below to lint, test and build Romulus-JS.
2022-01-29 10:57:04 +00:00
2022-01-29 14:02:24 +00:00
#### Lint
2022-01-29 10:57:04 +00:00
2022-01-29 14:02:24 +00:00
```bash
$ npm install
$ npm run lint
```
#### Test
```bash
$ npm install
$ npm run test
```
#### Build
```bash
$ npm install
$ npm run build
```
### Visual Studio Code
This repository contains the necessary configuration files to debug, test and build Romulus-JS using only Visual Studio Code.
Run the build task (`Ctrl+Shift+B` or `⇧⌘B`) to automatically compile the Typescript source files in the background.
2022-01-29 14:56:06 +00:00
Unit tests use the [Jest](https://jestjs.io/) library. Support for Visual Studio Code is offered through the [Jest marketplace package](https://marketplace.visualstudio.com/items?itemName=Orta.vscode-jest) maintained by Orta.
## Contribution guidelines
[![JavaScript Style Guide](https://cdn.rawgit.com/standard/standard/master/badge.svg)](https://github.com/standard/standard)
This library uses [ts-standard](https://github.com/standard/ts-standard), based on [JavaScript Standard Style](https://standardjs.com/rules.html). Please ensure all contributions are ts-standard compliant before submitting a pull request.