Merge pull request #991 from hkad98/jkd/fix-docs

docs: add docstrings DataSourceValidator

Author: hkad98

gooddata-sdk/gooddata_sdk/catalog/data_source/validation/data_source.py

@@ -10,6 +10,13 @@ def __init__(self, data_source_service: CatalogDataSourceService):
         self._ds_service = data_source_service
 
     def validate_ldm(self, model: CatalogDeclarativeModel) -> None:
+        """
+        Validates that referenced data sources in LDM actually exist.
+        If they do not exist, raises ValueError.
+
+        Returns:
+            None
+        """
         if model.ldm is not None:
             ldm_ds_in_use = set(
                 dataset.data_source_table_id.data_source_id
@@ -19,6 +26,12 @@ def validate_ldm(self, model: CatalogDeclarativeModel) -> None:
             self.validate_data_source_ids(ldm_ds_in_use)
 
     def validate_data_source_ids(self, data_source_ids: set[str]) -> None:
+        """
+        Compares data source ids with existing data sources in the catalog.
+
+        Returns:
+            None
+        """
         full_ds_set = set(data_source.id for data_source in self._ds_service.list_data_sources())
         diff_ds = data_source_ids - full_ds_set
         if len(diff_ds) != 0: