docassemble.AssemblyLine 4.0.0__tar.gz → 4.2.0__tar.gz

{docassemble_assemblyline-4.0.0/docassemble.AssemblyLine.egg-info → docassemble_assemblyline-4.2.0}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: docassemble.AssemblyLine
-Version: 4.0.0
+Version: 4.2.0
 Home-page: https://courtformsonline.org
 Author: Suffolk Legal Innovation and Technology Lab
 Author-email: qsteenhuis@suffolk.edu
 License: The MIT License (MIT)
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: docassemble.ALToolbox>=0.11.1
+Requires-Dist: docassemble.ALToolbox>=0.12.0
 Requires-Dist: docassemble.GithubFeedbackForm>=0.4.1.1
 Dynamic: author
 Dynamic: author-email

docassemble_assemblyline-4.2.0/docassemble/AssemblyLine/__init__.py

@@ -0,0 +1 @@
+__version__ = '4.2.0'

{docassemble_assemblyline-4.0.0 → docassemble_assemblyline-4.2.0}/docassemble/AssemblyLine/al_courts.py

@@ -3,7 +3,7 @@ Package for a very simple / MVP list of courts that is mostly signature compatib
 """
 
 import os
-from typing import Any, Callable, Dict, List, Mapping, Optional, Union, Set
+from typing import Any, Callable, Dict, List, Mapping, Optional, Union, Set, Tuple
 import pandas as pd
 import docassemble.base.functions
 from docassemble.base.util import (
@@ -238,12 +238,12 @@ class ALCourtLoader(DAObject):
     # Only solution I can think of would require court database owners to assign each court a unique ID
     # and something that triggers recalculating the court address/etc info.
 
-    def all_courts(self) -> List[Dict[int, str]]:
+    def all_courts(self) -> List[Tuple[int, str]]:
         """
         Return a list of all courts in the spreadsheet.
 
         Returns:
-            List[Dict[int, str]]: List of all ALCourt instances without filtering.
+            List[Tuple[int, str]]: List of tuples where each tuple contains (dataframe_index, display_value). The dataframe_index (int) can be used with as_court() to retrieve the full court object. The display_value (str) is the court's name or other display column value.
         """
         return self.filter_courts(None)
 
@@ -329,13 +329,14 @@ class ALCourtLoader(DAObject):
         display_column: str = "name",
         search_string: Optional[str] = None,
         search_columns: Optional[Union[List[str], str]] = None,
-    ) -> List[Dict[int, str]]:
+    ) -> List[Tuple[int, str]]:
         """
         Retrieve a list of all courts in the specified county.
 
         This function fetches courts suitable for displaying as a drop-down or radio button list
