Simple terminal message outputting tool.

Prints a message to the terminal.

• {Array|String} messages - Message to output, each item in the array is printed on a newline
• {Object} options
  • {Boolean} after - Add empty newline after message, defaults to true
  • {Boolean} before - Add empty newline before message, defaults to false
  • {Boolean} empty - Clear terminal, defaults to false
  • {Boolean} newline - Set to false to prevent moving cursor to newline, overrides after when false

These are tags which are dynamically replaced when generating the terminal message.

• {{basis version}} - Replaced with current Basis version in its package.json
• {{canvas version}} - Replaced with current Canvas version in its package.json
• {{storybook version}} - Replaced with current Canvas Storybook Tools version in its package.json

Moves the cursor and clears the terminal.

• {Object} clear
  • {String} clear.direction - Direction to clear in, accepts all, before, or after
  • {String} clear.type - Type of clear, accepts screen or line
• {Object} move
  • {String} move.direction - Direction to move, accepts up, down, right, or left
  • {Number} move.lines - Number of lines to move

Returns provided string with selected colour based on value of colour. Does not output the string, you must use message() or add() for this.

colour supports the following strings as values:

Note: When using background colour values the text colour is automatically set to the most contrasting (usually black).

Starts a spinner that shows each frame with a message.

• {Object} options
  • {Array} frames - Each item in array is used as a frame in the animation
  • {Number} interval - Time in ms between each frame, defaults to 100
  • {String} message - Message to display after animation frame
  • {Object} states - Contains the messages for various states which are accessed by the value of state in Tny.spinner.stop(state)

Stops the spinner and replaces it with the message defined in states using state as the key to find it.

E.g. if states contained values for success and error then using Tny.spinner.stop('success') would display the success message.

• {String} state - State to find in options.states of Tny.spinner.start()

Returns time taken with appropriate clock emoji where start is start time (or time taken in ms) and end is end time, both times should be ms from unix epoch.

• {Number} start - Start time
• {Number} end - End time

Writes messages to a log file. Does not replace or overwrite the log file, it will always append the new message to the end of the log file. Passing --- to the message option will write a horizontal rule.

• {Array|Object|String} messages - Message to append to log file, each item in the array is printed on a newline with a timestamp, if the item in the array is an object (or if an object is passed) then it will be stringified using JSON.stringify()
• {String} filepath - Filepath to log file to update, if it doesn't exist it will be created

See CHANGELOG.md for a history of changes.

Before making any updates to Tannoy please talk to Craig Baldwin ([email protected])

Once any work is completed send a pull request to Craig for review.