pyeasyphd 0.1.2__py3-none-any.whl → 0.1.5__py3-none-any.whl

pyeasyphd/tools/py_run_bib_md_tex.py

@@ -22,23 +22,14 @@ class PyRunBibMdTex(BasicInput):
     ) -> None:
         """Initialize the PyRunBibMdTex instance.
 
-        Parameters
-        ----------
-        path_output : str
-            Output directory path for processed files
-        tex_md_flag : str, optional
-            Flag indicating whether to process as LaTeX (".tex") or Markdown (".md"),
-            by default ".md"
-        template_name : str, optional
-            Template type to use ("paper" or "beamer"), by default "paper"
-        options : Dict[str, Any], optional
-            Additional configuration options, by default {}
-
-        Raises
-        ------
-        AssertionError
-            If tex_md_flag is not ".tex" or ".md"
-            If template_name is not "paper" or "beamer"
+        Args:
+            path_output (str): Output directory path for processed files.
+            tex_md_flag (str, optional): Flag indicating whether to process as LaTeX (".tex") or Markdown (".md"). Defaults to ".md".
+            template_name (str, optional): Template type to use ("paper" or "beamer"). Defaults to "paper".
+            options (Dict[str, Any], optional): Additional configuration options. Defaults to {}.
+
+        Raises:
+            AssertionError: If tex_md_flag is not ".tex" or ".md" or if template_name is not "paper" or "beamer".
         """
         super().__init__(options)
 
@@ -48,6 +39,9 @@ class PyRunBibMdTex(BasicInput):
         assert self.template_name in ["paper", "beamer"], f"{template_name} must be `paper` or `beamer`."
         self.path_output = standard_path(path_output)
 
+        self.path_bibs = ""
+        self.path_figures = ""
+
         # Configuration options
         self.generate_html = options.get("generate_html", False)
         self.generate_tex = options.get("generate_tex", True)
@@ -65,8 +59,8 @@ class PyRunBibMdTex(BasicInput):
         self.delete_original_bib_in_output_folder = options.get("delete_original_bib_in_output_folder", False)
 
         # Initialize helper classes
-        self._python_bib = PythonRunBib(self.full_json_c, self.full_json_j, self.options)
-        self._python_writer = PythonWriters(self.full_json_c, self.full_json_j, self.options)
+        self._python_bib = PythonRunBib(self.options)
+        self._python_writer = PythonWriters(self.options)
 
         self._python_md = PythonRunMd(self.options)
         self._python_tex = PythonRunTex(self.options)
@@ -76,19 +70,13 @@ class PyRunBibMdTex(BasicInput):
     ) -> Tuple[List[str], List[str]]:
         """Process a list of Markdown or LaTeX files.
 
-        Parameters
-        ----------
-        file_list_md_tex : List[str]
-            List of input file paths (Markdown or LaTeX)
-        output_prefix : str, optional
-            Prefix for output files, by default ""
-        output_level : str, optional
-            Output directory level ("previous", "current", or "next"), by default "next"
-
-        Returns
-        -------
-        Tuple[List[str], List[str]]
-            Tuple containing processed Markdown content and LaTeX content
+        Args:
+            file_list_md_tex (List[str]): List of input file paths (Markdown or LaTeX).
+            output_prefix (str, optional): Prefix for output files. Defaults to "".
+            output_level (str, optional): Output directory level ("previous", "current", or "next"). Defaults to "next".
+
+        Returns:
+            Tuple[List[str], List[str]]: Tuple containing processed Markdown content and LaTeX content.
         """
         file_list_md_tex = [f for f in file_list_md_tex if f.endswith(self.tex_md_flag)]
         data_list_list = [read_list(standard_path(f), "r") for f in file_list_md_tex]