-        in Docassemble. The results are dictionaries where the key is the index in the dataframe,
-        useful for retrieving the court's full details later using the as_court() method.
+        in Docassemble. The results are tuples where the first element is the dataframe index
+        (useful for retrieving the court's full details later using the as_court() method) and
+        the second element is the display value from the specified display_column.
 
         Args:
             county_name (str): Name of the county.
@@ -346,7 +347,7 @@ class ALCourtLoader(DAObject):
                 the search_string in a case-insensitive manner. Defaults to None.
 
         Returns:
-            List[Dict[int, str]]: List of dictionaries representing matching courts.
+            List[Tuple[int, str]]: List of tuples where each tuple contains (dataframe_index, display_value). The dataframe_index (int) can be used with as_court() to retrieve the full court object. The display_value (str) is the court's name or other display column value.
         """
         return self.filter_courts(
             court_types=county_name,
@@ -363,11 +364,11 @@ class ALCourtLoader(DAObject):
         display_column: str = "name",
         search_string: Optional[str] = None,
         search_columns: Optional[Union[List[str], str]] = None,
-    ) -> List[Dict[int, str]]:
+    ) -> List[Tuple[int, str]]:
         """
-        Return a filtered subset of courts represented as a list of dictionaries.
+        Return a filtered subset of courts represented as a list of tuples.
 
-        Each dictionary has the format {index: name}, where "index" refers to the dataframe index and "name"
+        Each tuple has the format (index, display_value), where "index" refers to the dataframe index and "display_value"
         is determined by the `display_column`.
 
         Args:
@@ -380,7 +381,7 @@ class ALCourtLoader(DAObject):
                 the search_string in a case-insensitive manner. Defaults to None.
 
         Returns:
-            List[Dict[int, str]]: List of dictionaries representing filtered courts.
+            List[Tuple[int, str]]: List of tuples where each tuple contains (dataframe_index, display_value). The dataframe_index (int) can be used with as_court() to retrieve the full court object. The display_value (str) is the court's name or other display column value.
         """
         df = self._load_courts()
         if court_types:

{docassemble_assemblyline-4.0.0 → docassemble_assemblyline-4.2.0}/docassemble/AssemblyLine/al_general.py

@@ -37,6 +37,7 @@ from docassemble.base.util import (
     log,
     value,
 )
+from docassemble.ALToolbox.misc import fa_icon
 import random
 import re
 import pycountry
@@ -802,12 +803,12 @@ class ALPeopleList(DAList):
             [person.familiar(**kwargs) for person in self], and_string=word("or")
         )
 
-    def short_list(self, limit: int, truncate_string: str = ", et. al.") -> str:
-        """Return a subset of the list, truncated with 'et. al.' if it exceeds a given limit.
+    def short_list(self, limit: int, truncate_string: str = ", et al.") -> str:
+        """Return a subset of the list, truncated with 'et al.' if it exceeds a given limit.
 
         Args:
             limit (int): The maximum number of items to display before truncating.
-            truncate_string (str, optional): The string to append when truncating. Defaults to ', et. al.'.
+            truncate_string (str, optional): The string to append when truncating. Defaults to ', et al.'.
 
         Returns:
             str: Formatted string of names, truncated if needed.
@@ -958,6 +959,14 @@ class ALIndividual(Individual):
     ) -> str:
         """Fetches and formats the phone numbers of the individual.
 
+        Supports the following attributes:
+
+        - `mobile_number`: Mobile phone number
+        - `phone_number`: Other phone number
+        - `work_number`: Work phone number
+        - `other_number`: Any other phone number
+        - `home_number`: Home phone number (if applicable)
+
         Args:
             country (str, optional): The country for phone number formatting. Defaults to the country of the docassemble server.
             show_impounded (bool): If True, shows the phone numbers even if impounded. Defaults to False.
@@ -986,6 +995,36 @@ class ALIndividual(Individual):
                 nums.append({fmt_number: "other"})
             else:
                 nums.append({self.phone_number: "other"})
+        if hasattr(self, "work_number") and self.work_number:
+            fmt_number = None
+            try:
+                fmt_number = phone_number_formatted(self.work_number, country=country)
+            except:
+                fmt_number = None
+            if fmt_number:
+                nums.append({fmt_number: "work"})
+            else:
+                nums.append({self.work_number: "work"})
+        if hasattr(self, "other_number") and self.other_number:
+            fmt_number = None
+            try:
+                fmt_number = phone_number_formatted(self.other_number, country=country)
+            except:
+                fmt_number = None
+            if fmt_number:
+                nums.append({fmt_number: "other"})
+            else:
+                nums.append({self.other_number: "other"})
+        if hasattr(self, "home_number") and self.home_number:
+            fmt_number = None
+            try:
+                fmt_number = phone_number_formatted(self.home_number, country=country)
+            except:
+                fmt_number = None
+            if fmt_number:
+                nums.append({fmt_number: "home"})
+            else:
+                nums.append({self.home_number: "home"})
         if len(nums) < 1:
             return ""
         # Check for impounded phone number
@@ -1075,6 +1114,7 @@ class ALIndividual(Individual):
         maxlengths: Optional[Dict[str, int]] = None,
         suffix_choices: Optional[Union[List[str], Callable]] = None,
         title_options: Optional[Union[List[str], Callable]] = None,
+        required: Optional[Dict[str, bool]] = None,
     ) -> List[Dict[str, str]]:
         """
         Generates suitable field prompts for a name based on the type of entity (person or business)
@@ -1094,6 +1134,7 @@ class ALIndividual(Individual):
             maxlengths (Dict[str, int], optional): A dictionary of field names and their maximum lengths. Default is None.
             suffix_choices (Union[List[str], Callable], optional): A list of suffix options or a callable to generate suffix options, or overridden by value of global `al_name_suffixes`.
             title_options: (Union[List[str], Callable], optional): Deprecated parameter, use `title_choices` instead. If provided, it will be used to set the title choices.
+            required (Dict[str, bool], optional): A dictionary of field names and if they should be required. Default is None.
 
         Returns:
             List[Dict[str, str]]: A list of dictionaries where each dictionary contains field prompt details.
@@ -1157,6 +1198,17 @@ class ALIndividual(Individual):
             if show_if:
                 for field in fields:
                     field["show if"] = show_if
+
+            if maxlengths:
+                for field in fields:
+                    if field["field"] in maxlengths:
+                        field["maxlength"] = maxlengths[field["field"]]
+
+            if required:
+                for field in fields:
+                    if field["field"] in required:
+                        field["required"] = required[field["field"]]
+
             return fields
         elif person_or_business == "business":
             fields = [
@@ -1167,6 +1219,17 @@ class ALIndividual(Individual):
             ]
             if show_if:
                 fields[0]["show if"] = show_if
+
+            if maxlengths:
+                for field in fields:
+                    if field["field"] in maxlengths:
+                        field["maxlength"] = maxlengths[field["field"]]
+
+            if required:
+                for field in fields:
+                    if field["field"] in required:
+                        field["required"] = required[field["field"]]
+
             return fields
         else:
             # Note: the labels are template block objects: if they are keys,
@@ -1234,6 +1297,12 @@ class ALIndividual(Individual):
                 for field in fields:
                     if field["field"] in maxlengths:
                         field["maxlength"] = maxlengths[field["field"]]
+
+            if required:
+                for field in fields:
+                    if field["field"] in required:
+                        field["required"] = required[field["field"]]
+
             return fields
 
     def address_fields(
@@ -1285,6 +1354,7 @@ class ALIndividual(Individual):
         show_if: Union[str, Dict[str, str], None] = None,
         maxlengths: Optional[Dict[str, int]] = None,
         choices: Optional[Union[List[Dict[str, str]], Callable]] = None,
+        required: Optional[Dict[str, bool]] = None,
     ) -> List[Dict[str, str]]:
         """
         Generate fields for capturing gender information, including a
