/usr/lib/pypy/dist-packages/dulwich/objectspec.py is in pypy-dulwich 0.12.0-1build2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 | # objectspec.py -- Object specification
# Copyright (C) 2014 Jelmer Vernooij <jelmer@samba.org>
#
# This program is free software; you can redistribute it and/or
# modify it under the terms of the GNU General Public License
# as published by the Free Software Foundation; version 2
# of the License or (at your option) a later version of the License.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
# MA 02110-1301, USA.
"""Object specification."""
def to_bytes(text):
if getattr(text, "encode", None) is not None:
text = text.encode('ascii')
return text
def parse_object(repo, objectish):
"""Parse a string referring to an object.
:param repo: A `Repo` object
:param objectish: A string referring to an object
:return: A git object
:raise KeyError: If the object can not be found
"""
objectish = to_bytes(objectish)
return repo[objectish]
def parse_ref(container, refspec):
"""Parse a string referring to a reference.
:param container: A RefsContainer object
:param refspec: A string referring to a ref
:return: A ref
:raise KeyError: If the ref can not be found
"""
refspec = to_bytes(refspec)
possible_refs = [
refspec,
b"refs/" + refspec,
b"refs/tags/" + refspec,
b"refs/heads/" + refspec,
b"refs/remotes/" + refspec,
b"refs/remotes/" + refspec + b"/HEAD"
]
for ref in possible_refs:
if ref in container:
return ref
else:
raise KeyError(refspec)
def parse_reftuple(lh_container, rh_container, refspec):
"""Parse a reftuple spec.
:param lh_container: A RefsContainer object
:param hh_container: A RefsContainer object
:param refspec: A string
:return: A tuple with left and right ref
:raise KeyError: If one of the refs can not be found
"""
if refspec.startswith(b"+"):
force = True
refspec = refspec[1:]
else:
force = False
refspec = to_bytes(refspec)
if b":" in refspec:
(lh, rh) = refspec.split(b":")
else:
lh = rh = refspec
if rh == b"":
lh = None
else:
lh = parse_ref(lh_container, lh)
if rh == b"":
rh = None
else:
try:
rh = parse_ref(rh_container, rh)
except KeyError:
# TODO: check force?
if not b"/" in rh:
rh = b"refs/heads/" + rh
return (lh, rh, force)
def parse_reftuples(lh_container, rh_container, refspecs):
"""Parse a list of reftuple specs to a list of reftuples.
:param lh_container: A RefsContainer object
:param hh_container: A RefsContainer object
:param refspecs: A list of refspecs or a string
:return: A list of refs
:raise KeyError: If one of the refs can not be found
"""
if not isinstance(refspecs, list):
refspecs = [refspecs]
ret = []
# TODO: Support * in refspecs
for refspec in refspecs:
ret.append(parse_reftuple(lh_container, rh_container, refspec))
return ret
def parse_refs(container, refspecs):
"""Parse a list of refspecs to a list of refs.
:param container: A RefsContainer object
:param refspecs: A list of refspecs or a string
:return: A list of refs
:raise KeyError: If one of the refs can not be found
"""
# TODO: Support * in refspecs
if not isinstance(refspecs, list):
refspecs = [refspecs]
ret = []
for refspec in refspecs:
ret.append(parse_ref(container, refspec))
return ret
def parse_commit_range(repo, committishs):
"""Parse a string referring to a range of commits.
:param repo: A `Repo` object
:param committishs: A string referring to a range of commits.
:return: An iterator over `Commit` objects
:raise KeyError: When the reference commits can not be found
:raise ValueError: If the range can not be parsed
"""
committishs = to_bytes(committishs)
# TODO(jelmer): Support more than a single commit..
return iter([parse_commit(repo, committishs)])
def parse_commit(repo, committish):
"""Parse a string referring to a single commit.
:param repo: A` Repo` object
:param commitish: A string referring to a single commit.
:return: A Commit object
:raise KeyError: When the reference commits can not be found
:raise ValueError: If the range can not be parsed
"""
committish = to_bytes(committish)
return repo[committish] # For now..
# TODO: parse_path_in_tree(), which handles e.g. v1.0:Documentation
|