Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/applitopia/duxen
High performance data engine maintaining complex immutable state for reactive applications. Fully integrated with Immutable.js, Redux, and Meteor.
https://github.com/applitopia/duxen
immutablejs meteor redux
Last synced: about 1 month ago
JSON representation
High performance data engine maintaining complex immutable state for reactive applications. Fully integrated with Immutable.js, Redux, and Meteor.
- Host: GitHub
- URL: https://github.com/applitopia/duxen
- Owner: applitopia
- License: mit
- Created: 2017-07-03T07:57:04.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2023-01-03T15:15:57.000Z (almost 2 years ago)
- Last Synced: 2024-04-14T08:33:03.466Z (7 months ago)
- Topics: immutablejs, meteor, redux
- Language: JavaScript
- Homepage: https://applitopia.github.io/duxen
- Size: 2.01 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
DUXEN
=====
[](https://badge.fury.io/js/duxen)
[](https://facebook.github.io/jest/)
[](https://david-dm.org/applitopia/duxen)
[](https://david-dm.org/applitopia/duxen?type=dev)
[](https://gitter.im/duxen/Lobby)
[](https://opensource.org/licenses/MIT)
High performance data engine maintaining complex immutable state for reactive applications.
Fully integrated with [Immutable.js](https://facebook.github.io/immutable-js/), [Redux](https://redux.js.org), and [Meteor](https://meteor.com).
See demo here: [https://stackblitz.com/edit/duxen-demo](https://stackblitz.com/edit/duxen-demo)
Huh?
====
Redux is an amazing concept that shows how to manage application data in a predictable state containers. It is actually a tiny library (2kB) with a simple container that receives actions and forwards them to reducers. The actions and reducers themselves have to be fully designed and developed from scratch. Although Redux applications are elegant, behave consistently, and are easy to test, their state management logic is usually scattered across many small files and developers may end up typing a lot of repetitive boilerplate code. Moreover, the reducers must be written as pure functions with no side effects and they have to modify the application state in an immutable way. This can become difficult and error prone especially if application logic is complex.
So here comes DUXEN, the Redux Engine.
Instead of writing individual reducers and action creators, the developer is focusing on the whole application state. The state is described with a schema that contains simple values, collections, and views which are seamlessly transforming the data in collections into their presentation form. The DUXEN compiles the schema, generates the reducers, and provides all the action creators. The resulting application state is built by DUXEN as one large immutable object using Immutable.js library.
Installation
------------
```shell
npm install duxen
```
Development
-----------
Setup:
```shell
git clone https://github.com/applitopia/duxen.git
cd duxen
npm install
```
Lint:
```shell
npm run lint
```
Build:
```shell
npm run build
```
Test:
```shell
npm test
```
Lint, Build, & Test:
```shell
npm run all
```
Update Dependencies:
```shell
npm update --save
```
Example
------
Define your DUXEN schema:
```js
const cmp=(a,b)=>(a>b?1:(aseq
.filter(v=>v.get('text').indexOf(props.todosFilter) >= 0)
.sort((a, b)=>cmp(a.get('text'), b.get('text')))
.take(props.todosLimit),
},
'todosCnt': {
type:'view',
sourceName: 'todosView',
props: [],
recipe: (seq)=>Seq({cnt: seq.count()})
},
'todosCompletedCnt': {
type:'view',
sourceName: 'todosView',
props: [],
recipe: (seq, props)=>{
const cnt = seq
.filter(v=>v.get('completed'))
.count();
return Seq({cnt});
}
},
}
```
Create a DUXEN engine:
```js
import { createEngine } from 'duxen'
const engine = createEngine(schema)
```
Get a reducer from the engine and attach it to a Redux store:
```js
import { createStore } from 'redux'
const store = createStore(engine.reducer())
```
Create actions and dispatch them to the store:
```js
// Create an action that changes the value of the filter
const action = engine.value('todosFilter', "Get milk");
// Dispatch the action to the Redux store
store.dispatch(action);
// Get the updated state from the store
const state = store.getState();
```
License
-------
MIT