+ &j-X^RIt^RIt^RIt^RIHt^RIHt^RIHt!RR]4t R#)N)AbstractFileSysteminfer_storage_options) MemoryFilecaa]tRt^ toRtRtRtRtRtRV3Rllt ] R4t ] RRl4t ] R4t] R 4t] R 4tRR ltRR lt] V3R l4t]R4tRRltRRltRRltRtRtVtV;t#)GithubFileSystemaJInterface to files in github An instance of this class provides the files residing within a remote github repository. You may specify a point in the repos history, by SHA, branch or tag (default is current master). For files less than 1 MB in size, file content is returned directly in a MemoryFile. For larger files, or for files tracked by git-lfs, file content is returned as an HTTPFile wrapping the ``download_url`` provided by the GitHub API. When using fsspec.open, allows URIs of the form: - "github://path/file", in which case you must specify org, repo and may specify sha in the extra args - 'github://org:repo@/precip/catalog.yml', where the org and repo are part of the URI - 'github://org:repo@sha/precip/catalog.yml', where the sha is also included ``sha`` can be the full or abbreviated hex of the commit you want to fetch from, or a branch or tag name (so long as it doesn't contain special characters like "/", "?", which would have to be HTTP-encoded). For authorised access, you must provide username and token, which can be made at https://github.com/settings/tokens z9https://api.github.com/repos/{org}/{repo}/git/trees/{sha}zChttps://api.github.com/repos/{org}/{repo}/contents/{path}?ref={sha}githubc <\S V`!R/VBWnW nVRJVRJ, 'd \ R4hW@nWPnVeW`nVfgRp\P!VPWR73RVP/VPBp V P4V P4R,pY0nVPR4^RIHp V !R/VBVnR# \&d RTnR#i;i) Nz%Auth required both username and tokenz)https://api.github.com/repos/{org}/{repo})orgrepotimeoutdefault_branch)HTTPFileSystem)super__init__r r ValueErrorusernametokenr requestsgetformatkwraise_for_statusjsonrootlshttprhttp_fs ImportError) selfr r sharrr kwargsurr __class__s &&&&&&&, u/Users/jameslopez/projects/CWCArchive/cwc-podcast/.venv/lib/python3.14/site-packages/fsspec/implementations/github.pyrGithubFileSystem.__init__,s "6"  $ / /DE E   "L ;;A S,6:llFJggA    &&(+,C    ,)3F3DL DL sC))C?>C?c^VP'dRVPVP3/#/#)auth)rrr"s&r(rGithubFileSystem.kwJs( ===T]]DJJ78 8 c \P!RRR.V, RV R2VPR7pVP4VP 4Uu.uF qDR,NK up#uupi)aList repo names for given org or user This may become the top level of the FS Parameters ---------- org_or_user: str Name of the github org or user to query is_org: bool (default True) Whether the name is an organisation (True) or user (False) Returns ------- List of string zhttps://api.github.com/usersorgs/z/repos)r name)rrr rr)cls org_or_useris_orgr&r s&&& r(reposGithubFileSystem.reposPsf" LL%w&7&?%@+f UKK  )*2V 222sA)c \P!RVP RVP R23RVP/VP BpVP 4VP4Uu.uF q"R,NK up#uupi)zNames of tags in the repohttps://api.github.com/repos/r2z/tagsr r3rrr r r rrrr"r&ts& r(tagsGithubFileSystem.tagshsv LL+DHH:Qtyyk G LL gg  #$668,8a& 8,,,+A?c \P!RVP RVP R23RVP/VP BpVP 4VP4Uu.uF q"R,NK up#uupi)zNames of branches in the repor:r2z /branchesr r3r;r<s& r(branchesGithubFileSystem.branchesssv LL+DHH:Qtyyk K LL gg  #$668,8a& 8,,,r@c 6RVPRVP/#)z#Named references, tags and branchesr>rB)r>rBr,s&r(refsGithubFileSystem.refs~s :t}}==r.c lVPV4pVR8XdT;'g VPpVfVPR4PR4pRpT;'g VPpVFpVP VRW4R7p Yw'd RV,MT, pV U u.uFqR,V8XgKV NK p p V 'g \ V4hV ^,p V R,R8XdV'dV .u#Vu#V R ,pK WP 9gW0PR39EdB\P!VPPVPVPVR 73R VP/VPBp V PR 8Xd \ V4hV P!4R RRR/p V P#4R,U u.uFpp V R,V 9gKRV'dVR,V R,,MV R,RV R,RWR,,RV PR^4R V R ,/NKr p p W0PR39dWP V&MVP V,p V'dV #\%V U u.uF qR,NK up 4#uup iuup iuup i)aList files at given path Parameters ---------- path: str Location to list, relative to repo root detail: bool If True, returns list of dicts, one per file; if False, returns list of full filenames only sha: str (optional) List at the given point in the repo history, branch or tag name or commit SHA _sha: str (optional) List this specific tree object (used internally to descend into trees) rNr2T)r#_shar3typefiler#)r r r#r blobtree directorypathmodesize)_strip_protocolrrstripsplitrFileNotFoundErrordircacherrurlrr r r r status_coderrsorted)r"rOdetailr#rHr$partsso_farpartoutor&typesfs&&&&&, r(rGithubFileSystem.lssi ##D) 2:##$))D <KK$**3/EF##$))Dggfdg?#*D8"%=#Q6f)( $3s%!J'5J'J,%J,.AJ,J1c:VPP4R#N)rVclear)r"rOs&&r(invalidate_cache!GithubFileSystem.invalidate_caches r.cv<\V4pRV9d\SV` V4#VR,PR4#)rrOr2)rrrRlstrip)r4rOoptsr's&& r(rR GithubFileSystem._strip_protocols:$T* T !7*40 0F|""3''r.c\V4pRV9d/#RVR,RVR,/pVR,'d VR,VR&V#)rr r passwordhostr#r)rOrjr^s& r(_get_kwargs_from_urls&GithubFileSystem._get_kwargs_from_urlssL$T* T !Id:&Z0@A <<fCJ r.c VR8wd\hVPPVPVPY;'g VP R7p\ P!V3RVP/VPBpVPR8Xd \V4hVP4VP4p V R,'dB\P!V R,4p V P!R4'g\#RRV 4#VP$f \'R4hVP$P(!V R,3R VR VR V/VB#) rbr r rOr#r rKcontents#version https://git-lfs.github.com/NzRPlease install fsspec[http] to access github files >1 MB or git-lfs tracked files. download_urlrP block_size cache_options)NotImplementedError content_urlrr r rrrr rrXrUrrbase64 b64decode startswithrr r!open) r"rOrPrvrwr#r$rWr& content_jsonrts &&&&&&, r(_openGithubFileSystem._opensC 4<% %%%tyyt9I9I &  LL >dll >dgg > ==C #D) ) vvx   " "&&|I'>?G %%&LMM!$g66 << , ||   (  " (     r.ctVPWVR7p\V4FpVPWTR7K R#)) recursivemaxdepth)messageN) expand_pathreversedrm_file)r"rOrrrps&&&&& r(rmGithubFileSystem.rm s3HM$A LLL , r.c VP'g \R4hVPV4pVPV4pV'gVPP VP VPVPR4VPR7p\P!V3RVP/VPBpVPR8Xd \V4hVP!4VP#4R,pVPP VP VPWPR7pVPpRT;'gRV 2RV/V'dR V/M/Cp \P$!V3R V RVP/VPBpVP#4PRR 4p \&P(!R V 4'dR p \V 4hVP!4VP+V4R#)a Remove a file from a specified branch using a given commit message. Since Github DELETE operation requires a branch name, and we can't reliably determine whether the provided SHA refers to a branch, tag, or commit, we assume it's a branch. If it's not, the user will encounter an error when attempting to retrieve the file SHA or delete the file. Parameters ---------- path: str The file's location relative to the repository root. message: str, optional The commit message for the deletion. zAuthentication requiredr2rsr rKr#rzDelete branchrrzBranch .+ not foundzTRemove only works when the filesystem is initialised from a branch or default (None)N)rrrR_get_sha_from_cacheryrr r rirrrr rrXrUrrdeleteresearchrf) r"rOrr$r#rWr& delete_urlrdata error_messageerrors &&&, r(rGithubFileSystem.rm_files"}}}67 7##D)&&t,""))HH4994;;s3C*C SB$,,B$''BA}}#'--   &&(5/C%%,,tyyt-  w22GD6"2 3 &,&!  OOJ ST S4<< S477 S Y3 99+] ; ;jEU# #  d#r.cVPP4FCpVF:pVPR4pV'gKWA8XgK&RV9gK/VR,uu# KE R#)r3r#N)rVvaluesr)r"rOentriesentry entry_paths&& r(r$GithubFileSystem._get_sha_from_cacheGsP}}++-G "YYv. :*"4% <'!. r.)r r r rr rr)<r)NNNN)T)FNNrd)rrNNN)__name__ __module__ __qualname____firstlineno____doc__rWryprotocolr rpropertyr classmethodr7r>rBrErrfrR staticmethodrorrrr__static_attributes____classdictcell__ __classcell__)r' __classdict__s@@r(rr s6 FCWKHG < 33.---->>@4D(( 1 f- 4$lr.r) rzrrspecrutilsrmemoryrrrr.r(rs& %)B)Br.