summaryrefslogtreecommitdiff
path: root/deps/npm/node_modules/opener/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'deps/npm/node_modules/opener/README.md')
-rw-r--r--deps/npm/node_modules/opener/README.md57
1 files changed, 57 insertions, 0 deletions
diff --git a/deps/npm/node_modules/opener/README.md b/deps/npm/node_modules/opener/README.md
new file mode 100644
index 0000000000..8a803f3384
--- /dev/null
+++ b/deps/npm/node_modules/opener/README.md
@@ -0,0 +1,57 @@
+# It Opens Stuff
+
+That is, in your desktop environment. This will make *actual windows pop up*, with stuff in them:
+
+```bash
+npm install opener -g
+
+opener http://google.com
+opener ./my-file.txt
+opener firefox
+opener npm run lint
+```
+
+Also if you want to use it programmatically you can do that too:
+
+```js
+var opener = require("opener");
+
+opener("http://google.com");
+opener("./my-file.txt");
+opener("firefox");
+opener("npm run lint");
+```
+
+Plus, it returns the child process created, so you can do things like let your script exit while the window stays open:
+
+```js
+var editor = opener("documentation.odt");
+editor.unref();
+// These other unrefs may be necessary if your OS's opener process
+// exits before the process it started is complete.
+editor.stdin.unref();
+editor.stdout.unref();
+editor.stderr.unref();
+```
+
+
+## Use It for Good
+
+Like opening the user's browser with a test harness in your package's test script:
+
+```json
+{
+ "scripts": {
+ "test": "opener ./test/runner.html"
+ },
+ "devDependencies": {
+ "opener": "*"
+ }
+}
+```
+
+## Why
+
+Because Windows has `start`, Macs have `open`, and *nix has `xdg-open`. At least
+[according to some guy on StackOverflow](http://stackoverflow.com/q/1480971/3191). And I like things that work on all
+three. Like Node.js. And Opener.