Commit2ff0388

committed

document, expose, and test 'partial:true' option

1 parent5dbd6a7 commit2ff0388Copy full SHA for 2ff0388

File tree

+26

-2

lines changed

+26

-2

lines changed

Lines changed: 16 additions & 0 deletions

Original file line number	Diff line number	Diff line change
@@ -171,6 +171,22 @@ Suppress the behavior of treating a leading `!` character as negation.
`171`	`171`	`Returns from negate expressions the same as if they were not negated.`
`172`	`172`	`(Ie, true on a hit, false on a miss.)`
`173`	`173`
	`174`	`+###partial`
	`175`	`+`
	`176`	`+Compare a partial path to a pattern. As long as the parts of the path that`
	`177`	`+are present are not contradicted by the pattern, it will be treated as a`
	`178`	`+match. This is useful in applications where you're walking through a`
	`179`	`+folder structure, and don't yet have the full path, but want to ensure that`
	`180`	`+you do not walk down paths that can never be a match.`
	`181`	`+`
	`182`	`+For example,`
	`183`	`+`
	`184`	+```js
	`185`	`+minimatch('/a/b','/a/*/c/d', { partial:true })// true, might be /a/b/c/d`
	`186`	`+minimatch('/a/b','/**/d', { partial:true })// true, might be /a/b/.../d`
	`187`	`+minimatch('/x/y/z','/a/**/z', { partial:true })// false, because x !== a`
	`188`	+```
	`189`	`+`
`174`	`190`	`##Comparisons to other fnmatch/glob implementations`
`175`	`191`
`176`	`192`	`While strict compliance with the existing standards is a worthwhile`

Lines changed: 5 additions & 2 deletions

Original file line number	Diff line number	Diff line change
`@@ -146,6 +146,7 @@ function Minimatch (pattern, options) {`
`146`	`146`	`this.negate=false`
`147`	`147`	`this.comment=false`
`148`	`148`	`this.empty=false`
	`149`	`+this.partial=!!options.partial`
`149`	`150`
`150`	`151`	`// make the set of regexps etc.`
`151`	`152`	`this.make()`
`@@ -719,13 +720,15 @@ minimatch.match = function (list, pattern, options) {`
`719`	`720`	`returnlist`
`720`	`721`	`}`
`721`	`722`
`722`		`-Minimatch.prototype.match=functionmatch(f){`
	`723`	`+Minimatch.prototype.match=functionmatch(f,partial=this.partial){`
`723`	`724`	`this.debug('match',f,this.pattern)`
`724`	`725`	`// short-circuit in the case of busted things.`
`725`	`726`	`// comments, etc.`
`726`	`727`	`if(this.comment)returnfalse`
`727`	`728`	`if(this.empty)returnf===''`
`728`	`729`
	`730`	`+if(f==='/'&&partial)returntrue`
	`731`	`+`
`729`	`732`	`varoptions=this.options`
`730`	`733`
`731`	`734`	`// windows: need to use /, not \`
`@@ -759,7 +762,7 @@ Minimatch.prototype.match = function match (f) {`
`759`	`762`	`if(options.matchBase&&pattern.length===1){`
`760`	`763`	`file=[filename]`
`761`	`764`	`}`
`762`		`-varhit=this.matchOne(file,pattern,false)`
	`765`	`+varhit=this.matchOne(file,pattern,partial)`
`763`	`766`	`if(hit){`
`764`	`767`	`if(options.flipNegate)returntrue`
`765`	`768`	`return!this.negate`

Lines changed: 5 additions & 0 deletions

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,5 @@`
	`1`	`+constt=require('tap')`
	`2`	`+constmm=require('../')`
	`3`	`+t.equal(mm('/a/b','/*/b/x/y/z',{partial:true}),true)`
	`4`	`+t.equal(mm('/a/b/c','/*/b/x/y/z',{partial:true}),false)`
	`5`	`+t.equal(mm('/','x',{partial:true}),true)`

Comments

(0)