module Agate

Defined in:

Constant Summary

LIBGIT2_AT_LEAST_1_9 = true

LIBGIT2_VERSION = {{ (`pkg-config --modversion libgit2 2>/dev/null || echo \"0.0.0\"`).strip.stringify }}

Detect libgit2 version at compile time via pkg-config. Used to select the correct API names for version-dependent functions.

LIBGIT2_VERSION is a string like "1.9.2". Use the LIBGIT2_AT_LEAST_1_9 compile-time constant for API selection.

VERSION = "0.1.1"

Class Method Summary

• .features

  Returns the compile-time feature flags of libgit2.

• .hex_to_raw(hex : String) : Bytes

  Converts a hex OID string to raw bytes.

• .init

  Initializes the libgit2 library.

• .initializations
• .prettify_message(message : String, strip_comments : Bool = true, comment_char : Char = '#') : String

  Cleans up a commit message: strips comments, trailing whitespace, and ensures a single trailing newline.

• .raw_to_hex(raw : Bytes) : String

  Converts raw bytes to a hex OID string.

• .repository?(path = ".") : Bool

  Returns true if the given path is a repository.

• .shutdown

  Decrements the libgit2 initialization count.

• .trace(level : TraceLevel, &callback : TraceLevel, String -> ) : Nil

  Sets the libgit2 tracing level and callback.

• .trace_off : Nil

  Disables tracing.

• .valid_full_oid?(hex : String) : Bool

  Module-level convenience for OID validation.

• .version

  Returns the libgit2 version as a SemanticVersion.

Class Method Detail

Agate.prettify_message("hello  \n\n") # => "hello\n"

Agate.trace(TraceLevel::Info) do |level, message|
  puts "[git2 #{level}] #{message}"
end