dulwich.objectspec module¶
Object specification.
-
exception
dulwich.objectspec.
AmbiguousShortId
(prefix, options)¶ Bases:
Exception
The short id is ambiguous.
-
dulwich.objectspec.
parse_commit
(repo, committish)¶ Parse a string referring to a single commit.
- Parameters
repo – A` Repo` object
commitish – A string referring to a single commit.
- Returns
A Commit object
- Raises
KeyError – When the reference commits can not be found
ValueError – If the range can not be parsed
-
dulwich.objectspec.
parse_commit_range
(repo, committishs)¶ Parse a string referring to a range of commits.
- Parameters
repo – A Repo object
committishs – A string referring to a range of commits.
- Returns
An iterator over Commit objects
- Raises
KeyError – When the reference commits can not be found
ValueError – If the range can not be parsed
-
dulwich.objectspec.
parse_object
(repo, objectish)¶ Parse a string referring to an object.
- Parameters
repo – A Repo object
objectish – A string referring to an object
- Returns
A git object
- Raises
KeyError – If the object can not be found
-
dulwich.objectspec.
parse_ref
(container, refspec)¶ Parse a string referring to a reference.
- Parameters
container – A RefsContainer object
refspec – A string referring to a ref
- Returns
A ref
- Raises
KeyError – If the ref can not be found
-
dulwich.objectspec.
parse_refs
(container, refspecs)¶ Parse a list of refspecs to a list of refs.
- Parameters
container – A RefsContainer object
refspecs – A list of refspecs or a string
- Returns
A list of refs
- Raises
KeyError – If one of the refs can not be found
-
dulwich.objectspec.
parse_reftuple
(lh_container, rh_container, refspec)¶ Parse a reftuple spec.
- Parameters
lh_container – A RefsContainer object
hh_container – A RefsContainer object
refspec – A string
- Returns
A tuple with left and right ref
- Raises
KeyError – If one of the refs can not be found
-
dulwich.objectspec.
parse_reftuples
(lh_container, rh_container, refspecs)¶ Parse a list of reftuple specs to a list of reftuples.
- Parameters
lh_container – A RefsContainer object
hh_container – A RefsContainer object
refspecs – A list of refspecs or a string
- Returns
A list of refs
- Raises
KeyError – If one of the refs can not be found
-
dulwich.objectspec.
parse_tree
(repo, treeish)¶ Parse a string referring to a tree.
- Parameters
repo – A Repo object
treeish – A string referring to a tree
- Returns
A git object
- Raises
KeyError – If the object can not be found
-
dulwich.objectspec.
scan_for_short_id
(object_store, prefix)¶ Scan an object store for a short id.
-
dulwich.objectspec.
to_bytes
(text)¶