docs: say debug flags log rather than print

- 11 docstrings in wtsite, wiki_tools, import_utility and wikitext
- the flags now gate _logger.debug, directly or via a forwarded param
- parallelize replays task stdout as log records, nothing hits stdout
- core.ExportJsonLdParams.debug left as is, the flag is never read

Author: LukasGold

src/osw/data/import_utility.py

@@ -779,7 +779,7 @@ def get_entities_from_osw(
     osw_obj:
         OSW instance to use. If None, a new instance is created.
     debug:
-        If True, prints debug information.
+        If True, logs debug information.
 
     Returns
     -------

src/osw/utils/wikitext.py

@@ -233,7 +233,7 @@ def find_dependencies(wikitext, debug=False):
     ----------
     wikitext : str
     debug : bool
-        Whether to print debugging messages
+        Whether to log debugging messages
 
     Returns
     -------
@@ -318,7 +318,7 @@ def find_dependencies_recursively(title, site, dependencies=None, debug=False):
     dependencies
         List of already found dependent titles
     debug : bool
-        Whether to print debugging messages
+        Whether to log debugging messages
 
     Returns
     -------

src/osw/wiki_tools.py

@@ -592,7 +592,7 @@ def search_redirection_sources(
     target_title :
         Title of the target wiki page
     debug:
-        Whether to print debugging messages
+        Whether to log debugging messages
 
     Returns
     -------

src/osw/wtsite.py

@@ -352,7 +352,7 @@ class GetPageParam(OswBaseModel):
         retry_delay_s: Optional[int] = 5
         """Retry delay in seconds"""
         debug: Optional[bool] = False
-        """Whether to print debug messages"""
+        """Whether to log debug messages"""
         raise_exception: Optional[bool] = False
         """Whether to raise an exception if an error occurs"""
         raise_warning: Optional[bool] = True
@@ -667,7 +667,7 @@ class UploadPageParam(OswBaseModel):
         parallel: Optional[bool] = False
         """If True, uploads the pages in parallel."""
         debug: Optional[bool] = False
-        """If True, debug messages will be printed."""
+        """If True, debug messages will be logged."""
         comment: Optional[str] = None
         """Edit comment for the page history, applied to every uploaded page."""
 
@@ -783,7 +783,7 @@ class DeletePageParam(OswBaseModel):
         page: Union["WtPage", List["WtPage"], str, List[str]]
         comment: Optional[str] = None
         debug: Optional[bool] = True
-        """If True, debug messages will be printed."""
+        """If True, debug messages will be logged."""
         parallel: Optional[bool] = None
         """If true, processes the pages in parallel."""
 
@@ -861,7 +861,7 @@ class CreatePagePackageParam(OswBaseModel):
         dump_config: Optional["WtPage.PageDumpConfig"] = None
         """Configuration object for the page dump"""
         debug: Optional[bool] = True
-        """If True, debug messages will be printed."""
+        """If True, debug messages will be logged."""
         parallel: Optional[bool] = None
         """If true, processes the pages in parallel."""
         offline_pages: Optional[Dict[str, "WtPage"]] = None
@@ -1021,7 +1021,7 @@ class ReadPagePackageParam(OswBaseModel):
         selected_slots: Optional[List[str]] = None
         """A list of slots that should be read. If None, all slots are read."""
         debug: Optional[bool] = False
-        """If True, debug information is printed to the console."""
+        """If True, debug information is logged."""
         offline: Optional[bool] = True
         """Skip reading the page content from the webserver
         before reading the local content, if True."""
@@ -1214,7 +1214,7 @@ class UploadPagePackageParam(OswBaseModel):
         """A list of WtPage objects.
         If 'pages' is not given, 'storage_path' must be given."""
         debug: Optional[bool] = False
-        """If True, prints debug information."""
+        """If True, logs debug information."""
 
         class Config:
             arbitrary_types_allowed = True
@@ -2167,7 +2167,7 @@ def get_file_info_and_usage(
         Parameters
         ----------
         debug
-            Whether to print debug information, by default False
+            Whether to log debug information, by default False
 
         Returns
         -------