@@ -1295,6 +1365,7 @@ class ALIndividual(Individual):
             show_if (Union[str, Dict[str, str], None]): Condition to determine if the field should be shown. Defaults to None.
             maxlengths (Dict[str, int], optional): A dictionary of field names and their maximum lengths. Default is None.
             choices (Optional[Union[List[Dict[str, str]], Callable]]): A list of choices of genders to use in the prompts, or a callable that returns such a list. Default set of choices includes male, female, nonbinary, prefer-not-to-say, self-described, and unknown.
+            required (Dict[str, bool], optional): A dictionary of field names and if they should be required. Default is None.
 
         Returns:
             List[Dict[str, str]]: A list of dictionaries with field prompts for gender.
@@ -1338,13 +1409,18 @@ class ALIndividual(Individual):
                 if field["field"] in maxlengths:
                     field["maxlength"] = maxlengths[field["field"]]
 
+        if required:
+            for field in fields:
+                if field["field"] in required:
+                    field["required"] = required[field["field"]]
+
         return fields
 
     def pronoun_fields(
         self,
         show_help=False,
         show_if: Union[str, Dict[str, str], None] = None,
-        required: bool = False,
+        required: Union[bool, Dict[str, bool]] = False,
         shuffle: bool = False,
         show_unknown: Optional[Union[Literal["guess"], bool]] = "guess",
         maxlengths: Optional[Dict[str, int]] = None,
@@ -1356,7 +1432,7 @@ class ALIndividual(Individual):
         Args:
             show_help (bool): Whether to show additional help text. Defaults to False.
             show_if (Union[str, Dict[str, str], None]): Condition to determine if the field should be shown. Defaults to None.
-            required (bool): Whether the field is required. Defaults to False.
+            required (Union[bool, Dict[str, bool]]): Whether the field is required. Can be a boolean (applies to all fields) or a dictionary of field names and if they should be required. Defaults to False.
             shuffle (bool): Whether to shuffle the order of pronouns. Defaults to False.
             show_unknown (Union[Literal["guess"], bool]): Whether to show an "unknown" option. Can be "guess", True, or False. Defaults to "guess".
             maxlengths (Dict[str, int], optional): A dictionary of field names and their maximum lengths. Default is None.
@@ -1390,7 +1466,7 @@ class ALIndividual(Individual):
                 "datatype": "checkboxes",
                 "choices": shuffled_choices + final_choices,
                 "none of the above": str(self.pronoun_prefer_not_to_say_label),
-                "required": required,
+                "required": required if isinstance(required, bool) else False,
             },
             self_described_input,
         ]
@@ -1405,6 +1481,12 @@ class ALIndividual(Individual):
                 if field["field"] in maxlengths:
                     field["maxlength"] = maxlengths[field["field"]]
 
