/usr/local/lib/python3.6/site-packages/fsspec/implementations/__pycache__
Edit: /usr/local/lib/python3.6/site-packages/fsspec/implementations/__pycache__/github.cpython-36.pyc (7404B)
3
8%Eg` @ s@ d dl Z ddlmZ ddlmZ ddlmZ G dd deZdS ) N )AbstractFileSystem)infer_storage_options )
MemoryFilec s e Zd ZdZdZdZdZd fdd Zedd Z e
d d d Z ed
d Z edd Z
edd Zd!ddZd"ddZe
fddZedd Zd#d d Z ZS )$GithubFileSystema& Interface 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).
Given that code files tend to be small, and that github does not support
retrieving partial content, we always fetch whole files.
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}z;https://raw.githubusercontent.com/{org}/{repo}/{sha}/{path}ZgithubNc s t jf | || _|| _|d k|d kA r2td|| _|| _|d krxd}tj|j ||df| j
}|j |j d }|| _
| jd d S )Nz%Auth required both username and tokenz)https://api.github.com/repos/{org}/{repo})orgrepoZdefault_branch )super__init__r r
ValueErrorusernametokenrequestsgetformatkwraise_for_statusjsonrootls) selfr r shar r kwargsur) __class__ G/usr/local/lib/python3.6/site-packages/fsspec/implementations/github.pyr ( s zGithubFileSystem.__init__c C s | j rd| j | jfiS i S )Nauth)r r )r r r r r : s zGithubFileSystem.kwTc C s6 t jdjddg| |d}|j dd |j D S )av List 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
z)https://api.github.com/{part}/{org}/reposZusersZorgs)partr c S s g | ] }|d qS )namer ).0r r r r
W s z*GithubFileSystem.repos..)r r r r r )clsZ org_or_userZis_orgr r r r repos@ s
zGithubFileSystem.reposc C s8 t jdj| j| jdf| j}|j dd |j D S )zNames of tags in the repoz.https://api.github.com/repos/{org}/{repo}/tags)r r c S s g | ] }|d qS )r" r )r# tr r r r$ b s z)GithubFileSystem.tags..)r r r r r r r r )r r r r r tagsY s zGithubFileSystem.tagsc C s8 t jdj| j| jdf| j}|j dd |j D S )z Names of branches in the repoz2https://api.github.com/repos/{org}/{repo}/branches)r r c S s g | ] }|d qS )r" r )r# r' r r r r$ m s z-GithubFileSystem.branches..)r r r r r r r r )r r r r r branchesd s zGithubFileSystem.branchesc C s | j | jdS )z#Named references, tags and branches)r( r) )r( r) )r r r r refso s zGithubFileSystem.refsFc
sv | j dkr |p| j}|dkr jdjd}d|p@| j}xz|D ]r}| jd||d}rld| n|7 fdd|D }|st |d }|d d
kr|r|gS S |d }qHW | jks|| jdgkrLtj| j j
| j | j |d f| j
} | jd
krt | j fdd| j d D }|| jdgkrV|| j < n
| j }|r`|S tdd |D S dS )a List 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)
r
N/T)r _shac s g | ]}|d kr|qS )r" r )r# o)so_farr r r$ s z'GithubFileSystem.ls..r typefiler )r r r i c sR g | ]J} r d |d n|d |d ddd|d |j dd|d d
qS ) r+ pathmoder0 directory)Zblobtreer/ sizer r )r" r2 r/ r5 r )r )r# f)r1 r r r$ s r4 c S s g | ] }|d qS )r" r )r# r6 r r r r$ s )_strip_protocolr rstripsplitr FileNotFoundErrordircacher r urlr r r r status_coder r sorted)
r r1 Zdetailr r, r partsr! outr r )r1 r. r r t sB
zGithubFileSystem.lsc C s | j j d S )N)r; clear)r r1 r r r invalidate_cache s z!GithubFileSystem.invalidate_cachec s* t |}d|kr t j|S |d jdS )Nr r1 r+ )r r r7 lstrip)r% r1 opts)r r r r7 s z GithubFileSystem._strip_protocolc C s> t | }d|kri S |d |d d}|d r:|d |d< |S )Nr password)r r hostr )r )r1 rD r@ r r r _get_kwargs_from_urls s z&GithubFileSystem._get_kwargs_from_urlsrbc
K sb |dkr t | jj| j| j||p$| jd}tj|f| j} | j dkrLt
|| j t d d | j
S )NrH )r r r1 r i )NotImplementedErrorrurlr r r r r r r r= r: r r content)
r r1 r2
block_sizeZ
autocommitZ
cache_optionsr r r< r r r r _open s
zGithubFileSystem._open)NNN)T)FNN)N)rH NTNN)__name__
__module__ __qualname____doc__r< rJ protocolr propertyr classmethodr& r( r) r* r rB r7 staticmethodrG rM
__classcell__r r )r r r
s(
>
r )r specr utilsr Zmemoryr r r r r r s