@@ -114,21 +102,14 @@ class PyRunBibMdTex(BasicInput):
     ) -> Tuple[List[str], List[str]]:
         """Process BibTeX, Markdown and LaTeX content.
 
-        Parameters
-        ----------
-        output_prefix : str
-            Prefix for output files
-        data_list_md_tex : List[str]
-            List of content lines (Markdown or LaTeX)
-        original_bib_data : Union[List[str], str, Library]
-            BibTeX data in various formats
-        output_level : str, optional
-            Output directory level ("previous", "current", or "next"), by default "next"
-
-        Returns
-        -------
-        Tuple[List[str], List[str]]
-            Tuple containing processed Markdown content and LaTeX content
+        Args:
+            output_prefix (str): Prefix for output files.
+            data_list_md_tex (List[str]): List of content lines (Markdown or LaTeX).
+            original_bib_data (Union[List[str], str, Library]): BibTeX data in various formats.
+            output_level (str, optional): Output directory level ("previous", "current", or "next"). Defaults to "next".
+
+        Returns:
+            Tuple[List[str], List[str]]: Tuple containing processed Markdown content and LaTeX content.
         """
         # Basic file names
         output_tex, output_md = output_prefix + ".tex", output_prefix + ".md"
@@ -168,21 +149,14 @@ class PyRunBibMdTex(BasicInput):
     ) -> Tuple[List[str], List[str]]:
         """Process BibTeX, Markdown and LaTeX content.
 
-        Parameters
-        ----------
-        output_md : str
-            Output Markdown filename
-        output_tex : str
-            Output LaTeX filename
-        data_list_md_tex : List[str]
-            List of content lines (Markdown or LaTeX)
-        original_bib_data : Union[List[str], str, Library]
-            BibTeX data in various formats
-
-        Returns
-        -------
-        Tuple[List[str], List[str]]
-            Tuple containing processed Markdown content and LaTeX content
+        Args:
+            output_md (str): Output Markdown filename.
+            output_tex (str): Output LaTeX filename.
+            data_list_md_tex (List[str]): List of content lines (Markdown or LaTeX).
+            original_bib_data (Union[List[str], str, Library]): BibTeX data in various formats.
+
+        Returns:
+            Tuple[List[str], List[str]]: Tuple containing processed Markdown content and LaTeX content.
         """
         # Copy figures if enabled
         if self.shutil_figures:
@@ -258,17 +232,12 @@ class PyRunBibMdTex(BasicInput):
     def search_figure_names(data_list: List[str], figure_postfixes: Optional[List[str]] = None) -> List[str]:
         """Search for figure filenames in content.
 
-        Parameters
-        ----------
-        data_list : List[str]
-            List of content lines to search
-        figure_postfixes : Optional[List[str]], optional
-            List of figure file extensions to look for, by default None
-
-        Returns
-        -------
-        List[str]
-            List of found figure filenames
+        Args:
+            data_list (List[str]): List of content lines to search.
+            figure_postfixes (Optional[List[str]], optional): List of figure file extensions to look for. Defaults to None.
+
+        Returns:
+            List[str]: List of found figure filenames.
         """
         if figure_postfixes is None:
             figure_postfixes = ["eps", "jpg", "png", "svg", "psd", "raw", "jpeg", "pdf"]
@@ -283,20 +252,11 @@ class PyRunBibMdTex(BasicInput):
     def shutil_copy_figures(fig_folder_name: str, path_fig: str, fig_names: List[str], path_output: str) -> None:
         """Copy figure files to output directory.
 
-        Parameters
-        ----------
-        fig_folder_name : str
-            Name of figures folder in output directory
-        path_fig : str
-            Source directory containing figures
-        fig_names : List[str]
-            List of figure filenames to copy
-        path_output : str
-            Output directory path
-
-        Returns
-        -------
-        None
+        Args:
+            fig_folder_name (str): Name of figures folder in output directory.
+            path_fig (str): Source directory containing figures.
+            fig_names (List[str]): List of figure filenames to copy.
+            path_output (str): Output directory path.
         """
         if not os.path.exists(path_fig):
             print(f"{path_fig} does not existed.")
