docassemble.AssemblyLine 4.4.0__tar.gz → 4.5.1__tar.gz

docassemble_assemblyline-4.5.1/MANIFEST.in

@@ -0,0 +1,17 @@
+include README.md
+graft docassemble/AssemblyLine/data
+recursive-exclude * *.egg-info
+recursive-exclude .git *
+recursive-exclude venv *
+recursive-exclude .github *
+recursive-exclude .pytest_cache *
+recursive-exclude .vscode *
+recursive-exclude build *
+recursive-exclude dist *
+recursive-exclude * __pycache__
+recursive-exclude * *.pyc
+recursive-exclude * *.pyo
+recursive-exclude * *.orig
+recursive-exclude * *~
+recursive-exclude * *.bak
+recursive-exclude * *.swp

{docassemble_assemblyline-4.4.0/docassemble.AssemblyLine.egg-info → docassemble_assemblyline-4.5.1}/PKG-INFO

@@ -1,9 +1,7 @@
 Metadata-Version: 2.4
 Name: docassemble.AssemblyLine
-Version: 4.4.0
+Version: 4.5.1
 Summary: Quickly go from a paper court form to a runnable, guided, step-by-step web application powered by Docassemble. Swap out branding and pre-built questions to meet your needs.
-Home-page: https://courtformsonline.org
-Author: Suffolk Legal Innovation and Technology Lab
 Author-email: Suffolk Legal Innovation and Technology Lab <litlab@suffolk.edu>
 License-Expression: MIT
 Project-URL: Homepage, https://courtformsonline.org
@@ -11,8 +9,6 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: docassemble.ALToolbox>=0.16.0
 Requires-Dist: docassemble.GitHubFeedbackForm>=0.4.1.1
-Dynamic: author
-Dynamic: home-page
 Dynamic: license-file
 
 # Suffolk LIT Lab Document Assembly Line

docassemble_assemblyline-4.5.1/docassemble/AssemblyLine/__init__.py

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

{docassemble_assemblyline-4.4.0 → docassemble_assemblyline-4.5.1}/docassemble/AssemblyLine/al_document.py

@@ -945,6 +945,15 @@ class ALDocument(DADict):
           instance. These values will be used to detect and handle overflow.
         has_addendum (bool): (optional) Defaults to False. Set to True if the
           document could have overflow, like for a PDF template.
+        default_overflow_message (str): The message appended to truncated text when it overflows
+          to the addendum. Defaults to `"..."`. This is used as the fallback whenever
+          `overflow_message=None` is passed to :meth:`safe_value`,
+          :meth:`overflow_value`, or :meth:`original_or_overflow_message`.
+          Override per-document by setting `my_doc.default_overflow_message`.
+        suffix_to_append (str): When the document key matches this value, it is appended to
+          the output filename to distinguish it from other versions. Defaults to `"preview"`
+          so the preview version is saved as e.g. `myDoc_preview.pdf` while the final
+          version is saved as `myDoc.pdf`.
 
     Note:
         The `enabled` attribute should always be defined by a code block or the
@@ -1099,6 +1108,7 @@ class ALDocument(DADict):
 
         if isinstance(main_doc, DAFileCollection):
             main_doc = main_doc.pdf
+        if isinstance(main_doc, DAFile):
             main_doc.title = self.title
             main_doc.filename = filename
             try:
@@ -1254,6 +1264,8 @@ class ALDocument(DADict):
         Args:
             field_name (str): The name of the field to check.
             overflow_message (str): A short message to go on the page where text is cutoff.
+                If `None`, falls back to `self.default_overflow_message`
+                (`"..."` by default).
             input_width (int): The width, in characters, of the input box. Defaults to 80.
             preserve_newlines (bool): Determines whether newlines are preserved in the "safe" text.
                 Defaults to False, which means all newlines are removed. This allows more text to appear
@@ -1292,7 +1304,9 @@ class ALDocument(DADict):
 
         Args:
             field_name (str): The name of the field to retrieve the safe value from.
-            overflow_message (Optional[str]): Message to display when the field value overflows. Defaults to the class's default overflow message.
+            overflow_message (Optional[str]): Message appended when the field value is truncated.
+                If `None`, falls back to `self.default_overflow_message`
+                (`"..."` by default).
             preserve_newlines (bool): Whether to maintain newlines in the output. Defaults to False.
             input_width (int): The expected input width, used for formatting. Defaults to 80.
             preserve_words (bool): Whether to avoid splitting words during formatting. Defaults to True.
