Adding Folder query param support and setting background image to none (

#371)

* Setting background image to none

* Adding query param support for Folders

* fixing tests and formatting

nylas/models/application_details.py

@@ -1,4 +1,4 @@
-from dataclasses import dataclass
+from dataclasses import dataclass, field
 from typing import Literal, Optional, List
 
 from dataclasses_json import dataclass_json
@@ -48,7 +48,7 @@ class HostedAuthentication:
         spacing: CSS spacing attribute in px.
     """
 
-    background_image_url: str
+    background_image_url: Optional[str] = None
     alignment: Optional[str] = None
     color_primary: Optional[str] = None
     color_secondary: Optional[str] = None
@@ -80,4 +80,4 @@ class ApplicationDetails:
     environment: Environment
     branding: Branding
     hosted_authentication: Optional[HostedAuthentication] = None
-    callback_uris: List[RedirectUri] = None
+    callback_uris: List[RedirectUri] = field(default_factory=list)

nylas/models/folders.py

@@ -4,6 +4,8 @@
 from dataclasses_json import dataclass_json
 from typing_extensions import TypedDict, NotRequired
 
+from nylas.models.list_query_params import ListQueryParams
+
 
 @dataclass_json
 @dataclass
@@ -75,3 +77,14 @@ class UpdateFolderRequest(TypedDict):
     parent_id: NotRequired[str]
     background_color: NotRequired[str]
     text_color: NotRequired[str]
+
+
+class ListFolderQueryParams(ListQueryParams):
+    """
+    Interface representing the query parameters for listing folders.
+
+    Attributes:
+        parent_id: (Microsoft and EWS only.) Use the ID of a folder to find all child folders it contains.
+    """
+
+    parent_id: NotRequired[str]

nylas/resources/folders.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from nylas.config import RequestOverrides
 from nylas.handler.api_resources import (
     ListableApiResource,
@@ -10,6 +12,7 @@
     Folder,
     CreateFolderRequest,
     UpdateFolderRequest,
+    ListFolderQueryParams,
 )
 from nylas.models.response import Response, ListResponse, DeleteResponse
 
@@ -30,13 +33,15 @@ class Folders(
     def list(
         self,
         identifier: str,
+        query_params: Optional[ListFolderQueryParams] = None,
         overrides: RequestOverrides = None,
     ) -> ListResponse[Folder]:
         """
         Return all Folders.
 
         Args:
             identifier: The identifier of the Grant to act upon.
+            query_params: The query parameters to include in the request.
             overrides: The request overrides to use.
 
         Returns:
@@ -46,6 +51,7 @@ def list(
         return super().list(
             path=f"/v3/grants/{identifier}/folders",
             response_type=Folder,
+            query_params=query_params,
             overrides=overrides,
         )
 

tests/resources/test_folders.py

@@ -38,7 +38,7 @@ def test_folder_deserialization(self):
     def test_list_folders(self, http_client_list_response):
         folders = Folders(http_client_list_response)
 
-        folders.list(identifier="abc-123")
+        folders.list(identifier="abc-123",query_params=None)
 
         http_client_list_response._execute.assert_called_once_with(
             "GET", "/v3/grants/abc-123/folders", None, None, None, overrides=None