@@ -320,22 +280,16 @@ class PyRunBibMdTex(BasicInput):
     def search_cite_keys(data_list: List[str], tex_md_flag: str = ".tex") -> List[str]:
         r"""Extract citation keys from content according to their places.
 
-        Parameters
-        ----------
-        data_list : List[str]
-            List of content lines to search
-        tex_md_flag : str, optional
-            Flag indicating content format (".tex" or ".md"), by default ".tex"
-
-        Returns
-        -------
-        List[str]
-            List of found citation keys
-
-        Notes
-        -----
-        For LaTeX, searches for \\cite, \\citep, \\citet patterns
-        For Markdown, searches for [@key], @key; and ;@key] patterns
+        Args:
+            data_list (List[str]): List of content lines to search.
+            tex_md_flag (str, optional): Flag indicating content format (".tex" or ".md"). Defaults to ".tex".
+
+        Returns:
+            List[str]: List of found citation keys.
+
+        Note:
+            For LaTeX, searches for \\cite, \\citep, \\citet patterns.
+            For Markdown, searches for [@key], @key; and ;@key] patterns.
         """
         cite_key_list = []
         if tex_md_flag == ".tex":
@@ -360,14 +314,8 @@ class PyRunBibMdTex(BasicInput):
     def _cleanup_file(self, file_path: str) -> None:
         """Cleanup files and empty directories.
 
-        Parameters
-        ----------
-        file_path : str
-            Path to file to be removed
-
-        Returns
-        -------
-        None
+        Args:
+            file_path (str): Path to file to be removed.
         """
         if os.path.exists(file_path):
             os.remove(file_path)

pyeasyphd/tools/search/data.py

@@ -2,7 +2,11 @@ from typing import Any, Dict
 
 
 def obtain_search_keywords() -> Dict[str, Any]:
-    """Keywords."""
+    """Obtain search keywords dictionary.
+
+    Returns:
+        Dict[str, Any]: Dictionary containing categorized search keywords.
+    """
     _h_ = "(?:| |-)"  # hyphen
 
     evol = "evol(?:ution|utionary)"  # 'evol(?:ution|utionary|ve|ved|ving)'
@@ -62,10 +66,7 @@ def obtain_search_keywords() -> Dict[str, Any]:
         [moea_d],
         [nsga],
         [f"multi{_h_}objective optimization"],
-        [
-            [f"multi{_h_}objective", "optimization"],
-            [f"multi{_h_}objective optimization"],
-        ],
+        [[f"multi{_h_}objective", "optimization"], [f"multi{_h_}objective optimization"]],
         [[f"multi{_h_}objective"], ["optimization"]],
         [f"multi{_h_}model optimization"],
         [[f"multi{_h_}model", "optimization"], [f"multi{_h_}model optimization"]],
@@ -75,36 +76,15 @@ def obtain_search_keywords() -> Dict[str, Any]:
         [[f"many{_h_}objective"], ["optimization"]],
         [f"dynamic multi{_h_}objective"],
         [f"dynamic {evol} multi{_h_}objective"],
-        [
-            ["dynamic", f"multi{_h_}objective"],
-            [
-                f"dynamic multi{_h_}objective",
-                f"dynamic {evol} multi{_h_}objective"
-            ]
-        ],
+        [["dynamic", f"multi{_h_}objective"], [f"dynamic multi{_h_}objective", f"dynamic {evol} multi{_h_}objective"]],
         [f"dynamic multi{_h_}model"],
         [["dynamic", f"multi{_h_}model"], [f"dynamic multi{_h_}model"]],
         [f"dynamic many{_h_}objective"],
         [f"dynamic {evol} many{_h_}objective"],
-        [
-            ["dynamic", f"many{_h_}objective"],
-            [
-                f"dynamic many{_h_}objective",
-                f"dynamic {evol} many{_h_}objective",
-            ]
-        ],
+        [["dynamic", f"many{_h_}objective"], [f"dynamic many{_h_}objective", f"dynamic {evol} many{_h_}objective"]],
         ["dynamic", "optimization"],
         ["dynamic", network],
