stylus-source 0.31.0 → 0.32.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (143) hide show
  1. checksums.yaml +7 -0
  2. data/VERSION +1 -1
  3. data/vendor/lib/nodes/unit.js +1 -1
  4. data/vendor/lib/parser.js +0 -1
  5. data/vendor/lib/renderer.js +2 -0
  6. data/vendor/lib/visitor/compiler.js +6 -0
  7. data/vendor/node_modules/cssom/README.mdown +34 -0
  8. data/vendor/node_modules/cssom/package.json +2 -1
  9. data/vendor/node_modules/debug/History.md +15 -0
  10. data/vendor/node_modules/debug/Readme.md +3 -18
  11. data/vendor/node_modules/debug/component.json +9 -0
  12. data/vendor/node_modules/debug/debug.js +10 -2
  13. data/vendor/node_modules/debug/index.js +5 -2
  14. data/vendor/node_modules/debug/lib/debug.js +5 -6
  15. data/vendor/node_modules/debug/package.json +11 -6
  16. data/vendor/node_modules/mkdirp/package.json +6 -9
  17. data/vendor/node_modules/mkdirp/{README.markdown → readme.markdown} +26 -24
  18. data/vendor/node_modules/mocha/History.md +140 -58
  19. data/vendor/node_modules/mocha/LICENSE +2 -2
  20. data/vendor/node_modules/mocha/Makefile +20 -5
  21. data/vendor/node_modules/mocha/Readme.md +110 -22
  22. data/vendor/node_modules/mocha/_mocha.js +574 -182
  23. data/vendor/node_modules/mocha/bin/_mocha +39 -22
  24. data/vendor/node_modules/mocha/bin/mocha +6 -2
  25. data/vendor/node_modules/mocha/component.json +16 -0
  26. data/vendor/node_modules/mocha/lib/browser/debug.js +1 -2
  27. data/vendor/node_modules/mocha/lib/browser/diff.js +287 -0
  28. data/vendor/node_modules/mocha/lib/browser/tty.js +7 -2
  29. data/vendor/node_modules/mocha/lib/hook.js +0 -1
  30. data/vendor/node_modules/mocha/lib/interfaces/bdd.js +3 -3
  31. data/vendor/node_modules/mocha/lib/interfaces/exports.js +5 -5
  32. data/vendor/node_modules/mocha/lib/interfaces/qunit.js +38 -9
  33. data/vendor/node_modules/mocha/lib/interfaces/tdd.js +15 -2
  34. data/vendor/node_modules/mocha/lib/mocha.js +20 -4
  35. data/vendor/node_modules/mocha/lib/reporters/base.js +57 -37
  36. data/vendor/node_modules/mocha/lib/reporters/html.js +2 -4
  37. data/vendor/node_modules/mocha/lib/reporters/json-stream.js +4 -14
  38. data/vendor/node_modules/mocha/lib/reporters/json.js +9 -19
  39. data/vendor/node_modules/mocha/lib/reporters/markdown.js +0 -1
  40. data/vendor/node_modules/mocha/lib/reporters/min.js +2 -2
  41. data/vendor/node_modules/mocha/lib/reporters/nyan.js +33 -39
  42. data/vendor/node_modules/mocha/lib/reporters/tap.js +12 -2
  43. data/vendor/node_modules/mocha/lib/reporters/templates/coverage.jade +3 -3
  44. data/vendor/node_modules/mocha/lib/reporters/templates/menu.jade +1 -1
  45. data/vendor/node_modules/mocha/lib/reporters/xunit.js +4 -4
  46. data/vendor/node_modules/mocha/lib/runnable.js +7 -9
  47. data/vendor/node_modules/mocha/lib/runner.js +24 -9
  48. data/vendor/node_modules/mocha/lib/template.html +2 -1
  49. data/vendor/node_modules/mocha/lib/utils.js +3 -3
  50. data/vendor/node_modules/mocha/mocha.css +37 -13
  51. data/vendor/node_modules/mocha/mocha.js +661 -253
  52. data/vendor/node_modules/mocha/node_modules/commander/package.json +5 -1
  53. data/vendor/node_modules/mocha/node_modules/diff/package.json +5 -1
  54. data/vendor/node_modules/mocha/node_modules/glob/LICENSE +27 -0
  55. data/vendor/node_modules/mocha/node_modules/glob/README.md +250 -0
  56. data/vendor/node_modules/mocha/node_modules/glob/examples/g.js +9 -0
  57. data/vendor/node_modules/mocha/node_modules/glob/examples/usr-local.js +9 -0
  58. data/vendor/node_modules/mocha/node_modules/glob/glob.js +675 -0
  59. data/vendor/node_modules/mocha/node_modules/glob/node_modules/graceful-fs/LICENSE +27 -0
  60. data/vendor/node_modules/mocha/node_modules/glob/node_modules/graceful-fs/README.md +33 -0
  61. data/vendor/node_modules/mocha/node_modules/glob/node_modules/graceful-fs/graceful-fs.js +442 -0
  62. data/vendor/node_modules/mocha/node_modules/glob/node_modules/graceful-fs/package.json +49 -0
  63. data/vendor/node_modules/mocha/node_modules/glob/node_modules/graceful-fs/test/open.js +46 -0
  64. data/vendor/node_modules/mocha/node_modules/glob/node_modules/graceful-fs/test/ulimit.js +158 -0
  65. data/vendor/node_modules/mocha/node_modules/glob/node_modules/inherits/README.md +51 -0
  66. data/vendor/node_modules/mocha/node_modules/glob/node_modules/inherits/inherits.js +29 -0
  67. data/vendor/node_modules/mocha/node_modules/glob/node_modules/inherits/package.json +26 -0
  68. data/vendor/node_modules/mocha/node_modules/glob/node_modules/minimatch/LICENSE +23 -0
  69. data/vendor/node_modules/mocha/node_modules/glob/node_modules/minimatch/README.md +218 -0
  70. data/vendor/node_modules/mocha/node_modules/glob/node_modules/minimatch/minimatch.js +1079 -0
  71. data/vendor/node_modules/mocha/node_modules/glob/node_modules/minimatch/node_modules/lru-cache/AUTHORS +8 -0
  72. data/vendor/node_modules/mocha/node_modules/glob/node_modules/minimatch/node_modules/lru-cache/LICENSE +23 -0
  73. data/vendor/node_modules/mocha/node_modules/glob/node_modules/minimatch/node_modules/lru-cache/README.md +97 -0
  74. data/vendor/node_modules/mocha/node_modules/glob/node_modules/minimatch/node_modules/lru-cache/lib/lru-cache.js +257 -0
  75. data/vendor/node_modules/mocha/node_modules/glob/node_modules/minimatch/node_modules/lru-cache/package.json +59 -0
  76. data/vendor/node_modules/mocha/node_modules/glob/node_modules/minimatch/node_modules/lru-cache/s.js +25 -0
  77. data/vendor/node_modules/mocha/node_modules/glob/node_modules/minimatch/node_modules/lru-cache/test/basic.js +329 -0
  78. data/vendor/node_modules/mocha/node_modules/glob/node_modules/minimatch/node_modules/lru-cache/test/foreach.js +52 -0
  79. data/vendor/node_modules/mocha/node_modules/glob/node_modules/minimatch/node_modules/lru-cache/test/memory-leak.js +50 -0
  80. data/vendor/node_modules/mocha/node_modules/glob/node_modules/minimatch/node_modules/sigmund/LICENSE +27 -0
  81. data/vendor/node_modules/mocha/node_modules/glob/node_modules/minimatch/node_modules/sigmund/README.md +53 -0
  82. data/vendor/node_modules/mocha/node_modules/glob/node_modules/minimatch/node_modules/sigmund/bench.js +283 -0
  83. data/vendor/node_modules/mocha/node_modules/glob/node_modules/minimatch/node_modules/sigmund/package.json +38 -0
  84. data/vendor/node_modules/mocha/node_modules/glob/node_modules/minimatch/node_modules/sigmund/sigmund.js +39 -0
  85. data/vendor/node_modules/mocha/node_modules/glob/node_modules/minimatch/node_modules/sigmund/test/basic.js +24 -0
  86. data/vendor/node_modules/mocha/node_modules/glob/node_modules/minimatch/package.json +36 -0
  87. data/vendor/node_modules/mocha/node_modules/glob/node_modules/minimatch/test/basic.js +399 -0
  88. data/vendor/node_modules/mocha/node_modules/glob/node_modules/minimatch/test/brace-expand.js +33 -0
  89. data/vendor/node_modules/mocha/node_modules/glob/node_modules/minimatch/test/caching.js +14 -0
  90. data/vendor/node_modules/mocha/node_modules/glob/node_modules/minimatch/test/defaults.js +274 -0
  91. data/vendor/node_modules/mocha/node_modules/glob/package.json +40 -0
  92. data/vendor/node_modules/mocha/node_modules/glob/test/00-setup.js +176 -0
  93. data/vendor/node_modules/mocha/node_modules/glob/test/bash-comparison.js +63 -0
  94. data/vendor/node_modules/mocha/node_modules/glob/test/bash-results.json +350 -0
  95. data/vendor/node_modules/mocha/node_modules/glob/test/cwd-test.js +55 -0
  96. data/vendor/node_modules/mocha/node_modules/glob/test/globstar-match.js +19 -0
  97. data/vendor/node_modules/mocha/node_modules/glob/test/mark.js +74 -0
  98. data/vendor/node_modules/mocha/node_modules/glob/test/nocase-nomagic.js +113 -0
  99. data/vendor/node_modules/mocha/node_modules/glob/test/pause-resume.js +73 -0
  100. data/vendor/node_modules/mocha/node_modules/glob/test/root-nomount.js +39 -0
  101. data/vendor/node_modules/mocha/node_modules/glob/test/root.js +46 -0
  102. data/vendor/node_modules/mocha/node_modules/glob/test/stat.js +32 -0
  103. data/vendor/node_modules/mocha/node_modules/glob/test/zz-cleanup.js +11 -0
  104. data/vendor/node_modules/mocha/node_modules/growl/History.md +5 -0
  105. data/vendor/node_modules/mocha/node_modules/growl/lib/growl.js +2 -0
  106. data/vendor/node_modules/mocha/node_modules/growl/package.json +7 -3
  107. data/vendor/node_modules/mocha/node_modules/jade/node_modules/mkdirp/package.json +5 -1
  108. data/vendor/node_modules/mocha/node_modules/jade/package.json +5 -1
  109. data/vendor/node_modules/mocha/node_modules/ms/package.json +5 -1
  110. data/vendor/node_modules/mocha/package.json +13 -7
  111. data/vendor/node_modules/mocha/test.js +10 -21
  112. data/vendor/node_modules/should/History.md +5 -0
  113. data/vendor/node_modules/should/Readme.md +172 -172
  114. data/vendor/node_modules/should/lib/eql.js +2 -0
  115. data/vendor/node_modules/should/lib/should.js +4 -3
  116. data/vendor/node_modules/should/package.json +8 -4
  117. data/vendor/node_modules/should/test/should.test.js +27 -0
  118. data/vendor/package.json +1 -1
  119. metadata +61 -35
  120. data/vendor/node_modules/debug/Makefile +0 -4
  121. data/vendor/node_modules/debug/debug.component.js +0 -120
  122. data/vendor/node_modules/debug/head.js +0 -1
  123. data/vendor/node_modules/debug/tail.js +0 -4
  124. data/vendor/node_modules/mocha/node_modules/mkdirp/LICENSE +0 -21
  125. data/vendor/node_modules/mocha/node_modules/mkdirp/README.markdown +0 -61
  126. data/vendor/node_modules/mocha/node_modules/mkdirp/examples/pow.js +0 -6
  127. data/vendor/node_modules/mocha/node_modules/mkdirp/examples/pow.js.orig +0 -6
  128. data/vendor/node_modules/mocha/node_modules/mkdirp/examples/pow.js.rej +0 -19
  129. data/vendor/node_modules/mocha/node_modules/mkdirp/index.js +0 -94
  130. data/vendor/node_modules/mocha/node_modules/mkdirp/package.json +0 -33
  131. data/vendor/node_modules/mocha/node_modules/mkdirp/test/chmod.js +0 -38
  132. data/vendor/node_modules/mocha/node_modules/mkdirp/test/clobber.js +0 -37
  133. data/vendor/node_modules/mocha/node_modules/mkdirp/test/mkdirp.js +0 -28
  134. data/vendor/node_modules/mocha/node_modules/mkdirp/test/perm.js +0 -32
  135. data/vendor/node_modules/mocha/node_modules/mkdirp/test/perm_sync.js +0 -39
  136. data/vendor/node_modules/mocha/node_modules/mkdirp/test/race.js +0 -41
  137. data/vendor/node_modules/mocha/node_modules/mkdirp/test/rel.js +0 -32
  138. data/vendor/node_modules/mocha/node_modules/mkdirp/test/return.js +0 -25
  139. data/vendor/node_modules/mocha/node_modules/mkdirp/test/return_sync.js +0 -24
  140. data/vendor/node_modules/mocha/node_modules/mkdirp/test/root.js +0 -18
  141. data/vendor/node_modules/mocha/node_modules/mkdirp/test/sync.js +0 -32
  142. data/vendor/node_modules/mocha/node_modules/mkdirp/test/umask.js +0 -28
  143. data/vendor/node_modules/mocha/node_modules/mkdirp/test/umask_sync.js +0 -32
