day2 0.2.1__tar.gz → 0.2.2__tar.gz

{day2-0.2.1 → day2-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: day2
-Version: 0.2.1
+Version: 0.2.2
 Summary: MontyCloud DAY2 SDK for Python
 Author-email: MontyCloud <info@montycloud.com>
 Requires-Python: >=3.11
@@ -152,7 +152,7 @@ The SDK supports authentication with both an API key and an API secret key. You
 1. Directly in code:
    ```python
    # Simplified API
-   session = day2.Session(api_key="your-api-key")
+   session = day2.Session(api_key="your-api-key", api_secret_key="your-secret-key")
 
    # With API secret key
    session = day2.Session(
@@ -191,7 +191,7 @@ The SDK supports multi-tenant operations through session-based tenant context:
 
 ```python
 # Create a session
-session = day2.Session(api_key="your-api-key")
+session = day2.Session(api_key="your-api-key", api_secret_key="your-secret-key")
 
 # Set tenant context
 session.set_tenant("org-123")

{day2-0.2.1 → day2-0.2.2}/README.md

@@ -114,7 +114,7 @@ The SDK supports authentication with both an API key and an API secret key. You
 1. Directly in code:
    ```python
    # Simplified API
-   session = day2.Session(api_key="your-api-key")
+   session = day2.Session(api_key="your-api-key", api_secret_key="your-secret-key")
 
    # With API secret key
    session = day2.Session(
@@ -153,7 +153,7 @@ The SDK supports multi-tenant operations through session-based tenant context:
 
 ```python
 # Create a session
-session = day2.Session(api_key="your-api-key")
+session = day2.Session(api_key="your-api-key", api_secret_key="your-secret-key")
 
 # Set tenant context
 session.set_tenant("org-123")

{day2-0.2.1 → day2-0.2.2}/day2/__init__.py

@@ -12,6 +12,7 @@ from day2.session import Session
 
 if TYPE_CHECKING:
     from day2.resources.assessment import AssessmentClient
+    from day2.resources.cost import CostClient
     from day2.resources.tenant import TenantClient
 
 
@@ -54,4 +55,20 @@ def assessment() -> "AssessmentClient":
     return get_default_session().assessment
 
 
-__all__ = ["Session", "__version__", "tenant", "assessment", "get_default_session"]
+def cost() -> "CostClient":
+    """Get a cost client using the default session.
+
+    Returns:
+        CostClient: A client for interacting with cost resources
+    """
+    return get_default_session().cost
+
+
+__all__ = [
+    "Session",
+    "__version__",
+    "tenant",
+    "assessment",
+    "cost",
+    "get_default_session",
+]

{day2-0.2.1 → day2-0.2.2}/day2/client/config.py

@@ -8,7 +8,19 @@ from typing import Any, Dict, Optional
 
 @dataclass
 class Config:
-    """Configuration for the MontyCloud SDK."""
+    """Configuration for the MontyCloud SDK.
+
+    Attributes:
+        base_url: Base URL for the MontyCloud API
+        api_version: API version to use
+        timeout: Request timeout in seconds
+        max_retries: Maximum number of retries for failed requests
+        retry_backoff_factor: Exponential backoff factor for retries
+        tenant_id: Default tenant ID for operations
+        retry_min_delay: Minimum delay between retries in seconds
+        retry_max_delay: Maximum delay between retries in seconds
+        output_format: Output format for CLI commands (table or json)
+    """
 
     # Base URL for the MontyCloud API
     base_url: str = "https://api.montycloud.com/day2/api"

{day2-0.2.1 → day2-0.2.2}/day2/models/__init__.py

@@ -7,6 +7,7 @@ from day2.models.assessment import (
     GetAssessmentOutput,
     ListAssessmentsOutput,
 )
+from day2.models.cost import GetCostByChargeTypeOutput
 from day2.models.tenant import ListTenantsOutput, TenantDetails
 
 __all__ = [
@@ -17,4 +18,5 @@ __all__ = [
     "CreateAssessmentInput",
     "CreateAssessmentOutput",
     "GetAssessmentOutput",
+    "GetCostByChargeTypeOutput",
 ]

{day2-0.2.1 → day2-0.2.2}/day2/models/assessment.py

@@ -5,7 +5,20 @@ from pydantic import BaseModel, ConfigDict, Field
 
 
 class Assessment(BaseModel):
-    """Details of an assessment."""
+    """Details of an assessment.
+
+    Attributes:
+        id: Assessment identifier
+        name: Name of the assessment
+        description: Description of the assessment
+        status: Current status of the assessment
+        assessment_arn: AWS ARN of the assessment
+        lenses: List of lens identifiers used in the assessment
+        total_questions: Total number of questions in the assessment
+        answered_questions: Number of questions that have been answered
+        created_at: Timestamp when the assessment was created
+        updated_at: Timestamp when the assessment was last updated
+    """
 
     id: str = Field(alias="AssessmentId")
     name: str = Field(alias="AssessmentName")
@@ -23,13 +36,15 @@ class Assessment(BaseModel):
 
 
 class ListAssessmentsOutput(BaseModel):
-    """Output of list_assessments operation."""
+    """Output of list_assessments operation.
+
+    Attributes:
+        assessments: List of assessment details
+        next_page_token: Token for fetching the next page of results
+    """
 
     assessments: List[Assessment] = Field(alias="Assessments")
     next_page_token: Optional[str] = Field(None, alias="NextPageToken")
-    # Keep these fields for backward compatibility
-    page_number: Optional[int] = Field(None, alias="PageNumber")
-    has_more: Optional[bool] = Field(None, alias="HasMore")
 
     # Allow extra fields
     model_config = ConfigDict(extra="allow")
@@ -38,16 +53,48 @@ class ListAssessmentsOutput(BaseModel):
 class CreateAssessmentInput(BaseModel):
     """Input for creating an assessment.
 
-    According to the server-side schema, Scope can be one of two formats:
-    1. ScopeAcc: {"Project": {}, "Accounts": [{"AccountNumber": "123", "Regions": ["us-east-1"]}]}
-    2. ScopeProj: {"Project": {"ProjectId": "123", "Applications": ["app1"]}, "Accounts": ["123"]}
+    The scope parameter can be in one of two formats:
+
+    1. Account-based scope:
+       ```python
+       {
+           "Project": {},
+           "Accounts": [
+               {"AccountNumber": "123456789012", "Regions": ["us-east-1", "us-west-2"]}
+           ]
+       }
+       ```
+
+    2. Project-based scope:
+       ```python
+       {
+           "Project": {"ProjectId": "proj-123", "Applications": ["app1", "app2"]},
+           "Accounts": ["123456789012"]
+       }
+       ```
+
+    Attributes:
+        name: Name of the assessment
+        description: Description of the assessment
+        review_owner: Email or identifier of the review owner
+        scope: Scope configuration (see formats above)
+        lenses: List of lens aliases to use (defaults to ["AWS Well-Architected Framework"] only "AWS Well-Architected Framework" is supported)
+        tags: Key-value pairs for tagging the assessment
+        region_code: AWS region code where the assessment is created
+        environment: Environment type (e.g., PRODUCTION, DEVELOPMENT)
+        hosted_account_number: Optional AWS account number for hosting
+        diagram_url: Optional URL to architecture diagram
+        industry_type: Optional industry type classification
+        industry: Optional industry specification
     """
 
     name: str = Field(alias="AssessmentName")
     description: str = Field(alias="Description")
     review_owner: str = Field(alias="ReviewOwner")
     scope: Dict[str, Any] = Field(alias="Scope")
-    lenses: Optional[List[str]] = Field(default=[], alias="Lenses")
+    lenses: List[str] = Field(
+        default=["AWS Well-Architected Framework"], alias="Lenses"
+    )
     tags: Optional[Dict[str, Any]] = Field(default={}, alias="Tags")
     region_code: str = Field(alias="RegionCode")
     environment: str = Field(alias="Environment")
@@ -63,7 +110,38 @@ class CreateAssessmentInput(BaseModel):
 
 
 class GetAssessmentOutput(BaseModel):
-    """Output of get_assessment operation."""
+    """Output of get_assessment operation.
+
+    Attributes:
+        id: Assessment identifier
+        name: Name of the assessment
+        description: Description of the assessment
+        status: Current status of the assessment
+        assessment_arn: AWS ARN of the assessment
+        created_at: Timestamp when the assessment was created
+        updated_at: Timestamp when the assessment was last updated
+        answered_questions: Number of questions that have been answered
+        total_questions: Total number of questions in the assessment
+        lenses: List of lens identifiers used in the assessment
+        owner: Owner of the assessment
+        diagram_url: URL to architecture diagram (if provided)
+        environment: Environment type
+        improvement_status: Status of improvement plan
+        in_sync: Synchronization status indicator
+        industry: Industry specification
+        industry_type: Industry type classification
+        region_code: AWS region code
+        scope: Scope configuration
+        risk_counts: Dictionary of risk counts by severity
+        lens_alias: Primary lens alias
+        lens_arn: AWS ARN of the lens
+        lens_version: Version of the lens
+        lens_name: Name of the lens
+        lens_status: Status of the lens
+        aws_updated_at: Timestamp of  the last AWS update
+        last_run_at: Timestamp of the last execution run (if completed)
+        execution_id: ID of the last execution run (if completed)
+    """
 
     id: str = Field(alias="AssessmentId")
     name: str = Field(alias="AssessmentName")
@@ -93,6 +171,12 @@ class GetAssessmentOutput(BaseModel):
     aws_updated_at: str = Field(
         alias="AWSUpdatedAt"
     )  # Changed to str to handle timezone format
+    last_run_at: Optional[datetime] = Field(
+        None, alias="LastRunAt"
+    )  # Optional since it will be present only when the execution run is completed for the assessment
+    execution_id: Optional[str] = Field(
+        None, alias="ExecutionId"
+    )  # Optional since it will be present only when the execution run is completed for the assessment
 
     # Allow extra fields
     model_config = ConfigDict(extra="allow")
@@ -101,7 +185,12 @@ class GetAssessmentOutput(BaseModel):
 class CreateAssessmentOutput(BaseModel):
     """Output of create_assessment operation.
 
-    According to the OpenAPI specification, this only returns the AssessmentId and AssessmentArn.
+    Note:
+        According to the OpenAPI specification, this only returns the AssessmentId and AssessmentArn.
+
+    Attributes:
+        id: Newly created assessment identifier
+        assessment_arn: AWS ARN of the newly created assessment
     """
 
     # Fields from the OpenAPI spec
@@ -113,7 +202,21 @@ class CreateAssessmentOutput(BaseModel):
 
 
 class Question(BaseModel):
-    """Details of an assessment question."""
+    """Details of an assessment question.
+
+    Attributes:
+        id: Question identifier
+        title: Title of the question
+        pillar_id: ID of the pillar this question belongs to
+        risk: Current risk level (HIGH, MEDIUM, LOW, or UNANSWERED)
+        reason: Reason for the current answer (if applicable)
+        description: Detailed description of the question
+        pillar_name: Name of the pillar this question belongs to
+        is_answered: Whether the question has been answered
+        choices: Available choices for the question
+        selected_choices: Currently selected choice IDs
+        notes: Additional notes for the answer
+    """
 
     id: str = Field(alias="QuestionId")
     title: str = Field(alias="QuestionTitle")
@@ -135,7 +238,15 @@ class Question(BaseModel):
 
 
 class ListQuestionsOutput(BaseModel):
-    """Output of list_questions operation."""
+    """Output of list_questions operation.
+
+    Attributes:
+        questions: List of question details
+        total_questions: Total number of questions
+        answered_questions: Number of questions that have been answered
+        pillar_id: ID of the pillar (if filtered by pillar)
+        pillar_name: Name of the pillar (if filtered by pillar)
+    """
 
     questions: List[Question] = Field(alias="Questions")
 
@@ -171,7 +282,25 @@ class ListQuestionsOutput(BaseModel):
 
 
 class GetQuestionOutput(BaseModel):
-    """Output of get_question operation."""
+    """Output of get_question operation.
+
+    Attributes:
+        title: Title of the question
+        description: Detailed description of the question
+        pillar_id: ID of the pillar this question belongs to
+        choices: Available choices for answering the question
+        is_applicable: Whether the question is applicable
+        risk: Current risk level (if answered)
+        reason: Reason for marking as not applicable
+        helpful_resource_url: URL to helpful resources
+        improvement_plan_url: URL to improvement plan
+        choice_answers: Currently selected choice answers
+        id: Question identifier
+        pillar_name: Name of the pillar
+        notes: Additional notes
+        is_answered: Whether the question has been answered
+        selected_choices: List of selected choice IDs
+    """
 
     # Fields directly from the API response
     title: str = Field(alias="QuestionTitle")
@@ -228,7 +357,11 @@ class GetQuestionOutput(BaseModel):
 
 
 class ChoiceStatus(BaseModel):
-    """Status of a choice in an answer."""
+    """Status of a choice in an answer.
+
+    Attributes:
+        status: Status of the choice (SELECTED or UNSELECTED)
+    """
 
     status: str = Field("SELECTED", alias="Status")
 
@@ -236,7 +369,18 @@ class ChoiceStatus(BaseModel):
 
 
 class AnswerQuestionInput(BaseModel):
-    """Input for answering a question."""
+    """Input for answering a question.
+
+    Attributes:
+        lens_alias: Alias of the lens (defaults to 'wellarchitected')
+        choice_updates: Dictionary mapping choice IDs to their status
+        notes: Additional notes about the answer
+        is_applicable: Whether the question is applicable (defaults to True)
+        reason: Reason if not applicable (OUT_OF_SCOPE, BUSINESS_PRIORITIES,
+            ARCHITECTURE_CONSTRAINTS, OTHER, or NONE)
+        selected_choices: List of selected choice IDs (deprecated, use choice_updates)
+        risk: Risk level (deprecated, automatically calculated)
+    """
 
     lens_alias: str = Field("wellarchitected", alias="LensAlias")
     choice_updates: Dict[str, ChoiceStatus] = Field(
@@ -275,7 +419,13 @@ class AnswerQuestionInput(BaseModel):
 class AnswerQuestionOutput(BaseModel):
     """Output of answer_question operation.
 
-    The API returns a success message with status and message fields.
+    Note:
+        The API returns a success message with status and message fields.
+
+    Attributes:
+        status: Status of the operation (e.g., 'success')
+        message: Descriptive message about the operation result
+        id: Question identifier (added for convenience)
     """
 
     # Fields directly from the API response
@@ -289,7 +439,29 @@ class AnswerQuestionOutput(BaseModel):
 
 
 class Finding(BaseModel):
-    """Details of a finding."""
+    """Details of a finding.
+
+    Attributes:
+        finding_id: Unique identifier for the finding
+        resource_id: ID of the affected resource
+        resource_type: Type of the affected resource (e.g., AWS::EC2::Instance)
+        account_number: AWS account number where the resource exists
+        region_code: AWS region where the resource exists
+        check_id: ID of the check that generated this finding
+        recommendation: Recommended action to address the finding
+        remediation: Whether remediation is available
+        created_at: Timestamp when the finding was created
+        question_id: Related assessment question ID
+        question: Related assessment question text
+        pillar_id: ID of the related pillar
+        severity: Severity level (HIGH, MEDIUM, LOW)
+        status: Current status of the finding (OPEN, RESOLVED, SUPPRESSED)
+        title: Title of the finding
+        description: Detailed description of the finding
+        best_practice_id: ID of the related best practice
+        best_practice: Description of the best practice
+        best_practice_risk: Risk level associated with not following the best practice
+    """
 
     finding_id: str = Field(alias="FindingId")
     resource_id: str = Field(alias="ResourceId")
@@ -315,7 +487,12 @@ class Finding(BaseModel):
 
 
 class ListFindingsOutput(BaseModel):
-    """Output of list_findings operation."""
+    """Output of list_findings operation.
+
+    Attributes:
+        records: List of finding details
+        next_page_token: Token for fetching the next page of results
+    """
 
     records: List[Finding] = Field(alias="Records", default=[])
     next_page_token: Optional[str] = Field(None, alias="NextPageToken")

{day2-0.2.1 → day2-0.2.2}/day2/models/cost.py

@@ -1,7 +1,7 @@
 import re
 from typing import Any, Dict, Optional
 
-from pydantic import BaseModel, ConfigDict, Field, root_validator
+from pydantic import BaseModel, ConfigDict, Field, model_validator
 
 
 # Utility function to convert camelCase or PascalCase to snake_case
@@ -10,7 +10,34 @@ def to_snake_case(name: str) -> str:
 
 
 class GetCostByChargeTypeOutput(BaseModel):
-    """Details of cost breakdown by charge type."""
+    """Details of cost breakdown by charge type.
+
+    This model provides a comprehensive breakdown of costs by various charge types.
+    It supports dynamic fields, automatically converting any additional charge types
+    from the API response to snake_case attributes.
+
+    Attributes:
+        total_cost: Total cost for the period
+        usage: Standard usage charges
+        bundled_discount: Bundled discount amount
+        credit: Credits applied
+        discount: General discounts applied
+        discounted_usage: Usage charges after discounts
+        fee: General fees
+        refund: Refund amounts
+        ri_fee: Reserved Instance fees
+        tax: Tax charges
+        savings_plan_upfront_fee: Upfront fee for Savings Plans
+        savings_plan_recurring_fee: Recurring fee for Savings Plans
+        savings_plan_covered_usage: Usage covered by Savings Plans
+        savings_plan_negation: Savings Plan negation amounts
+        spp_discount: SPP (Service Provider Program) discounts
+        distributor_discount: Distributor discounts
+
+    Note:
+        Additional charge types returned by the API are automatically added as
+        attributes with their names converted to snake_case format.
+    """
 
     total_cost: Optional[float] = Field(None, alias="TotalCost")
     usage: Optional[float] = Field(None, alias="Usage")
@@ -38,7 +65,7 @@ class GetCostByChargeTypeOutput(BaseModel):
     # Allow extra fields
     model_config = ConfigDict(extra="allow")
 
-    @root_validator(pre=True)
+    @model_validator(mode="before")
     @classmethod
     def handle_dynamic_extra_fields(cls, values: Dict[str, Any]) -> Dict[str, Any]:
         """Handle dynamic extra fields by converting them to snake_case."""

{day2-0.2.1 → day2-0.2.2}/day2/models/tenant.py

@@ -7,7 +7,22 @@ from pydantic import BaseModel, ConfigDict, Field
 
 
 class TenantDetails(BaseModel):
-    """Details of a tenant."""
+    """Details of a tenant.
+
+    Attributes:
+        id: Unique identifier of the tenant
+        name: Name of the tenant
+        description: Description of the tenant
+        parent_tenant_id: ID of the parent tenant if this is a sub-tenant
+        created_at: Timestamp when the tenant was created
+        created_by: User who created the tenant
+        modified_at: Timestamp of last modification
+        modified_by: User who last modified the tenant
+        owner: Owner of the tenant
+        document_url: URL to the tenant's documentation
+        feature: Feature set associated with the tenant
+        category_id: Category identifier for the tenant
+    """
 
     id: Optional[str] = Field(None, alias="ID")
     name: str = Field(alias="Name")
@@ -27,7 +42,12 @@ class TenantDetails(BaseModel):
 
 
 class ListTenantsOutput(BaseModel):
-    """Output of list_tenants operation."""
+    """Output of list_tenants operation.
+
+    Attributes:
+        tenants: List of tenant details
+        next_page_token: Token for fetching the next page of results
+    """
 
     tenants: List[TenantDetails] = Field(alias="Tenants", default=[])
     next_page_token: Optional[str] = Field(None, alias="NextPageToken")
@@ -37,11 +57,24 @@ class ListTenantsOutput(BaseModel):
 
 
 class GetTenantOutput(TenantDetails):
-    """Output of get_tenant operation."""
+    """Output of get_tenant operation.
+
+    This class inherits all attributes from TenantDetails without modification.
+    See TenantDetails for the complete list of attributes.
+    """
 
 
 class Account(BaseModel):
-    """Details of an account."""
+    """Details of an account.
+
+    Attributes:
+        number: AWS account number
+        name: Account name
+        status: Current status of the account
+        type: Type of the account
+        permission_model: Permission model used for the account
+        onboarded_date: Date when the account was onboarded
+    """
 
     number: str = Field(alias="Number")
     name: str = Field(alias="Name")
@@ -55,7 +88,13 @@ class Account(BaseModel):
 
 
 class ListAccountsOutput(BaseModel):
-    """Output of list_accounts operation."""
+    """Output of list_accounts operation.
+
+    Attributes:
+        accounts: List of account details
+        has_more: Whether there are more pages of results
+        page_number: Current page number
+    """
 
     accounts: List[Account] = Field(alias="Accounts", default=[])
     has_more: bool = Field(alias="HasMore", default=False)

{day2-0.2.1 → day2-0.2.2}/day2/resources/__init__.py

@@ -1,6 +1,7 @@
 """Resource implementations for the MontyCloud DAY2 SDK."""
 
 from day2.resources.assessment import AssessmentClient
+from day2.resources.cost import CostClient
 from day2.resources.tenant import TenantClient
 
-__all__ = ["TenantClient", "AssessmentClient"]
+__all__ = ["TenantClient", "AssessmentClient", "CostClient"]

{day2-0.2.1 → day2-0.2.2}/day2/resources/assessment.py

@@ -43,8 +43,7 @@ class AssessmentClient(BaseClient):
             status: Status to filter assessments by. Must be one of ["PENDING", "COMPLETED"].
             keyword: Optional keyword to filter assessments by name or description.
             page_size: The number of assessments per page (default: 10).
-            page_token: Token for pagination. If provided, page_number is ignored.
-            page_number: The page number to retrieve (deprecated, use page_token instead).
+            page_token: Token for pagination.
 
         Returns:
             ListAssessmentsOutput: Object containing list of assessments and pagination info.
@@ -55,7 +54,7 @@ class AssessmentClient(BaseClient):
             AuthenticationError: If authentication fails.
 
         Examples:
-            >>> session = Session(api_key="your-api-key")
+            >>> session = Session(api_key="your-api-key", api_secret_key="your-secret-key")
             >>> client = session.assessment
             >>> response = client.list_assessments(tenant_id="tenant-123", status="PENDING", page_size=10)
             >>> for assessment in response.assessments:
@@ -98,7 +97,7 @@ class AssessmentClient(BaseClient):
             AuthenticationError: If authentication fails.
 
         Examples:
-            >>> session = Session(api_key="your-api-key")
+            >>> session = Session(api_key="your-api-key", api_secret_key="your-secret-key")
             >>> client = session.assessment
             >>> response = client.get_assessment("tenant-123", "assessment-123")
             >>> print(f"Assessment name: {response.name}")
@@ -126,7 +125,7 @@ class AssessmentClient(BaseClient):
             AuthenticationError: If authentication fails.
 
         Examples:
-            >>> session = Session(api_key="your-api-key")
+            >>> session = Session(api_key="your-api-key", api_secret_key="your-secret-key")
             >>> client = session.assessment
             >>> data = CreateAssessmentInput(
             ...     name="My Assessment",
@@ -195,7 +194,7 @@ class AssessmentClient(BaseClient):
             AuthenticationError: If authentication fails.
 
         Examples:
-            >>> session = Session(api_key="your-api-key")
+            >>> session = Session(api_key="your-api-key", api_secret_key="your-secret-key")
             >>> client = session.assessment
             >>> response = client.list_questions("tenant-123", "assessment-123", "pillar-123")
             >>> for question in response.questions:
@@ -230,7 +229,7 @@ class AssessmentClient(BaseClient):
             AuthenticationError: If authentication fails.
 
         Examples:
-            >>> session = Session(api_key="your-api-key")
+            >>> session = Session(api_key="your-api-key", api_secret_key="your-secret-key")
             >>> client = session.assessment
             >>> response = client.get_question("tenant-123", "assessment-123", "question-123")
             >>> print(f"Question: {response.title}")
@@ -284,7 +283,7 @@ class AssessmentClient(BaseClient):
             AuthenticationError: If authentication fails.
 
         Examples:
-            >>> session = Session(api_key="your-api-key")
+            >>> session = Session(api_key="your-api-key", api_secret_key="your-secret-key")
             >>> client = session.assessment
             >>> data = AnswerQuestionInput(
             ...     Reason="ARCHITECTURE_CONSTRAINTS",
@@ -357,7 +356,7 @@ class AssessmentClient(BaseClient):
             AuthenticationError: If authentication fails.
 
         Examples:
-            >>> session = Session(api_key="your-api-key")
+            >>> session = Session(api_key="your-api-key", api_secret_key="your-secret-key")
             >>> client = session.assessment
             >>> response = client.list_findings(
             ...     tenant_id="tenant-123",

{day2-0.2.1 → day2-0.2.2}/day2/resources/cost.py

@@ -40,7 +40,7 @@ class CostClient(BaseClient):
             AuthenticationError: If authentication fails.
 
         Examples:
-            >>> session = Session(api_key="your-api-key")
+            >>> session = Session(api_key="your-api-key", api_secret_key="your-secret-key")
             >>> client = session.cost
             >>> response = client.get_cost_by_charge_type(
             ...     tenant_id="tenant-123",

{day2-0.2.1 → day2-0.2.2}/day2/resources/tenant.py

@@ -36,7 +36,7 @@ class TenantClient(BaseClient):
             AuthenticationError: If authentication fails.
 
         Examples:
-            >>> session = Session(api_key="your-api-key")
+            >>> session = Session(api_key="your-api-key", api_secret_key="your-secret-key")
             >>> client = session.tenant
             >>> response = client.list_tenants(page_size=10)
             >>> for tenant in response.tenants:
@@ -71,7 +71,7 @@ class TenantClient(BaseClient):
             AuthenticationError: If authentication fails.
 
         Examples:
-            >>> session = Session(api_key="your-api-key")
+            >>> session = Session(api_key="your-api-key", api_secret_key="your-secret-key")
             >>> client = session.tenant
             >>> response = client.get_tenant("tenant-123")
             >>> print(f"Tenant name: {response.name}")
@@ -100,7 +100,7 @@ class TenantClient(BaseClient):
             AuthenticationError: If authentication fails.
 
         Examples:
-            >>> session = Session(api_key="your-api-key")
+            >>> session = Session(api_key="your-api-key", api_secret_key="your-secret-key")
             >>> client = session.tenant
             >>> response = client.list_accounts("tenant-123", page_size=10)
             >>> for account in response.accounts:

{day2-0.2.1 → day2-0.2.2}/day2/session.py

@@ -20,6 +20,22 @@ class Session:
     """Session for interacting with the MontyCloud API.
 
     The Session manages authentication credentials, tenant context, and client creation.
+    It provides access to all DAY2 API resources through dedicated client properties.
+
+    Attributes:
+        credentials: Authentication credentials for API access.
+        tenant_id: Current tenant ID context for API operations.
+
+    Examples:
+        Create a session with API credentials:
+
+        >>> session = Session(api_key="your-api-key", api_secret_key="your-secret-key")
+        >>> tenants = session.tenant.list_tenants()
+
+        Create a session with custom configuration:
+
+        >>> config = Config(timeout=60, max_retries=5)
+        >>> session = Session(api_key="key", api_secret_key="secret", config=config)
     """
 
     def __init__(
@@ -33,11 +49,16 @@ class Session:
         """Initialize a new session.
 
         Args:
-            api_key: API key for authentication.
-            api_secret_key: API secret key for authentication.
-            credentials: Credentials object for authentication.
-            tenant_id: Tenant ID to use for API calls.
-            config: Configuration object.
+            api_key: API key for authentication. If not provided, will attempt to load
+                from environment variables or configuration file.
+            api_secret_key: API secret key for authentication. Required if api_key is provided.
+            credentials: Pre-configured Credentials object. Takes precedence over api_key/api_secret_key.
+            tenant_id: Default tenant ID for API operations. Can be changed later with set_tenant().
+            config: Configuration object with API settings. If not provided, loads from file or uses defaults.
+
+        Raises:
+            ValueError: If api_key is provided without api_secret_key.
+            AuthenticationError: If no valid credentials are found.
         """
         # Initialize credentials
         if credentials:

{day2-0.2.1 → day2-0.2.2}/day2.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: day2
-Version: 0.2.1
+Version: 0.2.2
 Summary: MontyCloud DAY2 SDK for Python
 Author-email: MontyCloud <info@montycloud.com>
 Requires-Python: >=3.11
@@ -152,7 +152,7 @@ The SDK supports authentication with both an API key and an API secret key. You
 1. Directly in code:
    ```python
    # Simplified API
-   session = day2.Session(api_key="your-api-key")
+   session = day2.Session(api_key="your-api-key", api_secret_key="your-secret-key")
 
    # With API secret key
    session = day2.Session(
@@ -191,7 +191,7 @@ The SDK supports multi-tenant operations through session-based tenant context:
 
 ```python
 # Create a session
-session = day2.Session(api_key="your-api-key")
+session = day2.Session(api_key="your-api-key", api_secret_key="your-secret-key")
 
 # Set tenant context
 session.set_tenant("org-123")

{day2-0.2.1 → day2-0.2.2}/day2_cli/commands/assessment.py

@@ -194,6 +194,11 @@ def get_assessment(
             if result.updated_at
             else "N/A"
         )
+        last_run_at = (
+            result.last_run_at.strftime("%Y-%m-%d %H:%M:%S")
+            if result.last_run_at
+            else "N/A"
+        )
 
         # Convert assessment object to dictionary for the formatter
         assessment_data = {
@@ -201,14 +206,30 @@ def get_assessment(
             "Name": result.name,
             "Description": result.description or "N/A",
             "Status": result.status,
-            "Scope": result.scope or "N/A",
+            "Assessment ARN": result.assessment_arn,
+            "Owner": result.owner,
+            "Diagram URL": result.diagram_url or "N/A",
             "Environment": result.environment or "N/A",
+            "Improvement Status": result.improvement_status,
+            "In Sync": result.in_sync,
+            "Industry": result.industry or "N/A",
+            "Industry Type": result.industry_type or "N/A",
             "Region": result.region_code or "N/A",
+            "Scope": result.scope or "N/A",
+            "Risk Counts": result.risk_counts,
             "Total Questions": result.total_questions,
             "Answered Questions": result.answered_questions,
             "Lenses": ", ".join(result.lenses) if result.lenses else "N/A",
+            "Lens Alias": result.lens_alias,
+            "Lens ARN": result.lens_arn,
+            "Lens Version": result.lens_version,
+            "Lens Name": result.lens_name,
+            "Lens Status": result.lens_status,
+            "AWS Updated At": result.aws_updated_at,
             "Created At": created_at,
             "Updated At": updated_at,
+            "Last Run At": last_run_at,
+            "Execution ID": result.execution_id or "N/A",
         }
 
         # Format and output the results
@@ -697,7 +718,9 @@ def answer_question(
         if notes:
             console.print(f"[bold]Notes:[/bold] {notes}")
         if not applicable:
-            console.print("[bold]Applicability:[/bold] Not applicable to this workload")
+            console.print(
+                "[bold]Applicability:[/bold] Not applicable to this assessment"
+            )
 
         console.print(
             "\n[dim]To view the updated question details, use the 'question' command.[/dim]"

{day2-0.2.1 → day2-0.2.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "day2"
-version = "0.2.1"
+version = "0.2.2"
 description = "MontyCloud DAY2 SDK for Python"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -50,6 +50,12 @@ cli = [
 requires = ["setuptools>=61.0.0", "wheel"]
 build-backend = "setuptools.build_meta"
 
+[tool.uv]
+# Note: This project requires uv to be installed globally
+# See DEVELOPER.md for installation instructions
+# Minimum version to ensure lock file compatibility
+required-version = ">=0.7.0"
+
 [tool.mypy]
 python_version = "3.11"
 disallow_untyped_defs = true

{day2-0.2.1 → day2-0.2.2}/tests/test_models_assessment.py

@@ -27,7 +27,7 @@ def test_assessment_parse():
         "Description": "Test Description",
         "Status": "COMPLETED",
         "AssessmentArn": "arn:aws:wellarchitected:us-east-1:123456789012:workload/assessment-123",
-        "Lenses": ["wellarchitected"],
+        "Lenses": ["AWS Well-Architected Framework"],
         "TotalQuestions": 50,
         "AnsweredQuestions": 25,
     }
@@ -42,7 +42,7 @@ def test_assessment_parse():
         assessment.assessment_arn
         == "arn:aws:wellarchitected:us-east-1:123456789012:workload/assessment-123"
     )
-    assert assessment.lenses == ["wellarchitected"]
+    assert assessment.lenses == ["AWS Well-Architected Framework"]
     assert assessment.total_questions == 50
     assert assessment.answered_questions == 25
 
@@ -57,21 +57,18 @@ def test_list_assessments_output_parse():
                 "Description": "Test Description",
                 "Status": "COMPLETED",
                 "AssessmentArn": "arn:aws:wellarchitected:us-east-1:123456789012:workload/assessment-123",
-                "Lenses": ["wellarchitected"],
+                "Lenses": ["AWS Well-Architected Framework"],
                 "TotalQuestions": 50,
                 "AnsweredQuestions": 25,
             }
         ],
-        "PageNumber": 1,
-        "HasMore": False,
+        "NextPageToken": "next-page-token",
     }
 
     list_output = ListAssessmentsOutput.model_validate(data)
 
     assert len(list_output.assessments) == 1
-    assert list_output.page_number == 1
-    assert list_output.has_more is False
-
+    assert list_output.next_page_token == "next-page-token"
     assessment = list_output.assessments[0]
     assert assessment.id == "assessment-123"
     assert assessment.name == "Test Assessment"
@@ -91,7 +88,7 @@ def test_create_assessment_input_serialization():
                 {"AccountNumber": "111122223333", "Regions": ["us-east-1", "us-east-2"]}
             ],
         },
-        Lenses=["wellarchitected"],
+        Lenses=["AWS Well-Architected Framework"],
         RegionCode="us-east-1",
         Environment="PRODUCTION",
     )
@@ -105,7 +102,7 @@ def test_create_assessment_input_serialization():
     assert len(data["Scope"]["Accounts"]) == 1
     assert data["Scope"]["Accounts"][0]["AccountNumber"] == "111122223333"
     assert "us-east-1" in data["Scope"]["Accounts"][0]["Regions"]
-    assert data["Lenses"] == ["wellarchitected"]
+    assert data["Lenses"] == ["AWS Well-Architected Framework"]
     assert data["RegionCode"] == "us-east-1"
     assert data["Environment"] == "PRODUCTION"
 
@@ -118,7 +115,7 @@ def test_create_assessment_output_parse():
         "Description": "Test Description",
         "Status": "PENDING",
         "AssessmentArn": "arn:aws:wellarchitected:us-east-1:123456789012:workload/assessment-123",
-        "Lenses": ["wellarchitected"],
+        "Lenses": ["AWS Well-Architected Framework"],
         "TotalQuestions": 50,
         "AnsweredQuestions": 0,
     }
@@ -167,6 +164,8 @@ def test_get_assessment_output_parse():
         "LensName": "AWS Well-Architected Framework",
         "LensStatus": "CURRENT",
         "AWSUpdatedAt": "2025-04-09T11:54:33+05:30",
+        "LastRunAt": "2025-04-09T06:24:34",
+        "ExecutionId": "9575dde75568c808c46e525ed88d9978",
     }
 
     output = GetAssessmentOutput.model_validate(data)
@@ -202,6 +201,8 @@ def test_get_assessment_output_parse():
     assert output.lens_name == "AWS Well-Architected Framework"
     assert output.lens_status == "CURRENT"
     assert output.aws_updated_at == "2025-04-09T11:54:33+05:30"
+    assert output.last_run_at == datetime.fromisoformat("2025-04-09T06:24:34")
+    assert output.execution_id == "9575dde75568c808c46e525ed88d9978"
 
 
 def test_get_question_output_parse():

{day2-0.2.1 → day2-0.2.2}/tests/test_resources_assessment.py

@@ -154,6 +154,8 @@ def test_get_assessment(mock_session):
         "LensName": "AWS Well-Architected Framework",
         "LensStatus": "CURRENT",
         "AWSUpdatedAt": "2025-04-09T11:54:33+05:30",
+        "LastRunAt": "2025-04-09T11:54:33+05:30",
+        "ExecutionId": "9575dde75568c808c46e525ed88d9978",
     }
 
     # Set up the mock