it-fsm/README.md

57 lines
1.3 KiB
Markdown

# IT FSM
[![ci](https://github.com/icetemple/it-fsm/actions/workflows/ci.yml/badge.svg)](https://github.com/icetemple/it-fsm/actions/workflows/ci.yml)
[![Coverage Status](https://coveralls.io/repos/github/icetemple/it-fsm/badge.svg?branch=master)](https://coveralls.io/github/icetemple/it-fsm?branch=master)
Simple full-featured finite state machine for your project
# Why it-fsm?
- 🚯 333 LOC - 0 dependencies
- 🍒 Sophisticated object-oriented design
# Getting started
```ts
import { StateMachineBuilder } from "it-fsm";
const [locked, unlocked] = ["locked", "unlocked"] as const;
const sm = new StateMachineBuilder()
.withStates([locked, unlocked])
.withTransitions([
[locked, { coin: unlocked }],
[unlocked, { push: locked }],
])
.build(locked);
```
You can find more examples [here](./examples/README.md)
# Installation
## Deno
if you use the [Deno](https://deno.land), just add the following to your
`import_map.json`
```json
{
"imports": {
"it-fsm": "https://git.pleshevski.ru/pleshevskiy/it-fsm/raw/tag/v2.0.3/fsm.ts"
}
}
```
## Node.js
If you use the Node.js or in a browser as ES module, you may need to install it
as follows, and additionally you can add import maps for client side.
`npm install --save it-fsm`
# License
GNU General Public License v3.0 or later
See [COPYING](./COPYING) to see the full text.