gode

README

gode

gode runs a sandboxed node installation to run node code and install npm packages.

Usage

Gode will autoinstall Node and npm if it's not in the specified working directory.

To use gode, first give it a working directory. In this case, ~/.gode. You would need to already have a homeDir variable for this to work.

c := NewClient(filepath.Join(homeDir, ".gode"))

Next, call c.Setup() to ensure that gode is setup properly in that working directory.

err := c.Setup()
if err != nil {
    panic(err)
}

Finally, execute a node script. This returns an *os/exec.Cmd:

output, err := c.RunScript(`console.log("hello world!")`).CombinedOutput()
if err != nil {
    panic(err)
}
fmt.Println(string(output))

Or install packages:

err := c.InstallPackage("request")
if err != nil {
    panic(err)
}

Meta

• Changelog
• License (ISC)
• Contributors

Documentation

Overview

Package gode runs a sandboxed node installation to run node code and install npm packages.

Index

• Constants
• type Client
  • func NewClient(rootPath string) *Client
  • func (c *Client) InstallPackage(name string) error
  • func (c *Client) IsSetup() bool
  • func (c *Client) Packages() ([]Package, error)
  • func (c *Client) RemovePackage(name string) error
  • func (c *Client) RunScript(script string) *exec.Cmd
  • func (c *Client) Setup() error
• type Package

Examples

• Client.RunScript

Constants

const DefaultNodeVersion = "1.1.0"

The Node version to install. Override this by setting client.Version.

const DefaultNpmVersion = "2.4.1"

The NPM version to install. Override this by setting client.Version.

const NodeCDN = "http://d1gnwkq6ucr1xr.cloudfront.net"

This is a Cloudfront CDN that mirrors http://iojs.org/dist It is much faster.

Types

type Client

type Client struct {
	RootPath    string
	NodeVersion string
	NpmVersion  string
	Registry    string
}

Client is the interface between Node and Go. It also setups up the Node environment if needed.

func NewClient

func NewClient(rootPath string) *Client

NewClient creates a new Client at the specified rootPath The Node installation can then be setup here with client.Setup()

func (*Client) InstallPackage

func (c *Client) InstallPackage(name string) error

InstallPackage installs an npm package.

func (*Client) IsSetup

func (c *Client) IsSetup() bool

IsSetup returns true if node is setup in the client's RootPath directory

func (*Client) Packages

func (c *Client) Packages() ([]Package, error)

Packages returns a list of npm packages installed.

func (*Client) RemovePackage

func (c *Client) RemovePackage(name string) error

RemovePackage removes an npm package.

func (*Client) RunScript

func (c *Client) RunScript(script string) *exec.Cmd

RunScript runs a given script in node Returns an *os/exec.Cmd instance

Example

c := NewClient("tmp")
err := c.Setup()
if err != nil {
	panic(err)
}
output, err := c.RunScript(`console.log("hello world!")`).CombinedOutput()
if err != nil {
	panic(err)
}
fmt.Println(string(output))

Output:

hello world!

func (*Client) Setup

func (c *Client) Setup() error

Setup downloads and sets up node in the client's RootPath directory

type Package

type Package struct {
	Name    string `json:"name"`
	Version string `json:"version"`
}

Package represents an npm package.