canvaslms 5.7__py3-none-any.whl → 5.9__py3-none-any.whl

canvaslms/cli/assignments.nw

@@ -1338,7 +1338,8 @@ content, accept it (which triggers the update), edit further, or discard changes
 title = attributes.get('name', assignment.name)
 result = canvaslms.cli.content.interactive_confirm_and_edit(
     title, body_content, attributes,
-    canvaslms.cli.content.ASSIGNMENT_SCHEMA, "Assignment")
+    canvaslms.cli.content.ASSIGNMENT_SCHEMA, "Assignment",
+    content_attr='description')
 
 if result is None:
   print("Discarded changes for this assignment.", file=sys.stderr)

canvaslms/cli/assignments.py

@@ -768,6 +768,7 @@ def assignments_edit_command(config, canvas, args):
                 attributes,
                 canvaslms.cli.content.ASSIGNMENT_SCHEMA,
                 "Assignment",
+                content_attr="description",
             )
 
             if result is None:

canvaslms/cli/content.nw

@@ -985,9 +985,14 @@ loop. Users can preview their content, choose to accept it, edit it further,
 or discard their changes.
 
 The function is generalized to work with any content type by accepting the
-schema for re-editing.
+schema for re-editing. When the user chooses to edit again, we need to pass
+the current content back to [[get_content_from_editor]]. Since that function
+expects content to be stored in the attributes dictionary under a named key
+(e.g., \enquote{message} for announcements, \enquote{body} for pages), we accept
+a [[content_attr]] parameter specifying which key to use.
 <<interactive functions>>=
-def interactive_confirm_and_edit(title, message, attributes, schema, content_type="Content"):
+def interactive_confirm_and_edit(title, message, attributes, schema,
+                                 content_type="Content", content_attr='message'):
     """Interactive loop for confirming or editing content.
 
     Args:
@@ -996,6 +1001,7 @@ def interactive_confirm_and_edit(title, message, attributes, schema, content_typ
         attributes: Current attributes
         schema: Schema for re-editing
         content_type: Type label for display
+        content_attr: Name of attribute that holds body content (for re-editing)
 
     Returns:
         Tuple of (attributes, message), or None if cancelled
@@ -1021,7 +1027,9 @@ def interactive_confirm_and_edit(title, message, attributes, schema, content_typ
         if choice in ['a', 'accept']:
             return current_attributes, current_message
         elif choice in ['e', 'edit']:
-            result = get_content_from_editor(schema, current_attributes, current_message)
+            edit_attrs = current_attributes.copy()
+            edit_attrs[content_attr] = current_message
+            result = get_content_from_editor(schema, edit_attrs, content_attr=content_attr)
             if result is None:
                 print("Editor cancelled or failed. Keeping previous content.", file=sys.stderr)
             else:

canvaslms/cli/content.py

@@ -479,7 +479,7 @@ def render_content_preview(
 
 
 def interactive_confirm_and_edit(
-    title, message, attributes, schema, content_type="Content"
+    title, message, attributes, schema, content_type="Content", content_attr="message"
 ):
     """Interactive loop for confirming or editing content.
 
@@ -489,6 +489,7 @@ def interactive_confirm_and_edit(
         attributes: Current attributes
         schema: Schema for re-editing
         content_type: Type label for display
+        content_attr: Name of attribute that holds body content (for re-editing)
 
     Returns:
         Tuple of (attributes, message), or None if cancelled
@@ -516,8 +517,10 @@ def interactive_confirm_and_edit(
         if choice in ["a", "accept"]:
             return current_attributes, current_message
         elif choice in ["e", "edit"]:
+            edit_attrs = current_attributes.copy()
+            edit_attrs[content_attr] = current_message
             result = get_content_from_editor(
-                schema, current_attributes, current_message
+                schema, edit_attrs, content_attr=content_attr
             )
             if result is None:
                 print(

canvaslms/cli/discussions.nw

@@ -394,7 +394,8 @@ for course in course_list:
 
 result = canvaslms.cli.content.interactive_confirm_and_edit(
   title, message, attributes,
-  canvaslms.cli.content.ANNOUNCEMENT_SCHEMA, "Announcement")
+  canvaslms.cli.content.ANNOUNCEMENT_SCHEMA, "Announcement",
+  content_attr='message')
 if result is None:
   print("Cancelled.", file=sys.stderr)
   sys.exit(0)
@@ -775,7 +776,8 @@ After editing, we enter the interactive confirm loop.
 title = edited_attrs.get('title', announcement.title)
 result = canvaslms.cli.content.interactive_confirm_and_edit(
     title, body_content, edited_attrs,
-    canvaslms.cli.content.ANNOUNCEMENT_SCHEMA, "Announcement")
+    canvaslms.cli.content.ANNOUNCEMENT_SCHEMA, "Announcement",
+    content_attr='message')
 
 if result is None:
   print("Discarded changes.", file=sys.stderr)

canvaslms/cli/discussions.py

@@ -143,6 +143,7 @@ def announce_command(config, canvas, args):
             attributes,
             canvaslms.cli.content.ANNOUNCEMENT_SCHEMA,
             "Announcement",
+            content_attr="message",
         )
         if result is None:
             print("Cancelled.", file=sys.stderr)
@@ -436,6 +437,7 @@ def discussions_edit_command(config, canvas, args):
                 edited_attrs,
                 canvaslms.cli.content.ANNOUNCEMENT_SCHEMA,
                 "Announcement",
+                content_attr="message",
             )
 
             if result is None:

canvaslms/cli/pages.nw

