Data Structures
struct	N_GIT_COMMIT_INFO
	Commit metadata. More...

struct	N_GIT_REMOTE_AUTH
	Credentials for remote operations. More...

struct	N_GIT_REPO
	Wrapper around a git_repository handle. More...

struct	N_GIT_STATUS_ENTRY
	Single file status entry. More...

Macros
#define	N_GIT_AUTH_BASIC 2
	Remote auth: username + password.

#define	N_GIT_AUTH_NONE 0
	Remote auth: no authentication.

#define	N_GIT_AUTH_SSH 3
	Remote auth: SSH key file.

#define	N_GIT_AUTH_TOKEN 1
	Remote auth: personal access token (used as password with empty or "x-access-token" user)

#define	N_GIT_STATUS_DELETED 4
	File has been deleted.

#define	N_GIT_STATUS_MODIFIED 2
	File has been modified.

#define	N_GIT_STATUS_NEW 1
	File is new / untracked.

#define	N_GIT_STATUS_STAGED 8
	File is staged in the index.

Functions
int	n_git_checkout_commit (N_GIT_REPO repo, const char hash)
	Checkout a specific commit (detached HEAD).

int	n_git_checkout_path (N_GIT_REPO repo, const char filepath)
	Restore a single file from HEAD (discard working directory changes).

void	n_git_close (N_GIT_REPO **repo)
	Close a Git repository and free resources.

int	n_git_commit (N_GIT_REPO repo, const char message, const char author_name, const char author_email)
	Create a commit from the current index.

int	n_git_create_branch (N_GIT_REPO repo, const char branch_name)
	Create a new branch from HEAD.

int	n_git_current_branch (N_GIT_REPO repo, char out, size_t out_size)
	Get the name of the current branch.

int	n_git_delete_branch (N_GIT_REPO repo, const char branch_name)
	Delete a local branch.

N_STR *	n_git_diff_commits (N_GIT_REPO repo, const char hash_a, const char *hash_b)
	Get a diff between two commits identified by hash.

N_STR *	n_git_diff_workdir (N_GIT_REPO *repo)
	Get a diff of the working directory against the index.

N_GIT_REPO *	n_git_init (const char *path)
	Initialize a new Git repository.

LIST *	n_git_list_branches (N_GIT_REPO *repo)
	List all local branch names.

LIST *	n_git_log (N_GIT_REPO *repo, size_t max_entries)
	Retrieve commit log entries starting from HEAD.

N_GIT_REPO *	n_git_open (const char *path)
	Open an existing Git repository.

int	n_git_pull (N_GIT_REPO *repo)
	Fetch from "origin" and fast-forward merge the current branch.

int	n_git_push (N_GIT_REPO *repo)
	Push the current branch to the "origin" remote.

int	n_git_remote_set_url (N_GIT_REPO repo, const char url)
	Ensure a remote named "origin" exists with the given URL.

int	n_git_set_remote_auth (N_GIT_REPO repo, const N_GIT_REMOTE_AUTH auth)
	Set remote authentication credentials on a repo handle.

int	n_git_stage (N_GIT_REPO repo, const char filepath)
	Stage a single file by path.

int	n_git_stage_all (N_GIT_REPO *repo)
	Stage all modified and untracked files.

LIST *	n_git_status (N_GIT_REPO *repo)
	Get the status of all files in the working directory.

int	n_git_switch_branch (N_GIT_REPO repo, const char branch_name)
	Switch to an existing local branch.

int	n_git_unstage (N_GIT_REPO repo, const char filepath)
	Unstage a single file (reset from HEAD).

Detailed Description

Data Structure Documentation

◆ N_GIT_COMMIT_INFO

struct N_GIT_COMMIT_INFO

Commit metadata.

Examples: ex_git.c.

Definition at line 98 of file n_git.h.

Collaboration diagram for N_GIT_COMMIT_INFO:

Data Fields
char	author[256]	author name and email
char	hash[42]	full hex hash
char	message[512]	first line of commit message
char	short_hash[10]	short (abbreviated) hex hash
int64_t	timestamp	unix timestamp of the commit

