Security News
tea.xyz Spam Plagues npm and RubyGems Package Registries
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
couchdb-worker
Advanced tools
Readme
Abstract CouchDB worker module
This is depricated in favour of couch-daemon
Install the module with: npm install couchdb-worker
var config = {
id: 'my-worker',
db: 'http://localhost:5984/mydb',
process: function(doc, db, done) {
doc.computed_value = Math.random();
db.insert(doc, done);
}
};
require('couchdb-worker')(config)
.start();
The object returned by worker.listen()
is a Feed
object, which is an EventEmitter.
See follow for documentation.
id
| Unique identifier for the worker.process
| Processor function. Receives doc
and done
arguments.db
| nano optionsfollow
| follow optionsstatus
| status options (optional). Default is false
.status.db
| nano options for status database connection. Default is to use the db
connection.status.id
| id for status document. Default is worker-status/<id>
.lock
| lock options (optional). Default is false
.lock.db
| nano options for lock database connection. Default is to use the status.db
connection.lock.prefix
| prefix for lock document ids. Default is worker-lock/<id>/
.process(doc, done)
This is where you do your work. It receives a doc
, which is the current document,
as well as a done
callback function, which must be invoked when the work is done.
The done
callback accepts itself an error
argument,
where you can inform couchdb-worker about any errors.
couchdb-worker can maintain a status document, where some stats are stored:
{
"_id": "worker-status/my-worker",
"worker_id": "my-worker",
"seq": 123,
"last_doc_id": "mydoc",
"checked": 42,
"triggered": 42,
"completed": 40,
"failed": 2
}
Its disabled by default as of 3.2.0
. To enable, set status: true
.
To prevent two same workers from processing the same document twice, couchdb-worker can keep a lock on the document.
This is achieved by putting an empty doc inside the lock.db
while processing.
It will be deleted when done.
The id of that lock document is calculated by appending the documents id to lock.prefix
.
Its disabled by default as of 3.2.0
. To enable locking, set lock: true
.
var worker = require('couchdb-worker')({
id: 'my-worker',
db: {
url: 'http://localhost:5984/mydb',
request_defaults: {
auth: {
user: 'me',
pass: 'secret'
}
}
},
status: {
db: {
url: 'http://localhost:5984/worker-stats',
request_defaults: {
auth: {
user: 'me',
pass: 'secret'
}
}
}
},
follow: {
since: 42,
heartbeat: 1000,
filter: 'myddoc/myfilter',
query_params: {
worker: 'my-worker',
app: '1234'
}
}
process: function(doc, db, done) {
doc.computed_value = Math.random();
db.insert(doc, done);
}
});
// listen to some events
worker.on('error', function(err) {
console.error('Since Follow always retries on errors, this must be serious');
});
worker.on('worker:complete', function(doc) {
console.log('worker completed: ', doc);
});
worker.on('worker:error', function(err, doc) {
console.log('worker error: ', err, doc);
});
// start work
worker.start();
// you can pause the worker
worker.pause();
// and resume...
worker.resume();
// and finally stop it.
worker.stop();
To run the tests, run npm test
.
The tests run agains a CouchDB server, and they create random databases of the form couchdb-worker-test-<uuid>
.
The default url is http://localhost:5984
,
which can be changed by setting the COUCH_URL
environment variable, eg:
COUCH_URL=http://me:secure@me.iriscouch.com npm test
In lieu of a formal styleguide, take care to maintain the existing coding style.
Add unit tests for any new or changed functionality.
Lint your code using npm run jshint
.
couchdb-worker follows semver-ftw. Dont think 1.0.0 means production ready yet. There were some breaking changes, so had to move up the major version.
3.2.0
: configurable status and lock behaviour3.1.1
: fix issue with db objects3.1.0
: process function receives db object3.0.0
: return function (worker.listen(config)
-> worker(config).listen()
)2.0.0
: do not store worker status in documents, store lock in extra documents1.0.0
: complete rewrite and new (functional) API using nano
(and follow) - currently no attachment support0.x
: object oriented version with attachment support - The 0.x
line continues on the v0 branchCopyright (c) 2012-2013 Johannes J. Schmidt, null2 GmbH
Licensed under the MIT license.
FAQs
CouchDB worker module that manages state
The npm package couchdb-worker receives a total of 27 weekly downloads. As such, couchdb-worker popularity was classified as not popular.
We found that couchdb-worker 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
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
Security News
As cyber threats become more autonomous, AI-powered defenses are crucial for businesses to stay ahead of attackers who can exploit software vulnerabilities at scale.
Security News
UnitedHealth Group disclosed that the ransomware attack on Change Healthcare compromised protected health information for millions in the U.S., with estimated costs to the company expected to reach $1 billion.