@@ -0,0 +1,158 @@
1
+ var test = require('tap').test
2
+
3
+ // simulated ulimit
4
+ // this is like graceful-fs, but in reverse
5
+ var fs_ = require('fs')
6
+ var fs = require('../graceful-fs.js')
7
+ var files = fs.readdirSync(__dirname)
8
+
9
+ // Ok, no more actual file reading!
10
+
11
+ var fds = 0
12
+ var nextFd = 60
13
+ var limit = 8
14
+ fs_.open = function (path, flags, mode, cb) {
15
+ process.nextTick(function() {
16
+ ++fds
17
+ if (fds >= limit) {
18
+ --fds
19
+ var er = new Error('EMFILE Curses!')
20
+ er.code = 'EMFILE'
21
+ er.path = path
22
+ return cb(er)
23
+ } else {
24
+ cb(null, nextFd++)
25
+ }
26
+ })
27
+ }
28
+
29
+ fs_.openSync = function (path, flags, mode) {
30
+ if (fds >= limit) {
31
+ var er = new Error('EMFILE Curses!')
32
+ er.code = 'EMFILE'
33
+ er.path = path
34
+ throw er
35
+ } else {
36
+ ++fds
37
+ return nextFd++
38
+ }
39
+ }
40
+
41
+ fs_.close = function (fd, cb) {
42
+ process.nextTick(function () {
43
+ --fds
44
+ cb()
45
+ })
46
+ }
47
+
48
+ fs_.closeSync = function (fd) {
49
+ --fds
50
+ }
51
+
52
+ fs_.readdir = function (path, cb) {
53
+ process.nextTick(function() {
54
+ if (fds >= limit) {
55
+ var er = new Error('EMFILE Curses!')
56
+ er.code = 'EMFILE'
57
+ er.path = path
58
+ return cb(er)
59
+ } else {
60
+ ++fds
61
+ process.nextTick(function () {
62
+ --fds
63
+ cb(null, [__filename, "some-other-file.js"])
64
+ })
65
+ }
66
+ })
67
+ }
68
+
69
+ fs_.readdirSync = function (path) {
70
+ if (fds >= limit) {
71
+ var er = new Error('EMFILE Curses!')
72
+ er.code = 'EMFILE'
73
+ er.path = path
74
+ throw er
75
+ } else {
76
+ return [__filename, "some-other-file.js"]
77
+ }
78
+ }
79
+
80
+
81
+ test('open emfile autoreduce', function (t) {
82
+ fs.MIN_MAX_OPEN = 4
83
+ t.equal(fs.MAX_OPEN, 1024)
84
+
85
+ var max = 12
86
+ for (var i = 0; i < max; i++) {
87
+ fs.open(__filename, 'r', next(i))
88
+ }
89
+
90
+ var phase = 0
91
+
92
+ var expect =
93
+ [ [ 0, 60, null, 1024, 4, 12, 1 ],
94
+ [ 1, 61, null, 1024, 4, 12, 2 ],
95
+ [ 2, 62, null, 1024, 4, 12, 3 ],
96
+ [ 3, 63, null, 1024, 4, 12, 4 ],
97
+ [ 4, 64, null, 1024, 4, 12, 5 ],
98
+ [ 5, 65, null, 1024, 4, 12, 6 ],
99
+ [ 6, 66, null, 1024, 4, 12, 7 ],
100
+ [ 7, 67, null, 6, 4, 5, 1 ],
101
+ [ 8, 68, null, 6, 4, 5, 2 ],
102
+ [ 9, 69, null, 6, 4, 5, 3 ],
103
+ [ 10, 70, null, 6, 4, 5, 4 ],
104
+ [ 11, 71, null, 6, 4, 5, 5 ] ]
105
+
106
+ var actual = []
107
+
108
+ function next (i) { return function (er, fd) {
109
+ if (er)
110
+ throw er
111
+ actual.push([i, fd, er, fs.MAX_OPEN, fs.MIN_MAX_OPEN, fs._curOpen, fds])
112
+
113
+ if (i === max - 1) {
114
+ t.same(actual, expect)
115
+ t.ok(fs.MAX_OPEN < limit)
116
+ t.end()
117
+ }
118
+
119
+ fs.close(fd)
120
+ } }
121
+ })
122
+
123
+ test('readdir emfile autoreduce', function (t) {
124
+ fs.MAX_OPEN = 1024
125
+ var max = 12
126
+ for (var i = 0; i < max; i ++) {
127
+ fs.readdir(__dirname, next(i))
128
+ }
129
+
130
+ var expect =
131
+ [ [0,[__filename,"some-other-file.js"],null,7,4,7,7],
132
+ [1,[__filename,"some-other-file.js"],null,7,4,7,6],
133
+ [2,[__filename,"some-other-file.js"],null,7,4,7,5],
134
+ [3,[__filename,"some-other-file.js"],null,7,4,7,4],
135
+ [4,[__filename,"some-other-file.js"],null,7,4,7,3],
136
+ [5,[__filename,"some-other-file.js"],null,7,4,6,2],
137
+ [6,[__filename,"some-other-file.js"],null,7,4,5,1],
138
+ [7,[__filename,"some-other-file.js"],null,7,4,4,0],
139
+ [8,[__filename,"some-other-file.js"],null,7,4,3,3],
140
+ [9,[__filename,"some-other-file.js"],null,7,4,2,2],
141
+ [10,[__filename,"some-other-file.js"],null,7,4,1,1],
142
+ [11,[__filename,"some-other-file.js"],null,7,4,0,0] ]
143
+
144
+ var actual = []
145
+
146
+ function next (i) { return function (er, files) {
147
+ if (er)
148
+ throw er
149
+ var line = [i, files, er, fs.MAX_OPEN, fs.MIN_MAX_OPEN, fs._curOpen, fds ]
150
+ actual.push(line)
151
+
152
+ if (i === max - 1) {
153
+ t.ok(fs.MAX_OPEN < limit)
154
+ t.same(actual, expect)
155
+ t.end()
156
+ }
157
+ } }
158
+ })
@@ -0,0 +1,51 @@
1
+ A dead simple way to do inheritance in JS.
2
+
3
+ var inherits = require("inherits")
4
+
5
+ function Animal () {
6
+ this.alive = true
7
+ }
8
+ Animal.prototype.say = function (what) {
9
+ console.log(what)
10
+ }
11
+
12
+ inherits(Dog, Animal)
13
+ function Dog () {
14
+ Dog.super.apply(this)
15
+ }
16
+ Dog.prototype.sniff = function () {
17
+ this.say("sniff sniff")
18
+ }
19
+ Dog.prototype.bark = function () {
20
+ this.say("woof woof")
21
+ }
22
+
23
+ inherits(Chihuahua, Dog)
24
+ function Chihuahua () {
25
+ Chihuahua.super.apply(this)
26
+ }
27
+ Chihuahua.prototype.bark = function () {
28
+ this.say("yip yip")
29
+ }
30
+
31
+ // also works
32
+ function Cat () {
33
+ Cat.super.apply(this)
34
+ }
35
+ Cat.prototype.hiss = function () {
36
+ this.say("CHSKKSS!!")
37
+ }
38
+ inherits(Cat, Animal, {
39
+ meow: function () { this.say("miao miao") }
40
+ })
41
+ Cat.prototype.purr = function () {
42
+ this.say("purr purr")
43
+ }
44
+
45
+
46
+ var c = new Chihuahua
47
+ assert(c instanceof Chihuahua)
48
+ assert(c instanceof Dog)
49
+ assert(c instanceof Animal)
50
+
51
+ The actual function is laughably small. 10-lines small.
@@ -0,0 +1,29 @@
1
+ module.exports = inherits
2
+
3
+ function inherits (c, p, proto) {
4
+ proto = proto || {}
5
+ var e = {}
6
+ ;[c.prototype, proto].forEach(function (s) {
7
+ Object.getOwnPropertyNames(s).forEach(function (k) {
8
+ e[k] = Object.getOwnPropertyDescriptor(s, k)
9
+ })
10
+ })
11
+ c.prototype = Object.create(p.prototype, e)
12
+ c.super = p
13
+ }
14
+
15
+ //function Child () {
16
+ // Child.super.call(this)
17
+ // console.error([this
18
+ // ,this.constructor
19
+ // ,this.constructor === Child
20
+ // ,this.constructor.super === Parent
21
+ // ,Object.getPrototypeOf(this) === Child.prototype
22
+ // ,Object.getPrototypeOf(Object.getPrototypeOf(this))
23
+ // === Parent.prototype
24
+ // ,this instanceof Child
25
+ // ,this instanceof Parent])
26
+ //}
27
+ //function Parent () {}
28
+ //inherits(Child, Parent)
29
+ //new Child
@@ -0,0 +1,26 @@
1
+ {
2
+ "name": "inherits",
3
+ "description": "A tiny simple way to do classic inheritance in js",
4
+ "version": "1.0.0",
5
+ "keywords": [
6
+ "inheritance",
7
+ "class",
8
+ "klass",
9
+ "oop",
10
+ "object-oriented"
11
+ ],
12
+ "main": "./inherits.js",
13
+ "repository": {
14
+ "type": "git",
15
+ "url": "https://github.com/isaacs/inherits"
16
+ },
17
+ "author": {
18
+ "name": "Isaac Z. Schlueter",
19
+ "email": "i@izs.me",
20
+ "url": "http://blog.izs.me/"
21
+ },
22
+ "readme": "A dead simple way to do inheritance in JS.\n\n var inherits = require(\"inherits\")\n\n function Animal () {\n this.alive = true\n }\n Animal.prototype.say = function (what) {\n console.log(what)\n }\n\n inherits(Dog, Animal)\n function Dog () {\n Dog.super.apply(this)\n }\n Dog.prototype.sniff = function () {\n this.say(\"sniff sniff\")\n }\n Dog.prototype.bark = function () {\n this.say(\"woof woof\")\n }\n\n inherits(Chihuahua, Dog)\n function Chihuahua () {\n Chihuahua.super.apply(this)\n }\n Chihuahua.prototype.bark = function () {\n this.say(\"yip yip\")\n }\n\n // also works\n function Cat () {\n Cat.super.apply(this)\n }\n Cat.prototype.hiss = function () {\n this.say(\"CHSKKSS!!\")\n }\n inherits(Cat, Animal, {\n meow: function () { this.say(\"miao miao\") }\n })\n Cat.prototype.purr = function () {\n this.say(\"purr purr\")\n }\n\n\n var c = new Chihuahua\n assert(c instanceof Chihuahua)\n assert(c instanceof Dog)\n assert(c instanceof Animal)\n\nThe actual function is laughably small. 10-lines small.\n",
23
+ "readmeFilename": "README.md",
24
+ "_id": "inherits@1.0.0",
25
+ "_from": "inherits@1"
26
+ }
@@ -0,0 +1,23 @@
1
+ Copyright 2009, 2010, 2011 Isaac Z. Schlueter.
2
+ All rights reserved.
3
+
4
+ Permission is hereby granted, free of charge, to any person
5
+ obtaining a copy of this software and associated documentation
6
+ files (the "Software"), to deal in the Software without
7
+ restriction, including without limitation the rights to use,
8
+ copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the
10
+ Software is furnished to do so, subject to the following
11
+ conditions:
12
+
13
+ The above copyright notice and this permission notice shall be
14
+ included in all copies or substantial portions of the Software.
15
+
16
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
17
+ EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
18
+ OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
19
+ NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
20
+ HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
21
+ WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
22
+ FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
23
+ OTHER DEALINGS IN THE SOFTWARE.
@@ -0,0 +1,218 @@
1
+ # minimatch
2
+
3
+ A minimal matching utility.
4
+
5
+ [![Build Status](https://secure.travis-ci.org/isaacs/minimatch.png)](http://travis-ci.org/isaacs/minimatch)
6
+
7
+
8
+ This is the matching library used internally by npm.
9
+
10
+ Eventually, it will replace the C binding in node-glob.
11
+
12
+ It works by converting glob expressions into JavaScript `RegExp`
13
+ objects.
14
+
15
+ ## Usage
16
+
17
+ ```javascript
18
+ var minimatch = require("minimatch")
19
+
20
+ minimatch("bar.foo", "*.foo") // true!
21
+ minimatch("bar.foo", "*.bar") // false!
22
+ ```
23
+
24
+ ## Features
25
+
26
+ Supports these glob features:
27
+
28
+ * Brace Expansion
29
+ * Extended glob matching
30
+ * "Globstar" `**` matching
31
+
32
+ See:
33
+
34
+ * `man sh`
35
+ * `man bash`
36
+ * `man 3 fnmatch`
37
+ * `man 5 gitignore`
38
+
39
+ ### Comparisons to other fnmatch/glob implementations
40
+
41
+ While strict compliance with the existing standards is a worthwhile
42
+ goal, some discrepancies exist between minimatch and other
43
+ implementations, and are intentional.
44
+
45
+ If the pattern starts with a `!` character, then it is negated. Set the
46
+ `nonegate` flag to suppress this behavior, and treat leading `!`
47
+ characters normally. This is perhaps relevant if you wish to start the
48
+ pattern with a negative extglob pattern like `!(a|B)`. Multiple `!`
49
+ characters at the start of a pattern will negate the pattern multiple
50
+ times.
51
+
52
+ If a pattern starts with `#`, then it is treated as a comment, and
53
+ will not match anything. Use `\#` to match a literal `#` at the
54
+ start of a line, or set the `nocomment` flag to suppress this behavior.
55
+
56
+ The double-star character `**` is supported by default, unless the
57
+ `noglobstar` flag is set. This is supported in the manner of bsdglob
58
+ and bash 4.1, where `**` only has special significance if it is the only
59
+ thing in a path part. That is, `a/**/b` will match `a/x/y/b`, but
60
+ `a/**b` will not. **Note that this is different from the way that `**` is
61
+ handled by ruby's `Dir` class.**
62
+
63
+ If an escaped pattern has no matches, and the `nonull` flag is set,
64
+ then minimatch.match returns the pattern as-provided, rather than
65
+ interpreting the character escapes. For example,
66
+ `minimatch.match([], "\\*a\\?")` will return `"\\*a\\?"` rather than
67
+ `"*a?"`. This is akin to setting the `nullglob` option in bash, except
68
+ that it does not resolve escaped pattern characters.
69
+
70
+ If brace expansion is not disabled, then it is performed before any
71
+ other interpretation of the glob pattern. Thus, a pattern like
72
+ `+(a|{b),c)}`, which would not be valid in bash or zsh, is expanded
73
+ **first** into the set of `+(a|b)` and `+(a|c)`, and those patterns are
74
+ checked for validity. Since those two are valid, matching proceeds.
75
+
76
+
77
+ ## Minimatch Class
78
+
79
+ Create a minimatch object by instanting the `minimatch.Minimatch` class.
80
+
81
+ ```javascript
82
+ var Minimatch = require("minimatch").Minimatch
83
+ var mm = new Minimatch(pattern, options)
84
+ ```
85
+
86
+ ### Properties
87
+
88
+ * `pattern` The original pattern the minimatch object represents.
89
+ * `options` The options supplied to the constructor.
90
+ * `set` A 2-dimensional array of regexp or string expressions.
91
+ Each row in the
92
+ array corresponds to a brace-expanded pattern. Each item in the row
93
+ corresponds to a single path-part. For example, the pattern
94
+ `{a,b/c}/d` would expand to a set of patterns like:
95
+
96
+ [ [ a, d ]
97
+ , [ b, c, d ] ]
98
+
99
+ If a portion of the pattern doesn't have any "magic" in it
100
+ (that is, it's something like `"foo"` rather than `fo*o?`), then it
101
+ will be left as a string rather than converted to a regular
102
+ expression.
103
+
104
+ * `regexp` Created by the `makeRe` method. A single regular expression
105
+ expressing the entire pattern. This is useful in cases where you wish
106
+ to use the pattern somewhat like `fnmatch(3)` with `FNM_PATH` enabled.
107
+ * `negate` True if the pattern is negated.
108
+ * `comment` True if the pattern is a comment.
109
+ * `empty` True if the pattern is `""`.
110
+
111
+ ### Methods
112
+
113
+ * `makeRe` Generate the `regexp` member if necessary, and return it.
114
+ Will return `false` if the pattern is invalid.
115
+ * `match(fname)` Return true if the filename matches the pattern, or
116
+ false otherwise.
117
+ * `matchOne(fileArray, patternArray, partial)` Take a `/`-split
118
+ filename, and match it against a single row in the `regExpSet`. This
119
+ method is mainly for internal use, but is exposed so that it can be
120
+ used by a glob-walker that needs to avoid excessive filesystem calls.
121
+
122
+ All other methods are internal, and will be called as necessary.
123
+
124
+ ## Functions
125
+
126
+ The top-level exported function has a `cache` property, which is an LRU
127
+ cache set to store 100 items. So, calling these methods repeatedly
128
+ with the same pattern and options will use the same Minimatch object,
129
+ saving the cost of parsing it multiple times.
130
+
131
+ ### minimatch(path, pattern, options)
132
+
133
+ Main export. Tests a path against the pattern using the options.
134
+
135
+ ```javascript
136
+ var isJS = minimatch(file, "*.js", { matchBase: true })
137
+ ```
138
+
139
+ ### minimatch.filter(pattern, options)
140
+
141
+ Returns a function that tests its
142
+ supplied argument, suitable for use with `Array.filter`. Example:
143
+
144
+ ```javascript
145
+ var javascripts = fileList.filter(minimatch.filter("*.js", {matchBase: true}))
146
+ ```
147
+
148
+ ### minimatch.match(list, pattern, options)
149
+
150
+ Match against the list of
151
+ files, in the style of fnmatch or glob. If nothing is matched, and
152
+ options.nonull is set, then return a list containing the pattern itself.
153
+
154
+ ```javascript
155
+ var javascripts = minimatch.match(fileList, "*.js", {matchBase: true}))
156
+ ```
157
+
158
+ ### minimatch.makeRe(pattern, options)
159
+
160
+ Make a regular expression object from the pattern.
161
+
162
+ ## Options
163
+
164
+ All options are `false` by default.
165
+
166
+ ### debug
167
+
168
+ Dump a ton of stuff to stderr.
169
+
170
+ ### nobrace
171
+
172
+ Do not expand `{a,b}` and `{1..3}` brace sets.
173
+
174
+ ### noglobstar
175
+
176
+ Disable `**` matching against multiple folder names.
177
+
178
+ ### dot
179
+
180
+ Allow patterns to match filenames starting with a period, even if
181
+ the pattern does not explicitly have a period in that spot.
182
+
183
+ Note that by default, `a/**/b` will **not** match `a/.d/b`, unless `dot`
184
+ is set.
185
+
186
+ ### noext
187
+
188
+ Disable "extglob" style patterns like `+(a|b)`.
189
+
190
+ ### nocase
191
+
192
+ Perform a case-insensitive match.
193
+
194
+ ### nonull
195
+
196
+ When a match is not found by `minimatch.match`, return a list containing
197
+ the pattern itself. When set, an empty list is returned if there are
198
+ no matches.
199
+
200
+ ### matchBase
201
+
202
+ If set, then patterns without slashes will be matched
203
+ against the basename of the path if it contains slashes. For example,
204
+ `a?b` would match the path `/xyz/123/acb`, but not `/xyz/acb/123`.
205
+
206
+ ### nocomment
207
+
208
+ Suppress the behavior of treating `#` at the start of a pattern as a
209
+ comment.
210
+
211
+ ### nonegate
212
+
213
+ Suppress the behavior of treating a leading `!` character as negation.
214
+
215
+ ### flipNegate
216
+
217
+ Returns from negate expressions the same as if they were not negated.
218
+ (Ie, true on a hit, false on a miss.)