FazBrowse GitHub Viewer
|
Trending
|
URL:
|
Home
Tools:
[Download Repo ZIP]
[View Raw Code]
[Original HTTPS Page]
GitPython/git/refs/reference.py at experiment-2012 · githubdelegate/GitPython · GitHub
githubdelegate
GitPython
Repository navigation
Code
Pull requests
Actions
Projects
Security and quality
Insights
Expand file tree
Breadcrumbs
GitPython
/
git
/
refs
/
reference.py
Copy path
More file actions
More file actions
Latest commit
History
History
History
127 lines (103 loc) · 4.33 KB
Breadcrumbs
GitPython
/
git
/
refs
/
reference.py
Copy path
File metadata and controls
127 lines (103 loc) · 4.33 KB
Raw
Copy raw file
Download raw file
Open symbols panel
Edit and raw actions
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
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
import
os
from
symbolic
import
SymbolicReference
from
head
import
HEAD
from
git
.
util
import
(
LazyMixin
,
Iterable
,
isfile
,
hex_to_bin
)
__all__
=
[
"Reference"
]
#{ Utilities
def
require_remote_ref_path
(
func
):
"""A decorator raising a TypeError if we are not a valid remote, based on the path"""
def
wrapper
(
self
,
*
args
):
if
not
self
.
path
.
startswith
(
self
.
_remote_common_path_default
+
"/"
):
raise
ValueError
(
"ref path does not point to a remote reference: %s"
%
path
)
return
func
(
self
,
*
args
)
# END wrapper
wrapper
.
__name__
=
func
.
__name__
return
wrapper
#}END utilites
class
Reference
(
SymbolicReference
,
LazyMixin
,
Iterable
):
"""Represents a named reference to any object. Subclasses may apply restrictions though,
i.e. Heads can only point to commits."""
__slots__
=
tuple
()
_points_to_commits_only
=
False
_resolve_ref_on_create
=
True
_common_path_default
=
"refs"
def
__init__
(
self
,
repo
,
path
,
check_path
=
True
):
"""Initialize this instance
:param repo: Our parent repository
:param path:
Path relative to the .git/ directory pointing to the ref in question, i.e.
refs/heads/master
:param check_path: if False, you can provide any path. Otherwise the path must start with the
default path prefix of this type."""
if
check_path
and
not
path
.
startswith
(
self
.
_common_path_default
+
'/'
):
raise
ValueError
(
"Cannot instantiate %r from path %s"
%
(
self
.
__class__
.
__name__
,
path
))
super
(
Reference
,
self
).
__init__
(
repo
,
path
)
def
__str__
(
self
):
return
self
.
name
#{ Interface
def
set_object
(
self
,
object
,
logmsg
=
None
):
"""Special version which checks if the head-log needs an update as well"""
oldbinsha
=
None
head
=
HEAD
(
self
.
repo
)
if
logmsg
is
not
None
:
if
not
head
.
is_detached
and
head
.
ref
==
self
:
oldbinsha
=
self
.
commit
.
binsha
# END handle commit retrieval
# END handle message is set
super
(
Reference
,
self
).
set_object
(
object
,
logmsg
)
if
oldbinsha
is
not
None
:
# /* from refs.c in git-source
# * Special hack: If a branch is updated directly and HEAD
# * points to it (may happen on the remote side of a push
# * for example) then logically the HEAD reflog should be
# * updated too.
# * A generic solution implies reverse symref information,
# * but finding all symrefs pointing to the given branch
# * would be rather costly for this rare event (the direct
# * update of a branch) to be worth it. So let's cheat and
# * check with HEAD only which should cover 99% of all usage
# * scenarios (even 100% of the default ones).
# */
head
.
log_append
(
oldbinsha
,
logmsg
)
# END check if the head
# NOTE: Don't have to overwrite properties as the will only work without a the log
@
property
def
name
(
self
):
""":return: (shortest) Name of this reference - it may contain path components"""
# first two path tokens are can be removed as they are
# refs/heads or refs/tags or refs/remotes
tokens
=
self
.
path
.
split
(
'/'
)
if
len
(
tokens
)
<
3
:
return
self
.
path
# could be refs/HEAD
return
'/'
.
join
(
tokens
[
2
:])
@
classmethod
def
iter_items
(
cls
,
repo
,
common_path
=
None
):
"""Equivalent to SymbolicReference.iter_items, but will return non-detached
references as well."""
return
cls
.
_iter_items
(
repo
,
common_path
)
#}END interface
#{ Remote Interface
@
property
@
require_remote_ref_path
def
remote_name
(
self
):
"""
:return:
Name of the remote we are a reference of, such as 'origin' for a reference
named 'origin/master'"""
tokens
=
self
.
path
.
split
(
'/'
)
# /refs/remotes/<remote name>/<branch_name>
return
tokens
[
2
]
@
property
@
require_remote_ref_path
def
remote_head
(
self
):
""":return: Name of the remote head itself, i.e. master.
:note: The returned name is usually not qualified enough to uniquely identify
a branch"""
tokens
=
self
.
path
.
split
(
'/'
)
return
'/'
.
join
(
tokens
[
3
:])
#} END remote interface
Back
|
FazBrowse Home
|
New Git URL