workflow-core

Workflow is an experiment in declarative virtual workspace management. Workflow aims to simplify navigating
complex window configurations. It does so by letting the user define layouts and
a way to easily navigate between them. Workflow is meant to be an abstraction
layer on top of window managers like i3, awesome, and the proprietary ones found in
OSX and Windows.

For more documentation checkout the Repository on github.

Documentation

The workflow-core module contains a single function. This function accepts
a configuration object to builds a facade which can be used to execute
workflow. The workflow-cmd module read the workflow-home config.js file
and builds the facade and contains a run function which uses the facade
to provide the functionality of the command workflow.

``
const workflow = require('workflow-core').workflow(config);
`

$3

`
const config = {

resolvers: [
{
function resolve(path) {
// Returns the absolute path of a flow found with the path argument.
// Throws an error if the flow is not found or is a directory.
},
function alternatives(path) {
// Returns a list of possible flows filtered by the path argument.
// Throws an error if the path or dirname(path) is not a directory.
// Returns an empty list if no files are found.
}
}
],

loaders: [
{
loader: {
function load(path) {
// Load the flow found on the path.
// Throws an error if the flow could not be loaded by the loader
}
},

function filter(path) {
// Optional function to determine if the loader should be used for the path.
// If the function returns false, the loader is skipped.
// If the function is not defined, the loader is always used
}
}
],

argumentParser: {
function parse(flow, argv) {
// parses the arguments given in argv as defined by the flow
}
},

transformers: [
{
function transform(flow, args) {
// Performs a transform to and from a valid AFT.
}
}
],

layout: {
function layout(args, { screen }) {
// Performs a transformation from an AFT to a CFT which
// supported by the windows manager adapter
}
}

wm: {
function screen() {
// Returns the dimensions of the screen
},

function apply(flow) {
// Applies the flow by opening applications and position them
// on the screen.
}
}

};

`

$3

`
const workflow = {

// Call all available resolvers and return the absolute path
//returned by the first resolver which provides a valid result
resolve(path: string): string,

// Ask all resolvers for the valid paths the can resolve
// and return the combined results
alternatives(path: string): Array,

// Ask all loaders to load the flow at given at the absolute path.
// The result of the first loader that loads the file without any
// errors is returned.
load(path: string): Flow,

// Parse the command line arguments require by the Flow
parseArguments(flow: Flow, args: Array): Args,

// Preform any transformation on the Flow
transform(flow: Flow, args: Args): Flow,

// Convert the Flow given as a AFT into the corresponding flow
// as a CFT. Refer to the workflow-layout package for addition details.
layout(flow: Flow, config: {screen: Screen}): Flow,

// Returns the screen dimensions
screen(): Screen,

// Applies the Flow by opening applications and positioning then
// on the screen.
apply(flow: Flow): void
}
``