mypy-boto3-transcribe

import boto3 from mypy_boto3_transcribe.client import TranscribeClient from typing import TYPE_CHECKING, cast import os # Boto3 client requires AWS credentials, which can be configured via # environment variables (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_REGION) # or other boto3 configuration methods. if TYPE_CHECKING: # This block is only for type checking tools like mypy or pyright. # It helps prevent runtime import issues and ensures correct type resolution. pass def get_typed_transcribe_client() -> TranscribeClient: """Returns a type-hinted boto3 Transcribe client.""" # boto3.client returns a DynamicClient which is untyped. # We cast it to the specific mypy-boto3-transcribe client type. client = boto3.client("transcribe", region_name=os.environ.get('AWS_REGION', 'us-east-1')) return cast(TranscribeClient, client) # --- Example Usage --- transcribe_client = get_typed_transcribe_client() print("Listing first 3 transcription jobs:") response = transcribe_client.list_transcription_jobs( MaxResults=3, Status='COMPLETED' # Example filter ) job_summaries = response.get("TranscriptionJobSummaries", []) if job_summaries: for job in job_summaries: print(f" - Name: {job['TranscriptionJobName']}, Status: {job['TranscriptionJobStatus']}") else: print(" No completed transcription jobs found.") # mypy will now correctly check arguments and return types for methods of transcribe_client # e.g., transcribe_client.start_transcription_job(TranscriptionJobName=123) will be flagged # as TranscriptionJobName expects a string.