◆ N_GIT_REMOTE_AUTH

struct N_GIT_REMOTE_AUTH

Credentials for remote operations.

Definition at line 64 of file n_git.h.

Collaboration diagram for N_GIT_REMOTE_AUTH:

Data Fields
char *	password	password or personal access token, or NULL
char *	ssh_passphrase	passphrase for SSH key, or NULL
char *	ssh_privkey_path	path to SSH private key file, or NULL
char *	ssh_pubkey_path	path to SSH public key file, or NULL (derived from private key + ".pub")
int	type	auth type: N_GIT_AUTH_NONE/TOKEN/BASIC/SSH
char *	username	username for basic auth or SSH, or NULL

◆ N_GIT_REPO

struct N_GIT_REPO

Wrapper around a git_repository handle.

Examples: ex_git.c.

Definition at line 80 of file n_git.h.

Collaboration diagram for N_GIT_REPO:

Data Fields
char *	path	filesystem path to the repository
N_GIT_REMOTE_AUTH *	remote_auth	credentials for remote operations, or NULL
git_repository *	repo	libgit2 repository handle

◆ N_GIT_STATUS_ENTRY

struct N_GIT_STATUS_ENTRY

Single file status entry.

Definition at line 90 of file n_git.h.

Collaboration diagram for N_GIT_STATUS_ENTRY:

Data Fields
int	flags	combination of N_GIT_STATUS_* flags
char	path[512]	relative path of the file

Macro Definition Documentation

◆ N_GIT_AUTH_BASIC

#define N_GIT_AUTH_BASIC 2

Remote auth: username + password.

Definition at line 59 of file n_git.h.

◆ N_GIT_AUTH_NONE

#define N_GIT_AUTH_NONE 0

Remote auth: no authentication.

Definition at line 55 of file n_git.h.

◆ N_GIT_AUTH_SSH

#define N_GIT_AUTH_SSH 3

Remote auth: SSH key file.

Definition at line 61 of file n_git.h.

◆ N_GIT_AUTH_TOKEN

#define N_GIT_AUTH_TOKEN 1

Remote auth: personal access token (used as password with empty or "x-access-token" user)

Definition at line 57 of file n_git.h.

◆ N_GIT_STATUS_DELETED

#define N_GIT_STATUS_DELETED 4

File has been deleted.

Definition at line 50 of file n_git.h.

◆ N_GIT_STATUS_MODIFIED

#define N_GIT_STATUS_MODIFIED 2

File has been modified.

Definition at line 48 of file n_git.h.

◆ N_GIT_STATUS_NEW

#define N_GIT_STATUS_NEW 1

File is new / untracked.

Definition at line 46 of file n_git.h.

◆ N_GIT_STATUS_STAGED

#define N_GIT_STATUS_STAGED 8

File is staged in the index.

Definition at line 52 of file n_git.h.

Function Documentation

◆ n_git_checkout_commit()

int n_git_checkout_commit	(	N_GIT_REPO *	repo,
		const char *	hash
	)

Checkout a specific commit (detached HEAD).

Parameters

repo	An opened N_GIT_REPO handle.
hash	Hash (or prefix) of the commit to checkout.

Returns: 0 on success, -1 on failure.

Definition at line 708 of file n_git.c.

References __n_assert, _n_git_log_error(), and N_GIT_REPO::repo.

Here is the call graph for this function:

◆ n_git_checkout_path()

int n_git_checkout_path	(	N_GIT_REPO *	repo,
		const char *	filepath
	)

Restore a single file from HEAD (discard working directory changes).

Parameters

repo	An opened N_GIT_REPO handle.
filepath	Relative path of the file to restore.

Returns: 0 on success, -1 on failure.

Definition at line 679 of file n_git.c.

References __n_assert, _n_git_log_error(), and N_GIT_REPO::repo.

Referenced by main().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ n_git_close()

void n_git_close ( N_GIT_REPO ** repo )

Close a Git repository and free resources.

Parameters

repo	Pointer to the N_GIT_REPO handle (set to NULL after close).

Definition at line 185 of file n_git.c.

References __n_assert, and FreeNoLog.

