どのノートブックも「開いて実行するだけ」。clone / 依存導入 / 認証を自動化し、環境や外部の助けが不要。
各セルが「何を・なぜ・どう読むか」を言葉で説明。コードを読んで理解できるから、AI に頼らず使えます。
pytest と main.py --help だけで動作を保証。実行前にコマンドの意味を自分で確認できます。
クォータ・ストレージ・フォルダ使用量をグラフ化し、結果を数字でなく「目で」検証。理解の裏付けになります。
Drive 運営で必要な操作を、コマンドとインタラクティブ UI の両方から実行できます。
フォルダ単位で再帰的に取得し、階層構造を視覚化。
MD5 ハッシュで同一ファイルを発見し、無駄な容量を可視化。
名前 / フルテキスト / サイズ / 更新日 / 並び替え / スター。
NEWダウンロード・アップロード・移動・コピー・名前変更・削除（進捗バー付き）。
総容量・使用量・空き・ゴミ箱使用量を即座に把握。
NEWフォルダごとの合計サイズ・ファイル数を集計し、整理ポイントを特定。
NEWファイル種別ごとの使用量を matplotlib / plotly グラフで可視化。
共有設定の取得・付与、全ファイルのアクセス権限一覧。
ファイルのリビジョン履歴と更新者を確認。
フォルダのスナップショットを日付付きで作成。
Drive の変更イベントをポーリングして通知。
スケジュールによる自動バックアップを登録・管理。
typer + rich によるカラー出力。全コマンドに --help が自動生成されます。
$ python main.py quota ┌─ Drive クォータ ─────────────┐ │ 項目 値 │ │ 総容量 100.00 GB │ │ 使用量 45.32 GB (45.3%) │ │ 空き容量 54.68 GB │ │ ゴミ箱 1.20 GB │ │ 使用状況 █████████░░░░░ 45% │ └─────────────────────────────┘
$ python main.py du ┌─ フォルダ別使用量 ──────────┐ │ 名前 サイズ # │ │ photos 20.5 GB 120 │ │ documents 12.0 GB 84 │ │ archives 8.1 GB 300 │ └────────────────────────────┘ $ python main.py search -q raptor --full-text --min-size 1000
ipywidgets のリッチ UI で、認証から分析までブラウザ上で完結します。
| ノートブック | 内容 | |
|---|---|---|
| 00_認証とセットアップ | セットアップ + 認証 | |
| 01_ファイルツリー | ツリー表示 | |
| 02_ファイル検索 | 検索 + 結果テーブル | |
| 03_重複ファイル検出 | MD5 重複スキャン | |
| 04_ストレージ分析 | matplotlib / plotly グラフ | |
| 05_ファイル操作 | DL / UL / Move / Copy / Rename / Delete | |
| 06_共有管理と権限 | 共有取得 / 追加 / 権限一覧 | |
| 07_バックアップとバージョン管理 | バックアップ + バージョン履歴 | |
| 08_クォータと容量 | 容量 / 使用量 / 空き / ゴミ箱 | NEW |
| 09_フォルダ別使用量 | フォルダごとの合計サイズ集計 | NEW |
| 10_高度な検索 | 複数フィルタを組み合わせた検索 | NEW |
同じコアを共有しつつ、用途に合わせて Colab と CLI を使い分けるのがポイントです。
/tmp は保持されません。毎セッションでセットアップセルを実行すれば、自動で clone + 更新（git pull）されます。Drive 上の既存パスへの直接書込みは drive.mount() で接続可能（API 経由時は不要）。
環境に応じて認証は自動判別。Colab ではブラウザ認証、ローカル CLI では OAuth で即利用できます。
pip install -r requirements.txt を実行。開発は pip install -e ".[dev]"。
Colab は自動ブラウザ認証。CLI は GOOGLE_CLIENT_ID / GOOGLE_CLIENT_SECRET を設定して初回 OAuth。
python main.py tree から一覧を確認。ノートブックは notebooks/ を Colab で開いて実行。