iframe-proxy | Sunbelt Computer Software

History

82 lines (64 loc) · 2.83 KB

Raw

# This module is part of GitPython and is released under the

# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/

"""Module implementing a remote object allowing easy access to git remotes."""

__all__ = ["RemoteReference"]

import os

from git.util import join_path

from .head import Head

# typing ------------------------------------------------------------------

from typing import Any, Iterator, NoReturn, TYPE_CHECKING, Union

from git.types import PathLike

if TYPE_CHECKING:

from git.remote import Remote

from git.repo import Repo

# ------------------------------------------------------------------------------

class RemoteReference(Head):

"""A reference pointing to a remote head."""

_common_path_default = Head._remote_common_path_default

@classmethod

def iter_items(

cls,

repo: "Repo",

common_path: Union[PathLike, None] = None,

remote: Union["Remote", None] = None,

*args: Any,

**kwargs: Any,

) -> Iterator["RemoteReference"]:

"""Iterate remote references, and if given, constrain them to the given remote."""

common_path = common_path or cls._common_path_default

if remote is not None:

common_path = join_path(common_path, str(remote))

# END handle remote constraint

# super is Reference

return super().iter_items(repo, common_path)

# The Head implementation of delete also accepts strs, but this implementation does

# not. mypy doesn't have a way of representing tightening the types of arguments in

# subclasses and recommends Any or "type: ignore".

# (See: https://github.com/python/typing/issues/241)

@classmethod

def delete(cls, repo: "Repo", *refs: "RemoteReference", **kwargs: Any) -> None: # type: ignore[override]

"""Delete the given remote references.

:note:

`kwargs` are given for comparability with the base class method as we

should not narrow the signature.

"""

for ref in refs:

cls._check_ref_name_valid(ref.path)

repo.git.branch("-d", "-r", *refs)

# The official deletion method will ignore remote symbolic refs - these are

# generally ignored in the refs/ folder. We don't though and delete remainders

# manually.

for ref in refs:

try:

os.remove(cls._get_validated_path(repo.common_dir, ref.path))

except OSError:

pass

try:

os.remove(cls._get_validated_path(repo.git_dir, ref.path))

except OSError:

pass

# END for each ref

@classmethod

def create(cls, *args: Any, **kwargs: Any) -> NoReturn:

"""Raise :exc:`TypeError`. Defined so the ``create`` method is disabled."""

raise TypeError("Cannot explicitly create remote references")

Sunbelt Computer Software

PL/B Language Development and Support

Navigation Menu

Uh oh!

Uh oh!

Sunbelt Computer Software

PL/B Language Development and Support

Uh oh!

Uh oh!

FilesExpand file tree

remote.py

Latest commit

History

remote.py

File metadata and controls