From 0231675abf3b467cff49d1976df882931d91019d Mon Sep 17 00:00:00 2001 From: Vincent Sanders Date: Wed, 23 Feb 2011 22:27:55 +0000 Subject: add resource handling move gtk and framebuffer to use generic resource handling svn path=/trunk/netsurf/; revision=11772 --- utils/findresource.c | 210 ---------------------------------- utils/findresource.h | 88 --------------- utils/resource.c | 310 +++++++++++++++++++++++++++++++++++++++++++++++++++ utils/resource.h | 105 +++++++++++++++++ 4 files changed, 415 insertions(+), 298 deletions(-) delete mode 100644 utils/findresource.c delete mode 100644 utils/findresource.h create mode 100644 utils/resource.c create mode 100644 utils/resource.h (limited to 'utils') diff --git a/utils/findresource.c b/utils/findresource.c deleted file mode 100644 index cc782682a..000000000 --- a/utils/findresource.c +++ /dev/null @@ -1,210 +0,0 @@ -/* - * Copyright 2010 Vincent Sanders - * - * This file is part of NetSurf, http://www.netsurf-browser.org/ - * - * NetSurf is free software; you can redistribute it and/or modify - * it under the terms of the GNU General Public License as published by - * the Free Software Foundation; version 2 of the License. - * - * NetSurf is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU General Public License for more details. - * - * You should have received a copy of the GNU General Public License - * along with this program. If not, see . - */ - -/** \file - * Provides utility functions for finding readable files. - * - * These functions are intended to make finding resource files more straightforward. - */ - -#include -#include -#include -#include -#include -#include -#include -#include - -#include "utils/config.h" -#include "utils/findresource.h" - -#define MAX_RESPATH 128 /* maximum number of elements in the resource vector */ - -/* exported interface documented in findresource.h */ -char *vsfindfile(char *str, const char *format, va_list ap) -{ - char *realpathname; - char *pathname; - int len; - - pathname = malloc(PATH_MAX); - if (pathname == NULL) - return NULL; /* unable to allocate memory */ - - len = vsnprintf(pathname, PATH_MAX, format, ap); - - if ((len < 0) || (len >= PATH_MAX)) { - /* error or output exceeded PATH_MAX length so - * operation is doomed to fail. - */ - free(pathname); - return NULL; - } - - realpathname = realpath(pathname, str); - - free(pathname); - - if (realpathname != NULL) { - /* sucessfully expanded pathname */ - if (access(realpathname, R_OK) != 0) { - /* unable to read the file */ - return NULL; - } - } - - return realpathname; -} - -/* exported interface documented in findresource.h */ -char *sfindfile(char *str, const char *format, ...) -{ - va_list ap; - char *ret; - - va_start(ap, format); - ret = vsfindfile(str, format, ap); - va_end(ap); - - return ret; -} - -/* exported interface documented in findresource.h */ -char *findfile(const char *format, ...) -{ - char *str; - char *ret; - va_list ap; - - str = malloc(PATH_MAX); - if (str == NULL) - return NULL; /* unable to allocate memory */ - - va_start(ap, format); - ret = vsfindfile(str, format, ap); - va_end(ap); - - if (ret == NULL) - free(str); - - return ret; -} - -/* exported interface documented in findresource.h */ -char *sfindresource(char **respathv, char *filepath, const char *filename) -{ - int respathc = 0; - - if ((respathv == NULL) || (respathv[0] == NULL) || (filepath == NULL)) - return NULL; - - while (respathv[respathc] != NULL) { - if (sfindfile(filepath, "%s/%s", respathv[respathc], filename) != NULL) - return filepath; - - respathc++; - } - - return NULL; -} - -/* exported interface documented in findresource.h */ -char *findresource(char **respathv, const char *filename) -{ - char *ret; - char *filepath; - - if ((respathv == NULL) || (respathv[0] == NULL)) - return NULL; - - filepath = malloc(PATH_MAX); - if (filepath == NULL) - return NULL; - - ret = sfindresource(respathv, filepath, filename); - - if (ret == NULL) - free(filepath); - - return ret; -} - -/* exported interface documented in findresource.h */ -char *sfindresourcedef(char **respathv, char *filepath, const char *filename, const char *def) -{ - char t[PATH_MAX]; - char *ret; - - if ((respathv == NULL) || (respathv[0] == NULL) || (filepath == NULL)) - return NULL; - - ret = sfindresource(respathv, filepath, filename); - - if ((ret == NULL) && - (def != NULL)) { - /* search failed, return the path specified */ - ret = filepath; - if (def[0] == '~') { - snprintf(t, PATH_MAX, "%s/%s/%s", getenv("HOME"), def + 1, filename); - } else { - snprintf(t, PATH_MAX, "%s/%s", def, filename); - } - if (realpath(t, ret) == NULL) { - strcpy(ret, t); - } - - } - return ret; -} - - -/* exported interface documented in findresource.h */ -char ** -findresource_generate(char * const *pathv, const char * const *langv) -{ - char **respath; /* resource paths vector */ - int pathc = 0; - int langc = 0; - int respathc = 0; - struct stat dstat; - char tmppath[PATH_MAX]; - - respath = calloc(MAX_RESPATH, sizeof(char *)); - - while (pathv[pathc] != NULL) { - if ((stat(pathv[pathc], &dstat) == 0) && - S_ISDIR(dstat.st_mode)) { - /* path element exists and is a directory */ - langc = 0; - while (langv[langc] != NULL) { - snprintf(tmppath, PATH_MAX,"%s/%s",pathv[pathc],langv[langc]); - if ((stat(tmppath, &dstat) == 0) && - S_ISDIR(dstat.st_mode)) { - /* path element exists and is a directory */ - respath[respathc++] = strdup(tmppath); - } - langc++; - } - respath[respathc++] = strdup(pathv[pathc]); - } - pathc++; - } - - return respath; -} diff --git a/utils/findresource.h b/utils/findresource.h deleted file mode 100644 index 9e499f570..000000000 --- a/utils/findresource.h +++ /dev/null @@ -1,88 +0,0 @@ -/* - * Copyright 2010 Vincent Sanders - * - * This file is part of NetSurf, http://www.netsurf-browser.org/ - * - * NetSurf is free software; you can redistribute it and/or modify - * it under the terms of the GNU General Public License as published by - * the Free Software Foundation; version 2 of the License. - * - * NetSurf is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU General Public License for more details. - * - * You should have received a copy of the GNU General Public License - * along with this program. If not, see . - */ - -#ifndef _NETSURF_UTILS_FINDRESOURCE_H_ -#define _NETSURF_UTILS_FINDRESOURCE_H_ - -/** Create a normalised file name. - * - * If the file described by the format exists and is accessible the - * normalised path is placed in str and a pointer to str returned - * otherwise NULL is returned. The string in str is always modified. - * - * @param str A buffer to contain the normalised file name must be at - * least PATH_MAX bytes long. - * @param format A printf format for the filename. - * @param ap The list of arguments for the format. - * @return A pointer to the expanded filename or NULL if the file is - * not present or accessible. - */ -char *vsfindfile(char *str, const char *format, va_list ap); - -/** Create a normalised file name. - * - * Similar to vsfindfile but takes variadic (printf like) parameters - */ -char *sfindfile(char *str, const char *format, ...); - -/** Create a normalised file name. - * - * Similar to sfindfile but allocates its own storage for the - * returned string. The caller must free this sorage. - */ -char *findfile(const char *format, ...); - -/** Searches an array of resource paths for a file. - * - * Iterates through a vector of resource paths and returns the - * normalised file name of the first acessible file or NULL if no file - * can be found in any of the resource paths. - * - * @param respathv The resource path vector to iterate. - * @param filepath The buffer to place the result in. - * @param filename The filename of the resource to search for. - * @return A pointer to filepath if a target is found or NULL if not. - */ -char *sfindresource(char **respathv, char *filepath, const char *filename); - -/** Searches an array of resource paths for a file. - * - * Similar to sfindresource except it allocates its own storage for - * the returned string. The caller must free this sorage. - */ -char *findresource(char **respathv, const char *filename); - -/** Searches an array of resource paths for a file optionally forcing a default. - * - * Similar to sfindresource except if no resource is found the default - * is used as an additional path element to search, if that still - * fails the returned path is set to the concatination of the default - * path and the filename. - */ -char *sfindresourcedef(char **respathv, char *filepath, const char *filename, const char *def); - -/** Merge two string vectors into a resource search path vector. - * - * @param pathv A string vector containing path elemets to scan. - * @param langv A string vector containing language names to enumerate. - * @return A pointer to a NULL terminated string vector of valid - * resource directories. - */ -char **findresource_generate(char * const *pathv, const char * const *langv); - -#endif diff --git a/utils/resource.c b/utils/resource.c new file mode 100644 index 000000000..80b1c8280 --- /dev/null +++ b/utils/resource.c @@ -0,0 +1,310 @@ +/* + * Copyright 2010 Vincent Sanders + * + * This file is part of NetSurf, http://www.netsurf-browser.org/ + * + * NetSurf is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation; version 2 of the License. + * + * NetSurf is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program. If not, see . + */ + +/** \file + * Provides utility functions for finding readable files. + * + * These functions are intended to make finding resource files more straightforward. + */ + +#include +#include +#include +#include +#include +#include +#include +#include + +#include "utils/config.h" +#include "utils/resource.h" + +/** maximum number of elements in the resource vector */ +#define MAX_RESPATH 128 + +/* exported interface documented in findresource.h */ +char *resource_vsfindfile(char *str, const char *format, va_list ap) +{ + char *realpathname; + char *pathname; + int len; + + pathname = malloc(PATH_MAX); + if (pathname == NULL) + return NULL; /* unable to allocate memory */ + + len = vsnprintf(pathname, PATH_MAX, format, ap); + + if ((len < 0) || (len >= PATH_MAX)) { + /* error or output exceeded PATH_MAX length so + * operation is doomed to fail. + */ + free(pathname); + return NULL; + } + + realpathname = realpath(pathname, str); + + free(pathname); + + if (realpathname != NULL) { + /* sucessfully expanded pathname */ + if (access(realpathname, R_OK) != 0) { + /* unable to read the file */ + return NULL; + } + } + + return realpathname; +} + +/* exported interface documented in findresource.h */ +char *resource_sfindfile(char *str, const char *format, ...) +{ + va_list ap; + char *ret; + + va_start(ap, format); + ret = resource_vsfindfile(str, format, ap); + va_end(ap); + + return ret; +} + +/* exported interface documented in findresource.h */ +char *resource_findfile(const char *format, ...) +{ + char *str; + char *ret; + va_list ap; + + str = malloc(PATH_MAX); + if (str == NULL) + return NULL; /* unable to allocate memory */ + + va_start(ap, format); + ret = resource_vsfindfile(str, format, ap); + va_end(ap); + + if (ret == NULL) + free(str); + + return ret; +} + +/* exported interface documented in findresource.h */ +char *resource_sfind(char **respathv, char *filepath, const char *filename) +{ + int respathc = 0; + + if ((respathv == NULL) || (respathv[0] == NULL) || (filepath == NULL)) + return NULL; + + while (respathv[respathc] != NULL) { + if (resource_sfindfile(filepath, "%s/%s", respathv[respathc], filename) != NULL) + return filepath; + + respathc++; + } + + return NULL; +} + +/* exported interface documented in findresource.h */ +char *resource_find(char **respathv, const char *filename) +{ + char *ret; + char *filepath; + + if ((respathv == NULL) || (respathv[0] == NULL)) + return NULL; + + filepath = malloc(PATH_MAX); + if (filepath == NULL) + return NULL; + + ret = resource_sfind(respathv, filepath, filename); + + if (ret == NULL) + free(filepath); + + return ret; +} + +/* exported interface documented in findresource.h */ +char *resource_sfinddef(char **respathv, char *filepath, const char *filename, const char *def) +{ + char t[PATH_MAX]; + char *ret; + + if ((respathv == NULL) || (respathv[0] == NULL) || (filepath == NULL)) + return NULL; + + ret = resource_sfind(respathv, filepath, filename); + + if ((ret == NULL) && (def != NULL)) { + /* search failed, return the path specified */ + ret = filepath; + if (def[0] == '~') { + snprintf(t, PATH_MAX, "%s/%s/%s", getenv("HOME"), def + 1, filename); + } else { + snprintf(t, PATH_MAX, "%s/%s", def, filename); + } + if (realpath(t, ret) == NULL) { + strcpy(ret, t); + } + + } + return ret; +} + + +/* exported interface documented in resource.h */ +char ** +resource_generate(char * const *pathv, const char * const *langv) +{ + char **respath; /* resource paths vector */ + int pathc = 0; + int langc = 0; + int respathc = 0; + struct stat dstat; + char tmppath[PATH_MAX]; + + respath = calloc(MAX_RESPATH, sizeof(char *)); + + while (pathv[pathc] != NULL) { + if ((stat(pathv[pathc], &dstat) == 0) && + S_ISDIR(dstat.st_mode)) { + /* path element exists and is a directory */ + langc = 0; + while (langv[langc] != NULL) { + snprintf(tmppath, sizeof tmppath, "%s/%s", pathv[pathc],langv[langc]); + if ((stat(tmppath, &dstat) == 0) && + S_ISDIR(dstat.st_mode)) { + /* path element exists and is a directory */ + respath[respathc++] = strdup(tmppath); + } + langc++; + } + respath[respathc++] = strdup(pathv[pathc]); + } + pathc++; + } + + return respath; +} + +/* expand ${} in a string into environment variables */ +static char * +expand_path(const char *path) +{ + char *exp = strdup(path); + int explen; + int cstart = -1; + int cloop = 0; + char *envv; + int envlen; + int replen; /* length of replacement */ + + if (exp == NULL) + return NULL; + + explen = strlen(exp) + 1; + + while (exp[cloop] != 0) { + if ((exp[cloop] == '$') && + (exp[cloop + 1] == '{')) { + cstart = cloop; + cloop++; + } + + if ((cstart != -1) && + (exp[cloop] == '}')) { + replen = cloop - cstart; + exp[cloop] = 0; + envv = getenv(exp + cstart + 2); + if (envv == NULL) { + memmove(exp + cstart, + exp + cloop + 1, + explen - cloop - 1); + explen -= replen; + } else { + envlen = strlen(envv); + exp = realloc(exp, explen + envlen - replen); + memmove(exp + cstart + envlen, + exp + cloop + 1, + explen - cloop - 1); + memmove(exp + cstart, envv, envlen); + explen += envlen - replen; + } + cloop -= replen; + cstart = -1; + } + + cloop++; + } + + return exp; +} + +/* exported interface documented in resource.h */ +char ** +resource_path_to_strvec(const char *path) +{ + char **strvec; + int strc = 0; + + strvec = calloc(MAX_RESPATH, sizeof(char *)); + if (strvec == NULL) + return NULL; + + strvec[strc] = expand_path(path); + if (strvec[strc] == NULL) { + free(strvec); + return NULL; + } + strc++; + + strvec[strc] = strchr(strvec[0], ':'); + while ((strc < (MAX_RESPATH - 2)) && + (strvec[strc] != NULL)) { + /* null terminate previous entry */ + *strvec[strc] = 0; + strvec[strc]++; + + /* skip colons */ + while (*strvec[strc] == ':') + strvec[strc]++; + + if (*strvec[strc] == 0) + break; /* string is terminated */ + + strc++; + + strvec[strc] = strchr(strvec[strc - 1], ':'); + } + + return strvec; +} + +/* exported interface documented in resource.h */ +void resource_free_strvec(char **pathv) +{ + free(pathv[0]); + free(pathv); +} diff --git a/utils/resource.h b/utils/resource.h new file mode 100644 index 000000000..ba1ad1535 --- /dev/null +++ b/utils/resource.h @@ -0,0 +1,105 @@ +/* + * Copyright 2010 Vincent Sanders + * + * This file is part of NetSurf, http://www.netsurf-browser.org/ + * + * NetSurf is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation; version 2 of the License. + * + * NetSurf is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program. If not, see . + */ + +/** \file Utility routines to locate file resources. */ + +#ifndef _NETSURF_UTILS_RESOURCE_H_ +#define _NETSURF_UTILS_RESOURCE_H_ + +/** Create a normalised file name. + * + * If the file described by the format exists and is accessible the + * normalised path is placed in str and a pointer to str returned + * otherwise NULL is returned. The string in str is always modified. + * + * @param str A buffer to contain the normalised file name must be at + * least PATH_MAX bytes long. + * @param format A printf format for the filename. + * @param ap The list of arguments for the format. + * @return A pointer to the expanded filename or NULL if the file is + * not present or accessible. + */ +char *resource_vsfindfile(char *str, const char *format, va_list ap); + +/** Create a normalised file name. + * + * Similar to vsfindfile but takes variadic (printf like) parameters + */ +char *resource_sfindfile(char *str, const char *format, ...); + +/** Create a normalised file name. + * + * Similar to sfindfile but allocates its own storage for the + * returned string. The caller must free this sorage. + */ +char *resource_findfile(const char *format, ...); + +/** Searches an array of resource paths for a file. + * + * Iterates through a vector of resource paths and returns the + * normalised file name of the first acessible file or NULL if no file + * can be found in any of the resource paths. + * + * @param respathv The resource path vector to iterate. + * @param filepath The buffer to place the result in. + * @param filename The filename of the resource to search for. + * @return A pointer to filepath if a target is found or NULL if not. + */ +char *resource_sfind(char **respathv, char *filepath, const char *filename); + +/** Searches an array of resource paths for a file. + * + * Similar to resource_sfind except it allocates its own storage for + * the returned string. The caller must free this sorage. + */ +char *resource_find(char **respathv, const char *filename); + +/** Searches an array of resource paths for a file optionally forcing a default. + * + * Similar to resource_sfind except if no resource is found the default + * is used as an additional path element to search, if that still + * fails the returned path is set to the concatination of the default + * path and the filename. + */ +char *resource_sfinddef(char **respathv, char *filepath, const char *filename, const char *def); + +/** Merge two string vectors into a resource search path vector. + * + * @param pathv A string vector containing path elemets to scan. + * @param langv A string vector containing language names to enumerate. + * @return A pointer to a NULL terminated string vector of valid + * resource directories. + */ +char **resource_generate(char * const *pathv, const char * const *langv); + + +/** Convert a colon separated list of path elements into a string vector. + * + * @param path A colon separated path. + * @return A pointer to a NULL terminated string vector of valid + * resource directories. + */ +char **resource_path_to_strvec(const char *path); + +/** Free a string vector + * + * Free a string vector allocated by resource_path_to_strvec + */ +void resource_free_strvec(char **pathv); + +#endif /* _NETSURF_UTILS_RESOURCE_H_ */ -- cgit v1.2.3