docassemble.AssemblyLine 4.1.0__tar.gz → 4.2.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: docassemble.AssemblyLine
-Version: 4.1.0
+Version: 4.2.0
 Home-page: https://courtformsonline.org
 Author: Suffolk Legal Innovation and Technology Lab
 Author-email: qsteenhuis@suffolk.edu

docassemble_assemblyline-4.2.0/docassemble/AssemblyLine/__init__.py

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

{docassemble_assemblyline-4.1.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.1.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.
@@ -1113,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)
@@ -1132,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.
@@ -1195,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 = [
@@ -1205,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,
@@ -1272,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(
@@ -1323,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
@@ -1333,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.
@@ -1376,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,
@@ -1394,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.
@@ -1428,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,
         ]
@@ -1443,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:
@@ -1481,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.
@@ -1490,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.
@@ -1524,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:
@@ -2360,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.
 

{docassemble_assemblyline-4.1.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.1.0 → docassemble_assemblyline-4.2.0}/docassemble/AssemblyLine/data/static/aldocument.js

@@ -1,7 +1,27 @@
 /*
- * given a docassemble event name, and text ID containing email address and whether
+ * Helper function to process multiple email addresses from a string
+ * Splits on comma or semicolon and trims whitespace
+ */
+function process_multiple_emails(email_string) {
+  if (!email_string || typeof email_string !== 'string') {
+    return email_string;
+  }
+  
+  // Split on comma or semicolon, trim whitespace, and filter out empty strings
+  var emails = email_string.split(/[,;]/).map(function(email) {
+    return email.trim();
+  }).filter(function(email) {
+    return email.length > 0;
+  });
+  
+  // Return single string if only one email, array if multiple
+  return emails.length === 1 ? emails[0] : emails;
+}
+
+/*
+ * given a docassemble event name, and text ID containing email address(es) and whether
  * or not user wants to send editable files, trigger docassemble event to
- * email an ALDocumentBundle
+ * email an ALDocumentBundle. Supports multiple email addresses separated by commas or semicolons.
  */
 function aldocument_send_action(event_name, wants_editable_id, email_id, template_name="", key="final", preferred_formats=null) {
   var editable = null;
@@ -18,7 +38,8 @@ function aldocument_send_action(event_name, wants_editable_id, email_id, templat
     }
   }
   
-  var email = $('#' + email_id)[0].value;
+  var email_raw = $('#' + email_id)[0].value;
+  var email = process_multiple_emails(email_raw);
   da_action_perform(event_name, {editable: editable, email: email, key:key, template_name: template_name, preferred_formats: final_formats});
 };
 

{docassemble_assemblyline-4.1.0 → docassemble_assemblyline-4.2.0}/docassemble/AssemblyLine/sessions.py

