docs: Docstrings for new fields

Author: jorwoods

tableauserverclient/models/datasource_item.py

@@ -42,6 +42,9 @@ class DatasourceItem:
         specified, it will default to SiteDefault. See REST API Publish
         Datasource for more information about ask_data_enablement.
 
+    connected_workbooks_count : Optional[int]
+        The number of workbooks connected to the datasource.
+
     connections : list[ConnectionItem]
         The list of data connections (ConnectionItem) for the specified data
         source. You must first call the populate_connections method to access
@@ -69,6 +72,12 @@ class DatasourceItem:
         A Boolean value to determine if a datasource should be encrypted or not.
         See Extract and Encryption Methods for more information.
 
+    favorites_total : Optional[int]
+        The number of users who have marked the data source as a favorite.
+
+    has_alert : Optional[bool]
+        A Boolean value that indicates whether the data source has an alert.
+
     has_extracts : Optional[bool]
         A Boolean value that indicates whether the datasource has extracts.
 
@@ -77,20 +86,32 @@ class DatasourceItem:
         specific data source or to delete a data source with the get_by_id and
         delete methods.
 
+    is_published : Optional[bool]
+        A Boolean value that indicates whether the data source is published.
+
     name : Optional[str]
         The name of the data source. If not specified, the name of the published
         data source file is used.
 
+    owner: Optional[UserItem]
+        The owner of the data source.
+
     owner_id : Optional[str]
         The identifier of the owner of the data source.
 
+    project : Optional[ProjectItem]
+        The project that the data source belongs to.
+
     project_id : Optional[str]
         The identifier of the project associated with the data source. You must
         provide this identifier when you create an instance of a DatasourceItem.
 
     project_name : Optional[str]
         The name of the project associated with the data source.
 
+    server_name : Optional[str]
+        The name of the server where the data source is published.
+
     tags : Optional[set[str]]
         The tags (list of strings) that have been added to the data source.
 

tableauserverclient/models/group_item.py

@@ -44,6 +44,11 @@ class GroupItem:
         login to a site. When the mode is onSync, a license is granted for group
         members each time the domain is synced.
 
+    Attributes
+    ----------
+    user_count: Optional[int]
+        The number of users in the group.
+
     Examples
     --------
     >>> # Create a new group item

tableauserverclient/models/location_item.py

@@ -3,6 +3,20 @@
 
 
 class LocationItem:
+    """
+    Details of where an item is located, such as a personal space or project.
+
+    Attributes
+    ----------
+    id : str | None
+        The ID of the location.
+
+    type : str | None
+        The type of location, such as PersonalSpace or Project.
+
+    name : str | None
+        The name of the location.
+    """
     class Type:
         PersonalSpace = "PersonalSpace"
         Project = "Project"

tableauserverclient/models/project_item.py

@@ -38,12 +38,29 @@ class corresponds to the project resources you can access using the Tableau
 
     Attributes
     ----------
+    datasource_count : int
+        The number of data sources in the project.
+
     id : str
         The unique identifier for the project.
 
     owner_id : str
         The unique identifier for the UserItem owner of the project.
 
+    project_count : int
+        The number of projects in the project.
+
+    top_level_project : bool
+        True if the project is a top-level project.
+
+    view_count : int
+        The number of views in the project.
+
+    workbok_count : int
+        The number of workbooks in the project.
+
+    writeable : bool
+        True if the project is writeable.
     """
 
     ERROR_MSG = "Project item must be populated with permissions first."

tableauserverclient/models/user_item.py

@@ -37,6 +37,49 @@ class UserItem:
     auth_setting: str
         Required attribute for Tableau Cloud. How the user autenticates to the
         server.
+
+    Attributes
+    ----------
+    domain_name: Optional[str]
+        The name of the Active Directory domain ("local" if local authentication
+        is used).
+
+    email: Optional[str]
+        The email address of the user.
+
+    external_auth_user_id: Optional[str]
+        The unique identifier for the user in the external authentication system.
+
+    id: Optional[str]
+        The unique identifier for the user.
+
+    favorites: dict[str, list]
+        The favorites of the user. Must be populated with a call to
+        `populate_favorites()`.
+
+    fullname: Optional[str]
+        The full name of the user.
+
+    groups: Pager
+        The groups the user belongs to. Must be populated with a call to
+        `populate_groups()`.
+
+    last_login: Optional[datetime]
+        The last time the user logged in.
+
+    locale: Optional[str]
+        The locale of the user.
+
+    language: Optional[str]
+        Language setting for the user.
+
+    idp_configuration_id: Optional[str]
+        The ID of the identity provider configuration.
+
+    workbooks: Pager
+        The workbooks owned by the user. Must be populated with a call to
+        `populate_workbooks()`.
+
     """
 
     tag_name: str = "user"

tableauserverclient/models/view_item.py

@@ -40,9 +40,16 @@ class ViewItem:
         The image of the view. You must first call the `views.populate_image`
         method to access the image.
 
+    location: Optional[LocationItem], default None
+        The location of the view. The location can be a personal space or a
+        project.
+
     name: Optional[str], default None
         The name of the view.
 
+    owner: Optional[UserItem], default None
+        The owner of the view.
+
     owner_id: Optional[str], default None
         The ID for the owner of the view.
 
@@ -54,6 +61,9 @@ class ViewItem:
         The preview image of the view. You must first call the
         `views.populate_preview_image` method to access the preview image.
 
+    project: Optional[ProjectItem], default None
+        The project that contains the view.
+
     project_id: Optional[str], default None
         The ID for the project that contains the view.
 
@@ -66,9 +76,11 @@ class ViewItem:
     updated_at: Optional[datetime], default None
         The date and time when the view was last updated.
 
+    workbook: Optional[WorkbookItem], default None
+        The workbook that contains the view.
+
     workbook_id: Optional[str], default None
         The ID for the workbook that contains the view.
-
     """
 
     def __init__(self) -> None:

tableauserverclient/models/workbook_item.py

@@ -54,20 +54,41 @@ class as arguments. The workbook item specifies the project.
     created_at : Optional[datetime.datetime]
         The date and time the workbook was created.
 
+    default_view_id : Optional[str]
+        The identifier for the default view of the workbook.
+
     description : Optional[str]
         User-defined description of the workbook.
 
+    encrypt_extracts : Optional[bool]
+        Indicates whether extracts are encrypted.
+
+    has_extracts : Optional[bool]
+        Indicates whether the workbook has extracts.
+
     id : Optional[str]
        The identifier for the workbook. You need this value to query a specific
        workbook or to delete a workbook with the get_by_id and delete methods.
 
+    last_published_at : Optional[datetime.datetime]
+        The date and time the workbook was last published.
+
+    location : Optional[LocationItem]
+        The location of the workbook, such as a personal space or project.
+
+    owner : Optional[UserItem]
+        The owner of the workbook.
+
     owner_id : Optional[str]
         The identifier for the owner (UserItem) of the workbook.
 
     preview_image : bytes
         The thumbnail image for the view. You must first call the
         workbooks.populate_preview_image method to access this data.
 
+    project: Optional[ProjectItem]
+        The project that contains the workbook.
+
     project_name : Optional[str]
         The name of the project that contains the workbook.