16     ./get_maintainer.py path --help
71         "path",
75         metavar="PATH",
77         help="Path to list areas for")
117         "path",
118         metavar="PATH",
120         help="Limit to files under PATH")
167         The path to the maintainers file
174             Path to the maintainers file to parse. If None, MAINTAINERS.yml in
178         if (filename is not None) and (pathlib.Path(filename).exists()):
179             self.filename = pathlib.Path(filename)
182             self._toplevel = pathlib.Path(_git("rev-parse", "--show-toplevel"))
198             # area._match_fn(path) tests if the path matches files and/or
204             # Like area._match_fn(path), but for files-exclude and
212     def path2areas(self, path):  argument
214         Returns a list of Area instances for the areas that contain 'path',
220         is_dir = os.path.isdir(path)
222         # Make 'path' relative to the repository root and normalize it.
224         path = os.path.normpath(os.path.join(
225             os.path.relpath(os.getcwd(), self._toplevel),
226             path))
229             path += "/"
232                 if area._contains(path)]
242         # rather than a path. That might give better error messages.
243         for path in _git("diff", "--name-only", commits, "--").splitlines():
244             res.update(self.path2areas(path))
255         # 'path' subcommand implementation
257         for path in args.paths:
258             if not os.path.exists(path):
259                 _serr("'{}': no such file or directory".format(path))
263         for path in args.paths:
264             areas = self.path2areas(path)
267                 orphaned.append(path)
326             for path in _ls_files():
328                     if area._contains(path):
329                         print(path)
338             for path in _ls_files():
339                 if area._contains(path):
340                     print(path)
345         if args.path is not None and not os.path.exists(args.path):
346             _serr("'{}': no such file or directory".format(args.path))
348         for path in _ls_files(args.path):
350                 if area._contains(path):
353                 print(path)  # We get here if we never hit the 'break'
384     def _contains(self, path):  argument
385         # Returns True if the area contains 'path', and False otherwise
387         return self._match_fn and self._match_fn(path) and not \
388             (self._exclude_match_fn and self._exclude_match_fn(path))
447         # The glob regexes must anchor to the beginning of the path, since we
459 def _load_maintainers(path):  argument
464     with open(path, encoding="utf-8") as f:
468             raise MaintainersError("{}: YAML error: {}".format(path, e))
470         _check_maintainers(path, yaml)
476     # file at maints_path, which is a pathlib.Path instance
536                         if all(path.is_dir() for path in paths):
572                 "it's in listed in the PATH environment variable"
585 def _ls_files(path=None):  argument
587     if path is not None:
588         cmd.append(path)