-        [
-            ["dynamic"],
-            [
-                f"multi{_h_}objective",
-                f"multi{_h_}model",
-                f"many{_h_}objective",
-                "optimization",
-                network,
-            ],
-        ],
+        [["dynamic"], [f"multi{_h_}objective", f"multi{_h_}model", f"many{_h_}objective", "optimization", network]],
         [f"{uncertain} optimization"],
         [[uncertain, "optimization"], [f"{uncertain} optimization"]],
         [[uncertain], ["optimization"]],
@@ -158,12 +138,7 @@ def obtain_search_keywords() -> Dict[str, Any]:
         ["active", "learning"],
         [
             ["supervised", "learning"],
-            [
-                f"semi{_h_}supervised",
-                f"self{_h_}supervised",
-                f"weakly{_h_}supervised",
-                "unsupervised",
-            ],
+            [f"semi{_h_}supervised", f"self{_h_}supervised", f"weakly{_h_}supervised", "unsupervised"],
         ],
         ["reinforcement", "learning", f"on{_h_}policy"],
         ["reinforcement", "learning", f"off{_h_}policy"],
@@ -174,15 +149,7 @@ def obtain_search_keywords() -> Dict[str, Any]:
         ["reinforcement", "learning", evol],
         [
             ["reinforcement", "learning"],
-            [
-                "offline",
-                f"on{_h_}policy",
-                f"off{_h_}policy",
-                f"model{_h_}based",
-                "deep",
-                "continual",
-                evol,
-            ],
+            ["offline", f"on{_h_}policy", f"off{_h_}policy", f"model{_h_}based", "deep", "continual", evol],
         ],
         ["policy", "search"],
         [["policy"], ["policy", "search"]],
@@ -295,10 +262,7 @@ def obtain_search_keywords() -> Dict[str, Any]:
         ["upper", bound],
         ["lower", bound],
         [[converg], [evol, "swarm", "colony", "genetic", analy]],
-        [
-            ["time"],
-            [evol, "swarm", "colony", "genetic", analy, "hitting", computation, run],
-        ],
+        [["time"], [evol, "swarm", "colony", "genetic", analy, "hitting", computation, run]],
         [[theor], [evol, "swarm", "colony", "genetic", analy]],
         [[bound], [evol, "swarm", "colony", "genetic", analy, "upper", "lower"]],
         [["complexity"], [evol, "swarm", "colony", "genetic", analy]],

pyeasyphd/tools/search/search_base.py

@@ -10,7 +10,16 @@ from .search_writers import WriteInitialResult, WriteSeparateResult
 
 
 def search_keywords_core(keywords_list_list: List[List[str]], library: Library, field: str) -> Tuple[Library, Library]:
-    """Search keywords in `field` such as `title` or `abstract` or `keywords`."""
+    """Search keywords in specified field such as title, abstract, or keywords.
+
+    Args:
+        keywords_list_list (List[List[str]]): List of keyword lists to search for.
+        library (Library): Bibliography library to search.
+        field (str): Field to search in (e.g., 'title', 'abstract', 'keywords').
+
+    Returns:
+        Tuple[Library, Library]: Tuple containing (matching_library, non_matching_library).
+    """
     search_library = []
     no_search_library = []
 
@@ -36,31 +45,35 @@ def search_keywords_core(keywords_list_list: List[List[str]], library: Library,
 
 
 class SearchInitialResult(BasicInput):
-    """Search initial result.
+    """Class for searching and processing initial results.
 
     Args:
-        options: dict
+        options (dict): Configuration options.
 
     Attributes:
-        options: dict
-
-        print_on_screen (bool = False): print on screen
-        deepcopy_library_for_every_field (bool = False): deepcopy library for every field
+        options (dict): Configuration options.
+        print_on_screen (bool): Whether to print results on screen. Defaults to False.
+        deepcopy_library_for_every_field (bool): Whether to deep copy library for every field. Defaults to False.
     """
 
     def __init__(self, options: dict) -> None:
+        """Initialize SearchInitialResult with configuration options.
+
+        Args:
+            options (dict): Configuration options.
+        """
         self.options = options
         super().__init__(options)
 
         self.print_on_screen: bool = options.get("print_on_screen", False)
         self.deepcopy_library_for_every_field = options.get("deepcopy_library_for_every_field", False)
 
-        self._python_bib = PythonRunBib(self.full_json_c, self.full_json_j, options)
+        self._python_bib = PythonRunBib(options)
 
         _options = {}
         _options["empty_entry_cite_keys"] = True
         _options.update(self.options)
-        self._python_writer = PythonWriters(self.full_json_c, self.full_json_j, _options)
+        self._python_writer = PythonWriters(_options)
 
     def main(
         self,
@@ -73,7 +86,21 @@ class SearchInitialResult(BasicInput):
         output_prefix: str,
         path_separate: str,
     ) -> Tuple[List[str], Dict[str, List[List[str]]], Dict[str, int], Library]:
-        """Search."""
+        """Main search method for processing search results.
+
+        Args:
+            search_field_list (List[str]): List of fields to search.
+            path_initial (str): Path to initial directory.
+            library (Library): Bibliography library to search.
+            keywords_type (str): Type of keywords being searched.
+            keywords_list_list (List[List[str]]): List of keyword lists.
+            combine_keywords (str): Combined keywords string.
+            output_prefix (str): Prefix for output files.
+            path_separate (str): Path to separate directory.
+
+        Returns:
+            Tuple[List[str], Dict[str, List[List[str]]], Dict[str, int], Library]: Tuple containing error messages, field data, field numbers, and remaining library.
+        """
         error_pandoc_md_md, field_data_dict, no_search_library = [], {}, library
         field_number_dict: Dict[str, int] = {}
 

pyeasyphd/tools/search/search_core.py

@@ -24,37 +24,45 @@ from .utils import keywords_type_for_title, switch_keywords_list, switch_keyword
 
 
 class SearchResultsCore(BasicInput):
-    """Generate tex, md, html, and pdf.
+    """Core class for generating tex, md, html, and pdf from search results.
 
     Args:
-        path_storage (str): the path of storage `abbr`
-        path_output (str): the path of output `abbr`
-        path_separate (str): the path of separate `abbr`
-        j_conf_abbr (str): the abbreviation of journal or conference
-        options (dict): options
+        path_storage (str): Path to storage directory for bibliography files.
+        path_output (str): Path to output directory for generated files.
+        path_separate (str): Path to separate directory for individual results.
+        j_conf_abbr (str): Abbreviation of journal or conference.
+        options (dict): Configuration options.
 
     Attributes:
-        path_storage (str): the path of storage
-        path_output (str): the path of output
-        path_separate (str): the path of separate
-        j_conf_abbr (str): the abbreviation of journal or conference
-
-        is_standard_bib_file_name (bool = True): whether the bib file name is standard
-        keywords_type_list (List[str] = []): keywords type list
-        keywords_dict (dict = {}): keywords dict
-        delete_redundant_files (bool = True): delete redundant files
-        generate_basic_md (bool = False): generate basic md
-        generate_beauty_md (bool = False): generate beauty md
-        generate_complex_md (bool = True): generate complex md
-        generate_tex (bool = False): generate tex
-        first_field_second_keywords (bool = True): first field second keywords
-        deepcopy_library_for_every_field (bool = False): deepcopy library for every field
-        deepcopy_library_for_every_keywords (bool = False): deepcopy library for every keywords
+        path_storage (str): Path to storage directory.
+        path_output (str): Path to output directory.
+        path_separate (str): Path to separate directory.
+        j_conf_abbr (str): Abbreviation of journal or conference.
+        is_standard_bib_file_name (bool): Whether the bib file name follows standard format.
+        keywords_type_list (List[str]): List of keyword types to search.
+        keywords_dict (dict): Dictionary of keywords for searching.
+        delete_redundant_files (bool): Whether to delete redundant files after processing.
+        generate_basic_md (bool): Whether to generate basic markdown files.
+        generate_beauty_md (bool): Whether to generate beautiful markdown files.
+        generate_complex_md (bool): Whether to generate complex markdown files.
+        generate_tex (bool): Whether to generate LaTeX files.
+        first_field_second_keywords (bool): Whether to search fields first, then keywords.
+        deepcopy_library_for_every_field (bool): Whether to deep copy library for every field.
+        deepcopy_library_for_every_keywords (bool): Whether to deep copy library for every keywords.
     """
 
     def __init__(
         self, path_storage: str, path_output: str, path_separate: str, j_conf_abbr: str, options: Dict[str, Any]
     ) -> None:
+        """Initialize SearchResultsCore with paths and configuration.
+
+        Args:
+            path_storage (str): Path to storage directory for bibliography files.
+            path_output (str): Path to output directory for generated files.
+            path_separate (str): Path to separate directory for individual results.
+            j_conf_abbr (str): Abbreviation of journal or conference.
+            options (Dict[str, Any]): Configuration options.
+        """
         super().__init__(options)
         self.path_storage: str = standard_path(path_storage)
         self.path_output: str = standard_path(path_output)
@@ -96,9 +104,17 @@ class SearchResultsCore(BasicInput):
         self.deepcopy_library_for_every_keywords = options.get("deepcopy_library_for_every_keywords", False)
 
         # for bib
-        self._python_bib = PythonRunBib(self.full_json_c, self.full_json_j, options)
+        self._python_bib = PythonRunBib(options)
 
     def optimize(self, search_year_list: List[str] = []) -> Dict[str, Dict[str, Dict[str, Dict[str, int]]]]:
+        """Optimize search results for given years.
+
+        Args:
+            search_year_list (List[str], optional): List of years to search. Defaults to [].
+
+        Returns:
+            Dict[str, Dict[str, Dict[str, Dict[str, int]]]]: Nested dictionary containing search results.
+        """
         search_year_list = list(set([str(i) for i in search_year_list]))
 
         data_list = self._obtain_full_files_data(self.path_storage, "bib", search_year_list)
@@ -107,6 +123,16 @@ class SearchResultsCore(BasicInput):
         return entry_type_keyword_type_keyword_field_number_dict
 
     def _obtain_full_files_data(self, path_storage: str, extension: str, search_year_list: List[str] = []) -> List[str]:
+        """Obtain data from all files with specified extension in storage path.
+
+        Args:
+            path_storage (str): Path to storage directory.
+            extension (str): File extension to search for.
+            search_year_list (List[str], optional): List of years to filter by. Defaults to [].
+
+        Returns:
+            List[str]: Combined content from all matching files.
+        """
         regex = None
         if self.is_standard_bib_file_name and search_year_list:
             regex = re.compile(f'({"|".join(search_year_list)})')
@@ -123,6 +149,15 @@ class SearchResultsCore(BasicInput):
         return combine_content_in_list([read_list(f, "r") for f in sort_int_str(file_list)], None)
 
     def optimize_core(self, data_list: List[str], search_year_list) -> Dict[str, Dict[str, Dict[str, Dict[str, int]]]]:
+        """Core optimization logic for processing bibliography data.
+
+        Args:
+            data_list (List[str]): List of bibliography data strings.
+            search_year_list: List of years to search.
+
+        Returns:
+            Dict[str, Dict[str, Dict[str, Dict[str, int]]]]: Nested dictionary containing search results.
+        """
         print("\n" + "*" * 9 + f" Search in {self.j_conf_abbr} " + "*" * 9)
 
         entry_type_year_volume_number_month_entry_dict = self._python_bib.parse_to_nested_entries_dict(data_list)
@@ -176,18 +211,25 @@ class SearchResultsCore(BasicInput):
         return entry_type_keyword_type_keyword_field_number_dict
 
     def _optimize_fields_keyword(self, keywords_type, library, output_prefix, p_origin, p_separate, p_combine):
+        """Optimize search by fields first, then keywords.
+
+        Args:
+            keywords_type: Type of keywords to search.
+            library: Bibliography library to search.
+            output_prefix (str): Prefix for output files.
+            p_origin (str): Path to origin directory.
+            p_separate (str): Path to separate directory.
+            p_combine (str): Path to combine directory.
+
+        Returns:
+            dict: Dictionary containing keyword field numbers.
+        """
         no_search_library = library
 
         keyword_field_number_dict_ = {}
         for field in self.search_field_list:
             keyword_field_number_dict, no_search_library = self.core_optimize(
-                [field],
-                keywords_type,
-                no_search_library,
-                output_prefix,
-                p_origin,
-                p_separate,
-                p_combine,
+                [field], keywords_type, no_search_library, output_prefix, p_origin, p_separate, p_combine
             )
 
             if self.deepcopy_library_for_every_field:
@@ -198,16 +240,23 @@ class SearchResultsCore(BasicInput):
         return keyword_field_number_dict_
 
     def _optimize_keywords_field(self, keywords_type, library, output_prefix, p_origin, p_separate, p_combine):
+        """Optimize search by keywords first, then fields.
+
+        Args:
+            keywords_type: Type of keywords to search.
+            library: Bibliography library to search.
+            output_prefix (str): Prefix for output files.
+            p_origin (str): Path to origin directory.
+            p_separate (str): Path to separate directory.
+            p_combine (str): Path to combine directory.
+
+        Returns:
+            dict: Dictionary containing keyword field numbers.
+        """
         no_search_library = library
 
         keyword_field_number_dict, no_search_library = self.core_optimize(
-            self.search_field_list,
-            keywords_type,
-            no_search_library,
-            output_prefix,
-            p_origin,
-            p_separate,
-            p_combine,
+            self.search_field_list, keywords_type, no_search_library, output_prefix, p_origin, p_separate, p_combine
         )
         return keyword_field_number_dict
 
@@ -221,6 +270,20 @@ class SearchResultsCore(BasicInput):
         p_separate: str,
         p_combine: str,
     ) -> Tuple[Dict[str, Dict[str, int]], Library]:
