summaryrefslogtreecommitdiff
path: root/node_modules/eyes/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'node_modules/eyes/README.md')
-rw-r--r--node_modules/eyes/README.md73
1 files changed, 73 insertions, 0 deletions
diff --git a/node_modules/eyes/README.md b/node_modules/eyes/README.md
new file mode 100644
index 0000000..c4f6f76
--- /dev/null
+++ b/node_modules/eyes/README.md
@@ -0,0 +1,73 @@
+eyes
+====
+
+a customizable value inspector for Node.js
+
+synopsis
+--------
+
+I was tired of looking at cluttered output in the console -- something needed to be done,
+`sys.inspect()` didn't display regexps correctly, and was too verbose, and I had an hour or two to spare.
+So I decided to have some fun. _eyes_ were born.
+
+![eyes-ss](http://dl.dropbox.com/u/251849/eyes-js-ss.gif)
+
+_example of the output of a user-customized eyes.js inspector_
+
+*eyes* also deals with circular objects in an intelligent way, and can pretty-print object literals.
+
+usage
+-----
+
+ var inspect = require('eyes').inspector({styles: {all: 'magenta'}});
+
+ inspect(something); // inspect with the settings passed to `inspector`
+
+or
+
+ var eyes = require('eyes');
+
+ eyes.inspect(something); // inspect with the default settings
+
+you can pass a _label_ to `inspect()`, to keep track of your inspections:
+
+ eyes.inspect(something, "a random value");
+
+If you want to return the output of eyes without printing it, you can set it up this way:
+
+ var inspect = require('eyes').inspector({ stream: null });
+
+ sys.puts(inspect({ something: 42 }));
+
+customization
+-------------
+
+These are the default styles and settings used by _eyes_.
+
+ styles: { // Styles applied to stdout
+ all: 'cyan', // Overall style applied to everything
+ label: 'underline', // Inspection labels, like 'array' in `array: [1, 2, 3]`
+ other: 'inverted', // Objects which don't have a literal representation, such as functions
+ key: 'bold', // The keys in object literals, like 'a' in `{a: 1}`
+ special: 'grey', // null, undefined...
+ string: 'green',
+ number: 'magenta',
+ bool: 'blue', // true false
+ regexp: 'green', // /\d+/
+ },
+
+ pretty: true, // Indent object literals
+ hideFunctions: false, // Don't output functions at all
+ stream: process.stdout, // Stream to write to, or null
+ maxLength: 2048 // Truncate output if longer
+
+You can overwrite them with your own, by passing a similar object to `inspector()` or `inspect()`.
+
+ var inspect = require('eyes').inspector({
+ styles: {
+ all: 'magenta',
+ special: 'bold'
+ },
+ maxLength: 512
+ });
+