Add getter for hasTerminal, terminalColumns and terminalLines on stdout.

sdk/lib/io/stdio.dart

 // Copyright (c) 2013, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 part of dart.io;
 
 const int _STDIO_HANDLE_TYPE_TERMINAL = 0;
 const int _STDIO_HANDLE_TYPE_PIPE = 1;
 const int _STDIO_HANDLE_TYPE_FILE = 2;
 const int _STDIO_HANDLE_TYPE_SOCKET = 3;
@@ skipping 141 matching lines @@
   /**
    * Synchronously read a byte from stdin. This call will block until a byte is
    * available.
    *
    * If at end of file, -1 is returned.
    */
   external int readByteSync();
 }
 
 
+/**
+ * [Stdout] exposes methods to query the terminal for properties.
+ *
+ * Use [hasTerminal] to test if there is a terminal associated to stdout.
+ */
+class Stdout extends _StdSink implements IOSink {
+  Stdout._(IOSink sink) : super(sink);
+
+  /**
+   * Returns true if there is a terminal attached to stdout.
+   */
+  external bool get hasTerminal;
+
+  /**
+   * Get the number of columns of the terminal.
+   *
+   * If no terminal is attached to stdout, a [StdoutException] is thrown. See
+   * [hasTerminal] for more info.
+   */
+  external int get terminalColumns;
+
+  /**
+   * Get the number of lines of the terminal.
+   *
+   * If no terminal is attached to stdout, a [StdoutException] is thrown. See
+   * [hasTerminal] for more info.
+   */
+  external int get terminalLines;
+}
+
+
+class StdoutException implements IOException {
+  final String message;
+  final OSError osError;
+
+  const StdoutException(this.message, [this.osError]);
+
+  String toString() {
+    return "StdoutException: $message${osError == null ? "" : ", $osError"}";
+  }
+}
+
+
 class _StdSink implements IOSink {
   final IOSink _sink;
 
   _StdSink(IOSink this._sink);
 
   Encoding get encoding => _sink.encoding;
   void set encoding(Encoding encoding) {
     _sink.encoding = encoding;
   }
   void write(object) => _sink.write(object);
@@ skipping 15 matching lines @@
   static const StdioType PIPE = const StdioType._("pipe");
   static const StdioType FILE = const StdioType._("file");
   static const StdioType OTHER = const StdioType._("other");
   final String name;
   const StdioType._(String this.name);
   String toString() => "StdioType: $name";
 }
 
 
 Stdin _stdin;
-IOSink _stdout;
+Stdout _stdout;
 IOSink _stderr;
 
 
 /// The standard input stream of data read by this program.
 Stdin get stdin {
   if (_stdin == null) {
     _stdin = _StdIOUtils._getStdioInputStream();
   }
   return _stdin;
 }
 
 
 /// The standard output stream of data written by this program.
-IOSink get stdout {
+Stdout get stdout {
   if (_stdout == null) {
     _stdout = _StdIOUtils._getStdioOutputStream(1);
   }
   return _stdout;
 }
 
 
 /// The standard output stream of errors written by this program.
 IOSink get stderr {
   if (_stderr == null) {
@@ skipping 28 matching lines @@
       }
     } catch (e) {
       // Only the interface implemented, _sink not available.
     }
   }
   return StdioType.OTHER;
 }
 
 
 class _StdIOUtils {
-  external static IOSink _getStdioOutputStream(int fd);
+  external static _getStdioOutputStream(int fd);
   external static Stdin _getStdioInputStream();
   external static int _socketType(nativeSocket);
 }