Security News
The Unpaid Backbone of Open Source: Solo Maintainers Face Increasing Security Demands
Solo open source maintainers face burnout and security challenges, with 60% unpaid and 60% considering quitting.
Finally is a simple flow control library for node.js and the browsers, with a mentally sane API.
Think of your flow as an array of sequential operations, each one containing an array of parallel operations.
var fs = require('fs')
var flow = require('finally')
flow(function(){
fs.readFile('path/to/file', 'utf-8', this.continue)
// this.continue is a node-style callback that also triggers the next sequential
})
.then(function(error, data1){
if (error) this.break(error)
// this.break is a node-style callback that also triggers the last sequential
fs.readFile('path/to/file', 'utf-8', function(error, data2) {
this.continue(error, data1, data2)
}.bind(this))
})
.finally(function(error, data1, data2){
if (error) throw error
console.log(data1, data2)
})
var fs = require('fs')
var flow = require('finally')
flow(
function(){
fs.readFile('path/to/file', 'utf-8', this.done)
// this.done is a node-style callback that increments the parallels counter and
// triggers the next sequential when all are completed.
// the first argument passed to done is then distributed, in order, to the next sequential
},
function(){
fs.readFile('path/to/file', 'utf-8', this.done)
},
)
.finally(function(error, data1, data2){
if (error) throw error
else console.log(data1, data2)
})
var fs = require('fs')
var flow = require('finally')
flow(function(){
fs.readFile('path/to/file.json', function(error, data){
if (error) return this.break(error) // goes to finally
var someObject = JSON.parse(data)
var someArray = someObject.someArray // someArray is [0,1,2,3,4]
this.spread(null, someArray)
// this.spread is a node-style callback that triggers the next sequential
// n times as the array's length
// treating the next sequential as an array of parallels
// each iteration gets the array[index] value as a single argument (after error, ofcourse)
}.bind(this))
})
.then(function(error, n){
this.done(error, n + 1)
})
.finally(function(error, n1, n2, n3, n4, n5){
if (error) throw error
else console.log(n1, n2, n3, n4, n5) // [1,2,3,4,5]
})
Say we want to continue on error only, for instance to find the first existing file.
var fs = require('fs')
var flow = require('finally')
flow(function(){
fs.readFile('path/to/file1', function(error, data){
if (error) this.continue(error)
else this.break(null, 'path/to/file1', data)
}.bind(this))
})
.then(function(error, n){
fs.readFile('path/to/file2', function(error, data){
if (error) this.continue(error)
else this.break(null, 'path/to/file2', data)
}.bind(this))
})
.then(function(error, n){
fs.readFile('path/to/file3', function(error, data){
if (error) this.continue(error)
else this.break(null, 'path/to/file3', data)
}.bind(this))
})
.finally(function(error, path, data){
if (error) console.log('no existing file found')
else console.log('first existing file was ' + path + ' with data ' + data)
})
But we can also automatically generate it:
var fs = require('fs')
var flow = require('finally')
var ƒ = flow()
['path/to/file1', 'path/to/file2', 'path/to/file3'].forEach(function(path) {
ƒ.then(function(error){
fs.readFile(path, function(error, data){
if (error) this.continue(error)
else this.break(null, path, data)
}.bind(this))
})
})
ƒ.finally(function(error, path, data){
if (error) console.log('no existing file found')
else console.log('first existing file was ' + path + ' with data ' + data)
})
FAQs
sane flow control library
We found that finally demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Solo open source maintainers face burnout and security challenges, with 60% unpaid and 60% considering quitting.
Security News
License exceptions modify the terms of open source licenses, impacting how software can be used, modified, and distributed. Developers should be aware of the legal implications of these exceptions.
Security News
A developer is accusing Tencent of violating the GPL by modifying a Python utility and changing its license to BSD, highlighting the importance of copyleft compliance.