type object_t[link]

type object_t = enum {
	OBJECT_ANY = -2, // Object can be any of the following
	OBJECT_INVALID = -1, // Object is invalid.
	OBJECT_COMMIT = 1, // A commit object.
	OBJECT_TREE = 2, // A tree (directory listing) object.
	OBJECT_BLOB = 3, // A file revision object.
	OBJECT_TAG = 4, // An annotated tag object.
};

Basic type (loose or packed) of any Git object.

type repository[link]

type repository = opaque;

Representation of an existing git repository, including all its object contents

type repository_init_flag_t[link]

type repository_init_flag_t = enum uint {
	REPOSITORY_INIT_BARE = 1 << 0, // Create a bare repository with no working directory.
	// Return an GIT_EEXISTS error if the repo_path appears to already be
	// an git repository.
	REPOSITORY_INIT_NO_REINIT = 1 << 1,
	// Make the repo_path (and workdir_path) as needed. Init is always willing
	// to create the ".git" directory even without this flag. This flag tells
	// init to create the trailing component of the repo and workdir paths
	// as needed.
	REPOSITORY_INIT_MKDIR = 1 << 3,
	// Recursively make all components of the repo and workdir paths as
	// necessary.
	REPOSITORY_INIT_MKPATH = 1 << 4,
	// libgit2 normally uses internal templates to initialize a new repo.
	// This flags enables external templates, looking the "template_path" from
	// the options if set, or the `init.templatedir` global config if not,
	// or falling back on "/usr/share/git-core/templates" if it exists.
	REPOSITORY_INIT_EXTERNAL_TEMPLATE = 1 << 5,
	// If an alternate workdir is specified, use relative paths for the gitdir
	// and core.worktree.
	REPOSITORY_INIT_RELATIVE_GITLINK = 1 << 6,
};

Option flags for repository_init_ext.

These flags configure extra behaviors to repository_init_ext. In every case, the default behavior is the zero value (i.e. flag is not set). Just OR the flag values together for the flags parameter when initializing a new repo.

fn libgit2_init[link]

@symbol("git_libgit2_init") fn libgit2_init() int;

Init the global state

This function must be called before any other libgit2 function in order to set up global state and threading.

This function may be called multiple times - it will return the number of times the initialization has been called (including this one) that have not subsequently been shutdown.

fn libgit2_shutdown[link]

@symbol("git_libgit2_shutdown") fn libgit2_shutdown() int;

Shutdown the global state

Clean up the global state and threading context after calling it as many times as git_libgit2_init() was called - it will return the number of remainining initializations that have not been shutdown (after this one).

fn repository_init[link]

fn repository_init(out: *nullable *repository, path: str, is_bare: bool) int;

Creates a new Git repository in the given folder.

is_bare is a boolean that determines whether the repository will be a bare repository, or whether it should be created as a working directory with a .git inside.

Returns 0 on success, or an error code.