Alphax NPM | npm.io

What is alphaX?

alphaX provides very simple JSON-like and chained APIs that allow you to manipulate files freely. Now it supports glob, task control, middleware, rename, filter and transform file as well.

BTW, alphaX was named from the Greek initials α and spaceX I admire.

Features

🚀 Fast, based on stream.
📦 Chained API.
💅 Using middlewares to process each file.
🚨 Asynchronous task control.
🌈 Filter or Rename files with a pure function or configuration.
💎 Support Condiitonal Manipulation

Install

npm i alphax --save 
# Pay attention to the case, NPM does not support capitals. 😅
# Or yarn add alphax

Usage

import alphax from 'alphax'
// Or cjs: const app = require('alphax')
const app = alphax()

Chained Style

alphax()
  .src('**')
  .task(task1)
  .task(task2)
  .task(task3)
  .use(file => file.content += Date.now())
  .rename(filepath => filepath.replace('{name}', name))
  .rename(filepath => filepath.replace('{age}', age))
  .transform(content => content.replace('{name}', name))
  .filter(filepath => filepath.endWith('.js'))
  .filter(filepath => !filepath.startWith('test'))
  .dest('dist')
  .then(files => console.log(files))
  .catch(error => console.log(error))

Config Style

const config = {
  tasks: [task1, task3, task3],
  use: file => file.content += Date.now(),
  rename: {
    '{name}': name,
    '{age}': age
  },
  filter: {
    'app.js': true,
    'test.js': false
  },
  transform(content) {
    return content.replace('{name}', name)
  }
}

alphax()
  .src('**', config)
  .dest('dist')
  .then(files => console.log(files))
  .catch(error => console.log(error))

For detailed usage please head to v2js.com/alphax.