@@ -1322,7 +1336,9 @@ class ALDocument(DADict):
 
         Args:
             field_name (str): The name of the field to retrieve the overflow value from.
-            overflow_message (Optional[str]): Message to display when the field value overflows. Defaults to the object's default overflow message.
+            overflow_message (Optional[str]): Message appended when the safe portion of the field
+                value is truncated. If `None`, falls back to `self.default_overflow_message`
+                (`"..."` by default).
             preserve_newlines (bool): Whether to maintain newlines in the output. Defaults to False.
             input_width (int): The expected input width, used for formatting. Defaults to 80.
             preserve_words (bool): Whether to avoid splitting words during formatting. Defaults to True.
@@ -1548,7 +1564,62 @@ class ALDocumentBundle(DAList):
         enabled (bool, optional): Determines if the bundle is active. Defaults to True.
         auto_gather (bool, optional): Automatically gathers attributes. Defaults to False.
         gathered (bool, optional): Specifies if attributes have been gathered. Defaults to True.
-        default_parity (Optional[Literal["even", "odd"]]): Default parity to enforce on the PDF. Defaults to None.
+        default_parity (Optional[Literal["even", "odd"]]): Default parity to enforce on the PDF.
+            When set, :meth:`as_pdf` will append a blank page if necessary to reach the desired
+            parity. Defaults to `None` (no enforcement).
+        suffix_to_append (str): When the document key matches this value, it is appended to the
+            output filename to distinguish it from other versions. Defaults to `"preview"`
+            so the preview bundle is saved as e.g. `bundle_preview.pdf` while the final is
+            saved as `bundle.pdf`.
+        view_label (DALazyTemplate): Template providing the label for "View" buttons in
+            :meth:`download_list_html`. Defined generically in `ql_baseline.yml`; resolves to
+            `"View"` (or its translation). Override by assigning a new template to
+            `your_bundle.view_label` in your interview YAML.
+        download_label (DALazyTemplate): Template providing the label for "Download" buttons in
+            :meth:`download_list_html`. Defined generically in `ql_baseline.yml`; resolves to
+            `"Download"` (or its translation).
+        send_label (DALazyTemplate): Template providing the label for "Send" buttons in
+            :meth:`download_list_html`, :meth:`send_email_table_row`, and
+            :meth:`send_button_to_html`. Defined generically in `ql_baseline.yml`; resolves to
+            `"Send"` (or its translation).
+        zip_label (DALazyTemplate): Template providing the label for the "Download all" zip
+            button in :meth:`download_list_html`. Defined generically in `al_document.yml`;
+            resolves to `"Download all"` (or its translation).
+        full_pdf_label (DALazyTemplate): Template providing the label for the "Download as one
+            PDF" button in :meth:`download_list_html`. Defined generically in
+            `al_document.yml`; resolves to `"Download as one PDF"` (or its translation).
+        send_email_template (DALazyTemplate): Template used as the default email subject and
+            body in :meth:`send_email` when `template=None`. Defined generically in
+            `al_document.yml`. The subject defaults to
+            `"Your <document> document from <app> is ready"` and the body to
+            `"Your document is attached. Visit <homepage> to learn more."`
+            Override by assigning a new template block to `your_bundle.send_email_template`
+            in your interview YAML.
+        get_email_copy (DALazyTemplate): Template providing the header text for the email input
+            section rendered by :meth:`send_button_html`. Defined generically in
+            `al_document.yml`; resolves to `"Get a copy of the documents in email"`
+            (or its translation).
+        include_editable_documents (DALazyTemplate): Template providing the label for the
+            "include editable copy" checkbox in :meth:`send_button_html`. Defined generically
+            in `al_document.yml`; resolves to `"Include an editable copy"`
+            (or its translation).
+        add_page_numbers (bool): If `True`, Bates-style page numbers are stamped onto the
+            merged PDF produced by :meth:`as_pdf`. Defaults to `False`.
+        page_number_prefix (str): Text prepended to each stamped page number (e.g. `"EX-"`).
+            Defaults to `""`.
+        page_number_start (int): The first page number used when stamping page numbers.
+            Defaults to `1`.
+        page_number_digits (int): Minimum number of digits in each stamped page number;
+            shorter numbers are left-padded with zeros. Defaults to `5`.
+        page_number_area (Optional[str]): Location on the page where numbers are stamped.
+            Accepted values: `"TOP_LEFT"`, `"TOP_RIGHT"`, `"BOTTOM_LEFT"`,
+            `"BOTTOM_RIGHT"`. Defaults to `None` (bottom-right).
+        page_number_font_size (float): Font size in points for stamped page numbers.
+            Defaults to `10`.
+        page_number_offset_horizontal (float): Horizontal inset in pixels from the nearest
+            page edge for stamped page numbers. Defaults to `15`.
+        page_number_offset_vertical (float): Vertical inset in pixels from the nearest page
+            edge for stamped page numbers. Defaults to `15`.
 
     Examples:
         Given three documents: `Cover page`, `Main motion form`, and `Notice of Interpreter Request`,
