mirror of
https://git.proxmox.com/git/libgit2
synced 2025-05-02 14:04:30 +00:00
66902d4773
This reorganizes a few of the examples so that the main function comes first with the argument parsing extracted into a helper that can come at the end of the file (so the example focuses more on the use of libgit2 instead of command line support). This also creates a shared examples/common.[ch] so that useful helper funcs can be shared across examples instead of repeated.
81 lines
2.5 KiB
C
81 lines
2.5 KiB
C
/*
|
|
* Copyright (C) the libgit2 contributors. All rights reserved.
|
|
*
|
|
* This file is part of libgit2, distributed under the GNU GPL v2 with
|
|
* a Linking Exception. For full terms see the included COPYING file.
|
|
*/
|
|
|
|
#include <stdio.h>
|
|
#include <string.h>
|
|
#include <stdlib.h>
|
|
#include <git2.h>
|
|
|
|
/**
|
|
* Check libgit2 error code, printing error to stderr on failure and
|
|
* exiting the program.
|
|
*/
|
|
extern void check_lg2(int error, const char *message, const char *extra);
|
|
|
|
/**
|
|
* Exit the program, printing error to stderr
|
|
*/
|
|
extern void fatal(const char *message, const char *extra);
|
|
|
|
/**
|
|
* Check if a string has the given prefix. Returns 0 if not prefixed
|
|
* or the length of the prefix if it is.
|
|
*/
|
|
extern size_t is_prefixed(const char *str, const char *pfx);
|
|
|
|
/**
|
|
* Match an integer string, returning 1 if matched, 0 if not.
|
|
*/
|
|
extern int is_integer(int *out, const char *str, int allow_negative);
|
|
|
|
struct args_info {
|
|
int argc;
|
|
char **argv;
|
|
int pos;
|
|
};
|
|
#define ARGS_INFO_INIT { argc, argv, 0 }
|
|
|
|
/**
|
|
* Check current `args` entry against `opt` string. If it matches
|
|
* exactly, take the next arg as a string; if it matches as a prefix with
|
|
* an equal sign, take the remainder as a string; otherwise return 0.
|
|
*/
|
|
extern int match_str_arg(
|
|
const char **out, struct args_info *args, const char *opt);
|
|
|
|
/**
|
|
* Check current `args` entry against `opt` string parsing as uint16. If
|
|
* `opt` matches exactly, take the next arg as a uint16_t value; if `opt`
|
|
* is a prefix (equal sign optional), take the remainder of the arg as a
|
|
* uint16_t value; otherwise return 0.
|
|
*/
|
|
extern int match_uint16_arg(
|
|
uint16_t *out, struct args_info *args, const char *opt);
|
|
|
|
/**
|
|
* Check current `args` entry against `opt` string parsing as int. If
|
|
* `opt` matches exactly, take the next arg as an int value; if it matches
|
|
* as a prefix (equal sign optional), take the remainder of the arg as a
|
|
* int value; otherwise return 0.
|
|
*/
|
|
extern int match_int_arg(
|
|
int *out, struct args_info *args, const char *opt, int allow_negative);
|
|
|
|
/**
|
|
* Basic output function for plain text diff output
|
|
* Pass `FILE*` such as `stdout` or `stderr` as payload (or NULL == `stdout`)
|
|
*/
|
|
extern int diff_output(
|
|
const git_diff_delta*, const git_diff_hunk*, const git_diff_line*, void*);
|
|
|
|
/**
|
|
* Convert a treeish argument to an actual tree; this will call check_lg2
|
|
* and exit the program if `treeish` cannot be resolved to a tree
|
|
*/
|
|
extern void treeish_to_tree(
|
|
git_tree **out, git_repository *repo, const char *treeish);
|