@@ -744,7 +744,8 @@ content, accept it (which triggers the update), edit further, or discard changes
 title = attributes.get('title', full_page.title)
 result = canvaslms.cli.content.interactive_confirm_and_edit(
     title, body_content, attributes,
-    canvaslms.cli.content.PAGE_SCHEMA, "Page")
+    canvaslms.cli.content.PAGE_SCHEMA, "Page",
+    content_attr='body')
 
 if result is None:
   print("Discarded changes for this page.", file=sys.stderr)

canvaslms/cli/pages.py

@@ -525,6 +525,7 @@ def pages_edit_command(config, canvas, args):
                 attributes,
                 canvaslms.cli.content.PAGE_SCHEMA,
                 "Page",
+                content_attr="body",
             )
 
             if result is None:

canvaslms/cli/quizzes.nw

@@ -3426,7 +3426,8 @@ def edit_quiz_interactive(quiz, requester, html_mode=False):
     message=body,
     attributes=attributes,
     schema=QUIZ_SCHEMA,
-    content_type="Quiz"
+    content_type="Quiz",
+    content_attr='instructions'
   )
 
   if result is None:

canvaslms/cli/quizzes.py

@@ -2499,6 +2499,7 @@ def edit_quiz_interactive(quiz, requester, html_mode=False):
         attributes=attributes,
         schema=QUIZ_SCHEMA,
         content_type="Quiz",
+        content_attr="instructions",
     )
 
     if result is None:

canvaslms/cli/results.nw

@@ -39,6 +39,7 @@ import importlib.machinery
 import importlib.util
 import os
 import pathlib
+import pkgutil
 import re
 import sys
 
@@ -55,13 +56,27 @@ The command requires two arguments: course and assignment.
 We also want the option to filter on users.
 We can add these by using [[add_assignment_option]], however, we don't need the 
 ungraded flag as we want to export results (\ie graded material).
-Also, we can just add the [[add_user_or_group_option]] to be able to filter on 
+Also, we can just add the [[add_user_or_group_option]] to be able to filter on
 users or groups.
+
+The epilog contains a formatted list of available grading modules.
+We use [[RawDescriptionHelpFormatter]] to preserve the whitespace formatting in
+the epilog while still allowing argument help text to wrap normally.
+
+However, we must be careful about how we construct the epilog string.
+When [[black]] formats the generated Python, triple-quoted strings passed as
+arguments get indented on continuation lines.
+Since [[RawDescriptionHelpFormatter]] preserves this whitespace literally, we'd
+end up with oddly indented prose text in the help output.
+
+To avoid this, we build the epilog via the [[format_results_epilog]] function,
+which joins individual lines without introducing unwanted indentation.
 <<add results command to subp>>=
 results_parser = subp.add_parser("results",
     help="Lists results of a course",
     description="""<<results command description>>""",
-    epilog="""<<results command epilog>>""")
+    epilog=format_results_epilog(),
+    formatter_class=argparse.RawDescriptionHelpFormatter)
 results_parser.set_defaults(func=results_command)
 assignments.add_assignment_option(results_parser, ungraded=False)
 users.add_user_or_group_option(results_parser)
@@ -83,13 +98,10 @@ prevent the student from getting a grade. Output format, CSV:
   <course code> <component code> <student ID> <missing assignment> <reason>
 
 The reason can be "not submitted" or "not graded".
-<<results command epilog>>=
-If you specify an assignment group, the results of the assignments in that 
-group will be summarized. You can supply your own function for summarizing 
-grades through the -S option. See `pydoc3 canvaslms.grades` for different 
-options.
-@ We will cover the option for and loading of the custom summary module later, 
+@ We will cover the option for and loading of the custom summary module later,
 in \cref{custom-summary-modules}.
+We will also cover the [[format_grading_modules_help]] function, which
+dynamically discovers available modules in the [[canvaslms.grades]] package.
 
 Now, that [[results_command]] function must take three arguments: [[config]], 
 [[canvas]] and [[args]].
@@ -395,18 +407,120 @@ if grade is None or grade_date is None \
   continue
 @
 
