#reference #git #object-id #file #stored #symbolic #store

deprecated git-ref

Please use gix-<thiscrate> instead (‘git’ -> ‘gix’)

40 releases (23 breaking)

0.24.1 Feb 17, 2023
0.23.1 Jan 10, 2023
0.22.0 Dec 30, 2022
0.20.0 Nov 21, 2022
0.2.0 Jul 23, 2020

#14 in #object-id

Download history 213/week @ 2024-03-15 100/week @ 2024-03-22 338/week @ 2024-03-29 182/week @ 2024-04-05 97/week @ 2024-04-12 151/week @ 2024-04-19 318/week @ 2024-04-26 153/week @ 2024-05-03 85/week @ 2024-05-10 117/week @ 2024-05-17 108/week @ 2024-05-24 141/week @ 2024-05-31 200/week @ 2024-06-07 272/week @ 2024-06-14 308/week @ 2024-06-21 136/week @ 2024-06-28

943 downloads per month
Used in 10 crates (3 directly)

MIT/Apache

545KB
11K SLoC

A crate for handling the references stored in various formats in a git repository.

References are also called refs which are used interchangeably.

Refs are the way to keep track of objects and come in two flavors.

  • symbolic refs are pointing to another reference
  • peeled refs point to the an object by its ObjectId

They can be identified by a relative path and stored in various flavors.

  • files
    • loose
      • one reference maps to a file on disk
    • packed
      • references are stored in a single human-readable file, along with their targets if they are symbolic.

Feature Flags

Dependencies

~7–17MB
~217K SLoC