@@ -842,13 +842,13 @@ def interview_list_html(
         table += f"""
         </td>
         <td>
-          <a href="{ url_action(delete_action, filename=answer.get("filename"), session=answer.get("key")) }"><i class="far fa-trash-alt" title="{ delete_label }" aria-hidden="true"></i><span class="sr-only">{ delete_label }</span></a>
+          <a href="{ url_action(delete_action, filename=answer.get("filename"), session=answer.get("key")) }"><i class="far fa-trash-alt" title="{ delete_label }" aria-hidden="true"></i><span class="sr-only visually-hidden">{ delete_label }</span></a>
           """
         if show_view_button:
             table += f"""
                 <a target="_blank" href="{ interview_url(i=answer.get("filename"), session=answer.get("key")) }">
                     <i class="far fa-eye" aria-hidden="true" title="{ view_label }"></i>
-                    <span class="sr-only">{ view_label }</span>
+                    <span class="sr-only visually-hidden">{ view_label }</span>
                 </a>
             """
         table += """
@@ -1133,7 +1133,7 @@ def session_list_html(
         <td class="al-progress-box">{ radial_progress(answer) }
         </td>
         <td>
-          <a class="al-sessions-action-rename" href="{ url_ask_rename }"><i class="fa-solid fa-tag" aria-hidden="true" title="{ rename_label }"></i><span class="sr-only">{ rename_label }</span></a>
+          <a class="al-sessions-action-rename" href="{ url_ask_rename }"><i class="fa-solid fa-tag" aria-hidden="true" title="{ rename_label }"></i><span class="sr-only visually-hidden">{ rename_label }</span></a>
         """
         if (
             get_config("assembly line", {}).get("enable answer sets")
@@ -1141,11 +1141,11 @@ def session_list_html(
         ):
             table += f"""
           &nbsp;
-          <a class="al-sessions-actions-clone" href="{ url_ask_copy }"><i class="fa-regular fa-clone" aria-hidden="true" title="{clone_label}"></i><span class="sr-only">{ clone_label }</span></a>
+          <a class="al-sessions-actions-clone" href="{ url_ask_copy }"><i class="fa-regular fa-clone" aria-hidden="true" title="{clone_label}"></i><span class="sr-only visually-hidden">{ clone_label }</span></a>
           """
         table += f"""
           &nbsp;
-          <a href="{ url_ask_delete }" class="text-danger al-delete-session"><i class="far fa-trash-alt text-danger" title="{ delete_label }" aria-hidden="true"></i><span class="sr-only">{ delete_label }</span></a>
+          <a href="{ url_ask_delete }" class="text-danger al-delete-session"><i class="far fa-trash-alt text-danger" title="{ delete_label }" aria-hidden="true"></i><span class="sr-only visually-hidden">{ delete_label }</span></a>
         </td>
         """
         table += "</tr>"

{docassemble_assemblyline-4.1.0 → docassemble_assemblyline-4.2.0}/docassemble/AssemblyLine/test_al_general.py

@@ -462,6 +462,157 @@ class TestALIndividual(unittest.TestCase):
         self.assertEqual(self.individual.name_short(), "Johnny's Sandwiches")
         self.assertEqual(str(self.individual), "Johnny's Sandwiches")
 
+    def test_name_fields_required(self):
+        """Test the required parameter for name_fields method"""
+        self.individual.instanceName = "test_individual"
+        self.individual.first_name_label = "First name"
+        self.individual.middle_name_label = "Middle name"
+        self.individual.last_name_label = "Last name"
+        self.individual.suffix_label = "Suffix"
+        self.individual.title_label = "Title"
+        self.individual.business_name_label = "Business name"
+
+        # Test without required parameter - middle name should default to False
+        fields = self.individual.name_fields(
+            person_or_business="person",
+            title_choices=["a title"],
+            suffix_choices=["Jr.", "Sr."],
+        )
+        middle_field = None
+        for field in fields:
+            if "middle" in field["field"]:
+                middle_field = field
+                break
+        self.assertIsNotNone(middle_field)
+        self.assertEqual(middle_field["required"], False)
+
+        # Test with required parameter making middle name required
+        fields = self.individual.name_fields(
+            person_or_business="person",
+            required={"test_individual.name.middle": True},
+            title_choices=["a title"],
+            suffix_choices=["Jr.", "Sr."],
+        )
+        middle_field = None
+        for field in fields:
+            if "middle" in field["field"]:
+                middle_field = field
+                break
+        self.assertIsNotNone(middle_field)
+        self.assertEqual(middle_field["required"], True)
+
+        # Test business case with required parameter
+        fields = self.individual.name_fields(
+            person_or_business="business",
+            required={"test_individual.name.first": True},
+            title_choices=["a title"],
+            suffix_choices=["Jr.", "Sr."],
+        )
+        business_field = fields[0]
+        self.assertEqual(business_field["required"], True)
+
+    def test_gender_fields_required(self):
+        """Test the required parameter for gender_fields method"""
+        self.individual.instanceName = "test_individual"
+        self.individual.gender_female_label = "Female"
+        self.individual.gender_male_label = "Female"
+        self.individual.gender_nonbinary_label = "Non-binary"
+        self.individual.gender_prefer_not_to_say_label = "Prefer not to say"
+        self.individual.gender_prefer_self_described_label = "Prefer self-described"
+        self.individual.gender_unknown_label = "Unknown"
+        self.individual.gender_self_described_label = "Self described"
+        self.individual.gender_label = "Gender"
+
+        # Test without required parameter
+        fields = self.individual.gender_fields()
+        gender_field = fields[0]
+        self.assertNotIn(
+            "required", gender_field
+        )  # Should not have required by default
+
+        # Test with required parameter
+        fields = self.individual.gender_fields(
+            required={"test_individual.gender": True}
+        )
+        gender_field = fields[0]
+        self.assertEqual(gender_field["required"], True)
+
+        # Test key not in required dict - should not change default
+        fields = self.individual.gender_fields(required={"other_field": True})
+        gender_field = fields[0]
+        self.assertNotIn("required", gender_field)
+
+    def test_pronoun_fields_required(self):
+        """Test the required parameter for pronoun_fields method (both bool and dict)"""
+        self.individual.instanceName = "test_individual"
+        self.individual.pronoun_prefer_self_described_label = "Something else"
+        self.individual.pronoun_unknown_label = "Unknown"
+        self.individual.pronoun_self_described_label = "Self described pronouns"
+        self.individual.pronouns_label = "Self described pronouns"
+        self.individual.pronoun_prefer_not_to_say_label = "Prefer not to say"
+
+        # Test with boolean required parameter (existing behavior)
+        fields = self.individual.pronoun_fields(
+            required=True, choices=[{"They/them/theirs": "they/them/theirs"}]
+        )
+        pronoun_field = fields[0]
+        self.assertEqual(pronoun_field["required"], True)
+
+        # Test with boolean required parameter = False
+        fields = self.individual.pronoun_fields(
+            required=False, choices=[{"They/them/theirs": "they/them/theirs"}]
+        )
+        pronoun_field = fields[0]
+        self.assertEqual(pronoun_field["required"], False)
+
+        # Test with dictionary required parameter (new behavior)
+        fields = self.individual.pronoun_fields(
+            required={"test_individual.pronouns": True},
+            choices=[{"They/them/theirs": "they/them/theirs"}],
+        )
+        pronoun_field = fields[0]
+        self.assertEqual(pronoun_field["required"], True)
+
+        # Test with dictionary required parameter for different field
+        fields = self.individual.pronoun_fields(
+            required={"test_individual.pronouns_self_described": True},
+            choices=[{"They/them/theirs": "they/them/theirs"}],
+        )
+        pronoun_field = fields[0]
+        self_described_field = fields[1]
+        self.assertEqual(
+            pronoun_field["required"],
+            False,
+        )  # First field should still be False
+        self.assertEqual(self_described_field["required"], True)
+
+    def test_language_fields_required(self):
+        """Test the required parameter for language_fields method"""
+        self.individual.instanceName = "test_individual"
+        self.individual.language_other_label = "Other language"
+        self.individual.language_label = "Language"
+
+        # Test without required parameter
+        fields = self.individual.language_fields()
+        language_field = fields[0]
+        self.assertNotIn(
+            "required", language_field
+        )  # Should not have required by default
+
+        # Test with required parameter
+        fields = self.individual.language_fields(
+            required={"test_individual.language": True}
+        )
+        language_field = fields[0]
+        self.assertEqual(language_field["required"], True)
+
+        # Test other language field
+        fields = self.individual.language_fields(
+            required={"test_individual.language_other": False}
+        )
+        other_field = fields[1]
+        self.assertEqual(other_field["required"], False)
+
 
 class test_get_visible_al_nav_items(unittest.TestCase):
     def test_case_1(self):

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: docassemble.AssemblyLine
-Version: 4.1.0
+Version: 4.2.0
 Home-page: https://courtformsonline.org
 Author: Suffolk Legal Innovation and Technology Lab
 Author-email: qsteenhuis@suffolk.edu

{docassemble_assemblyline-4.1.0 → docassemble_assemblyline-4.2.0}/setup.py

@@ -44,7 +44,7 @@ def find_package_data(where='.', package='', exclude=standard_exclude, exclude_d
     return out
 
 setup(name='docassemble.AssemblyLine',
-      version='4.1.0',
+      version='4.2.0',
       description=(''),
       long_description='# Suffolk LIT Lab Document Assembly Line\r\n\r\n[![PyPI version](https://badge.fury.io/py/docassemble-AssemblyLine.svg)](https://badge.fury.io/py/docassemble-AssemblyLine)\r\n\r\n<img src="https://user-images.githubusercontent.com/7645641/142245862-c2eb02ab-3090-4e97-9653-bb700bf4c54d.png" alt="drawing" width="300" alt="work together" style="align: center;"/>\r\n\r\nThe Assembly Line Project is a collection of volunteers, students, and institutions who joined together\r\nduring the COVID-19 pandemic to help increase access to the court system. Our vision is mobile-friendly,\r\neasy to use **guided** online forms that help empower litigants to access the court remotely.\r\n\r\nOur signature project is [CourtFormsOnline.org](https://courtformsonline.org).\r\n\r\nWe designed a step-by-step, assembly line style process for automating court forms on top of Docassemble\r\nand built several tools along the way that **you** can use in your home jurisdiction.\r\n\r\nThis package contains **runtime code** and **pre-written questions** to support authoring robust, \r\nconsistent, and attractive Docassemble interviews that help complete court forms.\r\n\r\nRead more on our [documentation page](https://suffolklitlab.org/docassemble-AssemblyLine-documentation/).\r\n\r\n\r\n# Related repositories\r\n\r\n* https://github.com/SuffolkLitLab/docassemble-ALWeaver\r\n* https://github.com/SuffolkLitLab/docassemble-ALMassachusetts\r\n* https://github.com/SuffolkLitLab/docassemble-MassAccess\r\n* https://github.com/SuffolkLitLab/docassemble-ALThemeTemplate\r\n* https://github.com/SuffolkLitLab/EfileProxyServer\r\n\r\n# Documentation\r\n\r\nhttps://suffolklitlab.org/docassemble-AssemblyLine-documentation/\r\n\r\n# Installation\r\n\r\n## Menu-driven installation\r\n\r\nThe recommended installation method is with the [guided installation script](https://suffolklitlab.org/docassemble-AssemblyLine-documentation/docs/installation).\r\n\r\n## Manual installation\r\n\r\nNormally you do not need to manually install the Assembly Line. Use the [installation script](https://suffolklitlab.org/docassemble-AssemblyLine-documentation/docs/installation)\r\nif you can. The instructions below are for your optional reference.\r\n\r\nThis package depends on the following configuration changes on your Docassemble server:\r\n\r\n* Ensure that [font-awesome](https://docassemble.org/docs/config.html#default%20icons) is enabled (this may be on by default:\r\n```yaml\r\ndefault icons: font awesome\r\n```\r\n* Add a [Google API key](https://docassemble.org/docs/config.html#google) that has access to:\r\n    * Google Places API\r\n    * Google Geocoding API\r\n* Add a [VoiceRSS API key](https://docassemble.org/docs/config.html#voicerss)\r\n* Add a [Twilio API key](https://docassemble.org/docs/config.html#twilio) for SMS support\r\n* Add an email account: [Mailgun](https://docassemble.org/docs/config.html#mailgun%20api) or [SendGrid](https://docassemble.org/docs/config.html#sendgrid%20api) recommended for email support\r\n* To show package update time and to enable the feedback form, add a GitHub Private Access token to your config.yml file, like this:\r\n```yaml\r\n# Needs access to create new issues on repositories\r\ngithub issues:\r\n  username: "suffolklitlab-issues"\r\n  token: "12345"\r\n# Does not need any special access to public repositories  \r\ngithub readonly:\r\n  username: "suffolklitlab-issues"\r\n  password: "45678"\r\n  type: "basic"\r\n```\r\n* If you are also using the [Assembly Line Weaver](https://github.com/SuffolkLITLab/docassemble-assemblylinewizard), you may want to set up a [Docassemble API key](https://docassemble.org/docs/api.html#manage_api) in your config.yml file to allow you to install packages automatically, like this:\r\n```yaml\r\ninstall packages api key: 12345\r\n```\r\n\r\n# Migration\r\n\r\nSee [discussion here](https://github.com/SuffolkLITLab/docassemble-AssemblyLine/issues/69)\r\n\r\n\r\n# ALDocument class\r\n\r\n## Purpose\r\n\r\nThe ALDocument class is a small utility library that makes it simpler to use the following features in an interview:\r\n\r\n* Conditional assembly of multiple, optional documents that are triggered in different ways in your interview\r\n* An addendum for PDF files that makes it simple to deal with overflow text\r\n* A customizable download screen that lists the documents in a neat table\r\n* A customizable "send" button that allows the user to email the final forms to a location of their choice\r\n\r\nHere is a small snippet that you can copy and modify that shows how to use the most important features of the ALDocument class.\r\n\r\n```\r\n---\r\nobjects:\r\n  - CRA_Motion_to_Dismiss_attachment: ALDocument.using(filename="CRA_Motion_to_Dismiss", title="Motion to Dismiss CRA", enabled=True, has_addendum=True, default_overflow_message="[See addendum]")  \r\n---\r\nobjects:\r\n  - al_user_bundle: ALDocumentBundle.using(elements=[CRA_Motion_to_Dismiss_attachment], title="Forms to download and deliver to court", filename="motion_to_dismiss_CRA.pdf")\r\n  - al_court_bundle: ALDocumentBundle.using(elements=[CRA_Motion_to_Dismiss_attachment], title="Forms to download and deliver to court", filename="motion_to_dismiss_CRA.pdf")\r\n---\r\ngeneric object: ALDocument\r\nattachment:\r\n  variable name: x.addendum\r\n  docx template file: docx_addendum.docx\r\n---\r\ncode: |\r\n  CRA_Motion_to_Dismiss_attachment.overflow_fields[\'reasons_for_request\'].overflow_trigger = 640\r\n  CRA_Motion_to_Dismiss_attachment.overflow_fields[\'reasons_for_request\'].label = "Reasons for request"\r\n  CRA_Motion_to_Dismiss_attachment.overflow_fields.gathered = True\r\n  \r\n---\r\nattachment:\r\n    variable name: CRA_Motion_to_Dismiss_attachment[i]\r\n    name: CRA Motion to Dismiss\r\n    filename: CRA_Motion_to_Dismiss\r\n    skip undefined: True\r\n    pdf template file: CRA_Motion_to_Dismiss.pdf\r\n    fields: \r\n      - "court_county": ${ trial_court.address.county }\r\n      - "docket_number": ${ docket_number }\r\n      - "user_signature": ${ users[0].signature_if_final(i) }\r\n      - "signature_date": ${ signature_date }\r\n```\r\n\r\nIt is very common to have a *contingent* document in ALDocument. If your document is contingent, remove the `enabled=True` from the object declaration, and use\r\nsome other method to "turn on" the attachment.\r\n\r\nE.g.,\r\n\r\n```\r\ncode: |\r\n  CRA_Motion_to_Dismiss_attachment.enabled = condition1 and condition2\r\n```\r\n\r\n# Changelog\r\n\r\nSee [CHANGELOG.MD](https://github.com/SuffolkLITLab/docassemble-AssemblyLine/blob/main/CHANGELOG.md)\r\n',
       long_description_content_type='text/markdown',

docassemble_assemblyline-4.1.0/docassemble/AssemblyLine/__init__.py

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