Clean and create output directory when generating docs.

frog/lib/node/node.dart

 // Copyright (c) 2011, 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.
 
 /**
  * A collection of helper io functions implemented using node.js.
  *
  * Idea is to clone the node.js API as closely as possible while adding types.
  * Dart libraries on top of this will experiment with different APIs.
  */
@@ skipping 72 matching lines @@
   void runInNewContext([Map sandbox]) native;
 }
 
 class fs native "require('fs')" {
   static void writeFileSync(String outfile, String text) native;
 
   static String readFileSync(String filename, [String encoding = 'utf8'])
     native;
 
   static String realpathSync(String path) native;
+
+  static void mkdirSync(String path, [num mode = 511 /* 077 octal */]) native;
+  static List<String> readdirSync(String path) native;
+  static void rmdirSync(String path) native;
+  static Stats statSync(String path) native;
+  static void unlinkSync(String path) native;
+}
+
+class Stats native "fs.Stats" {
+  bool isFile() native;

[Jacob, 2011/11/16 19:59:30]

should these be

bool get file() native;
bool get blockDevice() native;
...
?

[jimhug, 2011/11/17 16:59:44]

This is a tough interop case and I'm unsure at which layer to make things more
dart-like.  For now, I think that we should stick with a direct clone of the
node apis here whenever possible and worry about the cleaner dart design when we
have an official shared complete file i/o library in dart.

On 2011/11/16 19:59:30, Jacob wrote:

[jacob314, 2011/11/17 19:06:16]

I agree that just reusing the node names and at most adding a TODO is the right
call.

On 2011/11/17 16:59:44, jimhug wrote:

[Bob Nystrom, 2011/11/17 20:44:21]

What Jim said. I was under the impression that this layer had to match node's
API exactly since it's using native here. NodeFileSystem then consumes this and
provides a Dartier API.

+  bool isDirectory() native;
+  bool isBlockDevice() native;
+  bool isCharacterDevice() native;
+  bool isSymbolicLink() native;
+  bool isFIFO() native;
+  bool isSocket() native;
+
+  // TODO(rnystrom): There are also the other fields we can add here if needed.
+  // See: http://nodejs.org/docs/v0.6.1/api/fs.html#fs.Stats.
 }
 
 class path native "require('path')" {
   static bool existsSync(String filename) native;
   static String dirname(String path) native;
   static String basename(String path) native;
   static String extname(String path) native;
   static String normalize(String path) native;
   // TODO(jimhug): Get the right signatures for normalizeArray and join
 }
 
 class Readline native "require('readline')" {
   static ReadlineInterface createInterface(input, output) native;
 }
 
 class ReadlineInterface native "readline.Interface" {
   void setPrompt(String prompt, [int length]) native;
   void prompt() native;
   void on(String event, Function callback) native;
 }
 
 interface TimeoutId {}
 
 TimeoutId setTimeout(Function callback, num delay, [arg]) native;
 clearTimeout(TimeoutId id) native;