#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 569/week @ 2024-07-24 387/week @ 2024-07-31 381/week @ 2024-08-07 276/week @ 2024-08-14 269/week @ 2024-08-21 264/week @ 2024-08-28 304/week @ 2024-09-04 378/week @ 2024-09-11 457/week @ 2024-09-18 457/week @ 2024-09-25 290/week @ 2024-10-02 435/week @ 2024-10-09 155/week @ 2024-10-16 146/week @ 2024-10-23 113/week @ 2024-10-30 131/week @ 2024-11-06

591 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–16MB
~220K SLoC