6h^SSKJr SSKrSSKJrJrJrJrJrJ r SSK J r J r "SS\5r g)) annotationsN)CallableListOptionalProtocolSetUnion)HgPathTUserMsgTc\rSrSr%Sr\R SSj5r\R SSj5r\R SSj5r \R SSj5r Sr S\ S '\ \R SS j55r\R SS j5r\ \R SS j55r\R SS j5r\R SSj5r\R SSj5r\R SSj5r\R SSj5r\R SSj5r\R SSj5r\R SSj5rSrg)IMatcherzQA protocol class that defines the common interface for all file matching classes.cgNselfs >/usr/lib/python3/dist-packages/mercurial/interfaces/matcher.pywas_tampered_with_nonrec!IMatcher.was_tampered_with_nonrec cgrrrs rwas_tampered_withIMatcher.was_tampered_with!rrcgrr)rfns r__call__IMatcher.__call__%rrcgrr)rfmsgs rbad IMatcher.bad+rrNz#Optional[Callable[[HgPathT], None]] traversedircgrrrs r_filesIMatcher._files3 rcgrrrs rfilesIMatcher.files8rrcgrrrs r_filesetIMatcher._fileset<r*rcg)z!Returns True if f is in .files().Nrrr"s rexactIMatcher.exactArcgrrr2s rmatchfnIMatcher.matchfnErrcg)axDecides whether a directory should be visited based on whether it has potential matches in it or one of its subdirectories. This is based on the match's primary, included, and excluded patterns. Returns the string 'all' if the given directory and all subdirectories should be visited. Otherwise returns True or False indicating whether the given directory should be visited. Nrrdirs rvisitdirIMatcher.visitdirIr5rcg)aMDecides whether a directory should be visited based on whether it has potential matches in it or one of its subdirectories, and potentially lists which subdirectories of that directory should be visited. This is based on the match's primary, included, and excluded patterns. This function is very similar to 'visitdir', and the following mapping can be applied: visitdir | visitchildrenlist ----------+------------------- False | set() 'all' | 'all' True | 'this' OR non-empty set of subdirs -or files- to visit Example: Assume matchers ['path:foo/bar', 'rootfilesin:qux'], we would return the following values (assuming the implementation of visitchildrenset is capable of recognizing this; some implementations are not). '' -> {'foo', 'qux'} 'baz' -> set() 'foo' -> {'bar'} # Ideally this would be 'all', but since the prefix nature of matchers # is applied to the entire matcher, we have to downgrade this to # 'this' due to the non-prefix 'rootfilesin'-kind matcher being mixed # in. 'foo/bar' -> 'this' 'qux' -> 'this' Important: Most matchers do not know if they're representing files or directories. They see ['path:dir/f'] and don't know whether 'f' is a file or a directory, so visitchildrenset('dir') for most matchers will return {'f'}, but if the matcher knows it's a file (like exactmatcher does), it may return 'this'. Do not rely on the return being a set indicating that there are no files in this dir to investigate (or equivalently that if there are files to investigate in 'dir' that it will always return 'this'). Nrr:s rvisitchildrensetIMatcher.visitchildrensetTr5rcg)z[Matcher will match everything and .files() will be empty -- optimization might be possible.Nrrs ralwaysIMatcher.alwaysr5rcg)z[Matcher will match exactly the list of files in .files() -- optimization might be possible.Nrrs risexactIMatcher.isexactr5rcg)zWMatcher will match the paths in .files() recursively -- optimization might be possible.Nrrs rprefixIMatcher.prefixr5rcg)zXNone of .always(), .isexact(), and .prefix() is true -- optimizations will be difficult.Nrrs ranypatsIMatcher.anypatsr5rr)returnbool)rr rMrN)r"r r#zOptional[UserMsgT]rMNone)rMz List[HgPathT])rMz Set[HgPathT])r"r rMrN)r;r rMzUnion[bool, bytes])r;r rMzUnion[Set[HgPathT], bytes])__name__ __module__ __qualname____firstlineno____doc__abcabstractmethodrrrr$r&__annotations__propertyr(r,r/r3r7r<r?rBrErHrK__static_attributes__rrrrrs            8r]s* #  x,xx,r