kaggle 2.2.0__tar.gz → 2.2.1__tar.gz

{kaggle-2.2.0 → kaggle-2.2.1}/CHANGELOG.md

@@ -3,6 +3,16 @@ Changelog
 
 ### Next
 
+### 2.2.1
+
+* Add `kaggle competitions team-submissions` command (#1036)
+* Add `kaggle quota` command for GPU/TPU accelerator quota (#1029)
+* Support optional kernel version in specifier (#1035)
+* feat(benchmarks): Add log and download source files (#1019)
+* Fix benchmarks CLI error handling and UX improvements (#1024, #1026, #1028, #1030, #1032, #1037, #1039)
+* Fix JSON serialization and download label display (#1038, #1040, #1042)
+* Set proper permissions on auth file (#1033)
+
 ### 2.2.0
 
 * Add test runner workflow

{kaggle-2.2.0 → kaggle-2.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kaggle
-Version: 2.2.0
+Version: 2.2.1
 Summary: Access Kaggle resources anywhere
 Project-URL: Homepage, https://github.com/Kaggle/kaggle-cli
 Project-URL: Issues, https://github.com/Kaggle/kaggle-cli/issues
@@ -214,10 +214,11 @@ Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.11
 Requires-Dist: bleach
 Requires-Dist: jupytext
-Requires-Dist: kagglesdk<1.0,>=0.1.24
+Requires-Dist: kagglesdk<1.0,>=0.1.27
 Requires-Dist: packaging
 Requires-Dist: protobuf
 Requires-Dist: python-dateutil
+Requires-Dist: python-dotenv
 Requires-Dist: python-slugify
 Requires-Dist: requests
 Requires-Dist: tqdm

{kaggle-2.2.0 → kaggle-2.2.1}/docs/benchmarks.md

@@ -329,10 +329,29 @@ Downloads and extracts the output zip archive for each completed run. Files are
    ├── output files...
 ```
 
-Already-downloaded runs (where the output directory exists) are automatically skipped unless the `-f` / `--force` flag is used, in which case they are overwritten.
+Progress is rendered as a table with one row per run:
+
+```
+Model                File                                     Size       Progress
+──────────────────── ──────────────────────────────────────── ────────── ──────────
+gemini-2.5-pro       gemini-2.5-pro/12345/                    1.24MB     Done
+claude-sonnet-4      claude-sonnet-4/12346/                   2.10MB     Cached
+```
+
+The `Size` column reports the extracted on-disk size of the run's output directory. The `Progress` column is one of `Done` (freshly downloaded), `Cached` (output directory already on disk from a previous download), or `Bad zip` (downloaded archive was corrupt).
+
+Already-downloaded runs (where the output directory exists) are automatically skipped — they appear as `Cached` rows — unless the `-f` / `--force` flag is used, in which case they are overwritten.
 
 When `--include-source` is used, the downloaded zip also contains the kernel session's source files (e.g., `__notebook__.ipynb` and `__notebook_source__.ipynb`).
 
+If you re-run with `-s` after a previous download that omitted source notebooks, the cached directories are not re-fetched and the `-s` flag is effectively ignored. The CLI detects this and prints a tip after the summary:
+
+```
+Tip: 2 cached run(s) lack source notebooks. Re-run with -f -s to fetch them.
+```
+
+Use `-f -s` together to force re-download and backfill the source notebooks into the cached runs.
+
 ---
 
 ### `kaggle benchmarks tasks log`

{kaggle-2.2.0 → kaggle-2.2.1}/docs/simulation_competitions.md

@@ -140,6 +140,30 @@ kaggle competitions logs 98765432 1 -p ./logs
 
 This downloads the log file as `episode-98765432-agent-0-logs.json`.
 
+## 9. Inspect Top Teams' Active Agents
+
+You can study how the leading teams' agents are performing — useful for scouting strategies or understanding the metagame. Start from the leaderboard to grab the team ID:
+
+```bash
+kaggle competitions leaderboard connectx -s
+```
+
+This prints a table with columns `teamId`, `teamName`, `submissionDate`, `score`. Take the `teamId` of the team you want to inspect (e.g., first place), then list every active submission they have on the leaderboard:
+
+```bash
+kaggle competitions team-submissions 42
+```
+
+This returns the team's public-safe submissions — `id`, `dateSubmitted`, and `publicScore`. For simulation competitions every leaderboard-eligible submission is listed (not just the best one), so you can see the full rotation of agents a top team is fielding.
+
+Pick the submission with the highest `publicScore` and list its episodes, just like you would for your own:
+
+```bash
+kaggle competitions episodes 98765432
+```
+
+From there you can pull replays and agent logs for any episode that submission played in (`kaggle competitions replay <episode_id>` / `kaggle competitions logs <episode_id> <agent_index>`).
+
 ## Putting It All Together
 
 Here's a typical workflow for iterating on a simulation competition agent:
@@ -167,4 +191,8 @@ kaggle competitions logs 98765432 0
 
 # Check the leaderboard
 kaggle competitions leaderboard connectx -s
+
+# Scout the leader: list their active agents, then pick the best one's episodes
+kaggle competitions team-submissions <leader-team-id>
+kaggle competitions episodes <best-submission-id>
 ```

{kaggle-2.2.0 → kaggle-2.2.1}/pyproject.toml

@@ -24,7 +24,7 @@ keywords = ["Kaggle", "API"]
 requires-python = ">= 3.11"
 dependencies = [
     "bleach",
-    "kagglesdk >= 0.1.24, < 1.0", # sync with kagglehub
+    "kagglesdk >= 0.1.27, < 1.0", # sync with kagglehub
     "python-slugify",
     "requests",
     "python-dateutil",
@@ -33,6 +33,7 @@ dependencies = [
     "packaging",
     "protobuf",
     "jupytext",
+    "python-dotenv",
 ]
 
 [project.scripts]
@@ -97,7 +98,8 @@ module = [
     # TODO(b/505845982): Generate type hints for kagglesdk
     "kagglesdk.*",
     "kaggle_api_extended.*",
-    "jupytext.*"
+    "jupytext.*",
+    "dotenv.*"
 ]
 ignore_missing_imports = true
 

{kaggle-2.2.0 → kaggle-2.2.1}/requirements.lock

@@ -26,7 +26,7 @@ jupyter-core==5.9.1
     # via nbformat
 jupytext==1.19.1
     # via kaggle (pyproject.toml)
-kagglesdk==0.1.24
+kagglesdk==0.1.25
     # via kaggle (pyproject.toml)
 markdown-it-py==4.0.0
     # via
@@ -50,6 +50,8 @@ protobuf==7.34.1
     #   kagglesdk
 python-dateutil==2.9.0.post0
     # via kaggle (pyproject.toml)
+python-dotenv==1.2.2
+    # via kaggle (pyproject.toml)
 python-slugify==8.0.4
     # via kaggle (pyproject.toml)
 pyyaml==6.0.3

{kaggle-2.2.0 → kaggle-2.2.1}/skills/references/benchmarks.md

@@ -254,8 +254,10 @@ kaggle b t download my-task --include-source
 **Behavior details:**
 - Downloads outputs for all runs in a **terminal state** — this includes both `COMPLETED` and `ERRORED` runs (errored runs may still have partial output)
 - Downloads zip archives and extracts them automatically
-- Already-downloaded runs are skipped (use `--force` to re-download): `Skipping gemini-2.5-pro (run 123) — already downloaded to ./my-task/1/gemini-2.5-pro/123`
-- Corrupt zips: Warning printed, raw `.zip` file kept, continues with other models
+- Progress is rendered as a table with `Model | File | Size | Progress` columns. `Size` is the extracted on-disk size of the run's output directory.
+- Already-downloaded runs are skipped (use `--force` to re-download) and shown as a `Cached` row in the table
+- Corrupt zips show as a `Bad zip` row; the raw `.zip` is kept on disk and the next run is processed
+- If `-s` is passed but a cached run's directory lacks source notebooks (`__notebook__.ipynb` / `__notebook_source__.ipynb`), the cached row is left untouched and a tip is printed after the summary: `Tip: N cached run(s) lack source notebooks. Re-run with -f -s to fetch them.` — use `-f -s` together to backfill source notebooks into existing cached runs.
 - No downloadable runs (all still in progress): `No downloadable runs yet — N run(s) still in progress. Use 'kaggle b t status my-task' to check progress.`
 - No runs at all: `No runs found for task 'my-task'. Use 'kaggle b t run my-task' to start one.`
 

{kaggle-2.2.0 → kaggle-2.2.1}/src/kaggle/__init__.py

@@ -2,7 +2,7 @@
 from __future__ import absolute_import
 from kaggle.api.kaggle_api_extended import KaggleApi
 
-__version__ = "2.2.0"
+__version__ = "2.2.1"
 
 api = KaggleApi()
 api.authenticate()