clear-skies-doc-builder 2.0.10__tar.gz → 2.0.11__tar.gz

{clear_skies_doc_builder-2.0.10 → clear_skies_doc_builder-2.0.11}/CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.0.11] - 2026-01-28
+
+### Fixed
+- Ordering of modules
+
+## [2.0.10] - 2026-01-28
+
+### Changed
+- Bump version to v2.0.10 by @github-actions[bot]
+
 ## [2.0.9] - 2026-01-28
 
 ### Added
@@ -94,6 +104,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 * @ made their first contribution
 * @tnijboer made their first contribution in [#1](https://github.com/clearskies-py/doc-builder/pull/1)
 * @cmancone made their first contribution
+[2.0.11]: https://github.com/clearskies-py/doc-builder/compare/v2.0.10..v2.0.11
+[2.0.10]: https://github.com/clearskies-py/doc-builder/compare/v2.0.9..v2.0.10
 [2.0.9]: https://github.com/clearskies-py/doc-builder/compare/v2.0.8..v2.0.9
 [2.0.8]: https://github.com/clearskies-py/doc-builder/compare/v2.0.7..v2.0.8
 [2.0.7]: https://github.com/clearskies-py/doc-builder/compare/v2.0.6..v2.0.7

clear_skies_doc_builder-2.0.11/LATEST_CHANGELOG.md

@@ -0,0 +1,5 @@
+## [2.0.11] - 2026-01-28
+
+### Fixed
+- Ordering of modules
+

{clear_skies_doc_builder-2.0.10 → clear_skies_doc_builder-2.0.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clear-skies-doc-builder
-Version: 2.0.10
+Version: 2.0.11
 Summary: The docbuilder for all 'official' clearskies plugins (as well as the main clearskies docs)
 Project-URL: repository, https://github.com/clearskies-py/docs
 Project-URL: issues, https://github.com/clearskies-py/docs/issues

{clear_skies_doc_builder-2.0.10 → clear_skies_doc_builder-2.0.11}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "clear-skies-doc-builder"
 description = "The docbuilder for all 'official' clearskies plugins (as well as the main clearskies docs)"
-version = "2.0.10"
+version = "2.0.11"
 license = "MIT"
 readme = "./README.md"
 authors = [{name = "Conor Mancone", email = "cmancone@gmail.com"}]

{clear_skies_doc_builder-2.0.10 → clear_skies_doc_builder-2.0.11}/src/clearskies_doc_builder/build_callable.py

@@ -48,11 +48,15 @@ def _sort_key_for_entry(entry: dict[str, Any]) -> tuple[int, str]:
     return (type_priority, title)
 
 
-def _compute_nav_orders(tree: list[dict[str, Any]]) -> dict[int, int]:
+def _compute_nav_orders_and_child_counts(
+    tree: list[dict[str, Any]],
+) -> tuple[dict[int, int], dict[str, int]]:
     """
-    Compute nav_order for each entry in the tree based on sorting rules.
+    Compute nav_order for each entry and count children per parent.
 
-    Returns a dict mapping original tree index to computed nav_order.
+    Returns:
+        - nav_orders: dict mapping original tree index to computed nav_order
+        - child_counts: dict mapping parent title to number of child entries
 
     For entries with the same parent:
     - Groups by entry_type (submodules first, then classes)
@@ -60,6 +64,9 @@ def _compute_nav_orders(tree: list[dict[str, Any]]) -> dict[int, int]:
     - Assigns sequential nav_order values
 
     Top-level entries maintain their original order (index + 2).
+
+    The child_counts is used by Module builders to offset their internal class
+    nav_orders so that child entries (submodules) appear first in navigation.
     """
     # Group entries by their parent
     parent_groups: dict[str | None, list[tuple[int, dict[str, Any]]]] = {}
@@ -72,6 +79,7 @@ def _compute_nav_orders(tree: list[dict[str, Any]]) -> dict[int, int]:
 
     # Compute nav_order for each entry
     nav_orders: dict[int, int] = {}
+    child_counts: dict[str, int] = {}
 
     for parent, entries in parent_groups.items():
         if parent is None:
@@ -84,21 +92,34 @@ def _compute_nav_orders(tree: list[dict[str, Any]]) -> dict[int, int]:
             for nav_order, (original_index, entry) in enumerate(sorted_entries, start=1):
                 nav_orders[original_index] = nav_order
 
-    return nav_orders
+    # Count children for each parent (by title)
+    for entry in tree:
+        parent = entry.get("parent")
+        if parent:
+            child_counts[parent] = child_counts.get(parent, 0) + 1
+
+    return nav_orders, child_counts
 
 
 def build_callable(modules: models.Module, classes: models.Class, config: dict[str, Any], project_root: str):
     doc_root = prepare_doc_space(project_root)
 
-    # Pre-compute nav_orders based on sorting rules
-    nav_orders = _compute_nav_orders(config["tree"])
+    # Pre-compute nav_orders and child counts based on sorting rules
+    nav_orders, child_counts = _compute_nav_orders_and_child_counts(config["tree"])
 
     for index, branch in enumerate(config["tree"]):
         nav_order = nav_orders[index]
 
+        # Add child_entry_count to branch so Module builder can offset its class nav_orders
+        # This ensures child entries (submodules) appear first in navigation
+        branch_with_child_count = {
+            **branch,
+            "child_entry_count": child_counts.get(branch["title"], 0),
+        }
+
         builder_class = classes.find("import_path=" + branch["builder"]).type
         builder = builder_class(
-            branch,
+            branch_with_child_count,
             modules,
             classes,
             doc_root,

{clear_skies_doc_builder-2.0.10 → clear_skies_doc_builder-2.0.11}/src/clearskies_doc_builder/builders/module.py

@@ -13,6 +13,9 @@ class Module(Builder):
         self.args_to_additional_attributes_map = branch.get("args_to_additional_attributes_map", {})
         self.parent = branch.get("parent", False)
         self.grand_parent = branch.get("grand_parent", False)
+        # Number of child entries (submodules) under this module in the config tree
+        # Used to offset class nav_orders so child entries appear first in navigation
+        self.child_entry_count = branch.get("child_entry_count", 0)
 
     def build(self):
         title_snake_case = clearskies.functional.string.title_case_to_snake_case(self.title.replace(" ", "")).replace(
@@ -51,7 +54,9 @@ class Module(Builder):
 
         default_args = self.default_args()
 
-        nav_order = 0
+        # Start nav_order after any child entries (submodules) so they appear first
+        # Child entries get nav_order 1, 2, 3... and classes get nav_order after that
+        nav_order = self.child_entry_count
         for class_name in self.class_list:
             nav_order += 1
             source_class = self.classes.find(f"import_path={class_name}")

{clear_skies_doc_builder-2.0.10 → clear_skies_doc_builder-2.0.11}/uv.lock

@@ -146,7 +146,7 @@ wheels = [
 
 [[package]]
 name = "clear-skies-doc-builder"
-version = "2.0.10"
+version = "2.0.11"
 source = { editable = "." }
 dependencies = [
     { name = "clear-skies" },

clear_skies_doc_builder-2.0.10/LATEST_CHANGELOG.md

@@ -1,2 +0,0 @@
-## [2.0.10] - 2026-01-28
-