❤
npm
Sign UpSign In

node-vagrant-bin

1.0.2 • Public • Published

node-vagrant-cli

A library to ease programmatic use of vagrant binary with nodejs.

Install

npm i node-vagrant-cli --save

API

### new Vagrant(opts)

ServerPool constructor.

Arguments

  • opts - An object of configuration.

Examples

    var Vagrant = require('node-vagrant-cli');
    
    var opts = 
     {
      'provider':'virtualbox',
      'binary':'vagrant'
     };
    
    var vagrant = new Vagrant(opts);
 ### Vagrant.version(done)

Returns vagrant version number.

Arguments

  • done - A callback called on completion.
    • stderr - String of stderr.
    • version - String of version number.

Returns

  • child_process - A child_process.spawn object.

Examples

    var Vagrant = require('node-vagrant-cli');
    
    var opts = 
     {
      'provider':'virtualbox',
      'binary':'vagrant'
     };
    
    var vagrant = new Vagrant(opts);
    
    vagrant.version(function(err, version){
        console.log(err);
        console.log(version);
    });
 ### Vagrant.isInstalled(done)

Find out if vagrant is installed and available at options.binary location.

Arguments

  • done - A callback called on completion.
    • stderr - String of stderr.
    • isInstalled - Boolean.

Returns

  • child_process - A child_process.spawn object.

Examples

    var Vagrant = require('node-vagrant-cli');
    
    var opts = 
     {
      'provider':'virtualbox',
      'binary':'vagrant'
     };
    
    var vagrant = new Vagrant(opts);
    
    vagrant.isInstalled(function(err, isInstalled){
        console.log(err);
        console.log(isInstalled);
    });
 ### Vagrant.addBox(name, url, done)

Add box to vagrant.

Arguments

  • name - String of the new vagrant box.
  • url - String of the location of the vagrant box image.
  • done - A callback called on completion.
    • stderr - String of stderr.
    • stdout - String of stdout.
    • success - Boolean.

Returns

  • child_process - A child_process.spawn object.

Examples

    var Vagrant = require('node-vagrant-cli');
    
    var opts = 
     {
      'provider':'virtualbox',
      'binary':'vagrant'
     };
    
    var vagrant = new Vagrant(opts);
    
    vagrant.addBox(function(stderr, stdout, success){
        console.log(stderr);
        console.log(stdout);
        console.log(success);
    });
 ### Vagrant.up(machine, done)

Wake up a machine.

Arguments

  • machine - Name of an environment or a machine.
  • done - A callback called on completion.
    • stderr - String of output.
    • booted - Boolean true if machine has really booted.

Returns

  • child_process - A child_process.spawn object.

Examples

    var Vagrant = require('node-vagrant-cli');
    
    var opts = 
     {
      'provider':'virtualbox',
      'binary':'vagrant'
     };
    
    var vagrant = new Vagrant(opts);
    
    vagrant.up('centos', function(err, booted){
        console.log(err);
        console.log(booted);
    });
 ### Vagrant.halt(done)

Halt a machine.

Arguments

  • done - A callback called on completion.
    • stderr - An Error.

Returns

  • child_process - A child_process.spawn object.

Examples

    var Vagrant = require('node-vagrant-cli');
    
    var opts = 
     {
      'provider':'virtualbox',
      'binary':'vagrant'
     };
    
    var vagrant = new Vagrant(opts);
    
    vagrant.halt(function(err){
        console.log(err);
    });
 ### Vagrant.status(done)

Fetch vagrant status, returns a object of machines and their status.

Arguments

  • done - A callback called on completion.
    • stderr - An Error.
    • machines - An Object of machines and their status.

Returns

  • child_process - A child_process.spawn object.

Examples

    var Vagrant = require('node-vagrant-cli');
    
    var opts = 
     {
      'provider':'virtualbox',
      'binary':'vagrant'
     };
    
    var vagrant = new Vagrant(opts);
    
    vagrant.status(function(stderr, machines){
        console.log(machines);
        /*
        {
            'machine':{
              status:'running', // poweroff
              provider:'virtualbox' // libvirt
            }
        }
        */
    });
 ### Vagrant.isRunning(done)

Tells if vagrant is running a machine.

Arguments

  • done - A callback called on completion.
    • stderr - An Error.
    • isRunning - A Boolean, false if no machine runs, String if a machine runs.

Returns

  • child_process - A child_process.spawn object.

Examples

    var Vagrant = require('node-vagrant-cli');
    
    var opts = 
     {
      'provider':'virtualbox',
      'binary':'vagrant'
     };
    
    var vagrant = new Vagrant(opts);
    
    vagrant.isRunning(function(stderr, running){
        if(running===false){
            console.log('no machine runs';
        } else {
            console.log('runing machine is '+running);
        }
    });

Status

In development. It needs some tests.

Readme

Keywords

Package Sidebar

Install

npm i node-vagrant-bin

Weekly Downloads

7

Version

1.0.2

License

WTF

Last publish

Collaborators

  • maboiteaspam
Try on RunKit
Report malware