+        # Handle dictionary-based required parameter
+        if isinstance(required, dict):
+            for field in fields:
+                if field["field"] in required:
+                    field["required"] = required[field["field"]]
+
         return fields
 
     def get_pronouns(self) -> set:
@@ -1443,6 +1525,7 @@ class ALIndividual(Individual):
         style: str = "radio",
         show_if: Union[str, Dict[str, str], None] = None,
         maxlengths: Optional[Dict[str, int]] = None,
+        required: Optional[Dict[str, bool]] = None,
     ) -> List[Dict[str, str]]:
         """
         Generate fields for capturing language preferences.
@@ -1452,6 +1535,7 @@ class ALIndividual(Individual):
             style (str): The display style of choices. Defaults to "radio".
             show_if (Union[str, Dict[str, str], None]): Condition to determine if the field should be shown. Defaults to None.
             maxlengths (Dict[str, int], optional): A dictionary of field names and their maximum lengths. Default is None.
+            required (Dict[str, bool], optional): A dictionary of field names and if they should be required. Default is None.
 
         Returns:
             List[Dict[str, str]]: A list of dictionaries with field prompts for language preferences.
@@ -1486,6 +1570,12 @@ class ALIndividual(Individual):
             for field in fields:
                 if field["field"] in maxlengths:
                     field["maxlength"] = maxlengths[field["field"]]
+
+        if required:
+            for field in fields:
+                if field["field"] in required:
+                    field["required"] = required[field["field"]]
+
         return fields
 
     def language_name(self) -> str:
@@ -2322,47 +2412,6 @@ def filter_letters(letter_strings: Union[List[str], str]) -> str:
 # Note: removed "combined_locations" because it is too tightly coupled to MACourts.py right now
 
 
-def fa_icon(
-    icon: str, color: str = "primary", color_css: Optional[str] = None, size: str = "sm"
-) -> str:
-    """
-    Return HTML for a font-awesome icon of the specified size and color. You can reference
-    a CSS variable (such as Bootstrap theme color) or a true CSS color reference, such as 'blue' or
-    '#DDDDDD'. Defaults to Bootstrap theme color "primary".
-
-    Args:
-        icon (str): The name of the icon to use. See https://fontawesome.com/icons for a list of icons.
-        color (str): The color of the icon. Defaults to "primary".
-        color_css (Optional[str]): A CSS variable or color reference. Defaults to None.
-        size (str): The size of the icon. Defaults to "sm".
-
-    Returns:
-        str: HTML for the icon.
-    """
-    if not color and not color_css:
-        return ":" + icon + ":"  # Default to letting Docassemble handle it
-    elif color_css:
-        return (
-            '<i class="fa fa-'
-            + icon
-            + " fa-"
-            + size
-            + '" style="color:'
-            + color_css
-            + ';"></i>'
-        )
-    else:
-        return (
-            '<i class="fa fa-'
-            + icon
-            + " fa-"
-            + size
-            + '" style="color:var(--'
-            + color
-            + ');"></i>'
-        )
-
-
 def is_sms_enabled() -> bool:
     """Checks if SMS (Twilio) is enabled on the server. Does not verify that it works.
 
