Consume micro-services.

Usage no npm install needed!

<script type="module">
  import argosyClient from '';



NPM version Build Status Coverage Status Davis Dependency Status


Use argosy instead. This module is no longer maintained as a separate entity.

Consume micro-services.

Part of the Argosy family.


var http    = require('http'),
    query   = require('querystring'),
    service = require('argosy-service')(),
    match   = require('argosy-pattern/match'),
    client  = require('argosy-client')()

// connect the client to the service

// create a micro-service that gets weather
service.message({ get: 'weather', location: match.defined }).process(function (msg, cb) {
    var qs = query.stringify({ q: msg.location, units: msg.units || 'imperial' })
    http.get('' + qs, function (res) {
        var body = ''
        res.on('data', function (data) {
            body += data
        }).on('end', function () {
            cb(null, JSON.parse(body).main)

// use the service with argosy-client
client.invoke({ get: 'weather', location: 'Boston,MA' }, function (err, weather) {
    console.log(weather.temp + ' degrees (F) in Boston.')

// or create a convenience function using invoke.partial
var getWeather = client.invoke.partial({ get: 'weather', units: 'metric' })

getWeather({ location: 'Dublin,IE' }, function (err, weather) {
    console.log(weather.temp + ' degrees (C) in Dublin.')

// or use promises
getWeather({ location: 'London,UK' }).then(function (weather) {
    console.log(weather.temp + ' degrees (C) in London.')


var argosyClient = require('argosy-client')

client = argosyClient()

Create a new client object. The client object is a stream intended to be connected (piped) to Argosy services through any number of intermediary streams.

client.invoke(msg [, cb])

Invoke a service which implements the msg pattern. Upon completion, the callback cb, if supplied, will be called with the result or error. The client.invoke function also returns a promise which will resolve or reject appropriately.


Return a function that represents a partial invocation. The function returned has the same signature as client.invoke, but when called, the msg parameter will be merged with the partialMsg parameter provided at the time the function was created. Otherwise, the generated function behaves identically to client.invoke.


npm test [--dot | --spec] [--grep=pattern]

Specifying --dot or --spec will change the output from the default TAP style. Specifying --grep will only run the test files that match the given pattern.


npm run coverage [--html]

This will output a textual coverage report. Including --html will also open an HTML coverage report in the default browser.