fix manually

Author: ks6088ts

docs/index.md

@@ -114,6 +114,10 @@ az resource update \
   --set properties.disableLocalAuth=false
 ```
 
+### Azure Blob Storage
+
+- [クイック スタート: Python 用 Azure Blob Storage クライアント ライブラリ](https://learn.microsoft.com/ja-jp/azure/storage/blobs/storage-quickstart-blobs-python?tabs=connection-string%2Croles-azure-portal%2Csign-in-azure-cli&pivots=blob-storage-quickstart-scratch)
+
 ### Application Insights
 
 - [Application Insights の概要 - OpenTelemetry の可観測性](https://learn.microsoft.com/ja-jp/azure/azure-monitor/app/app-insights-overview)

pyproject.toml

@@ -8,6 +8,7 @@ dependencies = [
     "azure-cosmos>=4.9.0",
     "azure-functions>=1.23.0",
     "azure-monitor-opentelemetry>=1.6.10",
+    "azure-storage-blob>=12.25.1",
     "fastapi-mcp>=0.3.4",
     "fastapi[standard]>=0.115.12",
     "langchain-community>=0.3.27",

scripts/files.py

@@ -1,9 +1,7 @@
 #!/usr/bin/env python
 # filepath: /home/runner/work/template-fastapi/template-fastapi/scripts/files.py
 
-import os
 from pathlib import Path
-from typing import List, Optional
 
 import typer
 from rich.console import Console
@@ -18,89 +16,89 @@
 
 @app.command()
 def list_files(
-    prefix: Optional[str] = typer.Option(None, "--prefix", "-p", help="ファイル名のプレフィックス"),
+    prefix: str | None = typer.Option(None, "--prefix", "-p", help="ファイル名のプレフィックス"),
 ):
     """ファイル一覧を取得する"""
-    console.print(f"[bold green]ファイル一覧[/bold green]を取得します")
-    
+    console.print("[bold green]ファイル一覧[/bold green]を取得します")
+
     if prefix:
         console.print(f"プレフィックス: {prefix}")
-    
+
     try:
         files = file_repo.list_files(prefix=prefix)
-        
+
         if not files:
             console.print("[yellow]ファイルが見つかりませんでした[/yellow]")
             return
-        
+
         # テーブルで表示
         table = Table(title="ファイル一覧")
         table.add_column("ファイル名", style="cyan")
         table.add_column("サイズ (bytes)", style="green")
         table.add_column("コンテンツタイプ", style="yellow")
         table.add_column("最終更新日時", style="magenta")
-        
+
         for file in files:
             table.add_row(
                 file.name,
                 str(file.size) if file.size else "N/A",
                 file.content_type or "N/A",
-                file.last_modified.strftime("%Y-%m-%d %H:%M:%S") if file.last_modified else "N/A"
+                file.last_modified.strftime("%Y-%m-%d %H:%M:%S") if file.last_modified else "N/A",
             )
-        
+
         console.print(table)
         console.print(f"[bold blue]合計: {len(files)}件[/bold blue]")
-    
+
     except Exception as e:
         console.print(f"[bold red]エラー[/bold red]: {str(e)}")
 
 
 @app.command()
 def upload_file(
     file_path: str = typer.Argument(..., help="アップロードするファイルのパス"),
-    blob_name: Optional[str] = typer.Option(None, "--name", "-n", help="Blob名（指定しない場合はファイル名を使用）"),
+    blob_name: str | None = typer.Option(None, "--name", "-n", help="Blob名（指定しない場合はファイル名を使用）"),
 ):
     """単一のファイルをアップロードする"""
     file_path_obj = Path(file_path)
-    
+
     if not file_path_obj.exists():
         console.print(f"[bold red]エラー[/bold red]: ファイル '{file_path}' が見つかりません")
         return
-    
+
     if not file_path_obj.is_file():
         console.print(f"[bold red]エラー[/bold red]: '{file_path}' はファイルではありません")
         return
-    
+
     blob_name = blob_name or file_path_obj.name
     console.print(f"[bold green]ファイル[/bold green]: {file_path} -> {blob_name}")
-    
+
     try:
         with open(file_path_obj, "rb") as f:
             file_data = f.read()
-        
+
         uploaded_file = file_repo.upload_file(
             file_name=blob_name,
             file_data=file_data,
-            content_type=None  # Let Azure detect the content type
+            content_type=None,  # Let Azure detect the content type
         )
-        
-        console.print(f"[bold green]アップロード成功[/bold green]")
+
+        console.print("[bold green]アップロード成功[/bold green]")
         console.print(f"  ファイル名: {uploaded_file.name}")
         console.print(f"  サイズ: {uploaded_file.size} bytes")
         console.print(f"  コンテンツタイプ: {uploaded_file.content_type}")
         console.print(f"  URL: {uploaded_file.url}")
-    
+
     except Exception as e:
         console.print(f"[bold red]エラー[/bold red]: {str(e)}")
 
 
 @app.command()
 def upload_multiple_files(
-    file_paths: List[str] = typer.Argument(..., help="アップロードするファイルのパス（複数指定可能）"),
+    file_paths: list[str] = typer.Argument(..., help="アップロードするファイルのパス（複数指定可能）"),
 ):
     """複数のファイルを同時にアップロードする"""
-    console.print(f"[bold green]複数ファイル[/bold green]をアップロードします")
-    
+    console.print("[bold green]複数ファイル[/bold green]をアップロードします")
+
     # ファイルの存在チェック
     valid_files = []
     for file_path in file_paths:
@@ -112,49 +110,49 @@ def upload_multiple_files(
             console.print(f"[bold red]警告[/bold red]: '{file_path}' はファイルではありません - スキップします")
             continue
         valid_files.append(file_path_obj)
-    
+
     if not valid_files:
         console.print("[bold red]エラー[/bold red]: 有効なファイルが見つかりませんでした")
         return
-    
+
     try:
         file_data_list = []
         for file_path_obj in valid_files:
             with open(file_path_obj, "rb") as f:
                 file_data = f.read()
             file_data_list.append((file_path_obj.name, file_data, None))
-        
+
         uploaded_files = file_repo.upload_files(file_data_list)
-        
+
         console.print(f"[bold green]アップロード成功[/bold green]: {len(uploaded_files)}件")
         for uploaded_file in uploaded_files:
             console.print(f"  - {uploaded_file.name} ({uploaded_file.size} bytes)")
-    
+
     except Exception as e:
         console.print(f"[bold red]エラー[/bold red]: {str(e)}")
 
 
 @app.command()
 def download_file(
     blob_name: str = typer.Argument(..., help="ダウンロードするBlobの名前"),
-    output_path: Optional[str] = typer.Option(None, "--output", "-o", help="出力ファイルのパス"),
+    output_path: str | None = typer.Option(None, "--output", "-o", help="出力ファイルのパス"),
 ):
     """ファイルをダウンロードする"""
     console.print(f"[bold green]ファイル[/bold green]: {blob_name} をダウンロードします")
-    
+
     try:
         file_data = file_repo.download_file(blob_name)
-        
+
         output_path = output_path or blob_name
         output_path_obj = Path(output_path)
-        
+
         with open(output_path_obj, "wb") as f:
             f.write(file_data)
-        
-        console.print(f"[bold green]ダウンロード成功[/bold green]")
+
+        console.print("[bold green]ダウンロード成功[/bold green]")
         console.print(f"  出力先: {output_path_obj.absolute()}")
         console.print(f"  サイズ: {len(file_data)} bytes")
-    
+
     except Exception as e:
         console.print(f"[bold red]エラー[/bold red]: {str(e)}")
 
@@ -165,16 +163,16 @@ def get_file_info(
 ):
     """ファイル情報を取得する"""
     console.print(f"[bold green]ファイル情報[/bold green]: {blob_name}")
-    
+
     try:
         file_info = file_repo.get_file_info(blob_name)
-        
+
         console.print(f"  ファイル名: {file_info.name}")
         console.print(f"  サイズ: {file_info.size} bytes")
         console.print(f"  コンテンツタイプ: {file_info.content_type}")
         console.print(f"  最終更新日時: {file_info.last_modified}")
         console.print(f"  URL: {file_info.url}")
-    
+
     except Exception as e:
         console.print(f"[bold red]エラー[/bold red]: {str(e)}")
 
@@ -186,7 +184,7 @@ def delete_file(
 ):
     """ファイルを削除する"""
     console.print(f"[bold green]ファイル削除[/bold green]: {blob_name}")
-    
+
     try:
         # 削除前に確認
         if not force:
@@ -195,45 +193,45 @@ def delete_file(
             console.print(f"  ファイル名: {file_info.name}")
             console.print(f"  サイズ: {file_info.size} bytes")
             console.print(f"  最終更新日時: {file_info.last_modified}")
-            
+
             if not typer.confirm("削除してもよろしいですか？"):
                 console.print("[yellow]削除をキャンセルしました[/yellow]")
                 return
-        
+
         file_repo.delete_file(blob_name)
         console.print(f"[bold green]削除成功[/bold green]: {blob_name}")
-    
+
     except Exception as e:
         console.print(f"[bold red]エラー[/bold red]: {str(e)}")
 
 
 @app.command()
 def delete_multiple_files(
-    blob_names: List[str] = typer.Argument(..., help="削除するBlobの名前（複数指定可能）"),
+    blob_names: list[str] = typer.Argument(..., help="削除するBlobの名前（複数指定可能）"),
     force: bool = typer.Option(False, "--force", "-f", help="確認なしで削除する"),
 ):
     """複数のファイルを同時に削除する"""
     console.print(f"[bold green]複数ファイル削除[/bold green]: {len(blob_names)}件")
-    
+
     try:
         # 削除前に確認
         if not force:
             console.print("以下のファイルを削除しようとしています：")
             for blob_name in blob_names:
                 console.print(f"  - {blob_name}")
-            
+
             if not typer.confirm("削除してもよろしいですか？"):
                 console.print("[yellow]削除をキャンセルしました[/yellow]")
                 return
-        
+
         deleted_files = file_repo.delete_files(blob_names)
         console.print(f"[bold green]削除成功[/bold green]: {len(deleted_files)}件")
         for deleted_file in deleted_files:
             console.print(f"  - {deleted_file}")
-    
+
     except Exception as e:
         console.print(f"[bold red]エラー[/bold red]: {str(e)}")
 
 
 if __name__ == "__main__":
-    app()
+    app()

template_fastapi/models/file.py

@@ -1,16 +1,15 @@
 from datetime import datetime
-from typing import Optional
 
 from pydantic import BaseModel, ConfigDict
 
 
 class File(BaseModel):
     """ファイル情報を表すモデル"""
-    
+
     model_config = ConfigDict(extra="ignore")
-    
+
     name: str
-    size: Optional[int] = None
-    content_type: Optional[str] = None
-    last_modified: Optional[datetime] = None
-    url: Optional[str] = None
+    size: int | None = None
+    content_type: str | None = None
+    last_modified: datetime | None = None
+    url: str | None = None

template_fastapi/repositories/files.py

@@ -1,7 +1,5 @@
-from typing import List, Optional
-
-from azure.storage.blob import BlobServiceClient, BlobClient, ContainerClient
 from azure.core.exceptions import ResourceNotFoundError
+from azure.storage.blob import BlobServiceClient, ContainerClient
 
 from template_fastapi.models.file import File
 from template_fastapi.settings.azure_blob_storage import get_azure_blob_storage_settings
@@ -35,7 +33,7 @@ def container_client(self) -> ContainerClient:
             )
         return self._container_client
 
-    def list_files(self, prefix: Optional[str] = None) -> List[File]:
+    def list_files(self, prefix: str | None = None) -> list[File]:
         """ファイル一覧を取得する"""
         try:
             blobs = self.container_client.list_blobs(name_starts_with=prefix)
@@ -52,29 +50,29 @@ def list_files(self, prefix: Optional[str] = None) -> List[File]:
         except Exception as e:
             raise Exception(f"ファイル一覧の取得に失敗しました: {str(e)}")
 
-    def upload_file(self, file_name: str, file_data: bytes, content_type: Optional[str] = None) -> File:
+    def upload_file(self, file_name: str, file_data: bytes, content_type: str | None = None) -> File:
         """ファイルをアップロードする"""
         try:
             blob_client = self.container_client.get_blob_client(file_name)
             blob_client.upload_blob(
-                file_data,
-                overwrite=True,
-                content_settings={'content_type': content_type} if content_type else None
+                file_data, overwrite=True, content_settings={"content_type": content_type} if content_type else None
             )
-            
+
             # アップロードされたファイル情報を取得
             blob_properties = blob_client.get_blob_properties()
             return File(
                 name=blob_properties.name,
                 size=blob_properties.size,
-                content_type=blob_properties.content_settings.content_type if blob_properties.content_settings else None,
+                content_type=blob_properties.content_settings.content_type
+                if blob_properties.content_settings
+                else None,
                 last_modified=blob_properties.last_modified,
-                url=blob_client.url
+                url=blob_client.url,
             )
         except Exception as e:
             raise Exception(f"ファイルのアップロードに失敗しました: {str(e)}")
 
-    def upload_files(self, files: List[tuple[str, bytes, Optional[str]]]) -> List[File]:
+    def upload_files(self, files: list[tuple[str, bytes, str | None]]) -> list[File]:
         """複数のファイルを同時にアップロードする"""
         uploaded_files = []
         for file_name, file_data, content_type in files:
@@ -100,9 +98,11 @@ def get_file_info(self, file_name: str) -> File:
             return File(
                 name=blob_properties.name,
                 size=blob_properties.size,
-                content_type=blob_properties.content_settings.content_type if blob_properties.content_settings else None,
+                content_type=blob_properties.content_settings.content_type
+                if blob_properties.content_settings
+                else None,
                 last_modified=blob_properties.last_modified,
-                url=blob_client.url
+                url=blob_client.url,
             )
         except ResourceNotFoundError:
             raise Exception(f"ファイル '{file_name}' が見つかりません")
@@ -120,10 +120,10 @@ def delete_file(self, file_name: str) -> bool:
         except Exception as e:
             raise Exception(f"ファイルの削除に失敗しました: {str(e)}")
 
-    def delete_files(self, file_names: List[str]) -> List[str]:
+    def delete_files(self, file_names: list[str]) -> list[str]:
         """複数のファイルを同時に削除する"""
         deleted_files = []
         for file_name in file_names:
             if self.delete_file(file_name):
                 deleted_files.append(file_name)
-        return deleted_files
+        return deleted_files