+\subsection{Discovering available grading modules}
+\label{grading-module-discovery}
+
+When users install [[canvaslms]] via pipx, the package resides in an isolated
+virtual environment.
+This means the traditional approach of using [[pydoc3 canvaslms.grades]] to
+discover available modules no longer works---pydoc searches the system Python
+path, not pipx's isolated environment.
+
+To solve this, we dynamically discover available modules at runtime using
+[[pkgutil.iter_modules]].
+This works regardless of installation method because we introspect from within
+the package itself.
+If a module fails to import (for example, due to missing dependencies), we
+simply skip it rather than failing the entire discovery process.
+
+We provide two helper functions: one to list the modules with their
+descriptions, and one to format them for display in help text.
+<<functions>>=
+def list_grading_modules():
+  """
+  Discover available grading modules in canvaslms.grades package.
+  Returns a list of (module_name, description) tuples.
+  """
+  import canvaslms.grades
+
+  modules = []
+  # These are internal modules, not user-facing grading strategies
+  excluded = {"__init__", "grades"}
+
+  for importer, modname, ispkg in pkgutil.iter_modules(canvaslms.grades.__path__):
+    if modname in excluded:
+      continue
+    try:
+      module = importlib.import_module(f"canvaslms.grades.{modname}")
+      doc = module.__doc__
+      if doc:
+        # Take only the first line of the docstring
+        first_line = doc.strip().split('\n')[0]
+      else:
+        first_line = "(no description)"
+      modules.append((modname, first_line))
+    except ImportError:
+      continue
+
+  return sorted(modules)
+
+def format_grading_modules_help():
+  """Format the list of grading modules for help text display."""
+  modules = list_grading_modules()
+  if not modules:
+    return "  (no modules found)"
+
+  lines = []
+  for name, desc in modules:
+    lines.append(f"  canvaslms.grades.{name}: {desc}")
+  return "\n\n".join(lines)
+
+def format_results_epilog():
+  """
+  Build the epilog for results command help.
+
+  We construct the epilog by joining lines explicitly rather than using a
+  triple-quoted string. This avoids indentation issues when black formats
+  the generated Python code---triple-quoted strings in function arguments
+  get continuation-line indentation that RawDescriptionHelpFormatter
+  would preserve literally.
+  """
+  parts = [
+    "If you specify an assignment group, the results of the assignments in that",
+    "group will be summarized. You can supply your own function for summarizing",
+    "grades through the -S option.",
+    "",
+    "Available grading modules:",
+    format_grading_modules_help(),
+    "",
+    "You can also provide a path to your own Python file with a summarize_group",
+    "function."
+  ]
+  return "\n".join(parts)
+@
+
+The [[list_grading_modules]] function uses [[pkgutil.iter_modules]] to iterate
+over all submodules in the [[canvaslms.grades]] package.
+We exclude [[__init__]] (the package initializer) and [[grades]] (an internal
+module) since these are not user-facing grading strategies.
+
+For each module, we import it and extract the first line of its docstring as a
+brief description.
+This gives users immediate visibility into what each module does, right in the
+help output.
+
+The [[format_grading_modules_help]] function joins module entries with blank
+lines between them (double newline) for visual separation in the help output.
+This makes the list easier to scan when module descriptions vary in length.
+
+The [[format_results_epilog]] function builds the complete epilog by joining
+individual lines.
+This approach avoids the pitfall where [[black]] indents continuation lines in
+triple-quoted strings, which [[RawDescriptionHelpFormatter]] would preserve
+literally, resulting in oddly indented prose in the help output.
+
+
 \subsection{Loading a custom summary module}
 \label{custom-summary-modules}
 
-Different teachers have different policies for merging several assignments into 
+Different teachers have different policies for merging several assignments into
 one grade.
 We now want to provide a way to override the default function.
 <<summary module option doc>>=
-Name of Python module or file containing module to load with a custom 
-summarization function to summarize assignment groups. The default module is 
-part of the `canvaslms` package: `{default_summary_module}`. But it could be 
-any Python file in the file system or other built-in modules. See `pydoc3 
-canvaslms.grades` for alternative modules or how to build your own.
+Name of Python module or file to load with a custom summarization function.
+Default: `{default_summary_module}`. Available modules: """ + \
+", ".join(m[0] for m in list_grading_modules()) + """. \
+Or provide a path to your own Python file.
 <<add option for custom summary module>>=
 default_summary_module = "canvaslms.grades.conjunctavg"
 results_parser.add_argument("-S", "--summary-module",

canvaslms/cli/results.py

@@ -12,6 +12,7 @@ import importlib.machinery
 import importlib.util
 import os
 import pathlib
+import pkgutil
 import re
 import sys
 
@@ -250,6 +251,71 @@ def summarize_modules(canvas, args):
                     ]
 
 
+def list_grading_modules():
+    """
+    Discover available grading modules in canvaslms.grades package.
+    Returns a list of (module_name, description) tuples.
+    """
+    import canvaslms.grades
+
+    modules = []
+    # These are internal modules, not user-facing grading strategies
+    excluded = {"__init__", "grades"}
+
+    for importer, modname, ispkg in pkgutil.iter_modules(canvaslms.grades.__path__):
+        if modname in excluded:
+            continue
+        try:
+            module = importlib.import_module(f"canvaslms.grades.{modname}")
+            doc = module.__doc__
+            if doc:
+                # Take only the first line of the docstring
+                first_line = doc.strip().split("\n")[0]
+            else:
+                first_line = "(no description)"
+            modules.append((modname, first_line))
+        except ImportError:
+            continue
+
+    return sorted(modules)
+
+
+def format_grading_modules_help():
+    """Format the list of grading modules for help text display."""
+    modules = list_grading_modules()
+    if not modules:
+        return "  (no modules found)"
+
+    lines = []
+    for name, desc in modules:
+        lines.append(f"  canvaslms.grades.{name}: {desc}")
+    return "\n\n".join(lines)
+
+
+def format_results_epilog():
+    """
+    Build the epilog for results command help.
+
+    We construct the epilog by joining lines explicitly rather than using a
+    triple-quoted string. This avoids indentation issues when black formats
+    the generated Python code---triple-quoted strings in function arguments
+    get continuation-line indentation that RawDescriptionHelpFormatter
+    would preserve literally.
+    """
+    parts = [
+        "If you specify an assignment group, the results of the assignments in that",
+        "group will be summarized. You can supply your own function for summarizing",
+        "grades through the -S option.",
+        "",
+        "Available grading modules:",
+        format_grading_modules_help(),
+        "",
+        "You can also provide a path to your own Python file with a summarize_group",
+        "function.",
+    ]
+    return "\n".join(parts)
+
+
 def load_module(module_name):
     """
     Load a module from the file system or a built-in module.
@@ -334,10 +400,8 @@ def add_command(subp):
                        <course code> <component code> <student ID> <missing assignment> <reason>
 
                      The reason can be "not submitted" or "not graded".""",
-        epilog="""If you specify an assignment group, the results of the assignments in that 
-                group will be summarized. You can supply your own function for summarizing 
-                grades through the -S option. See `pydoc3 canvaslms.grades` for different 
-                options.""",
+        epilog=format_results_epilog(),
+        formatter_class=argparse.RawDescriptionHelpFormatter,
     )
     results_parser.set_defaults(func=results_command)
     assignments.add_assignment_option(results_parser, ungraded=False)