@@ -2404,7 +2453,7 @@ def is_phone_or_email(text: str) -> bool:
         DAValidationError if the string is neither a valid phone number nor a valid email address.
     """
     sms_enabled = is_sms_enabled()
-    if re.match("\S+@\S+", text) or (sms_enabled and phone_number_is_valid(text)):
+    if re.match(r"\S+@\S+", text) or (sms_enabled and phone_number_is_valid(text)):
         return True
     else:
         if sms_enabled:

{docassemble_assemblyline-4.0.0 → docassemble_assemblyline-4.2.0}/docassemble/AssemblyLine/custom_jinja_filters.py

@@ -5,8 +5,11 @@
 
 # See: https://docassemble.org/docs/documents.html#register_jinja_filter
 
-from typing import Any, Dict, List
-from docassemble.base.util import register_jinja_filter, DACatchAll
+import re
+from typing import Any, Dict, List, Optional, Union
+from docassemble.base.util import register_jinja_filter, DACatchAll, word
+from jinja2 import Undefined, pass_context
+from jinja2.runtime import Context as Jinja2Context
 
 __all__ = [
     "catchall_options",
@@ -200,11 +203,118 @@ def catchall_subquestion(value: Any, subquestion: str) -> DACatchAll:
     return value
 
 
+def _undefined_label(ud: Undefined) -> Union[str, None]:
+    """
+    Extract the variable name from a Jinja2 Undefined object for use as a placeholder label.
+
+    Args:
+        ud (Undefined): The Jinja2 Undefined object.
+    Returns:
+        str: A friendly name extracted from the Undefined object.
+    """
+    return getattr(ud, "_undefined_name", None)
+
+
+@pass_context
+def if_final(
+    context: Jinja2Context,
+    value: Any,
+    i: Optional[str] = None,
+    expected_i: Union[str, List[str]] = "final",
+    placeholder: Optional[str] = None,
+) -> Any:
+    """
+    Jinja2 filter to only seek the definition of a variable if the current value of `i`
+    is equal to the expected value (normally "final"); otherwise,
+    return a placeholder.
+
+    This is useful in ALDocument DOCX templates where you want to show a placeholder when
+    the document is being generated for preview or testing, but let Docassemble trigger
+    the actual value when the document is being generated for final output.
+
+    E.g., to show a placeholder for a signature field when the document is being
+    shown to the signer, but show the actual signature when the document is finalized.
+
+    The default placeholder is "[ signature ]" if the variable name follows the pattern "users[0].signature",
+    or [ variable_name ] if it is not an attribute of an item.
+
+    `i` will be the value from the template's context unless it is explicitly passed,
+    as in an ALDocument's "preview" or "final" values.
+
+    Example:
+        Contents of test_if_final.docx:
+        ```jinja
+        {{ users[0].signature | if_final }}
+        ```
+
+        Returns "[ signature ]" if `i` (passed to the context of the attachment block) is not "final",
+        otherwise the actual value of `users[0].signature`.
+
+        ```yaml
+        ---
+        include:
+        - assembly_line.yml
+        ---
+        mandatory: True
+        code: |
+            preview_screen
+            final_screen
+        ---
+        question: |
+            Here is what it looks like unsigned
+        subquestion: |
+            ${ test_if_final_attachment.as_pdf(key="preview") }
+        continue button field: preview_screen
+        ---
+        question: |
+            Here is what it looks like signed
+        subquestion: |
+            ${ test_if_final_attachment.as_pdf(key="final") }
+        event: final_screen
+        ---
+        objects:
+            - test_if_final_attachment: ALDocument.using(title="test_if_final", filename="test_if_final")
+        ---
+        attachment:
+            variable name: test_if_final_attachment[i]
+            docx template file: test_if_final.docx
+        ```
+
+    Args:
+        context (Jinja2Context): The Jinja2 context, automatically passed by the `pass_context` decorator.
+        value (Any): The original value as passed to the filter.
+        i (str, optional): The current value of `i`. If not provided, it will be fetched from the context.
+        expected_i (Union[str, List[str]], optional): The expected value(s) of `i` to trigger passthrough of `value`.
+            Defaults to "final".
+        placeholder (str, optional): The placeholder string to return if the condition is not met. If
+            not provided, a default placeholder will be generated based on the variable name.
+
+    Returns:
+        Any: The original `value` if `i` matches `expected_i`, otherwise the `placeholder`.
+    """
+    if i is None:
+        i = context.get("i")
+
+    if i != expected_i if isinstance(expected_i, str) else i not in expected_i:
+        if isinstance(value, Undefined):
+            _label = _undefined_label(value)
+            if _label and not placeholder:
+                if "." in _label:
+                    _label = _label.split(".")[-1]
+                placeholder = f"[ {_label} ]"
+            return placeholder
+        return value
+
+    # Allow Docassemble to trap the UndefinedError when i == expected_i (e.g., "final" instead of "preview"), triggering a question to define `value`
+    return value
+
+
 register_jinja_filter("catchall_options", catchall_options)
 register_jinja_filter("catchall_label", catchall_label)
 register_jinja_filter("catchall_datatype", catchall_datatype)
 register_jinja_filter("catchall_question", catchall_question)
 register_jinja_filter("catchall_subquestion", catchall_subquestion)
+register_jinja_filter("if_final", if_final)
 
 
 def catchall_fields_code(value: Any) -> List[Dict[str, Any]]:

{docassemble_assemblyline-4.0.0 → docassemble_assemblyline-4.2.0}/docassemble/AssemblyLine/data/questions/al_document.yml

@@ -162,7 +162,7 @@ subquestion: |
   This can take a few minutes.
 
   <div class="spinner-border text-primary d-flex justify-content-center" role="status">
-      <span class="sr-only">Making documents...</span>
+      <span class="sr-only visually-hidden">Making documents...</span>
   </div>
 event: al_download_waiting_screen
 reload: True
@@ -192,7 +192,7 @@ subquestion: |
   This can take a few minutes.
 
   <div class="spinner-border text-primary d-flex justify-content-center" role="status">
-      <span class="sr-only">Generating preview...</span>
+      <span class="sr-only visually-hidden">Generating preview...</span>
   </div>
 event: al_preview_waiting_screen
 reload: True

{docassemble_assemblyline-4.0.0 → docassemble_assemblyline-4.2.0}/docassemble/AssemblyLine/data/questions/ql_baseline.yml

@@ -1173,6 +1173,30 @@ fields:
   - Phone: x.mobile_number
     datatype: al_international_phone
 ---
+id: persons home number
+generic object: ALIndividual
+question: |
+  What is ${x}'s home phone number?
+fields:
+  - Phone: x.home_number
+    datatype: al_international_phone
+---
+id: persons work number
+generic object: ALIndividual
+question: |
+  What is ${x}'s work phone number?
+fields:
+  - Phone: x.work_number
+    datatype: al_international_phone
+---
+id: persons other number
+generic object: ALIndividual
+question: |
+  What is ${x}'s other phone number?
+fields:
+  - Phone: x.other_number
+    datatype: al_international_phone
+---
 id: persons fax number
 generic object: ALIndividual
 question: |
@@ -1440,6 +1464,17 @@ code: |
 code: |
   signature_fields = ['users[0].signature']
 ---
+code: |
+  if len(signature_fields):    
+    if next(iter(signature_fields)).endswith(".signature"):
+      # the id: signature choice question has to assume the object exists, so we don't guard against that here
+      # note: this does not need to be an ALIndividual, so just use str() instead of .full_name()
+      slash_s_example_name = str(value( next(iter(signature_fields))[:-len(".signature")] ))
+    else:
+      slash_s_example_name = "Signer's Name"
+  else:
+    slash_s_example_name = "Signer's Name"
+---
 id: signature choice
 decoration: file-signature
 question: |
@@ -1458,7 +1493,7 @@ fields:
           We can share a link with your phone on the next screen
           % endif
       - On this device: this_device
-      - With a typed signature, like "${ al_typed_signature_prefix }${ users[0] }": typed_signature
+      - With a typed signature, like "${ al_typed_signature_prefix }${ slash_s_example_name }": typed_signature
     show if:
       code: |
         al_form_requires_digital_signature and not (device() and (device().is_mobile or device().is_touch_capable))
@@ -1467,7 +1502,7 @@ fields:
     input type: radio
     choices:
       - On this device: this_device
-      - With a typed signature, like "${ al_typed_signature_prefix }${ users[0] }": typed_signature
+      - With a typed signature, like "${ al_typed_signature_prefix }${ slash_s_example_name }": typed_signature
     show if:
       code: |
         al_form_requires_digital_signature and (device() and (device().is_mobile or device().is_touch_capable))
@@ -1483,7 +1518,7 @@ fields:
           We can share a link with your phone on the next screen
           % endif
       - On this device: this_device
-      - With a typed signature, like "${ al_typed_signature_prefix }${ users[0] }": typed_signature
+      - With a typed signature, like "${ al_typed_signature_prefix }${ slash_s_example_name }": typed_signature
       - On the paper with a pen after I print the documents: sign_after_printing
     show if:
       code: |
@@ -1493,7 +1528,7 @@ fields:
     input type: radio
     choices:
       - On this device: this_device
-      - With a typed signature, like "${ al_typed_signature_prefix }${ users[0] }": typed_signature
+      - With a typed signature, like "${ al_typed_signature_prefix }${ slash_s_example_name }": typed_signature
       - On the paper with a pen after I print the documents: sign_after_printing
     show if:
       code: |

docassemble_assemblyline-4.2.0/docassemble/AssemblyLine/data/questions/test_if_final.yml

@@ -0,0 +1,27 @@
+---
+include:
+  - assembly_line.yml
+---
+mandatory: True
+code: |
+  preview_screen
+  final_screen
+---
+question: |
+  Here is what it looks like unsigned
+subquestion: |
+  ${ test_if_final_attachment.as_pdf(key="preview") }
+continue button field: preview_screen
+---
+question: |
+  Here is what it looks like signed
+subquestion: |
+  ${ test_if_final_attachment.as_pdf(key="final") }
+event: final_screen
+---
+objects:
+  - test_if_final_attachment: ALDocument.using(title="test_if_final", filename="test_if_final")
+---
+attachment:
+  variable name: test_if_final_attachment[i]
+  docx template file: test_if_final.docx