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

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 103/week @ 2024-02-06 75/week @ 2024-02-13 146/week @ 2024-02-20 224/week @ 2024-02-27 114/week @ 2024-03-05 195/week @ 2024-03-12 189/week @ 2024-03-19 119/week @ 2024-03-26 374/week @ 2024-04-02 102/week @ 2024-04-09 95/week @ 2024-04-16 223/week @ 2024-04-23 286/week @ 2024-04-30 110/week @ 2024-05-07 77/week @ 2024-05-14 119/week @ 2024-05-21

611 downloads per month
Used in 11 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
~219K SLoC