cu.drive: Drive, runs, and settings

Google Drive mounting, run folders, and persistent defaults.

Run folders

colabutilscs4337.drive.new_run(slug=None, *, notebook=None, runs_dir=None, mount=True, metadata=None)[source]

Create and return a new run folder on Drive.

The folder is <runs_dir>/<notebook>_<YYYYmmdd-HHMMSS>_<slug>. slug labels this run (for example "resnet34-lr1e-3"); a random one like "brave-otter" is generated when omitted. A run.json with runtime details is written inside.

Parameters:

  • slug (str | None)

  • notebook (str | None)

  • runs_dir (str | PathLike | None)

  • mount (bool)

  • metadata (dict | None)

Return type:

Run

class colabutilscs4337.drive.Run(path, notebook, timestamp, slug)[source]

Bases: object

A run folder. Usable anywhere a path is: open(run / "log.txt", "w").

Parameters:

  • path (Path)

  • notebook (str)

  • timestamp (str)

  • slug (str)

colabutilscs4337.drive.list_runs(notebook=None, runs_dir=None)[source]

Run folders, oldest first. Filter to one notebook with notebook=.

Parameters:

  • notebook (str | None)

  • runs_dir (str | PathLike | None)

Return type:

list[Path]

colabutilscs4337.drive.latest_run(notebook=None, runs_dir=None)[source]
Parameters:

  • notebook (str | None)

  • runs_dir (str | PathLike | None)

Return type:

Path | None

colabutilscs4337.drive.slugify(text, max_length=60)[source]

Filesystem-safe slug: "Lab 3 - CNNs (v2)" -> "Lab-3-CNNs-v2".

Parameters:

  • text (str)

  • max_length (int)

Return type:

str

colabutilscs4337.drive.random_slug(rng=None)[source]
Parameters:

rng (Random | None)

Return type:

str

Drive

colabutilscs4337.drive.mount(force_remount=False)[source]

Mount Google Drive at /content/drive (no-op if mounted); returns “My Drive”.

Parameters:

force_remount (bool)

Return type:

Path

colabutilscs4337.drive.is_mounted()[source]
Return type:

bool

Settings and data folder

colabutilscs4337.drive.data_dir(*parts, create=True)[source]

Path inside the data folder (/content/data in Colab by default).

Parameters:

  • parts (str)

  • create (bool)

Return type:

Path

colabutilscs4337.drive.get_config(**overrides)[source]

Current configuration, merging defaults, the Drive config file, env vars, and overrides.

Parameters:

overrides (str | None)

Return type:

Config

colabutilscs4337.drive.set_config(data_dir=None, runs_dir=None, timezone=None, save=True)[source]

Update defaults and (by default) save them to Drive for future sessions.

Parameters:

  • data_dir (str | PathLike | None)

  • runs_dir (str | PathLike | None)

  • timezone (str | None)

  • save (bool)

Return type:

Config

colabutilscs4337.drive.reset_config()[source]

Delete the saved config file so built-in defaults apply again.

Return type:

None

colabutilscs4337.drive.config_path()[source]
Return type:

Path

colabutilscs4337.drive.default_config()[source]
Return type:

Config

class colabutilscs4337.drive.Config(data_dir: 'str', runs_dir: 'str', timezone: 'str' = 'UTC')[source]

Bases: object

Parameters:

  • data_dir (str)

  • runs_dir (str)

  • timezone (str)