Add Node.Globals for other global objects

Also update docs + fix jshint problems

Author: hdgarrood

bower.json

@@ -20,6 +20,7 @@
     "purescript-node-streams": "~0.3.0",
     "purescript-maybe": "~0.3.5",
     "purescript-exceptions": "~0.3.3",
-    "purescript-unsafe-coerce": "~0.1.0"
+    "purescript-unsafe-coerce": "~0.1.0",
+    "purescript-node-fs": "~0.9.2"
   }
 }

docs/Node/Globals.md

@@ -0,0 +1,47 @@
+## Module Node.Globals
+
+Global objects exposed by Node.js. See also the [Node.js API
+documentation](https://nodejs.org/api/globals.html).
+
+#### `__dirname`
+
+``` purescript
+__dirname :: String
+```
+
+The name of the directory that the currently executing script resides in.
+
+Note that this will probably not give you a very useful answer unless you
+have bundled up your PureScript code using `psc-bundle`!
+
+#### `__filename`
+
+``` purescript
+__filename :: String
+```
+
+The absolute path of the code file being executed.
+
+Note that this will probably not give you a very useful answer unless you
+have bundled up your PureScript code using `psc-bundle`!
+
+#### `unsafeRequire`
+
+``` purescript
+unsafeRequire :: forall a. String -> a
+```
+
+Just calls `require`. You might also consider using the FFI instead. This
+function is, in general, horribly unsafe, and may perform side effects.
+
+#### `requireResolve`
+
+``` purescript
+requireResolve :: forall eff. String -> Eff (fs :: FS | eff) String
+```
+
+`require.resolve()`. Use the internal `require` machinery to look up the
+location of a module, but rather than loading the module, just return the
+resolved filename.
+
+

docs/Node/Process.md

@@ -109,10 +109,17 @@ setEnv :: forall eff. String -> String -> Eff (process :: PROCESS | eff) Unit
 
 Set an environment variable.
 
+#### `Pid`
+
+``` purescript
+newtype Pid
+  = Pid Int
+```
+
 #### `pid`
 
 ``` purescript
-pid :: Int
+pid :: Pid
 ```
 
 #### `platform`
@@ -143,7 +150,7 @@ event, so any handlers attached via `onEnd` will never be called.
 #### `stdout`
 
 ``` purescript
-stdout :: forall eff. Writable () (console :: CONSOLE | eff)
+stdout :: forall eff. Writable () (console :: CONSOLE, err :: EXCEPTION | eff)
 ```
 
 The standard output stream. Note that this stream cannot be closed; calling
@@ -152,7 +159,7 @@ The standard output stream. Note that this stream cannot be closed; calling
 #### `stderr`
 
 ``` purescript
-stderr :: forall eff. Writable () (console :: CONSOLE | eff)
+stderr :: forall eff. Writable () (console :: CONSOLE, err :: EXCEPTION | eff)
 ```
 
 The standard error stream. Note that this stream cannot be closed; calling

src/Node/Globals.js

@@ -0,0 +1,17 @@
+"use strict";
+/* global exports */
+/* global require */
+/* global __dirname */
+/* global __filename  */
+
+// module Node.Globals
+
+exports.__dirname = __dirname;
+exports.__filename = __filename;
+exports.unsafeRequire = require;
+
+exports.requireResolve = function(mod) {
+  return function() {
+    return require.resolve(mod);
+  };
+};

src/Node/Globals.purs

@@ -0,0 +1,27 @@
+-- | Global objects exposed by Node.js. See also the [Node.js API
+-- | documentation](https://nodejs.org/api/globals.html).
+module Node.Globals where
+
+import Control.Monad.Eff
+import Node.FS (FS())
+
+-- | The name of the directory that the currently executing script resides in.
+-- |
+-- | Note that this will probably not give you a very useful answer unless you
+-- | have bundled up your PureScript code using `psc-bundle`!
+foreign import __dirname :: String
+
+-- | The absolute path of the code file being executed.
+-- |
+-- | Note that this will probably not give you a very useful answer unless you
+-- | have bundled up your PureScript code using `psc-bundle`!
+foreign import __filename :: String
+
+-- | Just calls `require`. You might also consider using the FFI instead. This
+-- | function is, in general, horribly unsafe, and may perform side effects.
+foreign import unsafeRequire :: forall a. String -> a
+
+-- | `require.resolve()`. Use the internal `require` machinery to look up the
+-- | location of a module, but rather than loading the module, just return the
+-- | resolved filename.
+foreign import requireResolve :: forall eff. String -> Eff (fs :: FS | eff) String

src/Node/Process.js

@@ -1,12 +1,15 @@
 "use strict";
 // module Node.Process
 
+/* global exports */
+/* global process */
+
 exports.process = process;
 
 exports.onBeforeExit = function(callback) {
     return function() {
         process.on('beforeExit', callback);
-    }
+    };
 };
 
 exports.onExit = function(callback) {