datamaestro 1.7.1__tar.gz → 1.7.3__tar.gz

{datamaestro-1.7.1 → datamaestro-1.7.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: datamaestro
-Version: 1.7.1
+Version: 1.7.3
 Summary: Add your description here
 Author-email: Benjamin Piwowarski <benjamin@piwowarski.fr>
 License-File: LICENSE

datamaestro-1.7.3/release-notes.md

@@ -0,0 +1,5 @@
+## [1.7.3] - 2026-01-29
+
+### Features
+- Add DatamaestroAnalyzer to exclude @dataset classes from doc checks ([a6646b3](https://github.com/experimaestro/experimaestro-python/commit/a6646b321934bb4a28ba7ee0b826ed0f0d0bcb12))
+

{datamaestro-1.7.1 → datamaestro-1.7.3}/src/datamaestro/download/__init__.py

@@ -646,7 +646,7 @@ class reference(Resource):
         For function-based datasets, the reference is already a DatasetWrapper.
         """
         ref = self.reference
-        if hasattr(ref, "__dataset__"):
+        if isinstance(ref, type) and hasattr(ref, "__dataset__"):
             return ref.__dataset__
         return ref
 

{datamaestro-1.7.1 → datamaestro-1.7.3}/src/datamaestro/test/checks.py

@@ -2,6 +2,30 @@ import logging
 import importlib
 import inspect
 from datamaestro.context import Context
+from experimaestro.tools.documentation import DocumentationAnalyzer
+
+
+class DatamaestroAnalyzer(DocumentationAnalyzer):
+    """Documentation analyzer that excludes @dataset-annotated classes.
+
+    Dataset definitions (classes decorated with ``@dataset``) are documented
+    via ``dm:datasets`` Sphinx directives, not ``autoxpmconfig``. This
+    subclass filters them from the undocumented list after analysis.
+    """
+
+    def analyze(self):
+        super().analyze()
+        filtered = []
+        for fqn in self.undocumented:
+            module_name, class_name = fqn.rsplit(".", 1)
+            try:
+                mod = importlib.import_module(module_name)
+                cls = getattr(mod, class_name)
+                if not hasattr(cls, "__dataset__"):
+                    filtered.append(fqn)
+            except (ImportError, AttributeError):
+                filtered.append(fqn)
+        self.undocumented = filtered
 
 
 class DatasetTests:

{datamaestro-1.7.1 → datamaestro-1.7.3}/src/datamaestro/version.py

@@ -1,4 +1,4 @@
 # This file is auto-generated by Hatchling. As such, do not:
 #   - modify
 #   - track in version control e.g. be sure to add to .gitignore
-__version__ = VERSION = '1.7.1'
+__version__ = VERSION = '1.7.3'

datamaestro-1.7.1/release-notes.md

@@ -1,5 +0,0 @@
-## [1.7.1] - 2026-01-29
-
-### Features
-- Add CamelCase→snake_case ID inference and class-based dataset support for reference/links ([bf8bed3](https://github.com/experimaestro/experimaestro-python/commit/bf8bed3292fb851b47ff5c3c154ccd4a1b920e6e))
-