pyodide-mkdocs-theme 5.4.1__tar.gz → 5.4.2__tar.gz

{pyodide_mkdocs_theme-5.4.1 → pyodide_mkdocs_theme-5.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: pyodide-mkdocs-theme
-Version: 5.4.1
+Version: 5.4.2
 Summary: Package embedding the necessary tools to host pyodide, ACE editors, jQuery terminals in mkdocs documentations
 License: GPL-3.0-or-later
 Keywords: mkdocs,mkdocs-plugin,pyodide,IDE,terminal

{pyodide_mkdocs_theme-5.4.1 → pyodide_mkdocs_theme-5.4.2}/pyodide_mkdocs_theme/PMT_tools/p5/__init__.py

@@ -4,7 +4,7 @@ p5.js wrapper for Pyodide-MkDocs-Theme, by Frédéric Zinelli.
 Basic use:
 
 1. Import p5 as a namespace (no wildcard imports!):
-2. Define the setup and draw callbacks, using calls to the original p6 JS functions,
+2. Define the setup and draw callbacks, using calls to the original p5 JS functions,
    using`p5.functionName()` syntax.
 3. Call `p5.run(setup, draw, preload, target="div_id")` at the end of the code (`preload`
    is optional / `target` is also optional and defaults to the current PMT option value

pyodide_mkdocs_theme-5.4.2/pyodide_mkdocs_theme/__version__.py

@@ -0,0 +1 @@
+__version__ = "5.4.2"

{pyodide_mkdocs_theme-5.4.1 → pyodide_mkdocs_theme-5.4.2}/pyodide_mkdocs_theme/pyodide_macros/files_extractors/_inclusions_tools.py

@@ -136,7 +136,7 @@ Replacements:{ replacements }"""
         self.err_stack_closing()
         j = self.i
         str_repr = ''.join(self.tokens[i:j])
-        return eval(str_repr)
+        return eval(str_repr)           # Using eval to automatically handle escaped chars
 
 
 INCLUSION_PARSER = InclusionParser()

{pyodide_mkdocs_theme-5.4.1 → pyodide_mkdocs_theme-5.4.2}/pyodide_mkdocs_theme/pyodide_macros/files_extractors/base0_extractors.py

@@ -17,45 +17,42 @@ along with this program.
 If not, see <https://www.gnu.org/licenses/>.
 """
 
+
+
+
 """
 # Extractor general contracts/logic:
 ------------------------------------
 
 
-Represent all the files associated to a runner (IDE, terminal, ...), holding the logic/tools
-to build the various sections contents.
+Represent all the files associated to a runner (IDE, terminal, sqlide, ...), holding the 
+logic/tools to build the various sections contents.
 
 Context/Contracts/Goals:
 
 * An Extractor is linked to a single PMT file, with its potential "direct" dependencies
-(aka REMs, or tests/corr files par for the PM source project's format).
-
-* The PMT file can actually not exist at all! (in that case, exo_py is None)
-
-* A PMT file, if it exists, contains sections, delimited by tokens in the form:
-        `{something} (PMT|PYODIDE):{section} {something}`
-`something` being different depending on what is the file to extract (python, sql, ...).
-.
-* An Extractor instance is cached based on the absolute/resolved path to the main file
-(self.exo_py).
-
-* The cache is automatically refreshed when a local file has been modified (based on the
-stats of the file). NOTE: this update is done at the on_config step, to avoid checking on
-each extractor use/call.
-
-* The contents of the files are stored in the instance, avoiding multiple HDD reads operations.
-
-* Inclusions instructions are gathered after the file content has been read, WITHOUT recursively
-triggering extraction of successors: these will be resolved on demand, when building contents.
-NOTE: this is to allow .snippets.py file containing multiple sections, some of them not being
-used in the "parent" file. These .snippets.py files often using [py] redirections, forcing the
-resolution of the children might cause crashes if some sections of the .snippets.py file would
-require specific content in the parent file while they aren't actually needed for this file.
-
-* The final/actual contents are never stored in the object: sections (inclusions) are rebuilt
-on the fly each time they are needed (relying on the fact reading a file is longer than string
-concatenations, and that the simplification this allows in the implementation compensate for
-the extra computation time).
+(aka REMs, or tests/corr files with the PM source project's setup).
+
+* The PMT file can actually not exist at all! (in that case, exo_file is None)
+
+* A PMT file, if it exists, contains sections delimited by tokens (comments) in the form:
+        
+        {head} (PMT|PYODIDE):{section} {tail}
+        
+  Where `head` and `tail` depend on the type of the file, to build a valide comment (python, sql, ...).
+
+* An Extractor instance is cached based on the absolute/resolved path to the targeted
+ file (aka `self.exo_file`).
+
+* The file is automatically refreshed when a local file has been modified.
+
+* The concrete contents of the files are stored in the instance, avoiding multiple HDD
+reads operations. Note that the content is stored "as is", meaning the inclusions are not 
+resolved yet, but the code is analyzed so that the inclusions are known upfront.
+
+* The final/actual contents are never stored in the object: the concrete contents are 
+always built on the fly/on demand, so that all inclusions redirections can apply where 
+needed.
 """
 # pylint: disable=multiple-statements, missing-function-docstring
 
@@ -121,14 +118,15 @@ class BaseFilesExtractor:
     Path to the master main file (if any).
     Also used as key cache to retrieve an Extractor instance.
 
-    WARNING: This path is absolute AND normalized, while an exo_py for an IDE actually needs the
-             absolute UNnormalized path when generating its html id (for backward compatibility,
-             when checking their uniqueness).
+    WARNING: This path is absolute + resolved, whereas the runner_file for an IDE actually is 
+             absolute but NOT normalized (to reduce the needs of ID arugments in macros calls,
+             when generating the html ids of the resulting elements).
     """
 
     docs_file: Optional[Path] = None
     """
-    Same as self.exo_file, but relative to the CWD (logging and error messages purpose).
+    Same as self.exo_file, but relative to the CWD (logging and error messages purpose / NOTE:
+    also used to identify an inclusion location, when resolving them).
     """
 
     in_pages: Set[str] = field(default_factory=set)

{pyodide_mkdocs_theme-5.4.1 → pyodide_mkdocs_theme-5.4.2}/pyodide_mkdocs_theme/pyodide_macros/files_extractors/base1_contents_extractor.py

@@ -546,8 +546,7 @@ class BasePmtSectionsExtractor(BasePmtSectionsTools):
         Extraction of a bare file, supposedly containing only one section (implicitly / consider
         it's a `code` section).
         """
-        log_exo = self.exo_file and Path(self.exo_file).relative_to(CWD)
-        self.env.outdated_PM_files.append( (log_exo, self.env.file_location()) )
+        self.env.outdated_PM_files.append( (self.docs_file, self.env.file_location()) )
 
         sections_and_contents = (
             (ScriptData.code,     script_content),

{pyodide_mkdocs_theme-5.4.1 → pyodide_mkdocs_theme-5.4.2}/pyodide_mkdocs_theme/pyodide_macros/files_extractors/base2_inclusions.py

@@ -49,13 +49,16 @@ class FileExtractorWithInclusions(BasePmtSectionsExtractor):
     """
     Manage inclusions in the python files, following this kind of syntaxes:
 
+        ## {{ [cwd]py_name:section:section }}
         ## {{ [md]py_name:section:section }}
         ## {{ [py]py_name:section:section }}
         ## {{ py_name:section:section }}
 
-    Relative paths usable:
+    Relative paths are usable:
         ## {{ ../bal/py_name:section }}
-        ## {{ :section }}                      (= "in the current py file")
+
+    If no `py_name` element, extract from the current python file:
+        ## {{ :section }}
 
     Possible to change the file extractor type on the fly by giving the extension file in py_name.
     """

{pyodide_mkdocs_theme-5.4.1 → pyodide_mkdocs_theme-5.4.2}/pyodide_mkdocs_theme/pyodide_macros/macros/qcm.py

@@ -19,6 +19,8 @@ If not, see <https://www.gnu.org/licenses/>.
 # pylint: disable=unused-argument
 
 from functools import wraps
+import json
+from pathlib import Path
 from textwrap import dedent
 from typing import Any, Dict, List, Tuple
 
@@ -75,6 +77,7 @@ def multi_qcm(env:MaestroMacros):
         qcm_title:  str = None,
         tag_list_of_qs: str = None,
         DEBUG:      bool = None,
+        DUMP:       bool = None,
         SHOW:       str = None,         # sink (not needed here!)
         ID=None,                        # sink (deprecated)
     ):
@@ -280,6 +283,29 @@ def multi_qcm(env:MaestroMacros):
 
         qcm_close()
 
+        if DUMP:
+            json_data = {
+                'questions': questions,
+                'description': description,
+                'hide': hide,
+                'multi': multi,
+                'shuffle': shuffle,
+                'shuffle_questions': shuffle_questions,
+                'shuffle_items': shuffle_items,
+                'admo_kind': admo_kind,
+                'admo_class': admo_class,
+                'qcm_title': qcm_title,
+                'tag_list_of_qs': tag_list_of_qs,
+                'DEBUG': DEBUG,
+            }
+
+            name = env.page.url.strip('/').split('/')[-1]
+            loc = Path(env.page.file.abs_src_path).with_name(f"qcm_{ name }_{ env.compteur_qcms }.json")
+            content = json.dumps(json_data, indent=2)
+            loc.touch(exist_ok=True)
+            loc.write_text(content, encoding='utf-8')
+
+
 
         output = '\n'.join(admonition_lst)
         output = f'\n\n{ output }\n\n'    # Enforce empty spaces around in the markdown admonition

{pyodide_mkdocs_theme-5.4.1 → pyodide_mkdocs_theme-5.4.2}/pyodide_mkdocs_theme/pyodide_macros/plugin/maestro_base.py

@@ -148,6 +148,7 @@ class BaseMaestro(BasePlugin[PyodideMacrosConfig]):
     args_figure_p5_buttons: str = ConfigExtractor('config.args.figure', prop='p5_buttons')
 
     args_multi_qcm_DEBUG:             bool = ConfigExtractor('config.args.multi_qcm', prop='DEBUG')
+    args_multi_qcm_DUMP:              bool = ConfigExtractor('config.args.multi_qcm', prop='DUMP')
     args_multi_qcm_SHOW:               str = ConfigExtractor('config.args.multi_qcm', prop='SHOW')
     args_multi_qcm_admo_class:         str = ConfigExtractor('config.args.multi_qcm', prop='admo_class')
     args_multi_qcm_admo_kind:          str = ConfigExtractor('config.args.multi_qcm', prop='admo_kind')

{pyodide_mkdocs_theme-5.4.1 → pyodide_mkdocs_theme-5.4.2}/pyodide_mkdocs_theme/pyodide_macros/plugin/maestro_macros.py

@@ -76,7 +76,7 @@ class MaestroMacroManager(MaestroIndent):
     """
 
 
-    compteur_qcms: int = AutoCounter()
+    compteur_qcms: int = 0
     """ Number of qcm or qcs in the docs """
 
     _editors_ids: Set[str]
@@ -102,7 +102,9 @@ class MaestroMacroManager(MaestroIndent):
 
 
     def get_qcm_id(self):
-        return f"{ Prefix.py_mk_qcm_id_ }{ self.compteur_qcms :0>5}"
+        id = f"{ Prefix.py_mk_qcm_id_ }{ self.compteur_qcms :0>5}"
+        self.compteur_qcms += 1
+        return id
 
 
     def is_unique_then_register(self, id_ide:str, no_id_path:str, ID:Optional[str]) -> bool :

{pyodide_mkdocs_theme-5.4.1 → pyodide_mkdocs_theme-5.4.2}/pyodide_mkdocs_theme/pyodide_macros/plugin_config/definitions/macros_configs.py

@@ -1300,6 +1300,13 @@ MULTI_QCM = MultiQcmConfigSrc.with_default_docs(
         """,
         yaml_desc="Display macro related infos in the terminal.",
     ),
+    ConfigOptionSrc(
+        'DUMP', bool, default=False,
+        docs="""
+            Crée un fichier json avec les données du qcm en cours dans le dossier de la page en cours.
+        """,
+        yaml_desc="Dump the MCQ content as json.",
+    ),
 ))
 
 

{pyodide_mkdocs_theme-5.4.1 → pyodide_mkdocs_theme-5.4.2}/pyodide_mkdocs_theme/pyodide_macros/plugin_tools/macros_data.py

@@ -533,6 +533,7 @@ class MacroArgsDataMulti_qcm(ObjectWithDataGetters):
     tag_list_of_qs: str = DataGetter()
     DEBUG: bool = DataGetter()
     SHOW: str = DataGetter()
+    DUMP: bool = DataGetter()
 
 class MacroDataMulti_qcm(MacroData):
     """ Runtime data object for the multi_qcm macro. """

{pyodide_mkdocs_theme-5.4.1 → pyodide_mkdocs_theme-5.4.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "pyodide-mkdocs-theme"
-version = "5.4.1"
+version = "5.4.2"
 requires-python = ">=3.9, <4.0"
 license = { text = "GPL-3.0-or-later" }
 description = "Package embedding the necessary tools to host pyodide, ACE editors, jQuery terminals in mkdocs documentations"

pyodide_mkdocs_theme-5.4.1/pyodide_mkdocs_theme/__version__.py

@@ -1 +0,0 @@
-__version__ = "5.4.1"