Referenced by main().

Here is the caller graph for this function:

◆ n_git_commit()

int n_git_commit	(	N_GIT_REPO *	repo,
		const char *	message,
		const char *	author_name,
		const char *	author_email
	)

Create a commit from the current index.

Parameters

repo	An opened N_GIT_REPO handle.
message	The commit message.
author_name	Author name string.
author_email	Author email string.

Returns: 0 on success, -1 on failure.

Definition at line 412 of file n_git.c.

References __n_assert, _n_git_log_error(), and N_GIT_REPO::repo.

Referenced by main().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ n_git_create_branch()

int n_git_create_branch	(	N_GIT_REPO *	repo,
		const char *	branch_name
	)

Create a new branch from HEAD.

Parameters

repo	An opened N_GIT_REPO handle.
branch_name	Name for the new branch.

Returns: 0 on success, -1 on failure.

Definition at line 790 of file n_git.c.

References __n_assert, _n_git_log_error(), and N_GIT_REPO::repo.

Referenced by main().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ n_git_current_branch()

int n_git_current_branch	(	N_GIT_REPO *	repo,
		char *	out,
		size_t	out_size
	)

Get the name of the current branch.

Parameters

repo	An opened N_GIT_REPO handle.
out	Buffer to receive the branch name.
out_size	Size of the output buffer.

Returns: 0 on success, -1 on failure.

Definition at line 879 of file n_git.c.

References __n_assert, _n_git_log_error(), and N_GIT_REPO::repo.

Referenced by main(), n_git_pull(), and n_git_push().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ n_git_delete_branch()

int n_git_delete_branch	(	N_GIT_REPO *	repo,
		const char *	branch_name
	)

Delete a local branch.

Parameters

repo	An opened N_GIT_REPO handle.
branch_name	Name of the branch to delete.

Returns: 0 on success, -1 on failure.

Definition at line 909 of file n_git.c.

References __n_assert, _n_git_log_error(), and N_GIT_REPO::repo.

Referenced by main().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ n_git_diff_commits()

N_STR * n_git_diff_commits	(	N_GIT_REPO *	repo,
		const char *	hash_a,
		const char *	hash_b
	)

Get a diff between two commits identified by hash.

Parameters

repo	An opened N_GIT_REPO handle.
hash_a	Hash (or prefix) of the first commit.
hash_b	Hash (or prefix) of the second commit.

Returns: An N_STR containing the diff text, or NULL on failure.

Definition at line 597 of file n_git.c.

References __n_assert, _n_git_diff_print_cb(), _n_git_log_error(), new_nstr(), and N_GIT_REPO::repo.

Here is the call graph for this function:

◆ n_git_diff_workdir()

N_STR * n_git_diff_workdir ( N_GIT_REPO * repo )

Get a diff of the working directory against the index.

Parameters

repo	An opened N_GIT_REPO handle.

Returns: An N_STR containing the diff text, or NULL on failure.

Definition at line 567 of file n_git.c.

References __n_assert, _n_git_diff_print_cb(), _n_git_log_error(), new_nstr(), and N_GIT_REPO::repo.

Referenced by main().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ n_git_init()

N_GIT_REPO * n_git_init ( const char * path )

Initialize a new Git repository.

Parameters

path	Filesystem path where the repository will be created.

Returns: A new N_GIT_REPO handle, or NULL on failure.

Definition at line 155 of file n_git.c.

References __n_assert, _n_git_ensure_init(), _n_git_log_error(), FreeNoLog, LOG_ERR, Malloc, n_log, N_GIT_REPO::path, and N_GIT_REPO::repo.

Referenced by main().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ n_git_list_branches()

LIST * n_git_list_branches ( N_GIT_REPO * repo )

List all local branch names.

Parameters

repo	An opened N_GIT_REPO handle.

Returns: A LIST of char* branch name strings, or NULL on failure.

Definition at line 749 of file n_git.c.

References __n_assert, _n_git_log_error(), _n_git_string_destroy(), list_push(), new_generic_list(), N_GIT_REPO::repo, and UNLIMITED_LIST_ITEMS.

