docassemble.AssemblyLine 3.4.0__tar.gz → 3.5.0__tar.gz

{docassemble_assemblyline-3.4.0/docassemble.AssemblyLine.egg-info → docassemble_assemblyline-3.5.0}/PKG-INFO

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

docassemble_assemblyline-3.5.0/docassemble/AssemblyLine/__init__.py

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

{docassemble_assemblyline-3.4.0 → docassemble_assemblyline-3.5.0}/docassemble/AssemblyLine/al_general.py

@@ -116,6 +116,7 @@ class ALAddress(Address):
         allow_no_address: bool = False,
         ask_if_impounded: Optional[bool] = False,
         maxlengths: Optional[Dict[str, int]] = None,
+        required: Optional[Dict[str, bool]] = None,
     ) -> List[Dict[str, Any]]:
         """
         Return a YAML structure representing the list of fields for the object's address.
@@ -136,6 +137,7 @@ class ALAddress(Address):
             allow_no_address (bool): Allow users to specify they don't have an address. Defaults to False.
             ask_if_impounded (Optional[bool]): Whether to ask if the address is impounded. Defaults to False.
             maxlengths (Optional[Dict[str, int]]): A dictionary of field names and their maximum lengths. Defaults to None.
+            required (Dict[str, bool], optional): A dictionary of field names and if they should be required. Default is None (everything but unit and zip is required)
 
         Returns:
             List[Dict[str, Any]]: A list of dictionaries representing address fields.
@@ -277,6 +279,11 @@ class ALAddress(Address):
                 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 formatted_unit(
@@ -819,7 +826,14 @@ class ALPeopleList(DAList):
             str: Formatted string of full names.
         """
         return comma_and_list(
-            [person.name.full(middle="full") for person in self],
+            [
+                (
+                    person.name_full()
+                    if isinstance(person, ALIndividual)
+                    else person.name.full(middle="full")
+                )
+                for person in self
+            ],
             comma_string=comma_string,
             and_string=and_string,
         )
@@ -1234,6 +1248,7 @@ class ALIndividual(Individual):
         allow_no_address: bool = False,
         ask_if_impounded: bool = False,
         maxlengths: Optional[Dict[str, int]] = None,
+        required: Optional[Dict[str, bool]] = None,
     ) -> List[Dict[str, str]]:
         """
         Generate field prompts for capturing an address.
@@ -1247,6 +1262,7 @@ class ALIndividual(Individual):
             allow_no_address (bool): Whether to permit entries with no address. Defaults to False.
             ask_if_impounded (bool): Whether to ask if the address is impounded. Defaults to False.
             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 (everything but unit and zip is required)
 
         Returns:
             List[Dict[str, str]]: A list of dictionaries with field prompts for addresses.
@@ -1262,6 +1278,7 @@ class ALIndividual(Individual):
             allow_no_address=allow_no_address,
             ask_if_impounded=ask_if_impounded,
             maxlengths=maxlengths,
+            required=required,
         )
 
     def gender_fields(
@@ -1604,8 +1621,9 @@ class ALIndividual(Individual):
         else:
             if isinstance(self.address, ALAddress):
                 return (
-                    "[FLUSHLEFT] "
-                    + self.name.full()
+                    "[FLUSHLEFT] " + self.name_full()
+                    if isinstance(self, ALIndividual)
+                    else self.name.full(middle="full")
                     + " [NEWLINE] "
                     + self.address.block(
                         language=language,
@@ -1617,8 +1635,9 @@ class ALIndividual(Individual):
                 )
             else:
                 return (
-                    "[FLUSHLEFT] "
-                    + self.name.full()
+                    "[FLUSHLEFT] " + self.name_full()
+                    if isinstance(self, ALIndividual)
+                    else self.name.full(middle="full")
                     + " [NEWLINE] "
                     + self.address.block(
                         language=language,
@@ -2003,9 +2022,18 @@ class ALIndividual(Individual):
     def name_full(self) -> str:
         """Returns the individual's full name.
 
+        If the person has the attribute person_type and it is defined
+        as either `business` or `organization`, it will only return
+        the first name, even if middle, last, or suffix are defined.
+
         Returns:
-            str: The individual's full name.
+            str: The individual or business's full name.
         """
+        if hasattr(self, "person_type") and self.person_type in [
+            "business",
+            "organization",
+        ]:
+            return self.name.first
         return self.name.full(middle="full")
 
     def name_initials(self) -> str:
@@ -2014,9 +2042,18 @@ class ALIndividual(Individual):
         Equivalent to `name.full(middle="initial")`, which is also the default.
         Defined only to make it possible to be explicit about the name form.
 
+        If the person has the attribute person_type and it is defined
+        as either `business` or `organization`, it will only return
+        the "initials" of the first name, even if middle, last, or suffix are defined.
+
         Returns:
             str: The individual's name with the middle name as an initial.
         """
+        if hasattr(self, "person_type") and self.person_type in [
+            "business",
+            "organization",
+        ]:
+            return self.name.first
         return self.name.full(middle="initial")
 
     def name_short(self) -> str:
@@ -2025,9 +2062,18 @@ class ALIndividual(Individual):
 
         Equivalent to self.name.firstlast()
 
+        If the person has the attribute person_type and it is defined
+        as either `business` or `organization`, it will only return
+        the first name, even if middle, last, or suffix are defined.
+
         Returns:
             str: The individual'
         """
+        if hasattr(self, "person_type") and self.person_type in [
+            "business",
+            "organization",
+        ]:
+            return self.name.first
         return self.name.firstlast()
 
     def familiar(
@@ -2051,6 +2097,10 @@ class ALIndividual(Individual):
         * the default value, e.g., "the minor", if provided
         * the full name
 
+        If the person has the attribute `person_type` and it is defined
+        as either `business` or `organization`, it will only return
+        the first name, even if middle, last, or suffix are defined.
+
         Args:
             unique_names (Optional[List[Any]]): A list of unique names to compare against. Defaults to None.
             default (Optional[str]): The default name to return if no unique name is found. Defaults to None.
@@ -2063,6 +2113,12 @@ class ALIndividual(Individual):
             Who do you want to take care of ${ children.familiar(unique_names=parents + petitioners, default="the minor") }
             ```
         """
+        if hasattr(self, "person_type") and self.person_type in [
+            "business",
+            "organization",
+        ]:
+            return self.name.first
+
         if unique_names is None:
             unique_names = []
 
@@ -2113,6 +2169,28 @@ class ALIndividual(Individual):
             return default
         return self.name_full()  # We tried but couldn't disambiguate
 
+    def __str__(self) -> str:
+        """
+        Returns a string representation of the individual, which is their full name with the
+        middle name shortened to one letter.
+
+        If the individual has the attribute `person_type` and it is defined
+        as either `business` or `organization`, it will only return
+        the first name, even if middle, last, or suffix are defined.
+
+        Returns:
+            str: The individual's name.
+        """
+        if hasattr(self, "person_type") and self.person_type in [
+            "business",
+            "organization",
+        ]:
+            return self.name.first
+
+        return (
+            super().__str__()
+        )  # This will call the parent's __str__ method, which returns the full name with middle initial
+
 
 # (DANav isn't in public DA API, but currently in functions.py)
 def section_links(nav) -> List[str]:  # type: ignore

{docassemble_assemblyline-3.4.0 → docassemble_assemblyline-3.5.0}/docassemble/AssemblyLine/sessions.py

@@ -1614,7 +1614,7 @@ def get_filenames_having_sessions(
     conn = variables_snapshot_connection()
     if user_id is None:
         if user_logged_in():
-            user_id = current_context().id
+            user_id = user_info().id
         else:
             log("Asked to get interview list for user that is not logged in")
             return []
@@ -1623,7 +1623,7 @@ def get_filenames_having_sessions(
         if user_has_privilege(global_search_allowed_roles):
             user_id = None
         elif user_logged_in():
-            user_id = current_context().id
+            user_id = user_info().id
             log(
                 f"User {user_info().email} does not have permission to list interview sessions belonging to other users"
             )

{docassemble_assemblyline-3.4.0 → docassemble_assemblyline-3.5.0}/docassemble/AssemblyLine/test_al_general.py

@@ -12,6 +12,23 @@ class test_aladdress(unittest.TestCase):
         addr = ALAddress(address="", city="")
         self.assertEqual(addr.on_one_line(), "")
 
+    def test_address_required(self):
+        addr = ALAddress(
+            address_label="address",
+            unit_label="unit",
+            city_label="city",
+            state_label="state",
+            zip_label="zip",
+        )
+        fields = addr.address_fields(required={"zip": True})
+        for field in fields:
+            if field["field"] == "zip":
+                self.assertTrue(field["required"])
+        fields = addr.address_fields()
+        for field in fields:
+            if field["field"] == "zip":
+                self.assertFalse(field["required"])
+
     def test_no_unit_floor_room(self):
         self.assertFalse(hasattr(self.addr, "unit"))
         self.assertFalse(hasattr(self.addr, "floor"))
@@ -436,6 +453,14 @@ class TestALIndividual(unittest.TestCase):
         self.assertEqual(self.individual.name_initials(), "John J. Jingleheimer")
         self.assertEqual(self.individual.name_short(), "John Jingleheimer")
 
+        self.individual.person_type = "business"
+        self.individual.name.first = "Johnny's Sandwiches"
+
+        self.assertEqual(self.individual.name_full(), "Johnny's Sandwiches")
+        self.assertEqual(self.individual.name_initials(), "Johnny's Sandwiches")
+        self.assertEqual(self.individual.name_short(), "Johnny's Sandwiches")
+        self.assertEqual(str(self.individual), "Johnny's Sandwiches")
+
 
 class test_get_visible_al_nav_items(unittest.TestCase):
     def test_case_1(self):

{docassemble_assemblyline-3.4.0 → docassemble_assemblyline-3.5.0/docassemble.AssemblyLine.egg-info}/PKG-INFO

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

{docassemble_assemblyline-3.4.0 → docassemble_assemblyline-3.5.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='3.4.0',
+      version='3.5.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-3.4.0/docassemble/AssemblyLine/__init__.py

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