@@ -1581,6 +1652,7 @@ class ALDocumentBundle(DAList):
             self.auto_gather = False
         if "gathered" not in kwargs:
             self.gathered = True
+        self._set_default_attributes()
         self.initializeAttribute("cache", DALazyAttribute)
         self.always_enabled = hasattr(self, "enabled") and self.enabled
         # Pre-cache some DALazyTemplates we set up to aid translation that won't
@@ -1589,6 +1661,24 @@ class ALDocumentBundle(DAList):
             # When the key is "preview", append it to the file name
             self.suffix_to_append = "preview"
 
+    def _set_default_attributes(self) -> None:
+        if not hasattr(self, "add_page_numbers"):
+            self.add_page_numbers = False
+        if not hasattr(self, "page_number_prefix"):
+            self.page_number_prefix = ""
+        if not hasattr(self, "page_number_start"):
+            self.page_number_start = 1
+        if not hasattr(self, "page_number_digits"):
+            self.page_number_digits = 5
+        if not hasattr(self, "page_number_area"):
+            self.page_number_area = None
+        if not hasattr(self, "page_number_font_size"):
+            self.page_number_font_size = 10
+        if not hasattr(self, "page_number_offset_horizontal"):
+            self.page_number_offset_horizontal = 15
+        if not hasattr(self, "page_number_offset_vertical"):
+            self.page_number_offset_vertical = 15
+
     def as_pdf(
         self,
         key: str = "final",
@@ -1641,13 +1731,31 @@ class ALDocumentBundle(DAList):
                 pdfa=pdfa,
                 append_matching_suffix=append_matching_suffix,
             )
+            bundle_filename = f"{base_name(self.filename)}{append_suffix}.pdf"
             pdf.title = self.title
+            pdf.filename = bundle_filename
+            try:
+                pdf.set_attributes(filename=bundle_filename)
+                pdf.set_mimetype("application/pdf")
+            except:
+                pass
         else:
             pdf = pdf_concatenate(
                 [document.as_pdf(key=key, refresh=refresh) for document in files],
                 filename=f"{base_name(self.filename)}{append_suffix}.pdf",
                 pdfa=pdfa,
             )
+        if hasattr(self, "add_page_numbers") and self.add_page_numbers:
+            self._set_default_attributes()
+            pdf.bates_number(
+                prefix=self.page_number_prefix,
+                start=self.page_number_start,
+                digits=self.page_number_digits,
+                area=self.page_number_area,
+                font_size=self.page_number_font_size,
+                offset_horizontal=self.page_number_offset_horizontal,
+                offset_vertical=self.page_number_offset_vertical,
+            )
         pdf.title = self.title
         setattr(self.cache, safe_key, pdf)
 
@@ -2034,13 +2142,21 @@ class ALDocumentBundle(DAList):
             refresh (bool): Flag to reconsider the 'enabled' attribute, default is True.
             pdfa (bool): Flag to return documents in PDF/A format, default is False.
             include_zip (bool): Flag to include a zip option, default is True.
-            view_label (str): Label for the 'view' button, default is self.view_label or "View".
+            view_label (str): Label for the 'view' button. If `None`, falls back to
+                `self.view_label` (a translatable template defined in `ql_baseline.yml`,
+                defaulting to `"View"`).
             view_icon (str): Icon for the 'view' button, default is "eye".
-            download_label (str): Label for the 'download' button, default is self.download_label or "Download".
+            download_label (str): Label for the 'download' button. If `None`, falls back to
+                `self.download_label` (a translatable template defined in `ql_baseline.yml`,
+                defaulting to `"Download"`).
             download_icon (str): Icon for the 'download' button, default is "download".
-            send_label (str): Label for the 'send' button. Default is self.send_label or "Send".
+            send_label (str): Label for the 'send' button. If `None`, falls back to
+                `self.send_label` (a translatable template defined in `ql_baseline.yml`,
+                defaulting to `"Send"`).
             send_icon (str): Fontawesome icon for the 'send' button. Default is "envelope".
-            zip_label (Optional[str]): Label for the zip option. If not provided, uses the generic template for `self.zip_label` ("Download all").
+            zip_label (Optional[str]): Label for the zip button. If `None`, falls back to
+                `self.zip_label` (a translatable template defined in `al_document.yml`,
+                defaulting to `"Download all"`).
             zip_icon (str): Icon for the zip option, default is "file-archive".
             zip_row_label (str, optional): Text to go in the left-most column
                 of the table's zip row. Will default to the value of `self.title`.
@@ -2266,7 +2382,9 @@ class ALDocumentBundle(DAList):
 
         Args:
             key (str): A key used to identify which version of the ALDocument to send. Defaults to "final".
-            send_label (str): Label for the 'send' button. Default is "Send".
+            send_label (str): Label for the 'send' button. If `None`, falls back to
+                `self.send_label` (a translatable template defined in `ql_baseline.yml`,
+                defaulting to `"Send"`).
             send_icon (str): Icon for the 'send' button. Default is "envelope".
 
         Returns:
@@ -2330,7 +2448,9 @@ class ALDocumentBundle(DAList):
             email (str): The recipient's email address.
             editable (bool, optional): Flag indicating if the bundle is editable. Defaults to False. (deprecated; use preferred_formats instead)
             template_name (str, optional): The name of the template to be used. Defaults to an empty string.
-            label (str, optional): The label for the button. Defaults to "Send".
+            label (str, optional): The label for the button. If `None`, falls back to
+                `self.send_label` (a translatable template defined in `ql_baseline.yml`,
+                defaulting to `"Send"`).
             icon (str, optional): The Fontawesome icon for the button. Defaults to "envelope".
             color (str, optional): The Bootstrap color of the button. Defaults to "primary".
             key (str, optional): A key used to identify which version of the ALDocument to send. Defaults to "final".
@@ -2385,6 +2505,7 @@ class ALDocumentBundle(DAList):
         label: str = "Send",
         icon: str = "envelope",
         preferred_formats: Optional[Union[str, List[str]]] = None,
+        email_legend_class: str = "h4",
     ) -> str:
         """
         Generate HTML for an input box and button that allows someone to send the bundle
@@ -2404,6 +2525,8 @@ class ALDocumentBundle(DAList):
             icon (str, optional): The Fontawesome icon for the button. Defaults
                 to "envelope".
             preferred_formats (Optional[Union[str,List[str]]], optional): A list of allowed formats for the document. Defaults to "pdf" if not specified.
+            email_legend_class (str, optional): CSS class applied to the email
+                section legend. Defaults to "h4".
 
         Returns:
             str: The generated HTML string for the input box and button.
@@ -2443,7 +2566,7 @@ class ALDocumentBundle(DAList):
         # Container of whole email section with header
         return_str = f"""
   <fieldset class="al_send_bundle al_send_section_alone {html_safe_str(self.instanceName)}" id="al_send_bundle_{name}" name="al_send_bundle_{name}">
-    <legend class="h4 al_doc_email_header">{str(self.get_email_copy)}</legend> 
+    <legend class="{email_legend_class} al_doc_email_header">{str(self.get_email_copy)}</legend> 
     """
         # "Editable" checkbox
         if (
@@ -2495,7 +2618,14 @@ class ALDocumentBundle(DAList):
             to (Any): The email address, list of email addresses, or list of Individuals with a .email attribute to send to.
             key (str, optional): Specifies which version of the document to send. Defaults to "final".
             editable (bool, optional): If True, sends the editable documents. Defaults to False. (Deprecated)
-            template (Any): The template variable for the subject and body of the email, similar to da `send_email` `template` variable.
+            template (Any, optional): The template variable for the subject and body of the email,
+                similar to the `template` parameter of docassemble's `send_email` function.
+                If `None`, falls back to `self.send_email_template`, a template defined
+                generically in `al_document.yml`. Its subject defaults to
+                `"Your <document> document from <app> is ready"` and its body to
+                `"Your document is attached. Visit <homepage> to learn more."`
+                Override it by assigning a new template block to `your_bundle.send_email_template`
+                in your interview YAML.
             preferred_formats (str): Specifies the format of the files to send. Can be "pdf" or "docx", or a list of these formats. Overrides deprecated `editable` keyword.
             **kwargs: Additional parameters to pass to the da `send_email` function.
 
@@ -2735,9 +2865,14 @@ class ALExhibit(DAObject):
         self,
         *,
         refresh: bool = False,
-        prefix: str = "",
         pdfa: bool = False,
         add_page_numbers: bool = True,
+        page_number_prefix: str = "",
+        page_number_digits: int = 5,
+        page_number_area=None,
+        page_number_font_size: float = 10,
+        page_number_offset_horizontal: float = 15,
+        page_number_offset_vertical: float = 15,
         add_cover_page: bool = True,
         filename: Optional[str] = None,
         append_matching_suffix: bool = True,
@@ -2749,9 +2884,14 @@ class ALExhibit(DAObject):
 
         Args:
             refresh (bool): If True, forces the exhibit to refresh before generating the PDF. (unused, provided for signature compatibility)
-            prefix (str): Prefix for Bates numbering if 'add_page_numbers' is True.
             pdfa (bool): If True, the generated PDF will be in PDF/A format.
             add_page_numbers (bool): If True, apply Bates numbering starting from 'self.start_page'.
+            page_number_prefix (str): If add_page_numbers is True, this gets added to the beginning on the bates number each page (e.g. `EX-`).
+            page_number_digits (int): How many digits (i.e. leading 0s) that the bates number will have
+            page_number_area (str): Where on the page the bates number will go ("TOP_LEFT", "TOP_RIGHT", "BOTTOM_LEFT", "BOTTOM_RIGHT" (default))
+            page_number_font_size (float): How big the bates page number will be in points (default is 10).
+            page_number_offset_horizontal (float): The number of pixels that the bates page number is offset from the left / right of the page.
+            page_number_offset_vertical (float): The number of pixels that the bates page number is offset from the top / bottom of the page.
             add_cover_page (bool): If True, prepend the exhibit with a cover page.
             filename (Optional[str]): Custom filename for the generated PDF. Default is "exhibits.pdf".
             append_matching_suffix (bool): If True, appends a suffix to the filename based on certain matching criteria.
@@ -2779,7 +2919,15 @@ class ALExhibit(DAObject):
             )
 
         if add_page_numbers:
-            concatenated_pages.bates_number(prefix=prefix, start=self.start_page)
+            concatenated_pages.bates_number(
+                start=self.start_page,
+                prefix=page_number_prefix,
+                digits=page_number_digits,
+                area=page_number_area,
+                font_size=page_number_font_size,
+                offset_horizontal=page_number_offset_horizontal,
+                offset_vertical=page_number_offset_vertical,
+            )
 
         setattr(self._cache, safe_key, concatenated_pages)
         return getattr(self._cache, safe_key)
@@ -2913,6 +3061,12 @@ class ALExhibitList(DAList):
         filename="file.pdf",
         pdfa: bool = False,
         add_page_numbers: bool = False,
+        page_number_prefix: str = "",
+        page_number_digits: int = 5,
+        page_number_area=None,
+        page_number_font_size: float = 10,
+        page_number_offset_horizontal: float = 15,
+        page_number_offset_vertical: float = 15,
         toc_pages: int = 0,
         append_matching_suffix: bool = True,
     ) -> DAFile:
@@ -2923,6 +3077,12 @@ class ALExhibitList(DAList):
             filename (str): Desired filename for the generated PDF.
             pdfa (bool): If True, generates the PDF in PDF/A format.
             add_page_numbers (bool): If True, adds page numbers to the generated PDF.
+            page_number_prefix (str): What the bates number added to each page should start with (e.g. `EX-`).
+            page_number_digits (int): How many digits (i.e. leading 0s) that the bates number will have
+            page_number_area (str): Where on the page the bates number will go ("TOP_LEFT", "TOP_RIGHT", "BOTTOM_LEFT", "BOTTOM_RIGHT" (default))
+            page_number_font_size (float): How big the bates page number will be in points (default is 10).
+            page_number_offset_horizontal (float): The number of pixels that the bates page number is offset from the left / right of the page.
+            page_number_offset_vertical (float): The number of pixels that the bates page number is offset from the top / bottom of the page.
             toc_pages (int): Expected number of pages in the table of contents.
             append_matching_suffix (bool): If True, appends matching suffix to the filename.
 
@@ -2934,12 +3094,19 @@ class ALExhibitList(DAList):
                 exhibit.cover_page
         if self.include_table_of_contents and toc_pages != 1:
             self._update_page_numbers(toc_guess_pages=toc_pages)
+        if not page_number_prefix and self.bates_prefix:
+            page_number_prefix = self.bates_prefix
         return pdf_concatenate(
             [
                 exhibit.as_pdf(
                     add_cover_page=self.include_exhibit_cover_pages,
                     add_page_numbers=add_page_numbers,
-                    prefix=self.bates_prefix,
+                    page_number_prefix=page_number_prefix,
+                    page_number_digits=page_number_digits,
+                    page_number_area=page_number_area,
+                    page_number_font_size=page_number_font_size,
+                    page_number_offset_horizontal=page_number_offset_horizontal,
+                    page_number_offset_vertical=page_number_offset_vertical,
                 )
                 for exhibit in self
             ],
@@ -3072,12 +3239,19 @@ class ALExhibitDocument(ALDocument):
     has_addendum: bool
     auto_labeler: Callable
     auto_ocr: bool
+    # Deprecated
     bates_prefix: str
     maximum_size: int
     maximum_size_per_doc: int
     suffix_to_append: str
     exhibits: ALExhibitList
     table_of_contents: DAFile
+    page_number_prefix: str
+    page_number_digits: int
+    page_number_area: str | None
+    page_number_font_size: float
+    page_number_offset_horizontal: float
+    page_number_offset_vertical: float
 
     def init(self, *pargs, **kwargs) -> None:
         """Standard DAObject init method.