Referenced by main().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ n_git_log()

LIST * n_git_log	(	N_GIT_REPO *	repo,
		size_t	max_entries
	)

Retrieve commit log entries starting from HEAD.

Parameters

repo	An opened N_GIT_REPO handle.
max_entries	Maximum number of log entries to retrieve.

Returns: A LIST of N_GIT_COMMIT_INFO pointers, or NULL on failure.

Definition at line 491 of file n_git.c.

References __n_assert, _n_git_commit_info_destroy(), _n_git_log_error(), N_GIT_COMMIT_INFO::author, N_GIT_COMMIT_INFO::hash, list_push(), Malloc, N_GIT_COMMIT_INFO::message, new_generic_list(), N_GIT_REPO::repo, N_GIT_COMMIT_INFO::short_hash, N_GIT_COMMIT_INFO::timestamp, and UNLIMITED_LIST_ITEMS.

Referenced by main().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ n_git_open()

N_GIT_REPO * n_git_open ( const char * path )

Open an existing Git repository.

Parameters

path	Filesystem path to the repository root (or .git dir).

Returns: A new N_GIT_REPO handle, or NULL on failure.

Definition at line 123 of file n_git.c.

References __n_assert, _n_git_ensure_init(), _n_git_log_error(), FreeNoLog, LOG_ERR, Malloc, n_log, N_GIT_REPO::path, and N_GIT_REPO::repo.

Here is the call graph for this function:

◆ n_git_pull()

int n_git_pull ( N_GIT_REPO * repo )

Fetch from "origin" and fast-forward merge the current branch.

Uses credentials set via n_git_set_remote_auth. If the merge is not a fast-forward, returns -1 (no conflict resolution).

Parameters

repo	An opened N_GIT_REPO handle.

Returns: 0 on success, -1 on failure.

Definition at line 1107 of file n_git.c.

References __n_assert, _n_git_cred_cb(), _n_git_ensure_init(), _n_git_log_error(), LOG_ERR, LOG_INFO, n_git_current_branch(), n_log, N_GIT_REPO::remote_auth, and N_GIT_REPO::repo.

Here is the call graph for this function:

◆ n_git_push()

int n_git_push ( N_GIT_REPO * repo )

Push the current branch to the "origin" remote.

Uses credentials set via n_git_set_remote_auth.

Parameters

repo	An opened N_GIT_REPO handle.

Returns: 0 on success, -1 on failure.

Definition at line 1057 of file n_git.c.

References __n_assert, _n_git_cred_cb(), _n_git_ensure_init(), _n_git_log_error(), LOG_ERR, LOG_INFO, n_git_current_branch(), n_log, N_GIT_REPO::remote_auth, and N_GIT_REPO::repo.

Here is the call graph for this function:

◆ n_git_remote_set_url()

int n_git_remote_set_url	(	N_GIT_REPO *	repo,
		const char *	url
	)

Ensure a remote named "origin" exists with the given URL.

If "origin" exists with a different URL, it is updated.

Parameters

repo	An opened N_GIT_REPO handle.
url	Remote URL (HTTPS or SSH).

Returns: 0 on success, -1 on failure.

Definition at line 1019 of file n_git.c.

References __n_assert, _n_git_ensure_init(), _n_git_log_error(), and N_GIT_REPO::repo.

Here is the call graph for this function:

◆ n_git_set_remote_auth()

int n_git_set_remote_auth	(	N_GIT_REPO *	repo,
		const N_GIT_REMOTE_AUTH *	auth
	)

Set remote authentication credentials on a repo handle.

The credentials are used by n_git_push and n_git_pull.

Parameters

repo	An opened N_GIT_REPO handle.
auth	Pointer to auth struct. Contents are copied (caller can free).

Returns: 0 on success, -1 on failure.

Definition at line 986 of file n_git.c.

References __n_assert, FreeNoLog, Malloc, N_GIT_REMOTE_AUTH::password, N_GIT_REPO::remote_auth, N_GIT_REMOTE_AUTH::ssh_passphrase, N_GIT_REMOTE_AUTH::ssh_privkey_path, N_GIT_REMOTE_AUTH::ssh_pubkey_path, N_GIT_REMOTE_AUTH::type, and N_GIT_REMOTE_AUTH::username.

