dulwich.objectspec module

Object specification.

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.to_bytes(text)