anyscale 0.24.87__py3-none-any.whl → 0.24.91__py3-none-any.whl

anyscale/_private/anyscale_client/fake_anyscale_client.py

@@ -14,10 +14,16 @@ from anyscale._private.models.image_uri import ImageURI
 from anyscale._private.models.model_base import ListResponse
 from anyscale.cli_logger import BlockLogger
 from anyscale.client.openapi_client.models import (
+    AdminCreatedUser,
+    AdminCreateUser,
     Cloud,
+    CloudProviders,
     ComputeTemplateConfig,
+    CreateCloudCollaborator,
     CreateExperimentalWorkspace,
     CreateInternalProductionJob,
+    CreateResourceQuota,
+    CreateUserProjectCollaborator,
     DecoratedComputeTemplate,
     DeletedPlatformFineTunedModel,
     ExperimentalWorkspace,
@@ -26,9 +32,15 @@ from anyscale.client.openapi_client.models import (
     HaJobGoalStates,
     HaJobStates,
     InternalProductionJob,
+    MiniCloud,
+    MiniUser,
+    OrganizationCollaborator,
+    OrganizationInvitation,
+    OrganizationPermissionLevel,
     ProductionJob,
     ProductionJobStateTransition,
     Project,
+    ResourceQuota,
     WorkspaceDataplaneProxiedArtifacts,
 )
 from anyscale.client.openapi_client.models.create_schedule import CreateSchedule
@@ -133,6 +145,7 @@ class FakeAnyscaleClient(AnyscaleClientInterface):
         self._jobs: Dict[str, ProductionJob] = {}
         self._job_runs: Dict[str, List[APIJobRun]] = defaultdict(list)
         self._project_to_id: Dict[Optional[str] : Dict[Optional[str], str]] = {}
+        self._project_collaborators: Dict[str, List[CreateUserProjectCollaborator]] = {}
         self._rolled_out_model: Optional[ApplyServiceModel] = None
         self._sent_workspace_notifications: List[WorkspaceNotification] = []
         self._rolled_back_service: Optional[Tuple[str, Optional[int]]] = None
@@ -146,11 +159,14 @@ class FakeAnyscaleClient(AnyscaleClientInterface):
         self._controller_logs: Dict[str, str] = {}
         self._schedules: Dict[str, DecoratedSchedule] = {}
         self._schedule_trigger_counts: Dict[str, int] = defaultdict(int)
+        self._users: Dict[str, AdminCreatedUser] = {}
         self._workspaces: Dict[str, ExperimentalWorkspace] = {}
         self._workspaces_dependencies: Dict[str, List[str]] = {}
         self._workspaces_env_vars: Dict[str, Dict[str, str]] = {}
         self._clusters_headnode_ip: Dict[str, str] = {}
         self._clusters_ssh_key: Dict[str, SessionSshKey] = {}
+        self._organization_invitations: Dict[str, OrganizationInvitation] = {}
+        self._resource_quotas: Dict[str, ResourceQuota] = {}
 
         # Cloud ID -> Cloud.
         self._clouds: Dict[str, Cloud] = {
@@ -161,6 +177,9 @@ class FakeAnyscaleClient(AnyscaleClientInterface):
             ),
         }
 
+        # Cloud ID -> collaborators
+        self._cloud_collaborators: Dict[str, List[CreateCloudCollaborator]] = {}
+
         # Cloud ID -> default ClusterCompute.
         compute_config = ClusterCompute(
             id=self.DEFAULT_CLUSTER_COMPUTE_ID,
@@ -344,6 +363,25 @@ class FakeAnyscaleClient(AnyscaleClientInterface):
     def get_cloud(self, *, cloud_id: str) -> Optional[Cloud]:
         return self._clouds.get(cloud_id, None)
 
+    def add_cloud_collaborators(
+        self, cloud_id: str, collaborators: List[CreateCloudCollaborator]
+    ) -> None:
+        existing_collaborators = [
+            collaborator.email
+            for collaborator in self._cloud_collaborators.get(cloud_id, [])
+        ]
+
+        for collaborator in collaborators:
+            if collaborator.email in existing_collaborators:
+                raise ValueError(
+                    f"Collaborator with email '{collaborator.email}' already exists in cloud '{cloud_id}'."
+                )
+
+        if cloud_id not in self._cloud_collaborators:
+            self._cloud_collaborators[cloud_id] = collaborators
+        else:
+            self._cloud_collaborators[cloud_id].extend(collaborators)
+
     def add_compute_config(self, compute_config: DecoratedComputeTemplate) -> int:
         compute_config.version = (
             len(self._compute_config_name_to_ids[compute_config.name]) + 1
@@ -576,6 +614,28 @@ class FakeAnyscaleClient(AnyscaleClientInterface):
                     )
         return None
 
+    def add_project_collaborators(
+        self, project_id: str, collaborators: List[CreateUserProjectCollaborator]
+    ):
+        existing_collaborators = [
+            collaborator.value.email if collaborator.value else None
+            for collaborator in self._project_collaborators.get(project_id, [])
+        ]
+
+        for collaborator in collaborators:
+            if (
+                collaborator.value
+                and collaborator.value.email in existing_collaborators
+            ):
+                raise ValueError(
+                    f"Collaborator with email '{collaborator.value.email}' already exists in project '{project_id}'."
+                )
+
+        if project_id not in self._project_collaborators:
+            self._project_collaborators[project_id] = collaborators
+        else:
+            self._project_collaborators[project_id].extend(collaborators)
+
     def get_job(
         self,
         *,
@@ -905,7 +965,7 @@ class FakeAnyscaleClient(AnyscaleClientInterface):
             compute_config_id=model.compute_config_id,
             environment_id=model.cluster_environment_build_id,
             cloud_id=model.cloud_id or self.get_cloud_id(),
-            created_at=datetime.now(),
+            created_at=datetime.utcnow(),
             creator_id=self.DEFAULT_USER_ID,
             creator_email=self.DEFAULT_USER_EMAIL,
             organization_id=self.DEFAULT_ORGANIZATION_ID,
@@ -1078,3 +1138,135 @@ class FakeAnyscaleClient(AnyscaleClientInterface):
             filepath = filename
 
         return filepath
+
+    def admin_batch_create_users(
+        self, admin_create_users: List[AdminCreateUser]
+    ) -> List[AdminCreatedUser]:
+        created_users = []
+        for admin_create_user in admin_create_users:
+            if admin_create_user.email in self._users:
+                raise ValueError(
+                    f"User with email '{admin_create_user.email}' already exists."
+                )
+
+            user_id = f"user-id-{uuid.uuid4()!s}"
+            created_user = AdminCreatedUser(
+                user_id=user_id,
+                email=admin_create_user.email,
+                created_at=datetime.utcnow(),
+                name=admin_create_user.name,
+                lastname=admin_create_user.lastname,
+                title=admin_create_user.title,
+                is_sso_user=admin_create_user.is_sso_user,
+            )
+            created_users.append(created_user)
+            self._users[admin_create_user.email] = created_user
+
+        return created_users
+
+    def create_organization_invitations(
+        self, emails: List[str]
+    ) -> Tuple[List[str], List[str]]:
+        success_emails, error_messages = [], []
+        for email in emails:
+            if email in self._users:
+                error_messages.append(
+                    f"User with email {email} is already a member of your organization."
+                )
+            else:
+                orginv_id = f"orginv_{uuid.uuid4()!s}"
+                self._organization_invitations[email] = OrganizationInvitation(
+                    email=email,
+                    id=orginv_id,
+                    organization_id="org_1",
+                    created_at=datetime.utcnow(),
+                    expires_at=datetime.utcnow(),
+                )
+                success_emails.append(email)
+
+        return success_emails, error_messages
+
+    def list_organization_invitations(self) -> List[OrganizationInvitation]:
+        return list(self._organization_invitations.values())
+
+    def delete_organization_invitation(self, email: str) -> OrganizationInvitation:
+        if email not in self._organization_invitations:
+            raise ValueError(f"Invitation for email '{email}' not found.")
+
+        return self._organization_invitations.pop(email)
+
+    def get_organization_collaborator(self, email):
+        return OrganizationCollaborator(
+            id="identity_1",
+            permission_level=OrganizationPermissionLevel.COLLABORATOR,
+            name="Test User",
+            created_at=datetime.utcnow(),
+            email=email,
+            user_id="usr_1",
+        )
+
+    def create_resource_quota(
+        self, create_resource_quota: CreateResourceQuota
+    ) -> ResourceQuota:
+        resource_quota_id = f"rq_{uuid.uuid4()!s}"
+        resource_quota = ResourceQuota(
+            id=resource_quota_id,
+            name=create_resource_quota.name,
+            cloud_id=create_resource_quota.cloud_id,
+            project_id=create_resource_quota.project_id,
+            quota=create_resource_quota.quota,
+            is_enabled=True,
+            created_at=datetime.utcnow(),
+            creator=MiniUser(
+                id="user_1",
+                email="test@anyscale.com",
+                name="Test User",
+                username="testuser",
+            ),
+            cloud=MiniCloud(
+                id=create_resource_quota.cloud_id,
+                name="Test Cloud",
+                provider=CloudProviders.AWS,
+            ),
+        )
+
+        self._resource_quotas[resource_quota_id] = resource_quota
+
+        return self._resource_quotas[resource_quota_id]
+
+    def list_resource_quotas(
+        self,
+        name: Optional[str] = None,
+        cloud_id: Optional[str] = None,
+        creator_id: Optional[str] = None,
+        is_enabled: Optional[bool] = None,
+        max_items: int = 20,
+    ) -> List[ResourceQuota]:
+        results = []
+        for resource_quota in self._resource_quotas.values():
+            if name and resource_quota.name != name:
+                continue
+            if cloud_id and resource_quota.cloud_id != cloud_id:
+                continue
+            if creator_id and resource_quota.creator.id != creator_id:
+                continue
+            if is_enabled is not None and resource_quota.is_enabled != is_enabled:
+                continue
+            results.append(resource_quota)
+
+        return results[:max_items]
+
+    def delete_resource_quota(self, resource_quota_id: str) -> None:
+        if resource_quota_id not in self._resource_quotas:
+            raise ValueError(f"Resource Quota with id '{resource_quota_id}' not found.")
+
+        self._resource_quotas.pop(resource_quota_id)
+
+    def set_resource_quota_status(
+        self, resource_quota_id: str, is_enabled: bool
+    ) -> None:
+        resource_quota = self._resource_quotas.get(resource_quota_id)
+        if resource_quota is None:
+            raise ValueError(f"Resource Quota with id '{resource_quota_id}' not found.")
+
+        resource_quota.is_enabled = is_enabled

anyscale/_private/docgen/README.md

@@ -1,4 +1,4 @@
-Tool to autogenerate documentation for the Anyscale SDK/CLI that can be embedded in a [Docusarus](https://docusaurus.io/) site.
+Tool to autogenerate documentation for the Anyscale SDK/CLI that can be embedded in a [Docusarus](https://docusaurus.io/) site. If you're adding a new API reference in anyscale/product, follow this guide to see what changes you need to make: https://www.notion.so/anyscale-hq/How-to-document-new-anyscale-API-references-173027c809cb8080b8e3e53fc244d70b.
 
 This is used by: https://github.com/anyscale/docs/tree/master/docs/reference.
 

anyscale/_private/docgen/__main__.py

@@ -10,6 +10,10 @@ import anyscale
 from anyscale import scripts
 from anyscale._private.docgen.generator import MarkdownGenerator, Module
 from anyscale.aggregated_instance_usage.models import DownloadCSVFilters
+from anyscale.cloud.models import (
+    CloudPermissionLevel,
+    CreateCloudCollaborator,
+)
 from anyscale.commands import (
     aggregated_instance_usage_commands,
     cloud_commands,
@@ -22,11 +26,13 @@ from anyscale.commands import (
     logs_commands,
     machine_commands,
     machine_pool_commands,
+    organization_invitation_commands,
     project_commands,
     resource_quota_commands,
     schedule_commands,
     service_account_commands,
     service_commands,
+    user_commands,
     workspace_commands,
     workspace_commands_v2,
 )
@@ -57,6 +63,9 @@ from anyscale.llm.model.models import (
     FineTunedModel,
     FineTuningType,
 )
+from anyscale.organization_invitation.models import OrganizationInvitation
+from anyscale.project.models import CreateProjectCollaborator, ProjectPermissionLevel
+from anyscale.resource_quota.models import CreateResourceQuota, Quota, ResourceQuota
 from anyscale.schedule.models import ScheduleConfig, ScheduleState, ScheduleStatus
 from anyscale.service.models import (
     RayGCSExternalStorageConfig,
@@ -67,6 +76,7 @@ from anyscale.service.models import (
     ServiceVersionStatus,
     TracingConfig,
 )
+from anyscale.user.models import AdminCreatedUser, AdminCreateUser
 from anyscale.workspace.models import WorkspaceConfig
 
 
@@ -81,6 +91,41 @@ ALL_MODULES = [
         sdk_commands=[anyscale.aggregated_instance_usage.download_csv,],
         models=[DownloadCSVFilters],
     ),
+    Module(
+        title="User",
+        filename="user.md",
+        cli_prefix="user",
+        cli_commands=[user_commands.admin_batch_create],
+        sdk_prefix="anyscale.user",
+        sdk_commands=[anyscale.user.admin_batch_create,],
+        models=[AdminCreateUser, AdminCreatedUser],
+    ),
+    Module(
+        title="Project",
+        filename="project-api.md",
+        cli_prefix="anyscale project",
+        cli_commands=[project_commands.add_collaborators,],
+        sdk_prefix="anyscale.project",
+        sdk_commands=[anyscale.project.add_collaborators,],
+        models=[ProjectPermissionLevel, CreateProjectCollaborator],
+        legacy_cli_commands=[project_commands.create, project_commands.list,],
+        legacy_sdk_commands={
+            "create_project": None,
+            "delete_project": None,
+            "get_default_project": None,
+            "get_project": None,
+            "search_projects": None,
+            "update_project": None,
+        },
+        legacy_sdk_models=[
+            "CreateProject",
+            "Project",
+            "ProjectListResponse",
+            "ProjectResponse",
+            "ProjectsQuery",
+            "UpdateProject",
+        ],
+    ),
     Module(
         title="Job",
         filename="job-api.md",
@@ -389,10 +434,12 @@ ALL_MODULES = [
             cloud_commands.cloud_verify,
             cloud_commands.list_cloud,
             cloud_commands.cloud_config_update,
+            cloud_commands.cloud_set_default,
+            cloud_commands.add_collaborators,
         ],
         sdk_prefix="anyscale.cloud",
-        sdk_commands=[],
-        models=[],
+        sdk_commands=[anyscale.cloud.add_collaborators],
+        models=[CloudPermissionLevel, CreateCloudCollaborator],
         cli_command_group_prefix={cloud_commands.cloud_config_update: "config"},
         legacy_sdk_commands={
             # limited support, no replacement yet
@@ -568,8 +615,31 @@ ALL_MODULES = [
             resource_quota_commands.disable,
         ],
         sdk_prefix="anyscale.resource_quota",
-        sdk_commands=[],  # No SDK commands for resource quotas
-        models=[],
+        sdk_commands=[
+            anyscale.resource_quota.create,
+            anyscale.resource_quota.list,
+            anyscale.resource_quota.delete,
+            anyscale.resource_quota.enable,
+            anyscale.resource_quota.disable,
+        ],
+        models=[CreateResourceQuota, Quota, ResourceQuota],
+    ),
+    Module(
+        title="Organization Invitation",
+        filename="organization-invitation.md",
+        cli_prefix="anyscale organization-invitation",
+        cli_commands=[
+            organization_invitation_commands.create,
+            organization_invitation_commands.list,
+            organization_invitation_commands.delete,
+        ],
+        sdk_prefix="anyscale.organization-invitation",
+        sdk_commands=[
+            anyscale.organization_invitation.create,
+            anyscale.organization_invitation.list,
+            anyscale.organization_invitation.delete,
+        ],
+        models=[OrganizationInvitation],
     ),
     Module(
         title="Other",
@@ -588,23 +658,14 @@ ALL_MODULES = [
         legacy_cli_commands=[
             machine_commands.delete_machine,
             machine_commands.list_machines,
-            project_commands.create,
-            project_commands.list,
         ],
         legacy_sdk_commands={
             "get_organization_temporary_object_storage_credentials": None,
             "partial_update_organization": None,
-            "create_project": None,
-            "delete_project": None,
-            "get_default_project": None,
-            "get_project": None,
-            "search_projects": None,
-            "update_project": None,
             "get_runtime_environment": None,
             "create_session_command": None,
             "get_session_command": None,
             "list_session_commands": None,
-            "get_session_event_log": None,
             "upsert_sso_config": None,
             "upsert_test_sso_config": None,
         },
@@ -618,7 +679,6 @@ ALL_MODULES = [
             "BuildResponse",
             "BuildStatus",
             "CreateBuild",
-            "CreateProject",
             "CreateSSOConfig",
             "GrpcProtocolConfig",
             "HTTPValidationError",
@@ -635,10 +695,6 @@ ALL_MODULES = [
             "Organization",
             "OrganizationResponse",
             "PageQuery",
-            "Project",
-            "ProjectListResponse",
-            "ProjectResponse",
-            "ProjectsQuery",
             "Protocols",
             "PythonModules",
             "PythonVersion",
@@ -653,7 +709,6 @@ ALL_MODULES = [
             "TextQuery",
             "TracingConfig",
             "UpdateOrganization",
-            "UpdateProject",
             "UserServiceAccessTypes",
             "WorkerNodeType",
         ],

anyscale/_private/docgen/api.md

@@ -1058,26 +1058,6 @@ Name | Type | Description  | Notes
 
 Returns [SessioncommandListResponse](./models.md#sessioncommandlistresponse)
 
-## Session Events
-
-### get_session_event_log
-
-Retrieves a session's event log.
-
-Parameters
-
-Name | Type | Description  | Notes
-------------- | ------------- | ------------- | -------------
- `session_id` | str| ID of the Session to retrieve event logs for. | Defaults to null
- `before` | optional datetime| Filters events occurring before this datetime. | Defaults to null
- `after` | optional datetime| Filters events occurring after this datetime. | Defaults to null
- `event_types` | [List[SessionEventTypes]](./models.md#sessioneventtypes)| Filters events to these types. | Defaults to null
- `log_level_types` | [List[LogLevelTypes]](./models.md#logleveltypes)| Filters logs to these leves. | Defaults to null
- `paging_token` | optional str|  | Defaults to null
- `count` | optional int|  | Defaults to 20
-
-Returns [SessioneventListResponse](./models.md#sessioneventlistresponse)
-
 ## Sso Configs
 
 ### upsert_sso_config

anyscale/_private/docgen/generator.py

@@ -26,6 +26,7 @@ CLI_NO_EXAMPLES = {
     "anyscale",
     "anyscale cloud",
     "anyscale cloud config",
+    "anyscale cloud set-default",
     "anyscale logs",
     "anyscale service-account",
     "anyscale service",
@@ -178,10 +179,11 @@ class MarkdownGenerator:
             output = f"## {m.title} CLI\n"
 
         for t in commands or []:
+            cli_command_prefix = cli_prefix
             if m.cli_command_group_prefix and t in m.cli_command_group_prefix:
-                cli_prefix = f"{cli_prefix} {m.cli_command_group_prefix[t]}"
+                cli_command_prefix = f"{cli_prefix} {m.cli_command_group_prefix[t]}"
             output += "\n" + self._gen_markdown_for_cli_command(
-                t, cli_prefix=cli_prefix or ""
+                t, cli_prefix=cli_command_prefix or ""
             )
 
         return output

anyscale/_private/docgen/models.md

@@ -548,7 +548,7 @@ Possible Values:
 ClusterStatusDetails is a more granular status than ClusterStatus.
 
 Possible Values:
-['LAUNCHING_NODES', 'CONFIGURING_HEAD_NODE']
+['LAUNCHING_NODES', 'CONFIGURING_HEAD_NODE', 'UPDATING_CONTAINERS']
 
 ## ClustercomputeListResponse
 
@@ -1251,13 +1251,6 @@ Name | Type | Description | Notes
 **ray_worker_id** | **str** | The Ray worker ID that this file originated from, if appropriate. | [optional] [default to null]
 **job_id** | **str** | The Ray job ID that this file originated from, if appropriate. | [optional] [default to null]
 
-## LogLevelTypes
-
-The classification of a session event.     
-
-Possible Values:
-['info', 'error']
-
 ## LogStream
 
 
@@ -1886,35 +1879,6 @@ An enumeration.
 Possible Values:
 ['WEBTERMINAL', 'COMMAND_LINE_RUNNER']
 
-## SessionEvent
-
-Model of a session event item from the session event log.
-
-Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
-**event_type** | **str** | The category of session event. | [default to null]
-**log_level** | [**LogLevelTypes**](#logleveltypes) | The severity of the session event. | [default to null]
-**timestamp** | **datetime** | The time at which the session event occurred. | [default to null]
-**description** | **str** | A human readable description of the session event. | [default to null]
-**cause** | [**SessionEventCause**](#sessioneventcause) | The reason why the session event occurred. None indicates an unknown cause. | [optional] [default to null]
-**id** | **str** | A unique identifier for the session event. | [default to null]
-
-## SessionEventCause
-
-Model of a session event cause. Exactly one of cause_user or cause_system is non-None.
-
-Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
-**cause_user** | **str** | The username of the user who caused the session event. | [optional] [default to null]
-**cause_system** | **str** | The name of the internal anyscale system that caused the session event. | [optional] [default to null]
-
-## SessionEventTypes
-
-The type of session event.     
-
-Possible Values:
-['edited', 'terminate_command', 'start_command', 'running', 'terminated', 'awaiting_file_mounts', 'starting', 'updating', 'terminating', 'created', 'terminating_errored', 'updating_errored', 'startup_errored']
-
 ## SessionListResponse
 
 A list response form the API. Contains a field \"results\" which has the contents of the response.
@@ -2001,15 +1965,6 @@ Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **result** | [**SessionCommand**](#sessioncommand) |  | [default to null]
 
-## SessioneventListResponse
-
-A list response form the API. Contains a field \"results\" which has the contents of the response.
-
-Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
-**results** | [**List[SessionEvent]**](#sessionevent) |  | [default to null]
-**metadata** | [**ListResponseMetadata**](#listresponsemetadata) |  | [optional] [default to null]
-
 ## SessionoperationResponse
 
 A response from the API. Contains a field \"result\" which has the contents of the response.

anyscale/_private/workload/workload_config.py

@@ -93,7 +93,7 @@ class WorkloadConfig(ModelBase):
         default=None,
         repr=False,
         metadata={
-            "docstring": "A list of pip requirements or a path to a `requirements.txt` file for the workload. When running inside a workspace, this defaults to the workspace-tracked requirements."
+            "docstring": "A list of pip requirements or a path to a `requirements.txt` file for the workload. Anyscale installs these dependencies on top of the image. If you run a workload from a workspace, the default is to use the workspace dependencies, but specifying this option overrides them."
         },
     )
 

anyscale/aggregated_instance_usage/__init__.py

@@ -31,6 +31,6 @@ class AggregatedInstanceUsageSDK:
         doc_py_example=_DOWNLOAD_CSV_EXAMPLE, arg_docstrings=_DOWNLOAD_ARG_DOCSTRINGS,
     )
     def download_csv(self, filters: DownloadCSVFilters,) -> str:  # noqa: F811
-        """Downloads aggregated instance usage CSV.
+        """Download an aggregated instance usage report as a zipped CSV to the provided directory.
         """
         return self._private_sdk.download_csv(filters=filters)

anyscale/aggregated_instance_usage/commands.py

@@ -23,9 +23,7 @@ anyscale.aggregated_instance_usage.download_csv(
 )
 """
 
-_DOWNLOAD_ARG_DOCSTRINGS = {
-    "filters": "The filter of the instance usage to be downloaded."
-}
+_DOWNLOAD_ARG_DOCSTRINGS = {"filters": "The filter of the instance usage to download."}
 
 
 @sdk_command(
@@ -37,6 +35,6 @@ _DOWNLOAD_ARG_DOCSTRINGS = {
 def download_csv(
     filters: DownloadCSVFilters, *, _sdk: PrivateAggregatedInstanceUsageSDK
 ) -> str:
-    """Downloads aggregated instance usage CSV.
+    """Download an aggregated instance usage report as a zipped CSV to the provided directory.
     """
     return _sdk.download_csv(filters)

anyscale/aggregated_instance_usage/models.py

@@ -15,17 +15,17 @@ import anyscale
 from anyscale.aggregated_instance_usage.models import DownloadCSVFilters
 
 download_csv_filters = DownloadCSVFilters(
-    # Start date for the usage CSV (inclusive)
+    # Start date (inclusive) for the usage CSV.
     start_date="2024-10-01",
-    # End date for the usage CSV (inclusive)
+    # End date (inclusive) for the usage CSV.
     end_date="2024-10-31",
-    # Optional cloud name to filter by
+    # Optional cloud name to filter by.
     cloud="cloud_name",
-    # Optional project name to filter by
+    # Optional project name to filter by.
     project="project_name",
-    # Optional directory to save the CSV to
+    # Optional directory to save the CSV to.
     directory="/directory",
-    # Optional hide progress bar
+    # Optional hide progress bar.
     hide_progress_bar=False,
 )
 """
@@ -39,14 +39,14 @@ download_csv_filters = DownloadCSVFilters(
             raise ValueError("Incorrect date format, should be YYYY-MM-DD")
 
     start_date: str = field(
-        metadata={"docstring": "Start date for the usage CSV (inclusive)."}
+        metadata={"docstring": "Start date (inclusive) for the usage CSV."}
     )
 
     def _validate_start_date(self, start_date: str):
         self._validate_date(start_date)
 
     end_date: str = field(
-        metadata={"docstring": "End date for the usage CSV (inclusive)."}
+        metadata={"docstring": "End date (inclusive) for the usage CSV."}
     )
 
     def _validate_end_date(self, end_date: str):