Update docs

Author: domdfcoding

dict2css/__init__.py

@@ -3,9 +3,6 @@
 #  __init__.py
 """
 A μ-library for constructing cascasing style sheets from Python dictionaries.
-
-.. latex:vspace:: 10px
-.. seealso:: `css-parser <https://github.com/ebook-utils/css-parser>`_, which this library builds upon.
 """
 #
 #  Copyright © 2020-2021 Dominic Davis-Foster <dominic@davis-foster.co.uk>
@@ -143,6 +140,7 @@ def dumps(
 	:return: The style sheet as a string.
 
 	.. versionchanged:: 0.2.0  Added support for media at-rules.
+	.. versionchanged:: 0.5.0  New implementation. Output may differ slightly from previous css-parser based one.
 	"""
 
 	serializer = CSSSerializer(
@@ -224,6 +222,8 @@ def dump(
 		* ``fp`` now accepts :py:obj:`domdf_python_tools.typing.PathLike` objects,
 		  representing the path of a file to write to.
 		* Added support for media at-rules.
+
+	.. versionchanged:: 0.5.0  New implementation. Output may differ slightly from previous css-parser based one.
 	"""
 
 	css = dumps(
@@ -247,10 +247,13 @@ def loads(styles: str) -> MutableMapping[str, MutableMapping[str, Any]]:
 	Parse a style sheet and return its dictionary representation.
 
 	.. versionadded:: 0.2.0
+	.. versionchanged:: 0.5.0  New implementation. Output may differ slightly from previous css-parser based one.
 
 	:param styles:
 
 	:return: The style sheet as a dictionary.
+
+	.. latex:clearpage::
 	"""
 
 	stylesheet = tinycss2.parse_blocks_contents(styles, skip_comments=True, skip_whitespace=True)
@@ -298,6 +301,7 @@ def load(fp: Union[PathLike, IO]) -> MutableMapping[str, MutableMapping[str, Any
 	Parse a cascading style sheet from the given file and return its dictionary representation.
 
 	.. versionadded:: 0.2.0
+	.. versionchanged:: 0.5.0  New implementation. Output may differ slightly from previous css-parser based one.
 
 	:param fp: An open file handle, or the filename of a file to write to.
 

dict2css/serializer.py

@@ -72,7 +72,7 @@
 
 class CSSSerializer:
 	r"""
-	Serializes a :class:`~.StyleSheet` and its parts.
+	Serializes a dictionary to CSS.
 
 	This controls the formatting of the style sheet.
 
@@ -83,7 +83,9 @@ class CSSSerializer:
 	:param sort_keys: Sort dictionary keys alphabetically.
 	:param check_circular: Check for circular references.
 
-	.. autosummary-widths:: 5/16
+	.. versionchanged:: 0.5.0  New implementation. Output may differ slightly from previous css-parser based one.
+
+	.. autosummary-widths:: 1/4
 	"""
 
 	def __init__(
@@ -160,9 +162,9 @@ def encode(self, obj: Mapping) -> str:
 		"""
 		Return a CSS representation of a Python dictionary.
 
-		:param obj: The Python object to be serialized
+		:param obj: The Python dictionary to be serialized
 
-		:returns: The CSS string representation of the Python object
+		:returns: The CSS string representation of the Python dictionary
 		"""
 
 		return ''.join(self.iterencode(obj))

doc-source/api/dict2css.rst

@@ -3,7 +3,6 @@
 ================
 
 .. autosummary-widths:: 21/64
-	:html: 41/128
 
 .. raw:: latex
 

doc-source/api/helpers.rst

@@ -3,6 +3,5 @@
 ===========================
 
 .. autosummary-widths:: 7/16
-	:html: 2/10
 
 .. automodule:: dict2css.helpers

doc-source/api/serializer.rst

@@ -3,7 +3,6 @@
 ===========================
 
 .. autosummary-widths:: 1/2
-	:html: 4/10
 
 .. automodule:: dict2css.serializer
 	:no-show-inheritance:

doc-source/conf.py

@@ -101,5 +101,4 @@ def setup(app):
 
 nitpicky = True
 latex_elements["preamble"] = "\\raggedbottom\n\\widowpenalty10000"
-autosummary_widths_builders = ["latex"]
 changelog_sections_numbered = False

pyproject.toml

@@ -63,7 +63,7 @@ extensions = [
     "sphinx_licenseinfo",
     "seed_intersphinx_mapping",
     "html_section",
-    "sphinx_toolbox_experimental.autosummary_widths",
+    "sphinx_toolbox.more_autosummary.column_widths",
     "sphinx_toolbox_experimental.succinct_seealso",
     "sphinx_toolbox_experimental.needspace",
     "sphinx_toolbox_experimental.missing_xref",

repo_helper.yml

@@ -40,15 +40,14 @@ classifiers:
 sphinx_conf_epilogue:
  - nitpicky = True
  - latex_elements["preamble"] = "\\raggedbottom\n\\widowpenalty10000"
- - autosummary_widths_builders = ["latex"]
  - changelog_sections_numbered = False
 
 exclude_files:
  - contributing
 
 
 extra_sphinx_extensions:
- - sphinx_toolbox_experimental.autosummary_widths
+ - sphinx_toolbox.more_autosummary.column_widths
  - sphinx_toolbox_experimental.succinct_seealso
  - sphinx_toolbox_experimental.needspace
  - sphinx_toolbox_experimental.missing_xref