ybjA  %SSKJr SSKrSSKrSSKrSSKJr SSKJr SSK J r J r SSK J r SSKJrJr \R"S :XGamSSKrSSKrSS KJr S rS \S 'SrS \S'SrS \S'\\-\-rS \S'SrS \S'SrS \S'SrS \S'SrS \S'SrS \S'SrS \S'Sr S \S'Sr!S \S '\\ -\!-r"S \S!'Sr#S \S"'Sr$S \S#'Sr%S \S$'S%r&S \S&'S'r'S \S('Sr(S \S)'S*r)S \S+'S,r*S \S-'S.r+S \S/'S0r,S1\S2'S3r-S1\S4'\R\"S55r/S6\S7'\R\"S8S9S:9r0S6\S;'"S<S=\Rb5r2"S>S?\Rb5r3"S@SA\Rb5r4"SBSC\Rb5r5"SDSE\Rb5r6\Rn\/Rpl9\Rt"\Rv5\Rx\Rt"\35\Rt"\45\Rt"\Rz5\R|\R|\R|\R|\R~\R|/ \/Rpl@\Rn\/Rl9\R\Rt"\25\R~\R~/\/Rl@S\/Rl9\Rt"\25/\/Rl@\R|\/Rl9\Rn/\/Rl@\Rv/\0Rl@\R\0Rl9\Rv\Rt"\65/\0Rl@\R\0Rl9\Rv\Rx\Rx\Rx\Rx\Rt"\55/\0Rl@\R\0Rl9\Rv\Rx\Rx\Rx\Rt"\55/\0Rl@\R\0Rl9SMSFjrJSNSGjrK"SHSI\ 5rLSOSJjrMSPSKjrNO "SLSI\ 5rLSI/rOg)Q) annotationsN)suppress)Path)Finalcast) BaseFileLock)ensure_directory_existsraise_on_not_writable_filewin32)wintypeslz Final[int] _GENERIC_READi@_GENERIC_WRITEi _SYNCHRONIZE_DESIRED_ACCESS_FILE_SHARE_READ_WRITE _FILE_OPEN_IF_FILE_ATTRIBUTE_READONLY_FILE_ATTRIBUTE_NORMALi_FILE_ATTRIBUTE_REPARSE_POINT _FILE_SYNCHRONOUS_IO_NONALERT@_FILE_NON_DIRECTORY_FILEi _FILE_OPEN_REPARSE_POINT_CREATE_OPTIONS_OBJ_CASE_INSENSITIVE _OWNER_WRITE_LOCKFILE_FAIL_IMMEDIATELY_LOCKFILE_EXCLUSIVE_LOCK!_ERROR_LOCK_VIOLATION_STATUS_SUCCESSl"_STATUS_ACCESS_DENIEDlC_STATUS_SHARING_VIOLATIONlV_STATUS_DELETE_PENDINGg?z Final[float]_ACCESS_DENIED_GRACEgMb`?_ACCESS_DENIED_RETRYntdllzFinal[ctypes.WinDLL]_ntdllkernel32T)use_last_error _kernel32cf\rSrSrS\R 4S\R 4S\R 44rSrg)_UNICODE_STRING=Length MaximumLengthBufferN) __name__ __module__ __qualname____firstlineno__r USHORTLPWSTR_fields___static_attributes__r7ڍ/tmp/claude-0/-home-danvics-docker-quiz/c1e0577a-e42c-4a3d-b1ea-3edd61103a4e/scratchpad/stt/lib/python3.13/site-packages/filelock/_windows.pyr2r2=s- x ' hoo . x ' r@r2c\rSrSrS\R 4S\R 4S\R"\ 54S\R 4S\R4S\R44r Sr g ) _OBJECT_ATTRIBUTESDr4 RootDirectory ObjectName AttributesSecurityDescriptorSecurityQualityOfServicer7N) r8r9r:r;r ULONGHANDLEctypesPOINTERr2c_void_pr>r?r7r@rArCrCDsV x~~ & hoo . 6>>/: ; 8>> * !6?? 3 ' 9  r@rCcL\rSrSrS\R 4S\R 44rSrg)_IO_STATUS_BLOCKNStatus Informationr7N)r8r9r:r;rLrNr>r?r7r@rArPrPNs! v ' FOO , r@rPc\rSrSrS\R 4S\R 4S\R4S\R4S\R44r Sr g) _OVERLAPPEDTInternal InternalHighOffset OffsetHighhEventr7N) r8r9r:r;rLrNr DWORDrKr>r?r7r@rArUrUTsE  ) V__ - x~~ & 8>> * x '  r@rUc \rSrSrS\R 4S\R 4S\R 4S\R 4S\R 4S\R 4S\R 4S \R 4S \R 4S \R 44 rS rg )_BY_HANDLE_FILE_INFORMATION]dwFileAttributesftCreationTimeftLastAccessTimeftLastWriteTimedwVolumeSerialNumber nFileSizeHigh nFileSizeLownNumberOfLinksnFileIndexHigh nFileIndexLowr7N) r8r9r:r;r r\FILETIMEr>r?r7r@rAr^r^]s  0 x00 1 !2!2 3  1 1 2 #X^^ 4 hnn - X^^ , x~~ . x~~ . hnn -  r@r^c ,[5n[[-n[R [ R "U5USSS[R"U55(ag[R"5nU[:Xag[R"U5e)NrrTF) rUr#r!r0 LockFileExmsvcrt get_osfhandlerLbyrefget_last_errorr%WinError)fd overlappedflagserrs rA_lock_fd_nonblockingrvsr!] (+EE    4 4R 8%Aq&,,WaJb c c##% ' 'ooc""r@c [5n[R[R"U5SSS[ R "U55(d)[ R"[ R"55eg)Nrr) rUr0 UnlockFileExrmrnrLrorqrp)rrrss rA _unlock_fdrysU ] %%f&:&:2&>1aV`Iabb//&"7"7"9: :cr@c,\rSrSrSrSSjrSSjrSrg)WindowsFileLockaQ Uses ``LockFileEx`` to hard lock a byte range of the lock file on Windows systems. Lock file cleanup: Windows attempts to delete the lock file after release, but deletion is not guaranteed in multi-threaded scenarios where another thread holds an open handle. The lock file may persist on disk, which does not affect lock correctness. cv[UR5 [UR5 [URUR 55nUcg[ U5nU(aUR U5 U(d[R"U5 gg![a [R"U5 ef=fN) r lock_filer _open_non_reparse_fd _open_moderv_mark_descriptor_owned BaseExceptionosclose)selfrrlockeds rA_acquireWindowsFileLock._acquires &t~~ 6 #DNN 3&dnndoo6GHBz -b1//3 !   s #B"B8cV[SURR5n[U5 UR 5 UR USS9 UR (d<[[5 [UR5R5 SSS5 gg!,(df  g=f)NintF)default_suppresses) r_context lock_file_fdry_mark_descriptor_released_close_released_fd_preserve_lock_filerOSErrorrrunlink)rrrs rA_releaseWindowsFileLock._releaseszeT]]778B rN  * * ,  # #B5 # A++g&(//1'&,&&s ,$B B(r7NreturnNoner8r9r:r;__doc__rrr?r7r@rAr{r{s  & 2r@r{c[R"SUS[R[R-5 U[ -(+n[ XS9up4U[:Xa[R"5[-nU[:Xac[R"5U:aJ[R"[5 [ XS9up4U[:Xa[R"5U:aMJU[:waUU[[1;ag[ R#U5n[%S[&R("U5R+5X5e[-5n[.R1U[&R2"U55(d@[&R4"5n[.R7U5 [&R8"U5eUR:[<-(a%[.R7U5 SU3n [%U 5e[>R@"U[R[RB-5$![Da [.R7U5 ef=f)a  Open *path* for locking while refusing reparse points, bound to the handle actually locked. The file is opened through ``NtCreateFile`` with ``FILE_OPEN_REPARSE_POINT`` so a symlink or junction planted at the path is not followed, and the reparse decision is read from *that* handle via ``GetFileInformationByHandle`` rather than from a prior pathname query. Reading the held handle closes the check-then-open race: an attacker cannot swap the path between validation and use because both act on the same handle. Share mode omits delete so a peer cannot unlink or rename the file out from under a live holder, matching ``os.open``'s ``_SH_DENYNO``. ``NtCreateFile`` is used instead of ``CreateFileW`` because its return value carries the raw ``NTSTATUS``. Windows collapses a transient delete-pending name and a permanent access denial into the same Win32 ``ERROR_ACCESS_DENIED``; the status keeps them apart, so a real denial fails fast instead of spinning until the caller's timeout (#604). The reparse option only guards the final path component; Windows still follows reparse points in intermediate directories. This assumes the lock file sits in a lock directory untrusted users cannot modify. A path with attacker-controlled parent directories would need component-by-component handle validation. :param path: the lock file path. :param mode: the permission mode; as ``os.open`` does on Windows, a cleared owner-write bit creates the file read-only. The attribute only takes effect when the file is created, not when an existing one is opened. :returns: a file descriptor owning the opened handle, or ``None`` on a sharing violation or a delete-pending name the caller should treat as contention and retry. :raises OSError: if the path resolves to a reparse point, or the open fails for any other reason, raised with the Win32 error the status maps to. An access denial is raised only once it outlasts a short grace, since a peer unlinking the file as it releases can make the open answer ``STATUS_ACCESS_DENIED`` for a moment. openN) read_onlyz1Lock file is a reparse point (symlink/junction): )#sysauditrO_RDWRO_CREATr _nt_openr'time monotonicr*sleepr+r&r(r)r-RtlNtStatusToDosErrorrrL FormatErrorstripr^r0GetFileInformationByHandlerorp CloseHandlerqr`rrmopen_osfhandle O_NOINHERITr) pathmoderhandlestatusdeadlinewinerrorinforumsgs rArrsB &$bii"**&<=|++ !$< * *~~'*>>H11dnn6F6Q /0!)$!D11dnn6F6Q _ $35KLL33F;H$ 2 28 < B B DdU U*,33FFLL _ $f9 || q&((  ' ' W(= >s C-F+F/c,\rSrSrSrSSjrSSjrSrg)r{iCzRUses ``LockFileEx`` to hard lock a byte range of the lock file on Windows systems.c[er~NotImplementedErrorrs rArrF% %r@c[er~rrs rArrIrr@r7Nrrr7r@rAr{r{Cs` & &r@)rrrrbool)rrrrr)rstrrrrz int | None)rrrrrztuple[int, int])P __future__rrrr contextlibrpathlibrtypingrr_apir _utilr r platformrLrmr r__annotations__rrrrrrrrrrrrrr r!r#r%r&r'r(r)r*r+WinDLLr-r0 Structurer2rCrPrUr^LONGrrestyperMrKr\ c_longlongrJrNargtypesrLPCWSTRrrrBOOLrrlrxrvryr{rr__all__r7r@rArs:" F<<7 *M:*!+NJ+)L*)"/."@<"OOZOJ!"M:!+5j5)3J30:!::1;!::+5j5+5j5"?BZ"Z]u"uOZu(2:2$L*$ .8 7+5j5(*:* #-OZ,(2:2,6z6)3J3*-,,).,.#)==#9F 9&,mmJt&TI#T &**  V--  6++  f&&   f&6&6  #+--Fx')*'(v(() $F >F]]F22:' ?F22; +/F',2NN?,K+LF(+3>>F  (-5]]OF  )&.oo%6I"$,MMI!5=__fnnUpFq4rI((13;==I((0{# %I!$,==I {# 'I#&.]]I" #; &2,&2P?B')V&,& r@