@@ -3092,8 +3266,6 @@ class ALExhibitDocument(ALDocument):
             self.exhibits.auto_labeler = self.auto_labeler
         if hasattr(self, "auto_ocr"):
             self.exhibits.auto_ocr = self.auto_ocr
-        if hasattr(self, "bates_prefix"):
-            self.exhibits.bates_prefix = self.bates_prefix
         if hasattr(self, "include_exhibit_cover_pages"):
             self.exhibits.include_exhibit_cover_pages = self.include_exhibit_cover_pages
         else:
@@ -3111,13 +3283,30 @@ class ALExhibitDocument(ALDocument):
         else:
             self.include_table_of_contents = True
             self.exhibits.include_table_of_contents = True
+        if hasattr(self, "bates_prefix"):
+            self.exhibits.bates_prefix = self.bates_prefix
         if not hasattr(self, "add_page_numbers"):
             self.add_page_numbers = False
+        self._set_default_attributes()
         self.has_addendum = False
         if not hasattr(self, "suffix_to_append"):
             # When the key is "preview", append it to the file name
             self.suffix_to_append = "preview"
 
+    def _set_default_attributes(self) -> None:
+        if not hasattr(self, "page_number_prefix"):
+            self.page_number_prefix = ""
+        if not hasattr(self, "page_number_digits"):
+            self.page_number_digits = 5
+        if not hasattr(self, "page_number_area"):
+            self.page_number_area = None
+        if not hasattr(self, "page_number_font_size"):
+            self.page_number_font_size = 10
+        if not hasattr(self, "page_number_offset_horizontal"):
+            self.page_number_offset_horizontal = 15
+        if not hasattr(self, "page_number_offset_vertical"):
+            self.page_number_offset_vertical = 15
+
     def has_overflow(self) -> bool:
         """
         Check if there is any overflow in the document.
@@ -3192,12 +3381,21 @@ class ALExhibitDocument(ALDocument):
             filename = base_name(self.filename) + ".pdf"
 
         if len(self.exhibits):
+            self._set_default_attributes()
             if self.include_table_of_contents:
                 toc_pages = self.table_of_contents.num_pages()
                 return pdf_concatenate(
                     self.table_of_contents,
                     self.exhibits.as_pdf(
-                        add_page_numbers=self.add_page_numbers, toc_pages=toc_pages
+                        add_page_numbers=self.add_page_numbers,
+                        page_number_prefix=self.page_number_prefix,
+                        page_number_digits=self.page_number_digits,
+                        page_number_area=self.page_number_area,
+                        page_number_font_size=self.page_number_font_size,
+                        page_number_offset_horizontal=self.page_number_offset_horizontal,
+                        page_number_offset_vertical=self.page_number_offset_vertical,
+                        toc_pages=toc_pages,
+                        pdfa=pdfa,
                     ),
                     filename=filename,
                     pdfa=pdfa,
@@ -3205,6 +3403,12 @@ class ALExhibitDocument(ALDocument):
             else:
                 return self.exhibits.as_pdf(
                     add_page_numbers=self.add_page_numbers,
+                    page_number_prefix=self.page_number_prefix,
+                    page_number_digits=self.page_number_digits,
+                    page_number_area=self.page_number_area,
+                    page_number_font_size=self.page_number_font_size,
+                    page_number_offset_horizontal=self.page_number_offset_horizontal,
+                    page_number_offset_vertical=self.page_number_offset_vertical,
                     filename=filename,
                     pdfa=pdfa,
                 )

{docassemble_assemblyline-4.4.0 → docassemble_assemblyline-4.5.1}/docassemble/AssemblyLine/al_general.py

@@ -1914,7 +1914,7 @@ class ALIndividual(Individual):
             if len(pronouns_to_use) > 0:
                 output = "/".join(pronouns_to_use)
             else:
-                output = default
+                output = f"{default}'s {target}"
         elif hasattr(self, "person_type") and self.person_type in [
             "business",
             "organization",
@@ -1928,7 +1928,7 @@ class ALIndividual(Individual):
             else:
                 output = their(target, **kwargs)
         else:
-            output = default
+            output = f"{default}'s {target}"
 
         if "capitalize" in kwargs and kwargs["capitalize"]:
             return capitalize(output)

{docassemble_assemblyline-4.4.0 → docassemble_assemblyline-4.5.1}/docassemble/AssemblyLine/data/questions/al_language.yml

@@ -19,13 +19,16 @@ code: |
 default screen parts:
   navigation bar html: |
     % if enable_al_language and len(al_interview_languages) > 1:
-    ${ get_language_list_dropdown(al_interview_languages,current=al_user_language ) }
+    ${ get_language_list_dropdown(al_interview_languages, current=session_local.attr("al_user_language") or al_user_language ) }
     % endif
 ---
 initial: True
 code: |
   if enable_al_language:
-    set_language(al_user_language)
+    if session_local.attr("al_user_language"):
+      set_language(session_local.attr("al_user_language"))
+    else:
+      set_language(al_user_language)
   process_action()
 ---
 code: |
@@ -37,6 +40,14 @@ code: |
 ---
 event: al_change_language
 code: |
+  # Set browser-specific language for this interview session
+  if "lang" in action_arguments():
+    session_local.al_user_language = action_argument("lang")
+    set_language(session_local.al_user_language)
+---
+event: al_get_language_list_change_language
+code: |
+  # Set "global" language for this interview session instead of user-specific
   if "lang" in action_arguments():
     al_user_language = action_argument("lang")
     set_language(al_user_language)

{docassemble_assemblyline-4.4.0 → docassemble_assemblyline-4.5.1}/docassemble/AssemblyLine/data/questions/al_visual.yml

@@ -110,9 +110,16 @@ data from code:
     label: str(al_load_answer_set_string)
     hidden: not get_config('assembly line',{}).get('enable answer sets')
   - url: |
-      url_action('al_error_action_download_screen')
-    label: str(al_download_answer_set_string)
-    hidden: (not get_config('assembly line',{}).get('enable answer set imports')) or (_internal.get('steps') < 2)
+      url_ask(["al_sessions_json_file", {"recompute": ["al_sessions_import_json"]}, "al_sessions_load_status"])
+    label: str(al_import_answer_set_string)
+    hidden: |
+      not (
+        (
+          get_config('assembly line',{}).get('enable answer sets')
+          and get_config('assembly line',{}).get('enable answer set imports')
+        )
+        or (user_logged_in() and user_has_privilege('admin'))
+      )
 ---
 template: al_start_over_string
 content: >-
@@ -134,9 +141,9 @@ template: al_load_answer_set_string
 content: >-
   Load answer set
 ---
-template: al_download_answer_set_string
+template: al_import_answer_set_string
 content: >-
-  Download answer set
+  Import answer set
 ---
 event: al_exit_logout
 code: |

{docassemble_assemblyline-4.4.0 → docassemble_assemblyline-4.5.1}/docassemble/AssemblyLine/data/questions/assembly_line.yml

@@ -1,4 +1,4 @@
-# For usage, see https://suffolklitlab.org/docassemble-AssemblyLine-documentation/docs/framework/magic_variables
+# For usage, see https://assemblyline.suffolklitlab.org/docs/components/AssemblyLine/magic_variables
 ---
 include:
   - al_language.yml
@@ -19,4 +19,4 @@ modules:
   - .al_document
   - .al_courts
   - docassemble.GithubFeedbackForm.github_issue
-  
+  

{docassemble_assemblyline-4.4.0 → docassemble_assemblyline-4.5.1}/docassemble/AssemblyLine/data/questions/interview_list.yml

@@ -18,7 +18,7 @@ comment: |
       new form label: Start a new form
       new form url: https://courtformsonline.org
       logo url: null # Defaults to `app homepage`
-      logo image url: https://app.yourserver.org/packagestatic/docassemble.AssemblyLine/ma_logo.png
+      logo image url: https://app.example.org/packagestatic/docassemble.AssemblyLine/ma_logo.png
       logo image alt: Logo
       answer sets title: Answer sets
       logo title row 1: null # Defaults to `interview page title`
@@ -490,4 +490,4 @@ code: |
 event: delete_results_action
 code: |
   undefine("limit_filename")
-  undefine("search_keyword")
+  undefine("search_keyword")

{docassemble_assemblyline-4.4.0 → docassemble_assemblyline-4.5.1}/docassemble/AssemblyLine/data/questions/test_aldocument.yml

@@ -31,7 +31,7 @@ code: |
 ---
 objects:
   # No addenda, all start enabled
-  - multi_bundle_1: ALDocumentBundle.using(elements=[pdf_1, docx_1, notice_to_quit], title="Multiple docs 1", filename="multi_bundle_1" )
+  - multi_bundle_1: ALDocumentBundle.using(elements=[pdf_1, docx_1, notice_to_quit], title="Multiple docs 1", filename="multi_bundle_1", add_page_numbers=True, page_numbers_font_size=20 )
   - single_pdf_bundle_1: ALDocumentBundle.using(elements=[pdf_1], title="One pdf", filename="single_pdf_1" )
   - single_docx_bundle_1: ALDocumentBundle.using(elements=[docx_1], title="One docx", filename="single_docx_1" )
 ---
@@ -341,9 +341,9 @@ subquestion: |
 
   Send button which allows the user to edit the email address.
   
-  multi_bundle_1.send_button_html( key="test_key", show_editable_checkbox=False, label="Custom send label", icon="search" )
+  multi_bundle_1.send_button_html( key="test_key", show_editable_checkbox=False, label="Custom send label", icon="search", email_legend_class="h5" )
   
-  ${ multi_bundle_1.send_button_html( key="test_key", show_editable_checkbox=False, label="Custom send label", icon="search" ) }
+  ${ multi_bundle_1.send_button_html( key="test_key", show_editable_checkbox=False, label="Custom send label", icon="search", email_legend_class="h5" ) }
   
   ---
   single_pdf_bundle_1.send_button_html( key="test_key", show_editable_checkbox=False, label="Custom send label", icon="search" )
@@ -380,4 +380,4 @@ subquestion: |
 id: end aldocument tests
 event: end_aldocument_tests
 question: The end of ALDocument tests
----
+---

{docassemble_assemblyline-4.4.0 → docassemble_assemblyline-4.5.1}/docassemble/AssemblyLine/language.py

@@ -173,7 +173,7 @@ def get_language_list(
     current="",
     lang_codes: Optional[List[str]] = None,
     languages_path: Optional[str] = None,
-    event_name="al_change_language",
+    event_name="al_get_language_list_change_language",
 ) -> str:
     """
     Given a list of language codes, returns