@@ -362,11 +426,11 @@ def add_command(subp):
         "--summary-module",
         required=False,
         default=default_summary_module,
-        help=f"""Name of Python module or file containing module to load with a custom 
-             summarization function to summarize assignment groups. The default module is 
-             part of the `canvaslms` package: `{default_summary_module}`. But it could be 
-             any Python file in the file system or other built-in modules. See `pydoc3 
-             canvaslms.grades` for alternative modules or how to build your own.""",
+        help=f"""Name of Python module or file to load with a custom summarization function.
+             Default: `{default_summary_module}`. Available modules: """
+        + ", ".join(m[0] for m in list_grading_modules())
+        + """. \
+             Or provide a path to your own Python file.""",
     )
     default_missing_module = "canvaslms.cli.results"
     results_parser.add_argument(

canvaslms/grades/Makefile

@@ -6,6 +6,7 @@ MODULES+=			disjunctmax.py
 MODULES+=			maxgradesurvey.py
 MODULES+=			conjunctavgsurvey.py
 MODULES+=			tilkryLAB1.py
+MODULES+=			participation.py
 
 .PHONY: all
 all: grades.tex
@@ -14,6 +15,7 @@ all: disjunctmax.tex
 all: maxgradesurvey.tex
 all: conjunctavgsurvey.tex
 all: tilkryLAB1.tex
+all: participation.tex
 all: ${MODULES}
 
 grades.tex: conjunctavg.tex
@@ -21,6 +23,7 @@ grades.tex: disjunctmax.tex
 grades.tex: maxgradesurvey.tex
 grades.tex: conjunctavgsurvey.tex
 grades.tex: tilkryLAB1.tex
+grades.tex: participation.tex
 
 __init__.py: init.py
 	${MV} $^ $@

canvaslms/grades/grades.nw

@@ -135,3 +135,4 @@ We can also give the relative or absolute path to \texttt{mysum.py} instead.
 \input{../src/canvaslms/grades/disjunctmax.tex}
 \input{../src/canvaslms/grades/maxgradesurvey.tex}
 \input{../src/canvaslms/grades/tilkryLAB1.tex}
+\input{../src/canvaslms/grades/participation.tex}

canvaslms/grades/participation.nw

@@ -0,0 +1,218 @@
+\section{Conjunctive P/F grading, the \texttt{participation} module}
+
+This module implements conjunctive P/F grading for participation-based
+assignments.
+It's useful when students must complete \emph{all} assignments in a group to
+pass, where each assignment is graded as complete/incomplete or 100/0.
+
+As an example, consider a course where students pass by participating in
+seminars and completing reflections:
+\begin{minted}{text}
+$ canvaslms assignments list -c vetcyb25h -A "^Participation INL1" \
+  | cut -f 1-3
+DA2215 HT25 (vetcyb25h)	Participation INL1	Reflection on literature reviews
+DA2215 HT25 (vetcyb25h)	Participation INL1	Overview of Science in Security
+DA2215 HT25 (vetcyb25h)	Participation INL1	How to Design Computer Security Experiments
+DA2215 HT25 (vetcyb25h)	Participation INL1	How do you know it's secure? Passwords
+DA2215 HT25 (vetcyb25h)	Participation INL1	Comprehension, literature review: Of passwords and people
+DA2215 HT25 (vetcyb25h)	Participation INL1	Comprehension: Graphical Passwords: Learning from the First Twelve Years
+DA2215 HT25 (vetcyb25h)	Participation INL1	Achieving Rigor in Literature Reviews  Insights from Qualitative Data Analysis and Tool-Support
+DA2215 HT25 (vetcyb25h)	Participation INL1	Live seminar 13/11 at 13:15
+DA2215 HT25 (vetcyb25h)	Participation INL1	Comprehension: Of Passwords and People, Measuring the Effect of Password-Composition Policies
+DA2215 HT25 (vetcyb25h)	Participation INL1	Comprehension: Can long passwords be secure and usable?
+DA2215 HT25 (vetcyb25h)	Participation INL1	Comprehension: Why phishing works
+DA2215 HT25 (vetcyb25h)	Participation INL1	Live seminar 6/11 at 15:15
+DA2215 HT25 (vetcyb25h)	Participation INL1	The RSA and ElGamal cryptosystems
+DA2215 HT25 (vetcyb25h)	Participation INL1	On the Security of EIGamal Based Encryption
+DA2215 HT25 (vetcyb25h)	Participation INL1	Stealing Keys from PCs using a Radio: Cheap Electromagnetic Attacks on Windowed Exponentiation
+DA2215 HT25 (vetcyb25h)	Participation INL1	Timing Analysis of Keystrokes and Timing Attacks on SSH
+DA2215 HT25 (vetcyb25h)	Participation INL1	Reflection on the use of models, part I
+DA2215 HT25 (vetcyb25h)	Participation INL1	Theorem proving: 1. Introduction
+DA2215 HT25 (vetcyb25h)	Participation INL1	Theorem proving: 2. Formal methods and Interactive Theorem Proving
+DA2215 HT25 (vetcyb25h)	Participation INL1	Theorem proving: 4. Examples for what can be verified with Interactive Theorem Provers
+DA2215 HT25 (vetcyb25h)	Participation INL1	Theorem proving: 5. Limitations of Interactive Theorem Proving and Conclusion
+DA2215 HT25 (vetcyb25h)	Participation INL1	Model checking: algorithmic verification and debugging
+DA2215 HT25 (vetcyb25h)	Participation INL1	Reflection on the use of models, part II
+DA2215 HT25 (vetcyb25h)	Participation INL1	Live seminar 28/11  at 10:15
+DA2215 HT25 (vetcyb25h)	Participation INL1	Dos and Don'ts of Machine Learning in Computer Security
+DA2215 HT25 (vetcyb25h)	Participation INL1	Reflection on the use of statistics
+DA2215 HT25 (vetcyb25h)	Participation INL1	Comprehension: Why Johnny can't encrypt
+DA2215 HT25 (vetcyb25h)	Participation INL1	Comprehension: Comparing the Usability of Cryptographic APIs
+DA2215 HT25 (vetcyb25h)	Participation INL1	Reflection on qualitative methods
+DA2215 HT25 (vetcyb25h)	Participation INL1	SoK: Science, Security and the Elusive Goal of Security as a Scientific Pursuit
+DA2215 HT25 (vetcyb25h)	Participation INL1	Reflection on Science in Security
+DA2215 HT25 (vetcyb25h)	Participation INL1	Live seminar 12/12 at 12:15
+DA2215 HT25 (vetcyb25h)	Participation INL1	Tor: The Second-Generation Onion Router
+DA2215 HT25 (vetcyb25h)	Participation INL1	Comprehension: Users get routed: traffic correlation on tor by realistic adversaries
+DA2215 HT25 (vetcyb25h)	Participation INL1	Comprehension:  Shadow: Running Tor in a Box for Accurate and Efficient Experimentation
+DA2215 HT25 (vetcyb25h)	Participation INL1	Comprehension: Website Fingerprinting with Website Oracles
+DA2215 HT25 (vetcyb25h)	Participation INL1	Comprehension: Online Website Fingerprinting: Evaluating Website Fingerprinting Attacks on Tor in the Real World
+DA2215 HT25 (vetcyb25h)	Participation INL1	Reflection on the use of models, part III
+DA2215 HT25 (vetcyb25h)	Participation INL1	Live seminar 3/12 at 12:15
+DA2215 HT25 (vetcyb25h)	Participation INL1	Reflection on inferences, experiments and measurements
+\end{minted}
+The exact assignments and names might change though.
+But that's fine.
+The grading system remains the same, we have the following grades:
+\begin{minted}{text}
+$ canvaslms submissions list -c vetcyb25h -A "^Participation INL1" \
+  | cut -f 4 | sort -u
+
+100
+complete
+incomplete
+\end{minted}
+We want all assignments to have either complete or 100 to get a passing grade.
+Otherwise the student gets an F.
+
+\subsection{Grading logic: conjunctive P/F}
+
+This module implements what we call \emph{conjunctive P/F grading}.
+Let's contrast this with other approaches to understand what makes it unique:
+\begin{description}
+\item[conjunctavg] All assignments must pass, and A--E grades are averaged.
+  Here we have no A--E grades, only complete/incomplete or 100/empty.
+\item[disjunctmax] At least one assignment must pass (disjunctive), and we take
+  the best grade.
+  Here \emph{all} assignments must pass (conjunctive), and the only possible
+  grades are P or F.
+\end{description}
+
+The grading rule is simple: if \emph{all} participation assignments have a
+passing grade, the student passes.
+If \emph{any} assignment is missing or has an incomplete grade, the student
+fails.
+
+\subsection{Module structure}
+
+We follow the standard module structure: a [[summarize_group]] function that
+iterates over users and delegates to a [[summarize]] helper function.
+<<[[participation.py]]>>=
+"""
+<<module doc>>
+"""
+import datetime as dt
+from canvaslms.cli import results
+from canvasapi.exceptions import ResourceDoesNotExist
+
+<<helper functions>>
+
+def summarize_group(assignments_list, users_list):
+  """
+  Summarizes participation assignments using conjunctive P/F grading.
+  All assignments must have 'complete' or '100' for P, otherwise F.
+  """
+  for user in users_list:
+    grade, grade_date, graders = summarize(user, assignments_list)
+    yield [user, grade, grade_date, *graders]
+@
+
+<<module doc>>=
+Summarizes participation assignments using conjunctive P/F grading.
+All assignments must have 'complete' or '100' for P, otherwise F.
+@
+
+\subsection{What counts as passing?}
+
+A grade is considered passing if it is either:
+\begin{itemize}
+\item [[complete]] (case-insensitive, so [[Complete]] or [[COMPLETE]] also work)
+\item [[100]] (a numeric grade indicating full completion)
+\end{itemize}
+
+Anything else---including [[incomplete]], [[None]], or a missing
+submission---counts as not passing.
+<<helper functions>>=
+def is_passing_grade(grade):
+  """
+  Returns True if the grade indicates passing (complete or 100).
+  """
+  if grade is None:
+    return False
+  if isinstance(grade, str):
+    if grade.casefold() == "complete":
+      return True
+    if grade == "100":
+      return True
+  return False
+@
+
+\subsection{Summarizing a student's participation}
+
+The [[summarize]] function iterates through all assignments and checks whether
+each one has a passing grade.
+We collect dates and graders along the way.
+<<helper functions>>=
+def summarize(user, assignments_list):
+  """
+  Extracts user's submissions for all participation assignments.
+  Returns (grade, date, graders) where grade is P if all passed, F otherwise.
+  """
+  passed = []
+  dates = []
+  graders = []
+
+  for assignment in assignments_list:
+    <<get submission for assignment>>
+    <<check if grade is passing>>
+    <<add graders to [[graders]] list>>
+    <<add date to [[dates]] list>>
+
+  <<determine final grade>>
+
+  return (final_grade, final_date, graders)
+@
+
+For each assignment, we attempt to fetch the student's submission.
+If the submission doesn't exist (which can happen in rare cases), we treat it
+as not passing.
+<<get submission for assignment>>=
+try:
+  submission = assignment.get_submission(user,
+                                        include=["submission_history"])
+except ResourceDoesNotExist:
+  passed.append(False)
+  continue
+
+submission.assignment = assignment
+@
+
+We extract the grade from the submission and check whether it's passing.
+<<check if grade is passing>>=
+grade = submission.grade
+passed.append(is_passing_grade(grade))
+@
+
+We collect all graders from the submission history.
+This ensures we credit everyone who participated in the grading process, not
+just the last person to grade.
+<<add graders to [[graders]] list>>=
+graders += results.all_graders(submission)
+@
+
+For the date, we prefer the submission date but fall back to the grading date
+if no submission was made (for example, oral presentations where the student
+didn't submit anything).
+<<add date to [[dates]] list>>=
+grade_date = submission.submitted_at or submission.graded_at
+if grade_date:
+  grade_date = dt.date.fromisoformat(grade_date.split("T")[0])
+  dates.append(grade_date)
+@
+
+\subsection{Determining the final grade}
+
+The final grade is P if \emph{all} assignments passed, F otherwise.
+If there are no dates (meaning the student has no activity at all), we return
+[[None]] for both grade and date.
+<<determine final grade>>=
+if dates:
+  final_date = max(dates)
+  if all(passed):
+    final_grade = "P"
+  else:
+    final_grade = "F"
+else:
+  final_date = None
+  final_grade = None
+@

canvaslms/grades/participation.py

@@ -0,0 +1,70 @@
+"""
+Summarizes participation assignments using conjunctive P/F grading.
+All assignments must have 'complete' or '100' for P, otherwise F.
+"""
+
+import datetime as dt
+from canvaslms.cli import results
+from canvasapi.exceptions import ResourceDoesNotExist
+
+
+def is_passing_grade(grade):
+    """
+    Returns True if the grade indicates passing (complete or 100).
+    """
+    if grade is None:
+        return False
+    if isinstance(grade, str):
+        if grade.casefold() == "complete":
+            return True
+        if grade == "100":
+            return True
+    return False
+
+
+def summarize(user, assignments_list):
+    """
+    Extracts user's submissions for all participation assignments.
+    Returns (grade, date, graders) where grade is P if all passed, F otherwise.
+    """
+    passed = []
+    dates = []
+    graders = []
+
+    for assignment in assignments_list:
+        try:
+            submission = assignment.get_submission(user, include=["submission_history"])
+        except ResourceDoesNotExist:
+            passed.append(False)
+            continue
+
+        submission.assignment = assignment
+        grade = submission.grade
+        passed.append(is_passing_grade(grade))
+        graders += results.all_graders(submission)
+        grade_date = submission.submitted_at or submission.graded_at
+        if grade_date:
+            grade_date = dt.date.fromisoformat(grade_date.split("T")[0])
+            dates.append(grade_date)
+
+    if dates:
+        final_date = max(dates)
+        if all(passed):
+            final_grade = "P"
+        else:
+            final_grade = "F"
+    else:
+        final_date = None
+        final_grade = None
+
+    return (final_grade, final_date, graders)
+
+
+def summarize_group(assignments_list, users_list):
+    """
+    Summarizes participation assignments using conjunctive P/F grading.
+    All assignments must have 'complete' or '100' for P, otherwise F.
+    """
+    for user in users_list:
+        grade, grade_date, graders = summarize(user, assignments_list)
+        yield [user, grade, grade_date, *graders]

{canvaslms-5.7.dist-info → canvaslms-5.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: canvaslms
-Version: 5.7
+Version: 5.9
 Summary: Command-line interface to Canvas LMS
 License-Expression: MIT
 License-File: LICENSE

{canvaslms-5.7.dist-info → canvaslms-5.9.dist-info}/RECORD

@@ -2,32 +2,32 @@ canvaslms/Makefile,sha256=9zE09HzyU-S2B1RI72UV1S9mmqXKiE9gIn-NuhyQP08,119
 canvaslms/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 canvaslms/cli/Makefile,sha256=8uQf6xKYRr_4mrYA-FnYYh7xAq7CcBvF3rbqDTNLUyY,820
 canvaslms/cli/__init__.py,sha256=KiOWz1mshRZeqQAmj_l27ZP2krgX-ta0X18Rs4KX8Ng,6515
-canvaslms/cli/assignments.nw,sha256=3XyaP_xl42tcMyNmmZ2Bi5vdYuRBx0jEC6Wh2Vwo7t4,54749
-canvaslms/cli/assignments.py,sha256=4M8cguSPBuUE7V4sjfFJ3oSL3XiGz7bfEquXFzY9TKU,38710
+canvaslms/cli/assignments.nw,sha256=bgKytV48ya0cGJsuur6sIZ_V7ZvuNR1qF7qPvg1xf2U,54781
+canvaslms/cli/assignments.py,sha256=gphQuMgB0H_y-w4flidu9QRPREheBtuLF8zg70-9gZs,38754
 canvaslms/cli/cache.nw,sha256=TV9nUkwSUrFyltH98uUJ-3BLXT_-yNGsilaFlbByaxU,13350
 canvaslms/cli/cache.py,sha256=EBD2YLYa7Efq_RWsDgZOf44SaUemsyPWgeYVS-eW1uk,8217
 canvaslms/cli/calendar.nw,sha256=-dN8Sx9LWGBwhq2wc3w0GjQL3ywwPKfvi9gjsRJ6qVg,22887
 canvaslms/cli/calendar.py,sha256=f8af6McSxg5G2Etf6TAxwp1cnYodlcyw7SJgcJJLBks,20898
 canvaslms/cli/canvas_calendar.py,sha256=AbA6nOZ7e-zACfAqwK1utBjuShVGsaERxIJ4xRKEUZc,22196
 canvaslms/cli/cli.nw,sha256=f3xbi1kzjVSsFzEmOS_7Pfy7nJbkYuAcR11RVqkSSsE,23675
-canvaslms/cli/content.nw,sha256=cFl2raYWrXJXXcjZ2cuzWIHdezUMlBypJhq95ZGEENg,36404
-canvaslms/cli/content.py,sha256=BXpQxhTfsNBgdRd3bz4E997gsBtPmk8_ILJqZnwEnHA,17149
+canvaslms/cli/content.nw,sha256=hg_KBHAPXTGyZFMV2Y96oE3VUHaVxsY2hvJBQDDHvOA,36995
+canvaslms/cli/content.py,sha256=OQiyhtwNenOZ1V0665f7p9VE9P3Zz3AX6vIzz0VqpKo,17362
 canvaslms/cli/courses.nw,sha256=W8hNE8wQYPoSRDbqdU_qFvmOFWF6mRap0NLaz-edHH0,14569
 canvaslms/cli/courses.py,sha256=XKeV43xNT1or_qv40_IATJgey2zbVEg8qHqnz-Z7qUo,3743
-canvaslms/cli/discussions.nw,sha256=IPavr0m43OeCsUvZVqnpSEDb9UZ_oh6IDpsAXW0wMmY,46633
-canvaslms/cli/discussions.py,sha256=R6GbFbHYXCa0vyDf4eegGp74Pj6WGC38MEb6kY0PkWY,40388
+canvaslms/cli/discussions.nw,sha256=woTvzURp10kimseuYTZs2RTFpCKnpxCsCnDTFK_4jNI,46687
+canvaslms/cli/discussions.py,sha256=fNhJlfzWLzH7Z_fP95w6Scp_ZS7R5Io7zRKQtKa68YU,40464
 canvaslms/cli/grade.nw,sha256=ms7sBiGRPbK0CJLKxxYx_CDY9LMWgKxUuf2M3FYepMs,2197
 canvaslms/cli/grade.py,sha256=b7YkFIz64oXzcV2FcptpYJphevuCU3cdx9CilZHcG_A,662
 canvaslms/cli/login.nw,sha256=93LyHO_LXL1WdEvMg3OLhWulgkdoO8pfjYZVLwUbX4I,4419
 canvaslms/cli/login.py,sha256=wbA5Q9fTsW1J-vraRcdq2kG4h_LFtvH_MTEay6h8GcE,2737
 canvaslms/cli/modules.nw,sha256=rvrZe4AU_ok955GZ_ZwwFNFIHIKzft1LR9zTVLW_gic,24122
 canvaslms/cli/modules.py,sha256=8fZpW_x7eUMUgcn8JrvbGuwtrmHsbVdNvqfcRgfF4x8,12953
-canvaslms/cli/pages.nw,sha256=njm6oQT22ryI8Z7O62d-qivQjbMX_je5OwhgHEvtVUg,28934
-canvaslms/cli/pages.py,sha256=lW8DpMeyQQoVcu7ztSj_PdW-oUJC0HSh5mDeo8BuaRc,27713
-canvaslms/cli/quizzes.nw,sha256=xgivQGColOzayvMn3OcxJf0V7E2K2lzindzPeBqymBw,262940
-canvaslms/cli/quizzes.py,sha256=1gX16Mo49rO4j98xy_j7xSuIs0E9DcOJigB90imBNR4,198225
-canvaslms/cli/results.nw,sha256=T-ry1k_cHCH_nJfvPl4d9UBbIl_SxvXjBMxyYfXgyaw,22503
-canvaslms/cli/results.py,sha256=8ODAhC4r1ndyTHnWSSwFEeV4ab_snxTi1nkrsqqwRLg,15033
+canvaslms/cli/pages.nw,sha256=ZCv1NAwwXRzSy27ePJ3CI1ET1BBZJsM2scnoZxCW4n4,28959
+canvaslms/cli/pages.py,sha256=7E6gjEfs3L6A9_c84gRHvx7auDDV7MQWUXDwQ2-dkz4,27750
+canvaslms/cli/quizzes.nw,sha256=c1zco19uSt9ULIyYWqoCYgNvK4PeSfC6otUpA_b7Flg,262973
+canvaslms/cli/quizzes.py,sha256=jLb1vVU7WClqaDVfXk9akgfii4X_Z5IO1FV6hEhdAAs,198262
+canvaslms/cli/results.nw,sha256=SQIiCwcQUO-irUD6-Ya-4QBVHo19uv5QHH7GXNvdrDg,26862
+canvaslms/cli/results.py,sha256=2KGcqGzmrfqc2Jj5ddQcrm33qF_DYHoljTol4qI9pSg,16845
 canvaslms/cli/results.py.broken,sha256=njHu8mKfPHqH4daxy-4LMpO6FdUBLPHiVKFFmyH8aJQ,13047
 canvaslms/cli/submissions.nw,sha256=RCpN7p2Oe9sbMeIPv16CeUGvuesyT9Z5f2PdIdKxHy8,97760
 canvaslms/cli/submissions.py,sha256=mvXiknSAxmdvoHg6V6k8IqTNdRx2FZqBskniIDRcpw8,49196
@@ -36,7 +36,7 @@ canvaslms/cli/users.nw,sha256=WOutY4VTeyDBqOIbHk6VY_nxgJPk1eKU9CvH6nqjsE4,35236
 canvaslms/cli/users.py,sha256=YBmL7tUStFd_JPNHTIN1H_n-DmLgYv54JdQrcIRsUDk,16979
 canvaslms/cli/utils.nw,sha256=E6mIJFZc_mCWIvfCHgOPqFWbOgLKcATEJlJiGZMyuMk,16270
 canvaslms/cli/utils.py,sha256=RO3-TZzgxSC662vB34WOt4V9S1bHv6N2B9eVo3sFavY,4138
-canvaslms/grades/Makefile,sha256=a9IDqfVcT7JImJ4a9o3T16NHdmMQNPqwUan1eoaeWiU,811
+canvaslms/grades/Makefile,sha256=NQoyTmiaW2Cw8sfM9LNYjiNN0rYxM8UmoLpDbdKHwu4,893
 canvaslms/grades/__init__.py,sha256=wDg-x-fbSsph2R0vradLXO4oDR1yG8Z-6whW2l5_pX8,1027
 canvaslms/grades/conjunctavg.nw,sha256=uaHcE7l72o66FUjK8x1KijE5YeMsU74WFS-j-ZCVBq0,4671
 canvaslms/grades/conjunctavg.py,sha256=ARLEWdtiDre8LDsL0DVKjQ9tfJslZAJept1fbhmKc9A,3006
@@ -44,10 +44,12 @@ canvaslms/grades/conjunctavgsurvey.nw,sha256=O158fPIv4y1_Qx8yB9O4wV9wMoVC5b5rVYG
 canvaslms/grades/conjunctavgsurvey.py,sha256=G-1i2BeapSsXJ9XfxEK0ShK5UxlqQpBcu9yJH9F1Sys,2730
 canvaslms/grades/disjunctmax.nw,sha256=tiPMd59OBsZyUdW_KqY-kSqQVL9I7u7tMSSyOQDa8YI,3982
 canvaslms/grades/disjunctmax.py,sha256=6dMah6yxHpJHKdO72SRh47GLC38UinMl0HVdGSIZePM,2703
-canvaslms/grades/grades.nw,sha256=EbO-rkqO12keY7nC_eOTGspTS0fZdOA1an9TNRumUUk,5046
+canvaslms/grades/grades.nw,sha256=ldR-_7l3L5ymHJV82TBnQ1YLn2kwyD2Cw3bW--Q-iiY,5096
 canvaslms/grades/grades.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 canvaslms/grades/maxgradesurvey.nw,sha256=agYMqH20K1DLZ0pB9CJPye0E1g_A-ImdGJJzO03HFcE,3263
 canvaslms/grades/maxgradesurvey.py,sha256=eEysQNgHuFM9-2vrx4h2ovmK5TsXbRI1ukRx7tsct7Y,2089
+canvaslms/grades/participation.nw,sha256=pqSxNdIrAbLvSXAmxLpgLm263yPObGqbEPibZ0BAHj0,9439
+canvaslms/grades/participation.py,sha256=Pex6-vYfqB33Lizn3Pkn6yZUq0l1LZG40555uXSxCj4,2054
 canvaslms/grades/tilkryLAB1.nw,sha256=xkieCGinC0sLpwsBPlOCxXjUPUiHITQzV7QTnJo3-io,10186
 canvaslms/grades/tilkryLAB1.py,sha256=_-p2DqeNZCnomCcXkUSSK4_KffJcaPwpjEBzfXlWsqg,3214
 canvaslms/hacks/Makefile,sha256=Xxk4Fw6U_QSB8KgBlSL8-vUqYIzWzDOXgN1_LNgmNdU,345
@@ -57,8 +59,8 @@ canvaslms/hacks/attachment_cache.py,sha256=LcOZqaa6jPrEJWUD-JYN5GTc3bxCbv2fr_vqu
 canvaslms/hacks/canvasapi.nw,sha256=ixmIHn4tgy-ZKtQ1rqWSw97hfY2m0qtGX0de2x89lwA,136470
 canvaslms/hacks/canvasapi.py,sha256=A-r48x7gO6143_QkuZ8n6EW66i-a2AXXr7X7oeehOAU,31868
 canvaslms/hacks/test_hacks.py,sha256=JSJNvZqHu1E_s51HsPD7yr1gC-R-xVe-tuMMAKU9Gj8,66709
-canvaslms-5.7.dist-info/METADATA,sha256=39VhZz1uFN7Bm1W7GU2Yyxt6RI_wh3u5dd1t3kweD_w,6078
-canvaslms-5.7.dist-info/WHEEL,sha256=3ny-bZhpXrU6vSQ1UPG34FoxZBp3lVcvK0LkgUz6VLk,88
-canvaslms-5.7.dist-info/entry_points.txt,sha256=lyblfkLbodN5yb7q1c6-rwIoJPV-ygXrB9PYb5boHXM,48
-canvaslms-5.7.dist-info/licenses/LICENSE,sha256=N_TKsbzzD5Ax5fWJqEQk9bkwtf394MJkNeFld4HV6-E,1074
-canvaslms-5.7.dist-info/RECORD,,
+canvaslms-5.9.dist-info/METADATA,sha256=KADA9jxYVaKQdgBMTccpmz794RWGkw7l296vT6UvxFg,6078
+canvaslms-5.9.dist-info/WHEEL,sha256=3ny-bZhpXrU6vSQ1UPG34FoxZBp3lVcvK0LkgUz6VLk,88
+canvaslms-5.9.dist-info/entry_points.txt,sha256=lyblfkLbodN5yb7q1c6-rwIoJPV-ygXrB9PYb5boHXM,48
+canvaslms-5.9.dist-info/licenses/LICENSE,sha256=N_TKsbzzD5Ax5fWJqEQk9bkwtf394MJkNeFld4HV6-E,1074
+canvaslms-5.9.dist-info/RECORD,,