JrGoodle/clowder

View on GitHub
clowder/util/git/model/submodule.py

Summary

Maintainability
A
0 mins
Test Coverage
"""Base Git utility class

.. codeauthor:: Joe DeCapo <joe@polka.cat>

"""

from pathlib import Path
from typing import Optional

# from clowder.util.git.constants import ORIGIN
from clowder.util.git.offline import GitOffline
from clowder.util.git.online import GitOnline

from .repo import Repo


class Submodule(Repo):
    """Class encapsulating base git utilities

    :ivar Path path: Absolute path to repo
    :ivar Path submodule_path: Relative path to submodule
    """

    def __init__(self, repo_path: Path, submodule_path: Path, url: Optional[str] = None, commit: Optional[str] = None,
                 branch: Optional[str] = None, active: Optional[bool] = None):
        """LocalRepo __init__

        :param Path repo_path: Absolute path to repo
        :param Path submodule_path: Relative path to submodule
        :param Optional[str] url: Remote url
        :param Optional[str] commit: Current commit sha stored in git tree
        :param Optional[str] branch: Branch to track
        :param Optional[bool] active: Whether submodule is active
        """

        self.repo_path: Path = repo_path
        self.submodule_path: Path = submodule_path
        super().__init__(repo_path / submodule_path)
        self._url: Optional[str] = url
        self._commit: Optional[str] = commit
        self._branch: Optional[str] = branch
        self._active: Optional[bool] = active

    def __eq__(self, other) -> bool:
        if isinstance(other, Submodule):
            return self.path == other.path
        return False

    def __lt__(self, other: 'Submodule') -> bool:
        return self.path < other.path

    @property
    def exists(self) -> bool:
        is_initialized = GitOffline.is_submodule_initialized(self.repo_path, self.submodule_path)
        is_cloned = GitOffline.is_submodule_cloned(self.repo_path, self.submodule_path)
        return is_initialized and is_cloned

    @property
    def is_initialized(self) -> bool:
        return GitOffline.is_submodule_initialized(self.repo_path, self.submodule_path)

    def absorbgitdirs(self) -> None:
        GitOffline.submodule_absorbgitdirs(self.repo_path, paths=[self.submodule_path])

    def deinit(self, force: bool = False) -> None:
        GitOffline.submodule_deinit(self.repo_path, force=force, paths=[self.submodule_path])

    def init(self) -> None:
        GitOffline.submodule_init(self.repo_path, paths=[self.submodule_path])

    def set_branch(self, branch: str) -> None:
        GitOffline.submodule_set_branch(self.repo_path, self.submodule_path, branch)

    def set_url(self, url: str) -> None:
        GitOffline.submodule_set_url(self.repo_path, self.submodule_path, url)

    def unset_branch(self) -> None:
        GitOffline.submodule_unset_branch(self.repo_path, self.submodule_path)

    def sync(self, recursive: bool = False) -> None:
        GitOffline.submodule_sync(self.repo_path, recursive=recursive, paths=[self.submodule_path])

    def update(self, init: bool = False, depth: Optional[int] = None, single_branch: bool = False,
               jobs: Optional[int] = None, recursive: bool = False, checkout: bool = False,
               rebase: bool = False, merge: bool = False) -> None:
        GitOnline.submodule_update(self.repo_path, init=init, depth=depth, single_branch=single_branch, jobs=jobs,
                                   recursive=recursive, checkout=checkout, merge=merge, rebase=rebase,
                                   paths=[self.submodule_path])