randex 0.2.0__py3-none-any.whl → 0.2.1__py3-none-any.whl

randex/cli.py

@@ -0,0 +1,56 @@
+"""Shared CLI utilities for randex scripts."""
+
+import click
+
+
+class CustomCommand(click.Command):
+    """Custom Click command that provides better error messages."""
+
+    def parse_args(
+        self,
+        ctx: click.Context,
+        args: list[str],
+    ) -> list[str]:
+        """
+        Override parse_args to catch parameter parsing errors.
+
+        This is a workaround to catch the error when the user passes multiple
+        folder arguments to the command.
+
+        Parameters
+        ----------
+        ctx : click.Context
+            The click context.
+        args : list[str]
+            The arguments passed to the command.
+
+        Returns
+        -------
+        list[str]:
+            The remaining unparsed arguments.
+
+        Examples
+        --------
+        ```bash
+        exams examples/en/folder_* -t template.yaml -n 2
+        ```
+        """
+        try:
+            return super().parse_args(ctx, args)
+        except click.UsageError as e:
+            if "Got unexpected extra arguments" in str(e):
+                # Extract the extra arguments from the error message
+                error_msg = str(e)
+                if "(" in error_msg and ")" in error_msg:
+                    extra_args = error_msg.split("(")[1].split(")")[0]
+
+                    raise click.UsageError(
+                        f"❌ Multiple folder arguments detected: {extra_args}\n\n"
+                        f"💡 This usually happens when your shell expands a glob pattern like 'examples/en/folder_*'\n"  # noqa: E501
+                        f"   into multiple folder names before passing them to the command.\n\n"  # noqa: E501
+                        f"🔧 Solutions:\n"
+                        f'   • Put quotes around your glob pattern: "examples/en/folder_*"\n'  # noqa: E501
+                        f"   • Or specify a single folder path instead of a glob pattern\n\n"  # noqa: E501
+                        f'Example: exams "examples/en/folder_*" -t template.yaml -n 2'
+                    ) from e
+            raise

randex/exam.py

@@ -202,8 +202,14 @@ class Pool:
             matched = [p.resolve() for p in Path().glob(folder_input) if p.is_dir()]
             if not matched:
                 raise ValueError(
-                    f"'{folder_input}' was detected as a glob pattern but "
-                    "matched no folders. If this is a folder name, use a Path instead.",
+                    f"❌ No folders found matching the pattern: '{folder_input}'\n\n"
+                    f"💡 Suggestions:\n"
+                    f"   • Check if the path exists and contains folders\n"
+                    f"   • Verify the spelling (common mistake: 'example' vs 'examples')\n"  # noqa: E501
+                    f"   • Use quotes around the pattern to prevent shell expansion\n"
+                    f"   • Try listing the directory to see available folders\n\n"
+                    f"🔍 If '{folder_input}' is meant to be a literal folder name (not a pattern), "  # noqa: E501
+                    f"remove the special characters or use a Path object instead."
                 )
             return matched
 

{randex-0.2.0.dist-info → randex-0.2.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: randex
-Version: 0.2.0
+Version: 0.2.1
 Summary: Create randomized multiple choice exams using latex.
 License: CC BY-NC 4.0
 Author: G. Arampatzis

randex-0.2.1.dist-info/RECORD

@@ -0,0 +1,12 @@
+randex/__init__.py,sha256=6bBAISO6MqVCSCvqLcK3SGUnDODuwobLWouO3GY8SRU,187
+randex/cli.py,sha256=hwLgZIfBkAeFXlbveywmQlKBGz9GsD_P6Q89YSDOe2M,2039
+randex/exam.py,sha256=sYBQhYjmZDNyTicSD6nOOTo_7c_rst5rhyjCJhCbVtk,26975
+scripts/__init__.py,sha256=F8pjiW8AlL0IhnvVh1TEfgiD--YdFE_PggtSevHp5y4,38
+scripts/exams.py,sha256=D4ky-3J4yx7R3_-UgpGT7C9nQWFqNvdn-fhvzt9Jkbg,3401
+scripts/randex_download_examples.py,sha256=fj88XkZV8bpHPCeXu1f3nVNws_hbcJ_3Zso7XOPB0RQ,1682
+scripts/validate.py,sha256=MnJqfSs8n6qSuxMUT4W0P4ePGyDtRUIXKakWVy20eVo,2659
+randex-0.2.1.dist-info/LICENSE,sha256=NxH5Y8BdC-gNU-WSMwim3uMbID2iNDXJz7fHtuTdXhk,19346
+randex-0.2.1.dist-info/METADATA,sha256=18RJ4FY6RmVK4C9OxDWM8Qe8kY0SClXtbnXT8VrRYP8,6551
+randex-0.2.1.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+randex-0.2.1.dist-info/entry_points.txt,sha256=RayNUArGNT0MLZi7uh1MHjnd1L1V4X6C4sBdMLbvAfc,138
+randex-0.2.1.dist-info/RECORD,,

scripts/exams.py

@@ -6,10 +6,12 @@ from pathlib import Path
 
 import click
 
+from randex.cli import CustomCommand
 from randex.exam import ExamBatch, ExamTemplate, Pool, QuestionSet
 
 
 @click.command(
+    cls=CustomCommand,
     context_settings={"help_option_names": ["--help"]},
 )
 @click.argument(

scripts/validate.py

@@ -6,10 +6,12 @@ from pathlib import Path
 
 import click
 
+from randex.cli import CustomCommand
 from randex.exam import Exam, ExamTemplate, Pool, QuestionSet
 
 
 @click.command(
+    cls=CustomCommand,
     context_settings={"help_option_names": ["--help"]},
 )
 @click.argument(

randex-0.2.0.dist-info/RECORD

@@ -1,11 +0,0 @@
-randex/__init__.py,sha256=6bBAISO6MqVCSCvqLcK3SGUnDODuwobLWouO3GY8SRU,187
-randex/exam.py,sha256=l-_6GnrstLgVMORXNEIKzgW9k6h_YbXndZd8YmEGKBI,26450
-scripts/__init__.py,sha256=F8pjiW8AlL0IhnvVh1TEfgiD--YdFE_PggtSevHp5y4,38
-scripts/exams.py,sha256=L4QSOZpU8Hw5QkW_2x5s8NESQAwlEmZTSaT6ZZ8-c04,3341
-scripts/randex_download_examples.py,sha256=fj88XkZV8bpHPCeXu1f3nVNws_hbcJ_3Zso7XOPB0RQ,1682
-scripts/validate.py,sha256=xruN1P1rgJnc0MTklLgSrsx9TcFC2SY1a9eksNT_-KM,2599
-randex-0.2.0.dist-info/LICENSE,sha256=NxH5Y8BdC-gNU-WSMwim3uMbID2iNDXJz7fHtuTdXhk,19346
-randex-0.2.0.dist-info/METADATA,sha256=1KJfVvoQSFmykT68kvqLkq2YAiu6AxC5hdUSY15Fks0,6551
-randex-0.2.0.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-randex-0.2.0.dist-info/entry_points.txt,sha256=RayNUArGNT0MLZi7uh1MHjnd1L1V4X6C4sBdMLbvAfc,138
-randex-0.2.0.dist-info/RECORD,,