Update changelog

And some minor docstring fixes

Author: jdavid

.mailmap

@@ -24,6 +24,7 @@ Matthias Bartelmeß <mba@fourplusone.de>
 Mikhail Yushkovskiy <mailto@zensecurity.su>
 Mukunda Rao Katta  <mukunda.vjcs6@gmail.com>
 Nabijacz Leweli <nabijaczleweli@nabijaczleweli.xyz>
+Nicholas Williams <github@nicholaswilliams.net>
 Nicolas Rybowski <nicolas.rybowski@uclouvain.be>
 Óscar San José <osanjose@tuenti.com>
 Petr Hosek <petrhosek@gmail.com> <p.hosek@imperial.ac.uk>

CHANGELOG.md

@@ -3,6 +3,10 @@
 - Add support for Python 3.15
   [#1498](https://github.com/libgit2/pygit2/pull/1498)
 
+- New `Config` subclasses: `DefaultConfig` for the default configuration and
+  `RepositoryConfig` for repository configurations
+  [#1501](https://github.com/libgit2/pygit2/pull/1501)
+
 - Fix `ConfigEntry` retaining `git_config_entry` pointers owned by config
   iterators, which could make entry values change unexpectedly and cause
   crashes; values are now copied eagerly

pygit2/config.py

@@ -171,7 +171,7 @@ def __init__(self, path: PathLike | str, /) -> None:
 
         :param path: The path to the configuration file to load as a string or path-like
                      value.
-        :raises IOError: If the path specified does not exist or could not be opened.
+        :raises OSError: If the path specified does not exist or could not be opened.
         """
         ...
 
@@ -206,7 +206,7 @@ def __init__(
 
         :param path: The path to the configuration file to load as a string or path-like
                      value.
-        :raises IOError: If the path specified does not exist or could not be opened.
+        :raises OSError: If the path specified does not exist or could not be opened.
 
         **Overload 3: __init__(c_config, is_snapshot)**
 
@@ -290,9 +290,9 @@ def __contains__(self, name: str | bytes) -> bool:
     def __getitem__(self, name: str | bytes) -> str | None:
         """Obtain the first value found for a config var with name ``name``.
 
-        Looks for a config var with name ``name`` and returns its value as a string
-        or ``None`` if the config var exists but the value is empty. If you want to
-        apply the Git config parsing rules, use :meth:`Config.get_bool` or
+        Looks for a config var with name ``name`` and returns its value as a string,
+        or ``None`` if the config var is a valueless flag. If you want to apply the
+        Git config parsing rules, use :meth:`Config.get_bool` or
         :meth:`Config.get_int` instead of ``[name]``.
 
         If the config var found is a multivar, only the first value is returned. To
@@ -699,7 +699,7 @@ def get_system_config() -> 'Config':
         The system configuration file is the one found at ``/etc/gitconfig`` or
         ``%PROGRAMFILES%\\Git\\etc\\gitconfig``, depending on the operating system.
 
-        :raises IOError: If the configuration file is not found.
+        :raises OSError: If the configuration file is not found.
         """
         return Config._from_found_config(C.git_config_find_system)
 
@@ -712,7 +712,7 @@ def get_global_config() -> 'Config':
         at the XDG-compatible user config file location (for that, see
         :meth:`Config.get_xdg_config`).
 
-        :raises IOError: If the configuration file is not found.
+        :raises OSError: If the configuration file is not found.
         """
         return Config._from_found_config(C.git_config_find_global)
 
@@ -724,7 +724,7 @@ def get_xdg_config() -> 'Config':
         This file is located at ``$HOME/.config/git/config``. This will not find the file
         at the standard user config location (for that, see :meth:`Config.get_global_config`).
 
-        :raises IOError: If the configuration file is not found.
+        :raises OSError: If the configuration file is not found.
         """
         return Config._from_found_config(C.git_config_find_xdg)
 

pygit2/repository.py

@@ -316,7 +316,7 @@ def config_snapshot(self) -> RepositoryConfig:
         This allows reads over multiple values to use the same version
         of the configuration files. As with :meth:`BaseRepository.config`, the
         snapshot includes any program, system, XDG, or global (user)
-        present on the system.
+        configuration present on the system.
         """
         return RepositoryConfig(self, self._repo, do_snapshot=True)