file

Classes:

• PackageStorage –

PackageStorage

PackageStorage(
    cwd: SPathLike | None = None,
    *,
    mode: int = 511,
    package_name: str | None = None
)

Methods:

• ensure_folder –
• get_file –

Attributes:

• BASE_FOLDER –
• folder –
• mode –

Source code

def __init__(
    self, cwd: SPathLike | None = None, *, mode: int = 0o777, package_name: str | None = None
) -> None:
    if not package_name:
        frame = inspect.stack()[1]
        module = inspect.getmodule(frame[0])

        if module:
            package_name = module.__name__

        if not TYPE_CHECKING:
            frame = module = None

    if not package_name:
        raise CustomRuntimeError('Can\'t determine package name!')

    package_name = package_name.strip('.').split('.')[0]

    if not cwd:
        cwd = SPath(get_script_path())
    elif not isinstance(cwd, SPath):
        cwd = SPath(str(cwd))

    cwd = cwd.get_folder()
    base_folder = cwd / self.BASE_FOLDER

    for old_names in ('.vsstg', '.vsiew'):
        old_base_folder = (cwd / '.vsstg')

        if old_base_folder.exists():
            old_base_folder.move_dir(base_folder)

    old_folder = cwd / f'.{package_name}'
    new_folder = base_folder / package_name

    if old_folder.exists():
        old_folder.move_dir(new_folder)

    self.mode = mode
    self.folder = new_folder

BASE_FOLDER class-attribute instance-attribute

BASE_FOLDER = SPath('.vsjet')

folder instance-attribute

folder = new_folder

mode instance-attribute

mode = mode

ensure_folder

ensure_folder() -> None

Source code

def ensure_folder(self) -> None:
    self.folder.mkdir(self.mode, True, True)

get_file

get_file(filename: SPathLike, *, ext: SPathLike | None = None) -> SPath

Source code

def get_file(self, filename: SPathLike, *, ext: SPathLike | None = None) -> SPath:
    filename = SPath(filename)

    if ext:
        filename = filename.with_suffix(SPath(ext).suffix)

    self.ensure_folder()

    return (self.folder / filename.name).resolve()