Fix Workbook constructor silently returning empty workbooks (0.11.3)

Workbook._prepare_datasources used a literal child search
(xml_root.find('datasources')) while its sibling methods
_prepare_dashboards and _prepare_worksheets both use descendant search
(`.//`).

Changes:
- _prepare_datasources now uses xml_root.find('.//datasources').
- _prepare_worksheets's ds_index lookup is now tolerant of missing
  entries (uses `.get(...)` and `continue`) so a worksheet that
  references an un-indexed datasource doesn't abort the constructor.
- Bumped wheel version 0.11.2 -> 0.11.3 in BUILD.bazel.
- CHANGELOG.md entry.

Author: Prathyusha Gidugu

BUILD.bazel

@@ -76,6 +76,6 @@ py_wheel(
     requires = [
         "lxml",
     ],
-    version = "0.11.2",
+    version = "0.11.3",
     deps = ["//tableaudocumentapi"],
 )

CHANGELOG.md

@@ -1,3 +1,7 @@
+## 0.11.3 (June 2026)
+* Fix `Workbook._prepare_datasources` to use descendant XPath (`.//datasources`) instead of literal `find('datasources')`, matching the sibling `_prepare_dashboards` / `_prepare_worksheets` methods. Without this, workbooks where `<datasources>` was not a direct child of `<workbook>` (common in newer Tableau XML versions) returned an empty datasource list, which then caused `_prepare_worksheets` to raise `KeyError` on `ds_index[datasource_name]` and silently abort the `Workbook` constructor entirely, leaving `worksheets`, `dashboards` and `datasources` all empty.
+* Make `_prepare_worksheets`'s `ds_index` lookup tolerant of missing entries (use `.get(...)` and `continue`) so that workbooks referencing a datasource that wasn't indexed don't abort the constructor.
+
 ## 011 (November 2022)
 * Remove extraneous debug print statements
 

tableaudocumentapi/workbook.py

@@ -97,8 +97,15 @@ def _prepare_datasource_index(datasources):
     def _prepare_datasources(xml_root):
         datasources = []
 
-        # loop through our datasources and append
-        datasource_elements = xml_root.find('datasources')
+        # Use descendant search (`.//`) so we find the <datasources> element
+        # regardless of where it sits in the workbook XML. Newer Tableau
+        # versions sometimes nest it below the top level, and matching only
+        # the direct child here returned [], which in turn caused
+        # _prepare_worksheets() to raise KeyError on ds_index lookups and
+        # silently abort the whole Workbook() constructor. Aligned with the
+        # sibling _prepare_dashboards / _prepare_worksheets methods which
+        # already use `.//`.
+        datasource_elements = xml_root.find('.//datasources')
         if datasource_elements is None:
             return []
 
@@ -137,7 +144,14 @@ def _prepare_worksheets(xml_root, ds_index):
 
             for dependency in dependencies:
                 datasource_name = dependency.attrib['datasource']
-                datasource = ds_index[datasource_name]
+                # Defensive: a worksheet may reference a datasource that
+                # isn't in the index (e.g. a parameter-only datasource).
+                # Previously this raised KeyError, aborting the Workbook
+                # constructor and leaving worksheets/dashboards/datasources
+                # all empty.
+                datasource = ds_index.get(datasource_name)
+                if datasource is None:
+                    continue
                 for column in dependency.findall('.//column'):
                     column_name = column.attrib['name']
                     if column_name in datasource.fields: