pyeasyphd 0.4.2__tar.gz → 0.4.24__tar.gz

{pyeasyphd-0.4.2 → pyeasyphd-0.4.24}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyeasyphd
-Version: 0.4.2
+Version: 0.4.24
 Summary: pyeasyphd
 License: GPL-3.0-or-later
 License-File: LICENSE
@@ -16,8 +16,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Dist: pyadvtools (>=0.2.14,<0.3.0)
-Requires-Dist: pybibtexer (>=0.2.12,<0.3.0)
+Requires-Dist: pybibtexer (>=0.3.13,<0.4.0)
 Project-URL: Documentation, https://github.com/Easy-PhD/pyeasyphd
 Project-URL: Homepage, https://github.com/Easy-PhD/pyeasyphd
 Project-URL: Repository, https://github.com/Easy-PhD/pyeasyphd

{pyeasyphd-0.4.2 → pyeasyphd-0.4.24}/pyeasyphd/main/basic_input.py

@@ -1,5 +1,5 @@
 import os
-from typing import Any, Dict
+from typing import Any
 
 from pyadvtools import read_list
 from pybibtexer.main import BasicInput as BasicInputInPyBibtexer
@@ -9,28 +9,28 @@ class BasicInput(BasicInputInPyBibtexer):
     """Basic input class for handling bibliography and template configurations.
 
     Args:
-        options (Dict[str, Any]): Configuration options.
+        options (dict[str, Any]): Configuration options.
 
     Attributes:
         full_csl_style_pandoc (str): Full path to CSL style for pandoc.
         full_tex_article_template_pandoc (str): Full path to tex article template for pandoc.
         full_tex_beamer_template_pandoc (str): Full path to tex beamer template for pandoc.
-        article_template_tex (List[str]): Article template for LaTeX.
-        article_template_header_tex (List[str]): Article template header for LaTeX.
-        article_template_tail_tex (List[str]): Article template tail for LaTeX.
-        beamer_template_header_tex (List[str]): Beamer template header for LaTeX.
-        beamer_template_tail_tex (List[str]): Beamer template tail for LaTeX.
-        math_commands_tex (List[str]): LaTeX math commands.
-        usepackages_tex (List[str]): LaTeX usepackages.
+        article_template_tex (list[str]): Article template for LaTeX.
+        article_template_header_tex (list[str]): Article template header for LaTeX.
+        article_template_tail_tex (list[str]): Article template tail for LaTeX.
+        beamer_template_header_tex (list[str]): Beamer template header for LaTeX.
+        beamer_template_tail_tex (list[str]): Beamer template tail for LaTeX.
+        math_commands_tex (list[str]): LaTeX math commands.
+        usepackages_tex (list[str]): LaTeX usepackages.
         handly_preamble (bool): Whether to handle preamble manually.
-        options (Dict[str, Any]): Configuration options.
+        options (dict[str, Any]): Configuration options.
     """
 
-    def __init__(self, options: Dict[str, Any]) -> None:
+    def __init__(self, options: dict[str, Any]) -> None:
         """Initialize BasicInput with configuration options.
 
         Args:
-            options (Dict[str, Any]): Configuration options dictionary.
+            options (dict[str, Any]): Configuration options dictionary.
         """
         super().__init__(options)
 
@@ -43,11 +43,11 @@ class BasicInput(BasicInputInPyBibtexer):
 
         self.options = options
 
-    def _initialize_pandoc_md_to(self, options: Dict[str, Any]) -> None:
+    def _initialize_pandoc_md_to(self, options: dict[str, Any]) -> None:
         """Initialize pandoc markdown to other formats configuration.
 
         Args:
-            options (Dict[str, Any]): Configuration options.
+            options (dict[str, Any]): Configuration options.
         """
         csl_name = options.get("csl_name", "apa-no-ampersand")
         if not isinstance(csl_name, str):
@@ -61,11 +61,11 @@ class BasicInput(BasicInputInPyBibtexer):
 
         self.article_template_tex = self._try_read_list("tex", "Article.tex")
 
-    def _initialize_python_run_tex(self, options: Dict[str, Any]) -> None:
+    def _initialize_python_run_tex(self, options: dict[str, Any]) -> None:
         """Initialize Python LaTeX processing configuration.
 
         Args:
-            options (Dict[str, Any]): Configuration options.
+            options (dict[str, Any]): Configuration options.
         """
         self.article_template_header_tex = self._try_read_list("tex", "Article_Header.tex")
         self.article_template_tail_tex = self._try_read_list("tex", "Article_Tail.tex")
@@ -89,7 +89,7 @@ class BasicInput(BasicInputInPyBibtexer):
             file_name (str): Name of the file to read.
 
         Returns:
-            List[str]: List of lines from the file, or empty list if file cannot be read.
+            list[str]: list of lines from the file, or empty list if file cannot be read.
         """
         path_file = os.path.join(self._path_templates, folder_name, file_name)
 

{pyeasyphd-0.4.2 → pyeasyphd-0.4.24}/pyeasyphd/main/pandoc_md_to.py

@@ -3,7 +3,6 @@ import os
 import re
 import subprocess
 import time
-from typing import Dict, List, Optional, Tuple
 
 from pyadvtools import (
     combine_content_in_list,
@@ -19,7 +18,7 @@ from .basic_input import BasicInput
 
 
 class PandocMdTo(BasicInput):
-    """Pandoc markdown to various formats (md, tex, html, pdf).
+    r"""Pandoc markdown to various formats (md, tex, html, pdf).
 
     Args:
         options (dict): Configuration options.
@@ -34,6 +33,7 @@ class PandocMdTo(BasicInput):
         add_anchor_for_basic_dict (bool): Whether to add anchor for items in basic dict. Defaults to False.
         add_anchor_for_beauty_dict (bool): Whether to add anchor for items in beauty dict. Defaults to False.
         add_anchor_for_complex_dict (bool): Whether to add anchor for items in complex dict. Defaults to False.
+        details_to_bib_separator (str): Separator between <details> and bibliography content. Defaults to "\n".
     """
 
     def __init__(self, options: dict) -> None:
@@ -59,9 +59,11 @@ class PandocMdTo(BasicInput):
         self.add_anchor_for_beauty_dict: bool = options.get("add_anchor_for_beauty_dict", False)
         self.add_anchor_for_complex_dict: bool = options.get("add_anchor_for_complex_dict", False)
 
+        self.details_to_bib_separator: str = options.get("details_to_bib_separator", "\n")
+
     def pandoc_md_to_md(
-        self, path_bib: str, path_md_one: str, path_md_two: str, name_md_one: Optional[str], name_md_two: Optional[str]
-    ) -> List[str]:
+        self, path_bib: str, path_md_one: str, path_md_two: str, name_md_one: str | None, name_md_two: str | None
+    ) -> list[str]:
         """Convert markdown to markdown using pandoc.
 
         Args:
@@ -72,13 +74,13 @@ class PandocMdTo(BasicInput):
             name_md_two (Optional[str]): Name of destination markdown file.
 
         Returns:
-            List[str]: List of processed markdown content lines.
+            list[str]: list of processed markdown content lines.
         """
         full_one = path_md_one if name_md_one is None else os.path.join(path_md_one, name_md_one)
         full_two = path_md_two if name_md_two is None else os.path.join(path_md_two, name_md_two)
         return self._pandoc_md_to_md(full_one, full_two, path_bib)
 
-    def _pandoc_md_to_md(self, full_md_one: str, full_md_two: str, path_bib: str) -> List[str]:
+    def _pandoc_md_to_md(self, full_md_one: str, full_md_two: str, path_bib: str) -> list[str]:
         """Internal method to convert markdown to markdown using pandoc.
 
         Args:
@@ -87,7 +89,7 @@ class PandocMdTo(BasicInput):
             path_bib (str): Path to bibliography file.
 
         Returns:
-            List[str]: List of processed markdown content lines.
+            list[str]: list of processed markdown content lines.
         """
         if not os.path.exists(path_two := os.path.dirname(full_md_two)):
             os.makedirs(path_two)
@@ -117,7 +119,7 @@ class PandocMdTo(BasicInput):
         return self._standardize_markdown_content(full_md_two)
 
     @staticmethod
-    def _standardize_markdown_content(full_md: str) -> List[str]:
+    def _standardize_markdown_content(full_md: str) -> list[str]:
         regex = re.compile(r"(\s*>*\s*[-+*]+)\s\s\s(.*)")
         for i in range(len(data_list := read_list(full_md, "r"))):
             if mch := regex.match(data_list[i]):
@@ -126,13 +128,13 @@ class PandocMdTo(BasicInput):
 
     # for pandoc markdown files to tex files
     def pandoc_md_to_tex(
-        self, template_name: str, path_md: str, path_tex: str, name_md: Optional[str], name_tex: Optional[str]
-    ) -> List[str]:
+        self, template_name: str, path_md: str, path_tex: str, name_md: str | None, name_tex: str | None
+    ) -> list[str]:
         full_one = path_md if name_md is None else os.path.join(path_md, name_md)
         full_two = path_tex if name_tex is None else os.path.join(path_tex, name_tex)
         return self._pandoc_md_to_tex(full_one, full_two, template_name)
 
-    def _pandoc_md_to_tex(self, full_md: str, full_tex: str, template_name: str) -> List[str]:
+    def _pandoc_md_to_tex(self, full_md: str, full_tex: str, template_name: str) -> list[str]:
         """Pandoc."""
         if not os.path.exists(path_tex := os.path.dirname(full_tex)):
             os.makedirs(path_tex)
@@ -153,7 +155,7 @@ class PandocMdTo(BasicInput):
 
         return self._substitute_in_tex_from_md(read_list(full_tex, "r", None))
 
-    def _substitute_in_tex_from_md(self, data_list: List[str]) -> List[str]:
+    def _substitute_in_tex_from_md(self, data_list: list[str]) -> list[str]:
         old_str_list = [r"{\[}@", r"{\[}-@", r"{\[}", r"{\]}", r"\\_"]
         new_str_list = [rf"\\{self.cite_flag_in_tex}" + "{", rf"\\{self.cite_flag_in_tex}" + "{", "{", "}", "_"]
         old_str_list.extend([r"\\footnote<.->{", r";", r"@"])
@@ -162,7 +164,7 @@ class PandocMdTo(BasicInput):
 
     # for pandoc markdown files to html files
     def pandoc_md_to_html(
-        self, path_md: str, path_html: str, name_md: Optional[str], name_html: Optional[str], operate: bool = False
+        self, path_md: str, path_html: str, name_md: str | None, name_html: str | None, operate: bool = False
     ) -> str:
         full_one = path_md if name_md is None else os.path.join(path_md, name_md)
         full_two = path_html if name_html is None else os.path.join(path_html, name_html)
@@ -189,7 +191,7 @@ class PandocMdTo(BasicInput):
         return ""
 
     # for pandoc markdown files to pdf files
-    def pandoc_md_to_pdf(self, path_md: str, path_pdf: str, name_md: Optional[str], name_pdf: Optional[str]) -> str:
+    def pandoc_md_to_pdf(self, path_md: str, path_pdf: str, name_md: str | None, name_pdf: str | None) -> str:
         full_one = path_md if name_md is None else os.path.join(path_md, name_md)
         full_two = path_pdf if name_pdf is None else os.path.join(path_pdf, name_pdf)
         return self._pandoc_md_to_pdf(full_one, full_two)
@@ -219,8 +221,8 @@ class PandocMdTo(BasicInput):
     # --------- --------- --------- --------- --------- --------- --------- --------- --------- #
     # md
     def generate_key_data_dict(
-        self, pandoc_md_data_list: List[str], key_url_http_bib_dict: Dict[str, List[List[str]]]
-    ) -> Tuple[Dict[str, List[str]], Dict[str, List[str]], Dict[str, List[str]]]:
+        self, pandoc_md_data_list: list[str], key_url_http_bib_dict: dict[str, list[list[str]]]
+    ) -> tuple[dict[str, list[str]], dict[str, list[str]], dict[str, list[str]]]:
         """Generate."""
         key_reference_dict = self._generate_citation_key_reference_dict_from_pandoc_md(pandoc_md_data_list)
         (key_basic_dict, key_beauty_dict, key_complex_dict) = self._generate_basic_beauty_complex_dict(
@@ -229,8 +231,8 @@ class PandocMdTo(BasicInput):
         return key_basic_dict, key_beauty_dict, key_complex_dict
 
     def _generate_citation_key_reference_dict_from_pandoc_md(
-        self, pandoc_md_data_list: List[str]
-    ) -> Dict[str, List[str]]:
+        self, pandoc_md_data_list: list[str]
+    ) -> dict[str, list[str]]:
         """Generate."""
         pandoc_md_data_list = self.__append_pandoc_md_reference_part(pandoc_md_data_list)
 
@@ -266,7 +268,7 @@ class PandocMdTo(BasicInput):
             key_reference_dict.update({citation_key: delete_empty_lines_last_occur_add_new_line(content)})
         return key_reference_dict
 
-    def __append_pandoc_md_reference_part(self, pandoc_md_data_list: List[str]) -> List[str]:
+    def __append_pandoc_md_reference_part(self, pandoc_md_data_list: list[str]) -> list[str]:
         """Append the line which starts with '::: {#'."""
         line_index, len_data = 0, len(pandoc_md_data_list)
         if self.markdown_name == "pandoc-markdown":
@@ -293,15 +295,15 @@ class PandocMdTo(BasicInput):
         return delete_empty_lines_last_occur_add_new_line(new_list)
 
     def _generate_basic_beauty_complex_dict(
-        self, key_url_http_bib_dict: Dict[str, List[List[str]]], key_reference_dict: Dict[str, list]
-    ) -> Tuple[Dict[str, List[str]], Dict[str, List[str]], Dict[str, List[str]]]:
+        self, key_url_http_bib_dict: dict[str, list[list[str]]], key_reference_dict: dict[str, list]
+    ) -> tuple[dict[str, list[str]], dict[str, list[str]], dict[str, list[str]]]:
         """Generate."""
-        header_list = ["<details>\n", "```\n"]
+        header_list = [f"<details>{self.details_to_bib_separator}", "```\n"]
         tail_list = ["```\n", "</details>\n"]
 
-        key_basic_dict: Dict[str, List[str]] = {}
-        key_beauty_dict: Dict[str, List[str]] = {}
-        key_complex_dict: Dict[str, List[str]] = {}
+        key_basic_dict: dict[str, list[str]] = {}
+        key_beauty_dict: dict[str, list[str]] = {}
+        key_complex_dict: dict[str, list[str]] = {}
 
         key_list_http = list(key_url_http_bib_dict.keys())
         key_list_md = list(key_reference_dict.keys())
@@ -310,10 +312,10 @@ class PandocMdTo(BasicInput):
             return key_basic_dict, key_beauty_dict, key_complex_dict
 
         for k in key_list_http:
-            a: List[str] = copy.deepcopy(key_reference_dict[k])
-            b: List[str] = copy.deepcopy(key_reference_dict[k])
-            aa: List[str] = key_url_http_bib_dict[k][0]
-            bb: List[str] = key_url_http_bib_dict[k][1]
+            a: list[str] = copy.deepcopy(key_reference_dict[k])
+            b: list[str] = copy.deepcopy(key_reference_dict[k])
+            aa: list[str] = key_url_http_bib_dict[k][0]
+            bb: list[str] = key_url_http_bib_dict[k][1]
 
             # add url
             if self.add_url_for_basic_dict:
@@ -323,9 +325,9 @@ class PandocMdTo(BasicInput):
 
             # add anchor
             if self.add_anchor_for_basic_dict:
-                a = [f'<a id="{k.lower()}"></a>\n'] + a
+                a = [f'<a id="{k.lower()}"></a>\n', *a]
             if self.add_anchor_for_beauty_dict or self.add_anchor_for_complex_dict:
-                b = [f'<a id="{k.lower()}"></a>\n'] + b
+                b = [f'<a id="{k.lower()}"></a>\n', *b]
 
             if self.display_one_line_reference_note:
                 a = ["".join(a).replace("\n", " ").strip() + "\n"]
@@ -353,7 +355,7 @@ class PandocMdTo(BasicInput):
         return None
 
     @staticmethod
-    def _generate_tex_content(file_prefix: str, add_tex_name: str, add_bib_name: str) -> Tuple[List[str], List[str]]:
+    def _generate_tex_content(file_prefix: str, add_tex_name: str, add_bib_name: str) -> tuple[list[str], list[str]]:
         if len(file_prefix) == 0:
             file_prefix = "file_prefix"
 

{pyeasyphd-0.4.2 → pyeasyphd-0.4.24}/pyeasyphd/main/python_run_md.py

@@ -3,7 +3,7 @@ import os
 import re
 import shutil
 import time
-from typing import Any, Dict, List, Tuple
+from typing import Any
 
 from pyadvtools import combine_content_in_list, delete_empty_lines_last_occur_add_new_line, read_list, write_list
 from pybibtexer.bib.core import ConvertStrToLibrary
@@ -14,8 +14,7 @@ from .pandoc_md_to import PandocMdTo
 
 
 def batch_convert_citations(text):
-    """
-    Process all citations in the text, including multiple citations in one bracket.
+    r"""Process all citations in the text, including multiple citations in one bracket.
 
     Example: [@ref1; @ref2] -> <sup>[@ref1](#ref1)</sup><sup>[@ref2](#ref2)</sup>
     """
@@ -43,10 +42,10 @@ def batch_convert_citations(text):
 
 
 class PythonRunMd(BasicInput):
-    """Python markdown processing class.
+    r"""Python markdown processing class.
 
     Args:
-        options (Dict[str, Any]): Configuration options.
+        options (dict[str, Any]): Configuration options.
 
     Attributes:
         delete_temp_generate_md (bool): Whether to delete temporary generated markdown files. Defaults to True.
@@ -56,13 +55,14 @@ class PythonRunMd(BasicInput):
         replace_by_basic_beauty_complex_in_md (str): Replace by basic, beauty, or complex format. Defaults to "beauty".
         display_basic_beauty_complex_references_in_md (str): Display basic, beauty, or complex references. Defaults to "beauty".
         add_anchor_in_md (bool): Whether add anchor in markdown. Defaults to False.
+        details_to_bib_separator (str): Separator between <details> and bibliography content. Defaults to "\n".
     """
 
-    def __init__(self, options: Dict[str, Any]) -> None:
+    def __init__(self, options: dict[str, Any]) -> None:
         """Initialize PythonRunMd with configuration options.
 
         Args:
-            options (Dict[str, Any]): Configuration options.
+            options (dict[str, Any]): Configuration options.
         """
         super().__init__(options)
 
@@ -77,6 +77,7 @@ class PythonRunMd(BasicInput):
             "display_basic_beauty_complex_references_in_md", "beauty"
         )
         self.add_anchor_in_md: bool = options.get("add_anchor_in_md", False)
+        self.details_to_bib_separator: str = options.get("details_to_bib_separator", "\n")
 
         # for md
         self._pandoc_md_to = PandocMdTo(self.options)
@@ -90,28 +91,28 @@ class PythonRunMd(BasicInput):
     def special_operate_for_md(
         self,
         path_output: str,
-        data_list_md: List[str],
+        data_list_md: list[str],
         output_md_name: str,
         full_bib_for_abbr: str,
         full_bib_for_zotero: str,
         template_name: str = "article",
         generate_html: bool = False,
         generate_tex: bool = True,
-    ) -> Tuple[List[str], List[str]]:
+    ) -> tuple[list[str], list[str]]:
         """Perform special operations on markdown files.
 
         Args:
             path_output (str): Path to output directory.
-            data_list_md (List[str]): List of markdown content lines.
+            data_list_md (list[str]): list of markdown content lines.
             output_md_name (str): Name of output markdown file.
             full_bib_for_abbr (str): Path to abbreviated bibliography file.
             full_bib_for_zotero (str): Path to Zotero bibliography file.
-            template_name (str, optional): Name of template to use. Defaults to "article".
-            generate_html (bool, optional): Whether to generate HTML. Defaults to False.
-            generate_tex (bool, optional): Whether to generate LaTeX. Defaults to True.
+            template_name (str): Name of template to use. Defaults to "article".
+            generate_html (bool): Whether to generate HTML. Defaults to False.
+            generate_tex (bool): Whether to generate LaTeX. Defaults to True.
 
         Returns:
-            Tuple[List[str], List[str]]: Tuple containing processed markdown and LaTeX content.
+            tuple[list[str], list[str]]: Tuple containing processed markdown and LaTeX content.
         """
         path_temp = os.path.join(path_output, "{}".format(time.strftime("%Y_%m_%d_%H_%M_%S")))
         if not os.path.exists(path_temp):
@@ -163,7 +164,7 @@ class PythonRunMd(BasicInput):
 
     def _special_operate_for_md(
         self, output_md_name: str, path_temp: str, full_bib_for_abbr: str, full_bib_for_zotero: str
-    ) -> List[str]:
+    ) -> list[str]:
         """Perform special operations for markdown processing.
 
         Args:
@@ -173,7 +174,7 @@ class PythonRunMd(BasicInput):
             full_bib_for_zotero (str): Path to Zotero bibliography file.
 
         Returns:
-            List[str]: List of processed markdown content lines.
+            list[str]: list of processed markdown content lines.
         """
         # pandoc markdown to markdown
         n1 = "1_pandoc" + ".md"
@@ -262,7 +263,7 @@ class PythonRunMd(BasicInput):
                 bib_in_md = combine_content_in_list(
                     [
                         ["## Bibliography\n\n"],
-                        ["<details>\n<summary>Bibliography</summary>\n\n"],
+                        [f"<details>{self.details_to_bib_separator}"],
                         ["```\n"],
                         temp_c,
                         ["```\n"],
@@ -276,16 +277,16 @@ class PythonRunMd(BasicInput):
         return content_md
 
     @staticmethod
-    def _special_format(temp_list: List[str], space_one: str, space_two: str) -> List[str]:
+    def _special_format(temp_list: list[str], space_one: str, space_two: str) -> list[str]:
         """Apply special formatting for alignment.
 
         Args:
-            temp_list (List[str]): List of strings to format.
+            temp_list (list[str]): list of strings to format.
             space_one (str): First space string.
             space_two (str): Second space string.
 
         Returns:
-            List[str]: Formatted list of strings.
+            list[str]: Formatted list of strings.
         """
         for j in range(len(temp_list) - 1):
             if temp_list[j][-1] == "\n":
@@ -294,23 +295,23 @@ class PythonRunMd(BasicInput):
 
     def _generate_content_md(
         self,
-        key_basic_beauty_complex_dict: Dict[str, List[str]],
-        key_in_md_tex: List[str],
-        main_part: List[str],
-        last_part: List[str],
-        bib_in_md: List[str],
-    ) -> List[str]:
+        key_basic_beauty_complex_dict: dict[str, list[str]],
+        key_in_md_tex: list[str],
+        main_part: list[str],
+        last_part: list[str],
+        bib_in_md: list[str],
+    ) -> list[str]:
         """Generate markdown content from various components.
 
         Args:
-            key_basic_beauty_complex_dict (Dict[str, List[str]]): Dictionary of formatted references.
-            key_in_md_tex (List[str]): List of citation keys in markdown/LaTeX.
-            main_part (List[str]): Main content part.
-            last_part (List[str]): Last content part.
-            bib_in_md (List[str]): Bibliography content for markdown.
+            key_basic_beauty_complex_dict (dict[str, list[str]]): dictionary of formatted references.
+            key_in_md_tex (list[str]): list of citation keys in markdown/LaTeX.
+            main_part (list[str]): Main content part.
+            last_part (list[str]): Last content part.
+            bib_in_md (list[str]): Bibliography content for markdown.
 
         Returns:
-            List[str]: Generated markdown content.
+            list[str]: Generated markdown content.
         """
         temp_b = []
         if self.add_reference_in_md:

{pyeasyphd-0.4.2 → pyeasyphd-0.4.24}/pyeasyphd/main/python_run_tex.py

@@ -2,7 +2,7 @@ import os
 import re
 import shutil
 import subprocess
-from typing import Any, Dict, List, Optional
+from typing import Any
 
 from pyadvtools import delete_files, insert_list_in_list, read_list, write_list
 
@@ -13,7 +13,7 @@ class PythonRunTex(BasicInput):
     """Python LaTeX processing class.
 
     Args:
-        options (Dict[str, Any]): Configuration options.
+        options (dict[str, Any]): Configuration options.
 
     Attributes:
         run_latex (bool): Whether to run LaTeX compilation. Defaults to False.
@@ -21,11 +21,11 @@ class PythonRunTex(BasicInput):
         delete_run_latex_cache (bool): Whether to delete LaTeX cache files. Defaults to True.
     """
 
-    def __init__(self, options: Dict[str, Any]) -> None:
+    def __init__(self, options: dict[str, Any]) -> None:
         """Initialize PythonRunTex with configuration options.
 
         Args:
-            options (Dict[str, Any]): Configuration options.
+            options (dict[str, Any]): Configuration options.
         """
         super().__init__(options)
 
@@ -34,11 +34,11 @@ class PythonRunTex(BasicInput):
         self.run_latex: bool = options.get("run_latex", False)
         self.pdflatex_xelatex: str = options.get("pdflatex_xelatex", "xelatex")  # pdflatex, xelatex
         self.delete_run_latex_cache: bool = options.get("delete_run_latex_cache", True)
-        self.latex_clean_file_types: Optional[List[str]] = options.get("latex_clean_file_types", None)
+        self.latex_clean_file_types: list[str] | None = options.get("latex_clean_file_types", None)
 
     def generate_standard_tex_data_list(
         self,
-        data_list_body: List[str],
+        data_list_body: list[str],
         output_tex_name: str,
         path_output: str,
         figure_folder_name: str = "figs",
@@ -46,21 +46,21 @@ class PythonRunTex(BasicInput):
         bib_folder_name: str = "bib",
         bib_name: str = "abbr.bib",
         template_name: str = "article",
-    ) -> List[str]:
+    ) -> list[str]:
         """Generate standard LaTeX data list with proper formatting.
 
         Args:
-            data_list_body (List[str]): List of body content strings.
+            data_list_body (list[str]): list of body content strings.
             output_tex_name (str): Name of output LaTeX file.
             path_output (str): Path to output directory.
-            figure_folder_name (str, optional): Name of figures folder. Defaults to "figs".
-            tex_folder_name (str, optional): Name of LaTeX folder. Defaults to "tex".
-            bib_folder_name (str, optional): Name of bibliography folder. Defaults to "bib".
-            bib_name (str, optional): Name of bibliography file. Defaults to "abbr.bib".
-            template_name (str, optional): Name of template to use. Defaults to "article".
+            figure_folder_name (str): Name of figures folder. Defaults to "figs".
+            tex_folder_name (str): Name of LaTeX folder. Defaults to "tex".
+            bib_folder_name (str): Name of bibliography folder. Defaults to "bib".
+            bib_name (str): Name of bibliography file. Defaults to "abbr.bib".
+            template_name (str): Name of template to use. Defaults to "article".
 
         Returns:
-            List[str]: List of processed LaTeX content strings.
+            list[str]: list of processed LaTeX content strings.
         """
         # for figures
         for i in range(len(data_list_body)):
@@ -78,7 +78,7 @@ class PythonRunTex(BasicInput):
 
     def _special_operate_tex(
         self,
-        data_list_body: List[str],
+        data_list_body: list[str],
         template_name: str,
         output_tex_name: str,
         path_output: str,
@@ -89,7 +89,7 @@ class PythonRunTex(BasicInput):
         """Perform special operations on LaTeX files.
 
         Args:
-            data_list_body (List[str]): List of body content strings.
+            data_list_body (list[str]): list of body content strings.
             template_name (str): Name of template to use.
             output_tex_name (str): Name of output LaTeX file.
             path_output (str): Path to output directory.
@@ -163,7 +163,7 @@ class PythonRunTex(BasicInput):
         if self.run_latex:
             if shutil.which("latexmk"):
                 os.chdir(path_output)
-                cmd = "latexmk -{} {}".format(self.pdflatex_xelatex, main_name)
+                cmd = f"latexmk -{self.pdflatex_xelatex} {main_name}"
                 try:
                     subprocess.run(cmd.split(), check=True, capture_output=True, text=True)
                 except subprocess.CalledProcessError as e:

{pyeasyphd-0.4.2 → pyeasyphd-0.4.24}/pyeasyphd/pyeasyphd.py

@@ -12,7 +12,7 @@ def delete_files(path_storage: str, extensions) -> None:
 
     Args:
         path_storage (str): Path to the storage directory.
-        extensions: List of file extensions to delete.
+        extensions: list of file extensions to delete.
     """
     for name in os.listdir(path_storage):
         for ext in extensions:

{pyeasyphd-0.4.2 → pyeasyphd-0.4.24}/pyeasyphd/pyeasyphd.sublime-settings

@@ -16,6 +16,8 @@
     "add_anchor_for_beauty_dict": false,
     // true, false
     "add_anchor_for_complex_dict": false,
+    // "\n" or "\n\n"
+    "details_to_bib_separator": "\n",
 
     // for md file
     // pyeasyphd/main/python_run_md.py
@@ -35,6 +37,8 @@
     "display_basic_beauty_complex_references_in_md": "beauty",
     // true, false
     "add_anchor_in_md": false,
+    // "\n" or "\n\n"
+    // "details_to_bib_separator": "\n",
 
     // for tex file
     // pyeasyphd/main/python_run_tex.py