Files
deb-python-pygit2/docs/references.rst
J. David Ibáñez 611e979113 Now Repository.head returns a reference (#203)
Now Repository.head behaves like libgit2's git_repository_head, it
returns the resolved reference. These two lines are equivalent:

  ref = repo.head
  ref = repo.lookup_reference('HEAD').resolve()

Before it returned a commit.
2013-04-17 08:16:43 +02:00

1.8 KiB

References

pygit2.Repository.listall_references

pygit2.Repository.lookup_reference

Reference lookup:

>>> all_refs = repo.listall_references()
>>> master_ref = repo.lookup_reference("refs/heads/master")
>>> commit = repo[master_ref.oid]

Reference log:

>>> head = repo.lookup_reference('refs/heads/master')
>>> for entry in head.log():
...     print(entry.message)

Shortcuts:

>>> # These two lines are equivalent
>>> head = repo.head
>>> head = repo.lookup_reference('HEAD').resolve()

The Reference type

pygit2.Reference.name

pygit2.Reference.oid

pygit2.Reference.hex

pygit2.Reference.target

pygit2.Reference.type

pygit2.Reference.delete

pygit2.Reference.rename

pygit2.Reference.resolve

pygit2.Reference.log

The HEAD

pygit2.Repository.head

pygit2.Repository.head_is_detached

pygit2.Repository.head_is_orphaned

The reference log

pygit2.RefLogEntry.oid_new

pygit2.RefLogEntry.oid_old

pygit2.RefLogEntry.message

pygit2.RefLogEntry.committer

Notes

pygit2.Repository.notes

pygit2.Repository.create_note

pygit2.Repository.lookup_note

The Note type

pygit2.Note.annotated_id

pygit2.Note.oid

pygit2.Note.message

pygit2.Note.remove