/*
 * Copyright 2021-2025 Nico Sonack <nsonack@herrhotzenplotz.de>
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * 1. Redistributions of source code must retain the above copyright
 * notice, this list of conditions and the following disclaimer.
 *
 * 2. Redistributions in binary form must reproduce the above
 * copyright notice, this list of conditions and the following
 * disclaimer in the documentation and/or other materials provided
 * with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
 * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
 * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 * OF THE POSSIBILITY OF SUCH DAMAGE.
 */

#ifndef GCLI_H
#define GCLI_H

#ifdef HAVE_CONFIG_H
#include <config.h>
#endif

#include <inttypes.h>
#include <stdbool.h>
#include <stdint.h>

#include <gcli/port/port.h>

enum gcli_output_flags {
	OUTPUT_SORTED = (1 << 0),
	OUTPUT_LONG   = (1 << 1),
};

typedef enum gcli_forge_type {
	GCLI_FORGE_GITHUB,
	GCLI_FORGE_GITLAB,
	GCLI_FORGE_GITEA,
	GCLI_FORGE_BUGZILLA,
} gcli_forge_type;

typedef uint64_t gcli_id;

#define PRIid PRIu64

#ifdef IN_LIBGCLI
#include <gcli/ctx.h>

void gcli_clear_ptr(void *ptr);

#endif /* IN_LIBGCLI */

struct gcli_ctx;

char const *gcli_init(struct gcli_ctx **,
                      gcli_forge_type (*get_forge_type)(struct gcli_ctx *),
                      char *(*get_authheader)(struct gcli_ctx *),
                      char *(*get_apibase)(struct gcli_ctx *));

enum {
	GCLI_VERBOSITY_NORMAL  = 0,
	GCLI_VERBOSITY_QUIET   = 1,
	GCLI_VERBOSITY_VERBOSE = 2,
};

void gcli_setverbosity(struct gcli_ctx *, int);
int  gcli_getverbosity(struct gcli_ctx *);
bool gcli_be_verbose(struct gcli_ctx *);
bool gcli_be_quiet(struct gcli_ctx *);

void gcli_warn(struct gcli_ctx *, char const *fmt, ...) PRINTF_FORMAT(2, 3);
void gcli_warnx(struct gcli_ctx *, char const *fmt, ...) PRINTF_FORMAT(2, 3);

void *gcli_get_userdata(struct gcli_ctx const *);
void gcli_set_userdata(struct gcli_ctx *, void *usrdata);
void gcli_set_progress_func(struct gcli_ctx *, void (*pfunc)(bool done));
void gcli_destroy(struct gcli_ctx **ctx);
char const *gcli_get_error(struct gcli_ctx *ctx);

#endif /* GCLI_H */
