helper.h

Go to the documentation of this file.

/*
 * rofi
 *
 * MIT/X11 License
 * Copyright © 2013-2023 Qball Cow <qball@gmpclient.org>
 *
 * Permission is hereby granted, free of charge, to any person obtaining
 * a copy of this software and associated documentation files (the
 * "Software"), to deal in the Software without restriction, including
 * without limitation the rights to use, copy, modify, merge, publish,
 * distribute, sublicense, and/or sell copies of the Software, and to
 * permit persons to whom the Software is furnished to do so, subject to
 * the following conditions:
 *
 * The above copyright notice and this permission notice shall be
 * included in all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
 * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
 * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
 * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
 * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 *
 */
 
#ifndef ROFI_HELPER_H
#define ROFI_HELPER_H
#include "rofi-types.h"
#include <cairo.h>
G_BEGIN_DECLS


int helper_parse_setup(char *string, char ***output, int *length, ...);

rofi_int_matcher **helper_tokenize(const char *input, int case_sensitive);

void helper_tokenize_free(rofi_int_matcher **tokens);

int find_arg_char(const char *const key, char *val);

int find_arg_uint(const char *const key, unsigned int *val);

int find_arg_int(const char *const key, int *val);

int find_arg_str(const char *const key, char **val);

const char **find_arg_strv(const char *const key);
int find_arg(const char *const key);

int helper_token_match(rofi_int_matcher *const *tokens, const char *input);
int execute_generator(const char *cmd) __attribute__((nonnull));

int create_pid_file(const char *pidfile, gboolean kill_running);

void remove_pid_file(int fd);

int config_sanity_check(void);

char helper_parse_char(const char *arg);

void cmd_set_arguments(int argc, char **argv);

char *rofi_expand_path(const char *input);

unsigned int levenshtein(const char *needle, const glong needlelen,
                         const char *haystack, const glong haystacklen,
                         const int case_sensitive);

char *rofi_force_utf8(const gchar *data, ssize_t length);

char *rofi_latin_to_utf8_strdup(const char *input, gssize length);

int rofi_scorer_fuzzy_evaluate(const char *pattern, glong plen, const char *str,
                               glong slen, const int case_sensitive);

int rofi_scorer_fzf_v2_evaluate(const char *pattern, glong plen,
                                const char *str, glong slen,
                                int case_sensitive);

int rofi_scorer_fzf_v2_sort_key(int score, const char *str);

int utf8_strncmp(const char *a, const char *b, size_t n)
    __attribute__((nonnull(1, 2)));

typedef struct {
  const gchar *name;
  const gchar *binary;
  const gchar *description;
  const gchar *icon;
  const gchar *app_id;
  const gchar *wmclass;
  const gchar *command;
} RofiHelperExecuteContext;

gboolean helper_execute_env(const char *wd, char **args,
                            const char *error_precmd, const char *error_cmd,
                            RofiHelperExecuteContext *context, gchar **envp);
gboolean helper_execute(const char *wd, char **args, const char *error_precmd,
                        const char *error_cmd,
                        RofiHelperExecuteContext *context);

gboolean helper_execute_command(const char *wd, const char *cmd,
                                gboolean run_in_term,
                                RofiHelperExecuteContext *context);

gboolean helper_execute_command_env(const char *wd, const char *cmd,
                                    gboolean run_in_term,
                                    RofiHelperExecuteContext *context,
                                    char **envp);
cairo_surface_t *cairo_image_surface_create_from_svg(const gchar *file,
                                                     int height);


void parse_ranges(char *input, rofi_range_pair **list, unsigned int *length);

int parse_case_sensitivity(const char *input);

void rofi_output_formatted_line(const char *format, const char *string,
                                int selected_line, const char *filter);

char *helper_string_replace_if_exists(char *string, ...);

char *helper_get_theme_path(const char *file, const char **ext,
                            const char *parent_dir)
    __attribute__((nonnull(1, 2)));

ConfigEntry *rofi_config_find_widget(const char *name, const char *state,
                                     gboolean exact);

Property *rofi_theme_find_property(ConfigEntry *widget, PropertyType type,
                                   const char *property, gboolean exact);

const char *helper_get_matching_mode_str(void);
void helper_select_next_matching_mode(void);
void helper_select_previous_matching_mode(void);

#if __has_attribute(__fallthrough__)
#define rofi_fallthrough __attribute__((__fallthrough__))
#else
#define rofi_fallthrough                                                       \
  do {                                                                         \
  } while (0) /* fallthrough */
#endif
 
G_END_DECLS

#endif // ROFI_HELPER_H