h SSKJr SSKrSSKrSSKrSSKrSSKrSSKJr SSKJr SSK J r "SS\R5r \SSj5r SSS jjr\4SS jjr\4SS jjrSS jrSSSjjrS\ "S5S 4SSjjrg)) annotationsN)contextmanager)datetime)Pathc.\rSrSrSrSSjrSrSrSrg) WorkingDirectorya A context manager and decorator for temporarily changing the working directory. This class allows for the temporary change of the working directory using a context manager or decorator. It ensures that the original working directory is restored after the context or decorated function completes. Attributes: dir (Path | str): The new directory to switch to. cwd (Path): The original current working directory before the switch. Methods: __enter__: Changes the current directory to the specified directory. __exit__: Restores the original working directory on context exit. Examples: Using as a context manager: >>> with WorkingDirectory('/path/to/new/dir'): >>> # Perform operations in the new directory >>> pass Using as a decorator: >>> @WorkingDirectory('/path/to/new/dir') >>> def some_function(): >>> # Perform operations in the new directory >>> pass c`Xl[R"5R5Ulg)zJInitialize the WorkingDirectory context manager with the target directory.N)dirrcwdresolve)selfnew_dirs Q/home/james-whalen/.local/lib/python3.13/site-packages/ultralytics/utils/files.py__init__WorkingDirectory.__init__+s88:%%'cD[R"UR5 g)zZChange the current working directory to the specified directory upon entering the context.N)oschdirr )rs r __enter__WorkingDirectory.__enter__0 rcD[R"UR5 g)z@Restore the original working directory when exiting the context.N)rrr )rexc_typeexc_valexc_tbs r__exit__WorkingDirectory.__exit__4rr)r r N)r str | Path) __name__ __module__ __qualname____firstlineno____doc__rrr__static_attributes__rrrrs6( rrc ## S[U5;Ga@[U[5n[U5n[R"5n[U5UR R SS5- nUR5(a[R"X5 OEUR5(a0URRSSS9 [R"X5 U(a [U5OUv UR5(a[R"X0SS9 O+UR5(a[R"X05 SSS5 gUv g!UR5(a[R"X0SS9 fUR5(a[R"X05 ff=f!,(df  g=f7f)aM Context manager to handle paths with spaces in their names. If a path contains spaces, it replaces them with underscores, copies the file/directory to the new path, executes the context code block, then copies the file/directory back to its original location. Args: path (str | Path): The original path that may contain spaces. Yields: (Path | str): Temporary path with spaces replaced by underscores if spaces were present, otherwise the original path. Examples: >>> with spaces_in_path('/path/with spaces') as new_path: >>> # Your code here >>> pass  _Tparentsexist_ok) dirs_exist_okN)str isinstancertempfileTemporaryDirectorynamereplaceis_dirshutilcopytreeis_fileparentmkdircopy2)pathstringtmp_dirtmp_paths rspaces_in_pathr@9s?* c$iD#&Dz ( ( *gG}tyy'8'8c'BBH{{}}/%%dT%B T, 1'-c(m8;??$$OOH$G%%''LL0'+ *. ??$$OOH$G%%''LL0(%+ *s9AGBF4E4AF4 GAF11F44 G>GFc[U5nUR5(aU(dUR5(aURS5UR4OUS4up[ SS5H3nUUUU3n[ RRU5(aM3 O [W5nU(aURSSS9 U$)a- Increment a file or directory path, i.e., runs/exp --> runs/exp{sep}2, runs/exp{sep}3, ... etc. If the path exists and `exist_ok` is not True, the path will be incremented by appending a number and `sep` to the end of the path. If the path is a file, the file extension will be preserved. If the path is a directory, the number will be appended directly to the end of the path. Args: path (str | Path): Path to increment. exist_ok (bool, optional): If True, the path will not be incremented and returned as-is. sep (str, optional): Separator to use between the path and the incrementation number. mkdir (bool, optional): Create a directory if it does not exist. Returns: (Path): Incremented path. Examples: Increment a directory path: >>> from pathlib import Path >>> path = Path("runs/exp") >>> new_path = increment_path(path) >>> print(new_path) runs/exp2 Increment a file path: >>> path = Path("runs/exp/results.txt") >>> new_path = increment_path(path) >>> print(new_path) runs/exp/results2.txt i'Tr+) rexistsr8 with_suffixsuffixrangerr<r:)r<r-sepr:rFnps rincrement_pathrKms> :D {{}}X>Bllnn((,dkk:SWY[R\ q$A&aS)A77>>!$$ Aw  4$ / Krc[R"5[R"[U5R 5R 5- nUR $)z>Return days since the last modification of the specified file.)rnow fromtimestamprstatst_mtimedays)r<dts rfile_agerSs7 (00d1B1K1KL LB 77Nrc[R"[U5R5R5nUR SUR SUR3$)z7Return the file modification date in 'YYYY-M-D' format.-)rrNrrOrPyearmonthday)r<ts r file_daterZsFtDz099:AffXQqwwiq ((rc*[U[[45(axSn[U5nUR5(aUR 5R U- $UR 5(a$[SURS555U- $g)z9Return the size of a file or directory in megabytes (MB).ic3# UH5oR5(dMUR5Rv M7 g7f)N)r8rOst_size).0fs r file_size..s'R1BAiik'qvvx''1Bs?!?z**/*g) r0r/rr8rOr]r5sumglob)r<mbs r file_sizeresq$d $$ Dz <<>>99;&&+ + [[]]R61BRRUWW W r.c[R"US3SS9nU(a"[U[RRS9$S$)zcReturn the path to the most recent 'last.pt' file in the specified directory for resuming training.z /**/last*.ptT) recursive)keyrB)rcmaxrr<getctime) search_dir last_lists rget_latest_runrns7 ZL 5FI3<3ybgg.. /D"Dr)z yolo11n.ptc4SSKJn SSKJn US- nUR SSS9 UHqnX- n[ SU35 U"U5nUR 5 U(aU"S5URlXV- n [ S US U 35 URU 5 Ms g ) aM Update and re-save specified YOLO models in an 'updated_models' subdirectory. Args: model_names (tuple, optional): Model filenames to update. source_dir (Path, optional): Directory containing models and target subdirectory. update_names (bool, optional): Update model names from a data YAML. Examples: Update specified YOLO models and save them in 'updated_models' subdirectory: >>> from ultralytics.utils.files import update_models >>> model_names = ("yolo11n.pt", "yolov8s.pt") >>> update_models(model_names, source_dir=Path("/models"), update_names=True) r)YOLO)default_class_namesupdated_modelsTr+zLoading model from z coco8.yamlz Re-saving z model to N) ultralyticsrpultralytics.nn.autobackendrqr:printhalfmodelnamessave) model_names source_dir update_namesrprq target_dir model_name model_pathrw save_paths r update_modelsrs!>..JTD1! ,  #J<01Z   3L AEKK +   :,j <= 9"r)r<r )FrBF) r<r r-boolrHr/r:rreturnr)r<r rint)r<r rr/)r<r rfloat)rf)rlr/rr/)rztupler{rr|r) __future__r contextlibrcrr6r1rrpathlibrContextDecoratorrr@rK__file__rSrZrernrr'rrrs# %'z22'T00f-`!) "*) E (74PS9kp$r