+        """Core optimization method for processing search results.
+
+        Args:
+            search_field_list (List[str]): List of fields to search.
+            keywords_type: Type of keywords to search.
+            library (Library): Bibliography library to search.
+            output_prefix (str): Prefix for output files.
+            p_origin (str): Path to origin directory.
+            p_separate (str): Path to separate directory.
+            p_combine (str): Path to combine directory.
+
+        Returns:
+            Tuple[Dict[str, Dict[str, int]], Library]: Tuple containing keyword field numbers and remaining library.
+        """
         error_pandoc_md_md: List[str] = []
         save_field_data_dict: Dict[str, List[List[str]]] = {}
         keyword_field_number_dict: Dict[str, Dict[str, int]] = {}
@@ -290,7 +353,14 @@ class SearchResultsCore(BasicInput):
         return keyword_field_number_dict, no_search_library
 
     def delete_files(self, keywords_type: str, p_origin: str, p_separate: str, p_combine: str) -> None:
-        """Delete some redundant files."""
+        """Delete redundant files after processing.
+
+        Args:
+            keywords_type (str): Type of keywords being processed.
+            p_origin (str): Path to origin directory.
+            p_separate (str): Path to separate directory.
+            p_combine (str): Path to combine directory.
+        """
         # for initial tex md bib
         if os.path.exists(p_origin):
             shutil.rmtree(p_origin)