console 2.2.0

Console Power Library

Console

A high-level console library.

Features

• Console Colors (ANSI)
• Icons (UTF-8)
• Keyboard Capture
• Experimental Clipboard Support
• Progress Bars
• Flexible Prompts
• Shell Prompts
• Choosers
• Fancy Formatting
• Loading Bars
• Timer (like pub's timer)
• Fancy Trees (like the npm dependency trees)
• Simple Unit Testing

Usage

This library does not work in browsers (for a hopefully obvious reason).

import "package:console/console.dart";

void main() {
  // Initialize the Console. Throws an exception if advanced terminal features are not supported.
  Terminal.init();
  
  // Use the library.
}

Unit Testing

You can test the output produced by this library (and thus your own project that uses this library). Here is an example:

library someproject.test;

import 'package:unittest/unittest.dart';
import 'package:console/console.dart';

void main() {

  // Configures Terminal to use a StringBuffer() instead of stdout.
  var output = useStringStdout();
  output.terminalColumns = 80;
  output.terminalLines = 20;

  // makes sure to clear output between test runs
  setUp(() => output.clear());

  group('base functions', () {
    test('centerCursor', () {
      Terminal.centerCursor();
      expect(output.str, equals(Terminal.ANSI_ESCAPE + "10;40H"));
    });
  });
}