Fix DOCString

src/_pytest/pytester.py

@@ -888,7 +888,12 @@ def test_something(pytester):
  return self._makefile(".txt", args, kwargs)
 
  def syspathinsert(self, path: str | os.PathLike[str] | None = None) -> None:
- """Prepend a directory to sys.path, defaults to :attr:`path`."""
+ """Prepend a directory to sys.path, defaults to :attr:`path`.
+ This is undone automatically when this object dies at the end of each
+ test.
+ :param path:
+ The path.
+ """
  if path is None:
  path = self.path
 
@@ -1372,6 +1377,31 @@ def run(
  stdin: NotSetType | bytes | IO[Any] | int = CLOSE_STDIN,
  env: dict[str, str] | None = None,
  ) -> RunResult:
+ """Run a command with arguments.
+ Run a process using :py:class:`subprocess.Popen` saving the stdout and
+ stderr.
+ :param cmdargs:
+ The sequence of arguments to pass to :py:class:`subprocess.Popen`,
+ with path-like objects being converted to :py:class:`str`
+ automatically.
+ :param timeout:
+ The period in seconds after which to timeout and raise
+ :py:class:`Pytester.TimeoutExpired`.
+ :param stdin:
+ Optional standard input.
+ - If it is ``CLOSE_STDIN`` (Default), then this method calls
+ :py:class:`subprocess.Popen` with ``stdin=subprocess.PIPE``, and
+ the standard input is closed immediately after the new command is
+ started.
+ - If it is of type :py:class:`bytes`, these bytes are sent to the
+ standard input of the command.
+ - Otherwise, it is passed through to :py:class:`subprocess.Popen`.
+ For further information in this case, consult the document of the
+ ``stdin`` parameter in :py:class:`subprocess.Popen`.
+ :type stdin: _pytest.compat.NotSetType | bytes | IO[Any] | int
+ :returns:
+ The result.
+ """
  __tracebackhide__ = True
 
  cmdargs = tuple(os.fspath(arg) for arg in cmdargs)
@@ -1444,6 +1474,20 @@ def runpython_c(self, command: str) -> RunResult:
  def runpytest_subprocess(
  self, *args: str | os.PathLike[str], timeout: float | None = None
  ) -> RunResult:
+ """Run pytest as a subprocess with given arguments.
+ Any plugins added to the :py:attr:`plugins` list will be added using the
+ ``-p`` command line option. Additionally ``--basetemp`` is used to put
+ any temporary files and directories in a numbered directory prefixed
+ with "runpytest-" to not conflict with the normal numbered pytest
+ location for temporary files and directories.
+ :param args:
+ The sequence of arguments to pass to the pytest subprocess.
+ :param timeout:
+ The period in seconds after which to timeout and raise
+ :py:class:`Pytester.TimeoutExpired`.
+ :returns:
+ The result.
+ """
  __tracebackhide__ = True
  p = make_numbered_dir(root=self.path, prefix="runpytest-", mode=0o700)
  args = (f"--basetemp={p}", *args)