◆ n_git_stage()

int n_git_stage	(	N_GIT_REPO *	repo,
		const char *	filepath
	)

Stage a single file by path.

Parameters

repo	An opened N_GIT_REPO handle.
filepath	Relative path of the file to stage.

Returns: 0 on success, -1 on failure.

Definition at line 290 of file n_git.c.

References __n_assert, _n_git_log_error(), and N_GIT_REPO::repo.

Referenced by main().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ n_git_stage_all()

int n_git_stage_all ( N_GIT_REPO * repo )

Stage all modified and untracked files.

Parameters

repo	An opened N_GIT_REPO handle.

Returns: 0 on success, -1 on failure.

Definition at line 328 of file n_git.c.

References __n_assert, _n_git_log_error(), and N_GIT_REPO::repo.

Here is the call graph for this function:

◆ n_git_status()

LIST * n_git_status ( N_GIT_REPO * repo )

Get the status of all files in the working directory.

Parameters

repo	An opened N_GIT_REPO handle.

Returns: A LIST of N_GIT_STATUS_ENTRY pointers, or NULL on failure.

Definition at line 210 of file n_git.c.

References __n_assert, _n_git_log_error(), _n_git_status_entry_destroy(), N_GIT_STATUS_ENTRY::flags, list_push(), Malloc, N_GIT_STATUS_DELETED, N_GIT_STATUS_MODIFIED, N_GIT_STATUS_NEW, N_GIT_STATUS_STAGED, new_generic_list(), N_GIT_STATUS_ENTRY::path, N_GIT_REPO::repo, and UNLIMITED_LIST_ITEMS.

Referenced by main().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ n_git_switch_branch()

int n_git_switch_branch	(	N_GIT_REPO *	repo,
		const char *	branch_name
	)

Switch to an existing local branch.

Parameters

repo	An opened N_GIT_REPO handle.
branch_name	Name of the branch to switch to.

Returns: 0 on success, -1 on failure.

Definition at line 833 of file n_git.c.

References __n_assert, _n_git_log_error(), and N_GIT_REPO::repo.

Here is the call graph for this function:

◆ n_git_unstage()

int n_git_unstage	(	N_GIT_REPO *	repo,
		const char *	filepath
	)

Unstage a single file (reset from HEAD).

Parameters

repo	An opened N_GIT_REPO handle.
filepath	Relative path of the file to unstage.

Returns: 0 on success, -1 on failure.

Definition at line 366 of file n_git.c.

References __n_assert, _n_git_log_error(), and N_GIT_REPO::repo.

Here is the call graph for this function:

Data Structures

Macros

Functions

Detailed Description

Data Structure Documentation

◆ N_GIT_COMMIT_INFO

◆ N_GIT_REMOTE_AUTH

◆ N_GIT_REPO

◆ N_GIT_STATUS_ENTRY

Macro Definition Documentation

◆ N_GIT_AUTH_BASIC

◆ N_GIT_AUTH_NONE

◆ N_GIT_AUTH_SSH

◆ N_GIT_AUTH_TOKEN

◆ N_GIT_STATUS_DELETED

◆ N_GIT_STATUS_MODIFIED

◆ N_GIT_STATUS_NEW

◆ N_GIT_STATUS_STAGED

Function Documentation

◆ n_git_checkout_commit()

◆ n_git_checkout_path()

◆ n_git_close()

◆ n_git_commit()

◆ n_git_create_branch()

◆ n_git_current_branch()

◆ n_git_delete_branch()

◆ n_git_diff_commits()

◆ n_git_diff_workdir()

◆ n_git_init()

◆ n_git_list_branches()

◆ n_git_log()

◆ n_git_open()

◆ n_git_pull()

◆ n_git_push()

◆ n_git_remote_set_url()

◆ n_git_set_remote_auth()

◆ n_git_stage()

◆ n_git_stage_all()

◆ n_git_status()

◆ n_git_switch_branch()

◆ n_git_unstage()