Method join

src/_pytest/_py/path.py:719–747

Return a new path by appending all 'args' as path components. if abs=1 is used restart from root if any of the args is an absolute path.

(self, *args: os.PathLike[str], abs: bool = False)

        return self.new(basename=class="st">"").join(*args, **kwargs)

    def join(self, *args: os.PathLike[str], abs: bool = False) -> LocalPath:
        class="st">"""Return a new path by appending all &class="cm">#x27;args' as path
        components.  if abs=1 is used restart from root if any
        of the args is an absolute path.
        class="st">"""
        sep = self.sep
        strargs = [os.fspath(arg) for arg in args]
        strpath = self.strpath
        if abs:
            newargs: list[str] = []
            for arg in reversed(strargs):
                if isabs(arg):
                    strpath = arg
                    strargs = newargs
                    break
                newargs.insert(0, arg)
        class="cm"># special case for when we have e.g. strpath == class="st">"/"
        actual_sep = class="st">"" if strpath.endswith(sep) else sep
        for arg in strargs:
            arg = arg.strip(sep)
            if iswin32:
                class="cm"># allow unix style paths even on windows.
                arg = arg.strip(class="st">"/")
                arg = arg.replace(class="st">"/", sep)
            strpath = strpath + actual_sep + arg
            actual_sep = sep
        obj = object.__new__(self.__class__)
        obj.strpath = normpath(strpath)
        return obj

    def open(self, mode=class="st">"r", ensure=False, encoding=None):
        class="st">"""Return an opened file with the given mode.