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)