k7i,SSKrSSKrSSKrSSKJr SSKJr "SS\5r"SS\5r "SS \5r "S S \5r SS SS SSSS.S\ S\\ S\\ S\ \-S\ S\ S\ S\ 4Sjjjrg)N)Sequence)Pathc\rSrSrSrSrg) EditorErrorzVRoot editor-related error. Root exception raised by all exceptions in :func:`.edit`. N__name__ __module__ __qualname____firstlineno____doc____static_attributes__rH/home/james-whalen/.local/lib/python3.13/site-packages/cyclopts/_edit.pyrrsrrc\rSrSrSrSrg)EditorDidNotSaveErrorz-User did not save upon exiting :func:`.edit`.rNr rrrrrs7rrc\rSrSrSrSrg)EditorDidNotChangeErrorz1User did not edit file contents in :func:`.edit`.rNr rrrrrs;rrc\rSrSrSrSrg)EditorNotFoundErrorz4Could not find a valid text editor for :func`.edit`.rNr rrrrrs>rr)nanovimnotepadgeditrzutf-8T)fallback_editors editor_argspathencodingsaverequired initial_textr r!r"r#r$r%returncSSKnSSKn[RR S5/UQ7H$n U (dM UR U 5(dM$ O [ eU(a&[U5nURRSSS9 O)[[R"SSSS 9R5nURXS 9 [R"5S - n [R"X:U 45 UR!5n UR#X/UQ5 UR!5n U(a U R$U R$::a[&eUR)US 9n UR1SS 9 U(a X:Xa[2eU $!UR*a n[-U S UR.35UeSnAff=f!UR1SS 9 f=f)aGet text input from a user by launching their default text editor. Parameters ---------- initial_text: str Initial text to populate the text file with. fallback_editors: Sequence[str] If the text editor cannot be determined from the environment variable ``EDITOR``, attempt to use these text editors in the order provided. editor_args: Sequence[str] Additional CLI arguments that are passed along to the editor-launch command. path: Union[str, Path] If specified, the path to the file that should be opened. Text editors typically display this, so a custom path may result in a better user-interface. Defaults to a temporary text file. encoding: str File encoding to use. save: bool **Require** the user to save before exiting the editor. Otherwise raises :exc:`EditorDidNotSaveError`. required: bool **Require** for the saved text to be different from ``initial_text``. Otherwise raises :exc:`EditorDidNotChangeError`. Raises ------ EditorError Base editor error exception. Explicitly raised if editor subcommand returned a non-zero exit code. EditorNotFoundError A suitable text editor could not be found. EditorDidNotSaveError The user exited the text-editor without saving and ``save=True``. EditorDidNotChangeError The user did not change the file contents and ``required=True``. Returns ------- str The resulting text that was saved by the text editor. rNEDITORT)exist_okparentsz.txtwF)suffixmodedelete)r#z exited with status ) missing_ok)shutil subprocessosenvirongetwhichrrparentmkdirtempfileNamedTemporaryFilename write_texttimeutimestat check_callst_mtimer read_textCalledProcessErrorr returncodeunlinkr)r&r r!r"r#r$r%r2r3editor past_time start_statend_stat edited_textes reditrMs`::>>(+?.>? 6fll6** @"! Dz 46H//vCPUV[[\OOLO4 aIHHTy)*J %v:k:;99; H%%)<)<<' 'nnhn7  t $K/%%   ( (PVH$8GHaOP t $s%AE>>F.F))F..F11G)r)r4r:r>collections.abcrpathlibr ExceptionrrrrstrboolrMrrrrSs  $)8K8