le-table

Another NodeJS module for creating ASCII tables.

☁️ Installation

$ npm i --save le-table

📋 Example

const Table = require("le-table");

// Table data
let data = [
    ["Cell 1.1", "Cell 2.1", "Cell 3.1"]
  , ["Cell 1.2", {
        text: "Multi\nline\n\u001b[34mcell\ncontent that\u001b[0m is\n left aligned."
      , data: {
            hAlign: "left"
        }
    }, "Cell 3.2"]
  , ["Cell 1.3", "Cell 2.3", "Cell 3.3"]
  , ["Cell 1.4", "Cell 2.4", "Cell 3.4"]
];

// Create table instance
var myTable = new Table();

// Push data
for (let i = 0; i < data.length; ++i) {
    myTable.addRow([i].concat(data[i]), {
        hAlign: i > 2 ? "left": "right"
    });
}

// Output table
console.log(myTable.stringify());

📝 Documentation

LeTable(options)

Creates a new instance of LeTable.

Params

• Object options: An object containing the table configuration:
  • cell: object containing
    • hAlign (default: "center"): One of the following values: "left", "center" and "right"
    • vAlign (default: "middle"): One of the following values: "top", "middle" and "bottom"
    • autoEOL (default: true): if true, the lines are wrapped inside of the cell
    • stretch (default: true): if true, the size of the box will not be fixed
  • marks: object containing the mark characters (see example)
  • noAnsi (Boolean): If you want to disable ANSI characters in the output.

Return

• LeTable The LeTable instance.

addRow(columns, ops)

Adds a new row in table.

Params

• Array columns: Row data (as array)
• Object ops: Options for cell content

Return

• LeTable The LeTable instance.

stringify()

Stringifies the table.

Return

• String The stringified table

😋 How to contribute

Have an idea? Found a bug? See how to contribute.

💫 Where is this library used?

If you are using this library in one of your projects, add it in this list. ✨

• ascii-github—GitHub CLI Client
• bible—Read the Holy Bible via the command line.
• birthday—Know when a friend's birthday is coming.
• cli-github—A fancy GitHub client for command line.
• git-issues (by Gabriel Petrovay)—Git issues extension to list issues of a Git project
• git-issues1 (by Gabriel Petrovay)—Git issues extension to list issues of a Git project
• idea—A lightweight CLI tool and module for keeping ideas in a safe place quick and easy.
• tilda—Tiny module for building command line tools.
• tithe—Organize and track the tithe payments.

📜 License

MIT © Ionică Bizău