mirror of https://github.com/python/cpython
121 lines
2.9 KiB
Python
121 lines
2.9 KiB
Python
# from jaraco.path 3.7
|
|
|
|
import functools
|
|
import pathlib
|
|
from typing import Dict, Protocol, Union
|
|
from typing import runtime_checkable
|
|
|
|
|
|
class Symlink(str):
|
|
"""
|
|
A string indicating the target of a symlink.
|
|
"""
|
|
|
|
|
|
FilesSpec = Dict[str, Union[str, bytes, Symlink, 'FilesSpec']] # type: ignore
|
|
|
|
|
|
@runtime_checkable
|
|
class TreeMaker(Protocol):
|
|
def __truediv__(self, *args, **kwargs):
|
|
... # pragma: no cover
|
|
|
|
def mkdir(self, **kwargs):
|
|
... # pragma: no cover
|
|
|
|
def write_text(self, content, **kwargs):
|
|
... # pragma: no cover
|
|
|
|
def write_bytes(self, content):
|
|
... # pragma: no cover
|
|
|
|
def symlink_to(self, target):
|
|
... # pragma: no cover
|
|
|
|
|
|
def _ensure_tree_maker(obj: Union[str, TreeMaker]) -> TreeMaker:
|
|
return obj if isinstance(obj, TreeMaker) else pathlib.Path(obj) # type: ignore
|
|
|
|
|
|
def build(
|
|
spec: FilesSpec,
|
|
prefix: Union[str, TreeMaker] = pathlib.Path(), # type: ignore
|
|
):
|
|
"""
|
|
Build a set of files/directories, as described by the spec.
|
|
|
|
Each key represents a pathname, and the value represents
|
|
the content. Content may be a nested directory.
|
|
|
|
>>> spec = {
|
|
... 'README.txt': "A README file",
|
|
... "foo": {
|
|
... "__init__.py": "",
|
|
... "bar": {
|
|
... "__init__.py": "",
|
|
... },
|
|
... "baz.py": "# Some code",
|
|
... "bar.py": Symlink("baz.py"),
|
|
... },
|
|
... "bing": Symlink("foo"),
|
|
... }
|
|
>>> target = getfixture('tmp_path')
|
|
>>> build(spec, target)
|
|
>>> target.joinpath('foo/baz.py').read_text(encoding='utf-8')
|
|
'# Some code'
|
|
>>> target.joinpath('bing/bar.py').read_text(encoding='utf-8')
|
|
'# Some code'
|
|
"""
|
|
for name, contents in spec.items():
|
|
create(contents, _ensure_tree_maker(prefix) / name)
|
|
|
|
|
|
@functools.singledispatch
|
|
def create(content: Union[str, bytes, FilesSpec], path):
|
|
path.mkdir(exist_ok=True)
|
|
build(content, prefix=path) # type: ignore
|
|
|
|
|
|
@create.register
|
|
def _(content: bytes, path):
|
|
path.write_bytes(content)
|
|
|
|
|
|
@create.register
|
|
def _(content: str, path):
|
|
path.write_text(content, encoding='utf-8')
|
|
|
|
|
|
@create.register
|
|
def _(content: Symlink, path):
|
|
path.symlink_to(content)
|
|
|
|
|
|
class Recording:
|
|
"""
|
|
A TreeMaker object that records everything that would be written.
|
|
|
|
>>> r = Recording()
|
|
>>> build({'foo': {'foo1.txt': 'yes'}, 'bar.txt': 'abc'}, r)
|
|
>>> r.record
|
|
['foo/foo1.txt', 'bar.txt']
|
|
"""
|
|
|
|
def __init__(self, loc=pathlib.PurePosixPath(), record=None):
|
|
self.loc = loc
|
|
self.record = record if record is not None else []
|
|
|
|
def __truediv__(self, other):
|
|
return Recording(self.loc / other, self.record)
|
|
|
|
def write_text(self, content, **kwargs):
|
|
self.record.append(str(self.loc))
|
|
|
|
write_bytes = write_text
|
|
|
|
def mkdir(self, **kwargs):
|
|
return
|
|
|
|
def symlink_to(self, target):
|
|
pass
|