tuchk4 / apop

apop 🐍

For transformation data. Replaces recursive nested constructions to flow functions

Full documentation

The main idea

• Array Parse(ap) - apply flow actions to array.
• Object Parse(op) - apply flow actions to object.

Installation

npm install --save apop

Imports

import ap from 'apop/ap';
import op from 'apop/op';

Contributing

Project is open for new ideas and features:

• New actions
• New experiments
• Support Map, Set
• Support async usage
• Support Immutable.js

apop's Issues

add flowtypes

Config for clear action

let config = {
emptyArray: true,
emptyObject : true,
emptyString: true
nullValue:true,
undefinedValue: true
}

Clear [null] and [undefined]

If array contains null or undefined - must be clear.

{
   key1: [null] - ignore if config.nullValue == true
   key2: [undefined] - ignore if config.undefinedValue == true
}

support Map, Set

support Map, WeakMap?, Set, WeakSet?
add actions: rmk.toMap, rmk.fromMap?

Make docs more simpler

For example doc actions/pick is too complex and it is hard to read and understand.

Make it more simpler:

• remove complex data structures
• split and describe each config mode
• use default data placeholders like foo, bar, baz etc

And same for others md files

Action: eachKeys

Add prettier + husky + lint-staged

npm i --save prettier lint-staged husky

update package.json:

"scripts": {
    "format-backend": "prettier --trailing-comma es5 --single-quote --write  'scripts/**/*.js'",
    "precommit": "lint-staged"
  },
  "lint-staged": {
    "*.js": [
      "prettier --trailing-comma es5 --single-quote --write",
      "git add"
    ]
  }

Idea: async rmk

const formula = rmk(
  // actions
  // ...
  // custom async action
  state => {
    /// any async code that returns Promise
    return Promise.resolve(state);
  }
);

const transformed = await formula({....});

Support Immutable.js

simple example experimental/immutable

Action request: filter / sort

const data = [
 { x: 0, y: 0},
 { x: 1, y: 1},
 { x: 2, y: 2},
];

rmk(
  rmk.filter(state => state.x === 0 && state.y === 0),
)(data) 

Same for sort action