Overview

This package provides a set of APIs to help you develop applications in Cloud Foundry. You can use these APIs to manage apps, service instances, orgs, spaces, and users in your environment. Mostly, this is a wrapper of the CF command line client, which runs a particular command and parses the output to the suitable JSON file. If an error or failure occurs, the runtime exception throws with relevant problem information.

API Reference Guide

API guide

Prerequisite

from version v1.0.0 and above:

Make sure you have installed the CF CLI v7 tool in your environment.

below version v1.0.0:

Make sure you have installed the CF CLI v6 tool in your environment.

Examples of usage

Example 1

try {
    const result = await cfLogin("https://api.cf.....com", "user", "password");
    if (result === "OK") {
        // successful
    }
} catch (e) {
    // display or/and log error
}

Example 2

try {
    const spaces = await cfGetAvailableSpaces("myOrg");
    for (const space of spaces) {
        console.log("Space label is " + space.label + " guid is " + space.guid);
    }
} catch (e) {
    // display or/and log error
}

Contributing

Contributing information can be found in the CONTRIBUTING.md file.