Răsfoiți Sursa

Docstrings for constructors of repo.Repo and repo.MemoryRepo (#1490)

Add docstrings for constructors of repo.Repo and repo.MemoryRepo

They previously inherited the docstring of repo.BaseRepo, which told you
not to call them!
Jelmer Vernooij 11 luni în urmă
părinte
comite
114c29bbdb
1 a modificat fișierele cu 9 adăugiri și 0 ștergeri
  1. 9 0
      dulwich/repo.py

+ 9 - 0
dulwich/repo.py

@@ -1135,6 +1135,14 @@ class Repo(BaseRepo):
         object_store: Optional[PackBasedObjectStore] = None,
         bare: Optional[bool] = None,
     ) -> None:
+        """Open a repository on disk.
+
+        Args:
+          root: Path to the repository's root.
+          object_store: ObjectStore to use; if omitted, we use the
+            repository's default object store
+          bare: True if this is a bare repository.
+        """
         hidden_path = os.path.join(root, CONTROLDIR)
         if bare is None:
             if os.path.isfile(hidden_path) or os.path.isdir(
@@ -1837,6 +1845,7 @@ class MemoryRepo(BaseRepo):
     """
 
     def __init__(self) -> None:
+        """Create a new repository in memory."""
         from .config import ConfigFile
 
         self._reflog: list[Any] = []