1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
|
"""
GitHub file system implementation
"""
from __future__ import annotations
import sys
from collections.abc import Sequence
from typing import TYPE_CHECKING
from upath.core import UnsupportedOperation
from upath.core import UPath
from upath.types import JoinablePathLike
if TYPE_CHECKING:
from typing import Literal
if sys.version_info >= (3, 11):
from typing import Unpack
else:
from typing_extensions import Unpack
from upath._chain import FSSpecChainParser
from upath.types.storage_options import GitHubStorageOptions
__all__ = ["GitHubPath"]
class GitHubPath(UPath):
"""
GitHubPath supporting the fsspec.GitHubFileSystem
"""
__slots__ = ()
if TYPE_CHECKING:
def __init__(
self,
*args: JoinablePathLike,
protocol: Literal["github"] | None = ...,
chain_parser: FSSpecChainParser = ...,
**storage_options: Unpack[GitHubStorageOptions],
) -> None: ...
@property
def path(self) -> str:
pth = super().path
if pth == ".":
return ""
return pth
@property
def parts(self) -> Sequence[str]:
parts = super().parts
if parts and parts[0] == "/":
return parts[1:]
else:
return parts
def touch(self, mode: int = 0o666, exist_ok: bool = True) -> None:
raise UnsupportedOperation
def mkdir(
self,
mode: int = 0o777,
parents: bool = False,
exist_ok: bool = False,
) -> None:
raise UnsupportedOperation
def unlink(self, missing_ok: bool = False) -> None:
raise UnsupportedOperation
def write_bytes(self, data: bytes) -> int:
raise UnsupportedOperation
def write_text(
self,
data: str,
encoding: str | None = None,
errors: str | None = None,
newline: str | None = None,
) -> int:
raise UnsupportedOperation("GitHubPath does not support writing")
|
