Add parser for [dependency-groups]

Author: akaihola

pyproject_parser/__init__.py

@@ -63,11 +63,12 @@
 
 # this package
 from pyproject_parser.classes import License, Readme, _NormalisedName
-from pyproject_parser.parsers import BuildSystemParser, PEP621Parser
+from pyproject_parser.parsers import BuildSystemParser, DependencyGroupsParser, PEP621Parser
 from pyproject_parser.type_hints import (  # noqa: F401
 		Author,
 		BuildSystemDict,
 		ContentTypes,
+		DependencyGroupsDict,
 		ProjectDict,
 		_PyProjectAsTomlDict
 		)
@@ -256,6 +257,9 @@ class PyProject:
 	#: Represents the :pep:`build-system table <518#build-system-table>` defined in :pep:`517` and :pep:`518`.
 	build_system: Optional[BuildSystemDict] = attr.ib(default=None)
 
+	#: Represents the :pep:`dependency groups table <735#specification>` defined in :pep:`735`.
+	dependency_groups: Optional[DependencyGroupsDict] = attr.ib(default=None)
+
 	#: Represents the :pep621:`project table <table-name>` defined in :pep:`621`.
 	project: Optional[ProjectDict] = attr.ib(default=None)
 
@@ -268,6 +272,12 @@ class PyProject:
 	to parse the :pep:`build-system table <518#build-system-table>` with.
 	"""
 
+	dependency_groups_table_parser: ClassVar[DependencyGroupsParser] = DependencyGroupsParser()
+	"""
+	The :class:`~dom_toml.parser.AbstractConfigParser`
+	to parse the :pep:`dependency groups table <735#specification>` with.
+	"""
+
 	project_table_parser: ClassVar[PEP621Parser] = PEP621Parser()
 	"""
 	The :class:`~dom_toml.parser.AbstractConfigParser`
@@ -323,6 +333,12 @@ def load(
 						)
 				keys.remove("build-system")
 
+			if "dependency-groups" in config:
+				dependency_groups_table = cls.dependency_groups_table_parser.parse(
+						config["dependency-groups"], set_defaults=set_defaults
+						)
+				keys.remove("dependency-groups")
+
 			if "project" in config:
 				project_table = cls.project_table_parser.parse(config["project"], set_defaults=set_defaults)
 				keys.remove("project")
@@ -336,7 +352,7 @@ def load(
 						tool_table[tool_name] = cls.tool_parsers[tool_name].parse(tool_subtable)
 
 		if keys:
-			allowed_top_level = ("build-system", "project", "tool")
+			allowed_top_level = ("build-system", "dependency-groups", "project", "tool")
 
 			for top_level_key in sorted(keys):
 				if top_level_key in allowed_top_level:
@@ -355,6 +371,7 @@ def load(
 
 		return cls(
 				build_system=build_system_table,
+				dependency_groups=dependency_groups_table,
 				project=project_table,
 				tool=tool_table,
 				)

pyproject_parser/parsers.py

@@ -49,7 +49,7 @@
 
 # this package
 from pyproject_parser.classes import License, Readme, _NormalisedName
-from pyproject_parser.type_hints import Author, BuildSystemDict, ProjectDict
+from pyproject_parser.type_hints import Author, BuildSystemDict, DependencyGroupsDict, ProjectDict
 from pyproject_parser.utils import PyProjectDeprecationWarning, content_type_from_filename, render_readme
 
 __all__ = [
@@ -258,6 +258,60 @@ def parse(  # type: ignore[override]
 		return cast(BuildSystemDict, parsed_config)
 
 
+class DependencyGroupsParser(AbstractConfigParser):
+	"""
+	Parser for the :pep:`dependency groups table <735#specification>` table from ``pyproject.toml``.
+
+	.. autosummary-widths:: 17/32
+	"""  # noqa: RST399
+
+	table_name: ClassVar[str] = "dependency-groups"
+
+	@property
+	def keys(self) -> List[str]:
+		"""
+		The keys to parse from the TOML file.
+		"""
+
+		return []
+
+	@staticmethod
+	def parse_group(config: TOML_TYPES) -> List[Union[str, Dict[str, str]]]:
+		"""
+		Parse a group from the TOML configuration.
+
+		:param config:
+		"""
+
+		if isinstance(config, list):
+			return config
+
+		raise BadConfigError("A group must be a list.")
+
+	def parse(  # type: ignore[override]
+		self,
+		config: Dict[str, TOML_TYPES],
+		set_defaults: bool = False,
+		) -> BuildSystemDict:
+		"""
+		Parse the TOML configuration.
+
+		:param config:
+		:param set_defaults: If :py:obj:`True`, the values in
+			:attr:`self.defaults <dom_toml.parser.AbstractConfigParser.defaults>` and
+			:attr:`self.factories <dom_toml.parser.AbstractConfigParser.factories>`
+			will be set as defaults for the returned mapping.
+
+		:rtype:
+
+		.. latex:clearpage::
+		"""
+
+		parsed_config = {key: self.parse_group(value) for key, value in config.items()}
+
+		return cast(DependencyGroupsDict, parsed_config)
+
+
 class PEP621Parser(RequiredKeysConfigParser):
 	"""
 	Parser for :pep:`621` metadata from ``pyproject.toml``.

pyproject_parser/type_hints.py

@@ -27,7 +27,7 @@
 #
 
 # stdlib
-from typing import Any, Dict, List, Optional
+from typing import Any, Dict, List, Optional, Union
 
 # 3rd party
 from packaging.markers import Marker
@@ -57,6 +57,16 @@
 				}
 		)
 
+IncludeGroupDict = TypedDict(
+	    "IncludeGroupDict",
+	    {
+			    "include-group": str
+	            }
+        )
+
+#: :class:`typing.TypedDict` representing the output from the :class:`~.DependencyGroupsParser` class.
+DependencyGroupsDict = Dict[str, List[Union[str, IncludeGroupDict]]]
+
 #: Type hint for the :pep621:`dynamic` field defined in :pep:`621`.
 Dynamic = Literal[
 	"name",