klish/klish/kpargv.h

/** @file kpargv.h
 *
 * @brief Parsed ARGuments Vector
 */

#ifndef _klish_kpargv_h
#define _klish_kpargv_h

#include <faux/list.h>
#include <faux/argv.h>
#include <klish/kentry.h>


typedef enum {
	KPARSE_NONE,
	KPARSE_OK,
	KPARSE_INPROGRESS,
	KPARSE_NOTFOUND,
	KPARSE_INCOMPLETED,
	KPARSE_ILLEGAL,
	KPARSE_ERROR,
	KPARSE_NOACTION,
	KPARSE_MAX,
} kpargv_status_e;


typedef enum {
	KPURPOSE_NONE,
	KPURPOSE_EXEC,
	KPURPOSE_COMPLETION,
	KPURPOSE_HELP,
	KPURPOSE_MAX,
} kpargv_purpose_e;


typedef struct kpargv_s kpargv_t;
typedef struct kparg_s kparg_t;

typedef faux_list_node_t kpargv_pargs_node_t;
typedef faux_list_node_t kpargv_completions_node_t;


C_DECL_BEGIN

// Parg

kparg_t *kparg_new(const kentry_t *entry, const char *value);
void kparg_free(kparg_t *parg);

const kentry_t *kparg_entry(const kparg_t *parg);
bool_t kparg_set_value(kparg_t *parg, const char *value);
const char *kparg_value(const kparg_t *parg);

// Pargv

kpargv_t *kpargv_new();
void kpargv_free(kpargv_t *pargv);

// Status
kpargv_status_e kpargv_status(const kpargv_t *pargv);
bool_t kpargv_set_status(kpargv_t *pargv, kpargv_status_e status);
const char *kpargv_status_decode(kpargv_status_e status);
const char *kpargv_status_str(const kpargv_t *pargv);
// Level
size_t kpargv_level(const kpargv_t *pargv);
bool_t kpargv_set_level(kpargv_t *pargv, size_t level);
// Command
const kentry_t *kpargv_command(const kpargv_t *pargv);
bool_t kpargv_set_command(kpargv_t *pargv, const kentry_t *command);
// Continuable
bool_t kpargv_continuable(const kpargv_t *pargv);
bool_t kpargv_set_continuable(kpargv_t *pargv, bool_t continuable);
// Purpose
kpargv_purpose_e kpargv_purpose(const kpargv_t *pargv);
bool_t kpargv_set_purpose(kpargv_t *pargv, kpargv_purpose_e purpose);
// Last argument
bool_t kpargv_set_last_arg(kpargv_t *pargv, const char *last_arg);
const char *kpargv_last_arg(const kpargv_t *pargv);
// Candidate parg
bool_t kpargv_set_candidate_parg(kpargv_t *pargv, kparg_t *candidate_parg);
kparg_t *kpargv_candidate_parg(const kpargv_t *pargv);
bool_t kpargv_accept_candidate_parg(kpargv_t *pargv);
bool_t kpargv_decline_candidate_parg(kpargv_t *pargv);

// Pargs
faux_list_t *kpargv_pargs(const kpargv_t *pargv);
ssize_t kpargv_pargs_len(const kpargv_t *pargv);
bool_t kpargv_pargs_is_empty(const kpargv_t *pargv);
bool_t kpargv_add_pargs(kpargv_t *pargv, kparg_t *parg);
kpargv_pargs_node_t *kpargv_pargs_iter(const kpargv_t *pargv);
kpargv_pargs_node_t *kpargv_pargs_iterr(const kpargv_t *pargv);
kparg_t *kpargv_pargs_each(kpargv_pargs_node_t **iter);
kparg_t *kpargv_pargs_eachr(kpargv_pargs_node_t **iter);
kparg_t *kpargv_pargs_last(const kpargv_t *pargv);
kparg_t *kpargv_entry_exists(const kpargv_t *pargv, const void *entry);
kparg_t *kpargv_find(const kpargv_t *pargv, const char *entry_name);
faux_list_t *kpargv_find_multi(const kpargv_t *pargv, const char *entry_name);

// Completions
faux_list_t *kpargv_completions(const kpargv_t *pargv);
bool_t kpargv_add_completions(kpargv_t *pargv, const kentry_t *completion);
ssize_t kpargv_completions_len(const kpargv_t *pargv);
bool_t kpargv_completions_is_empty(const kpargv_t *pargv);
kpargv_completions_node_t *kpargv_completions_iter(const kpargv_t *pargv);
const kentry_t *kpargv_completions_each(kpargv_completions_node_t **iter);

// Debug
bool_t kpargv_debug(const kpargv_t *pargv);

C_DECL_END

#endif // _klish_kpargv_h