Remove unnecessary "lang" parameter of various functions

[geany-mirror.git] / src / tagmanager / tm_workspace.c

/*
*
*   Copyright (c) 2001-2002, Biswapesh Chattopadhyay
*   Copyright 2005 The Geany contributors
*
*   This source code is released for free distribution under the terms of the
*   GNU General Public License.
*
*/

/**
 * @file tm_workspace.h
 The TMWorkspace structure is meant to be used as a singleton to store application
 wide tag information.

 The workspace is intended to contain a list of global tags
 and a set of individual source files.
*/

#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <ctype.h>
#include <sys/types.h>
#include <string.h>
#include <sys/stat.h>
#ifdef HAVE_GLOB_H
# include <glob.h>
#endif
#include <glib/gstdio.h>

#include "tm_workspace.h"
#include "tm_ctags.h"
#include "tm_tag.h"
#include "tm_parser.h"


/* when changing, always keep the three sort criteria below in sync */
static TMTagAttrType workspace_tags_sort_attrs[] =
{
        tm_tag_attr_name_t, tm_tag_attr_file_t, tm_tag_attr_line_t,
        tm_tag_attr_type_t, tm_tag_attr_scope_t, tm_tag_attr_arglist_t, 0
};

/* for file tags the file is always identical, don't use for sorting */
static TMTagAttrType file_tags_sort_attrs[] =
{
        tm_tag_attr_name_t, tm_tag_attr_line_t,
        tm_tag_attr_type_t, tm_tag_attr_scope_t, tm_tag_attr_arglist_t, 0
};

/* global tags don't have file/line information */
static TMTagAttrType global_tags_sort_attrs[] =
{
        tm_tag_attr_name_t,
        tm_tag_attr_type_t, tm_tag_attr_scope_t, tm_tag_attr_arglist_t, 0
};

static TMTagType TM_TYPE_WITH_MEMBERS =
        tm_tag_class_t | tm_tag_struct_t | tm_tag_union_t |
        tm_tag_enum_t | tm_tag_interface_t;

static TMTagType TM_GLOBAL_TYPE_MASK =
        tm_tag_class_t | tm_tag_enum_t | tm_tag_interface_t |
        tm_tag_struct_t | tm_tag_typedef_t | tm_tag_union_t | tm_tag_namespace_t;

static TMWorkspace *theWorkspace = NULL;


static gboolean tm_create_workspace(void)
{
        theWorkspace = g_new(TMWorkspace, 1);
        theWorkspace->tags_array = g_ptr_array_new();

        theWorkspace->global_tags = g_ptr_array_new();
        theWorkspace->source_files = g_ptr_array_new();
        theWorkspace->typename_array = g_ptr_array_new();
        theWorkspace->global_typename_array = g_ptr_array_new();

        tm_ctags_init();
        tm_parser_verify_type_mappings();

        return TRUE;
}


/* Frees the workspace structure and all child source files. Use only when
 exiting from the main program.
*/
void tm_workspace_free(void)
{
        guint i;

#ifdef TM_DEBUG
        g_message("Workspace destroyed");
#endif

        for (i=0; i < theWorkspace->source_files->len; ++i)
                tm_source_file_free(theWorkspace->source_files->pdata[i]);
        g_ptr_array_free(theWorkspace->source_files, TRUE);
        tm_tags_array_free(theWorkspace->global_tags, TRUE);
        g_ptr_array_free(theWorkspace->tags_array, TRUE);
        g_ptr_array_free(theWorkspace->typename_array, TRUE);
        g_ptr_array_free(theWorkspace->global_typename_array, TRUE);
        g_free(theWorkspace);
        theWorkspace = NULL;
}


/* Since TMWorkspace is a singleton, you should not create multiple
 workspaces, but get a pointer to the workspace whenever required. The first
 time a pointer is requested, or a source file is added to the workspace,
 a workspace is created. Subsequent calls to the function will return the
 created workspace.
*/
const TMWorkspace *tm_get_workspace(void)
{
        if (NULL == theWorkspace)
                tm_create_workspace();
        return theWorkspace;
}


static void tm_workspace_merge_tags(GPtrArray **big_array, GPtrArray *small_array)
{
        GPtrArray *new_tags = tm_tags_merge(*big_array, small_array, workspace_tags_sort_attrs, FALSE);
        /* tags owned by TMSourceFile - free just the pointer array */
        g_ptr_array_free(*big_array, TRUE);
        *big_array = new_tags;
}


static void merge_extracted_tags(GPtrArray **dest, GPtrArray *src, TMTagType tag_types)
{
        GPtrArray *arr;

        arr = tm_tags_extract(src, tag_types);
        tm_workspace_merge_tags(dest, arr);
        g_ptr_array_free(arr, TRUE);
}


static void update_source_file(TMSourceFile *source_file, guchar* text_buf,
        gsize buf_size, gboolean use_buffer, gboolean update_workspace)
{
#ifdef TM_DEBUG
        g_message("Source file updating based on source file %s", source_file->file_name);
#endif

        if (update_workspace)
        {
                /* tm_source_file_parse() deletes the tag objects - remove the tags from
                 * workspace while they exist and can be scanned */
                tm_tags_remove_file_tags(source_file, theWorkspace->tags_array);
                tm_tags_remove_file_tags(source_file, theWorkspace->typename_array);
        }
        tm_source_file_parse(source_file, text_buf, buf_size, use_buffer);
        tm_tags_sort(source_file->tags_array, file_tags_sort_attrs, FALSE, TRUE);
        if (update_workspace)
        {
#ifdef TM_DEBUG
                g_message("Updating workspace from source file");
#endif
                tm_workspace_merge_tags(&theWorkspace->tags_array, source_file->tags_array);

                merge_extracted_tags(&(theWorkspace->typename_array), source_file->tags_array, TM_GLOBAL_TYPE_MASK);
        }
#ifdef TM_DEBUG
        else
                g_message("Skipping workspace update because update_workspace is %s",
                        update_workspace?"TRUE":"FALSE");

#endif
}


/** Adds a source file to the workspace, parses it and updates the workspace tags.
 @param source_file The source file to add to the workspace.
*/
GEANY_API_SYMBOL
void tm_workspace_add_source_file(TMSourceFile *source_file)
{
        g_return_if_fail(source_file != NULL);

        g_ptr_array_add(theWorkspace->source_files, source_file);
        update_source_file(source_file, NULL, 0, FALSE, TRUE);
}


void tm_workspace_add_source_file_noupdate(TMSourceFile *source_file)
{
        g_return_if_fail(source_file != NULL);

        g_ptr_array_add(theWorkspace->source_files, source_file);
}


/* Updates the source file by reparsing the text-buffer passed as parameter.
 Ctags will use a parsing based on buffer instead of on files.
 You should call this function when you don't want a previous saving of the file
 you're editing. It's useful for a "real-time" updating of the tags.
 The tags array and the tags themselves are destroyed and re-created, hence any
 other tag arrays pointing to these tags should be rebuilt as well. All sorting
 information is also lost.
 @param source_file The source file to update with a buffer.
 @param text_buf A text buffer. The user should take care of allocate and free it after
 the use here.
 @param buf_size The size of text_buf.
*/
void tm_workspace_update_source_file_buffer(TMSourceFile *source_file, guchar* text_buf,
        gsize buf_size)
{
        update_source_file(source_file, text_buf, buf_size, TRUE, TRUE);
}


/** Removes a source file from the workspace if it exists. This function also removes
 the tags belonging to this file from the workspace. To completely free the TMSourceFile
 pointer call tm_source_file_free() on it.
 @param source_file Pointer to the source file to be removed.
*/
GEANY_API_SYMBOL
void tm_workspace_remove_source_file(TMSourceFile *source_file)
{
        guint i;

        g_return_if_fail(source_file != NULL);

        for (i=0; i < theWorkspace->source_files->len; ++i)
        {
                if (theWorkspace->source_files->pdata[i] == source_file)
                {
                        tm_tags_remove_file_tags(source_file, theWorkspace->tags_array);
                        tm_tags_remove_file_tags(source_file, theWorkspace->typename_array);
                        g_ptr_array_remove_index_fast(theWorkspace->source_files, i);
                        return;
                }
        }
}


/* Recreates workspace tag array from all member TMSourceFile objects. Use if you
 want to globally refresh the workspace. This function does not call tm_source_file_update()
 which should be called before this function on source files which need to be
 reparsed.
*/
static void tm_workspace_update(void)
{
        guint i, j;
        TMSourceFile *source_file;

#ifdef TM_DEBUG
        g_message("Recreating workspace tags array");
#endif

        g_ptr_array_set_size(theWorkspace->tags_array, 0);

#ifdef TM_DEBUG
        g_message("Total %d objects", theWorkspace->source_files->len);
#endif
        for (i=0; i < theWorkspace->source_files->len; ++i)
        {
                source_file = theWorkspace->source_files->pdata[i];
#ifdef TM_DEBUG
                g_message("Adding tags of %s", source_file->file_name);
#endif
                if (source_file->tags_array->len > 0)
                {
                        for (j = 0; j < source_file->tags_array->len; ++j)
                        {
                                g_ptr_array_add(theWorkspace->tags_array,
                                        source_file->tags_array->pdata[j]);
                        }
                }
        }
#ifdef TM_DEBUG
        g_message("Total: %d tags", theWorkspace->tags_array->len);
#endif
        tm_tags_sort(theWorkspace->tags_array, workspace_tags_sort_attrs, TRUE, FALSE);

        g_ptr_array_free(theWorkspace->typename_array, TRUE);
        theWorkspace->typename_array = tm_tags_extract(theWorkspace->tags_array, TM_GLOBAL_TYPE_MASK);
}


/** Adds multiple source files to the workspace and updates the workspace tag arrays.
 This is more efficient than calling tm_workspace_add_source_file() and
 tm_workspace_update_source_file() separately for each of the files.
 @param source_files @elementtype{TMSourceFile} The source files to be added to the workspace.
*/
GEANY_API_SYMBOL
void tm_workspace_add_source_files(GPtrArray *source_files)
{
        guint i;

        g_return_if_fail(source_files != NULL);

        for (i = 0; i < source_files->len; i++)
        {
                TMSourceFile *source_file = source_files->pdata[i];

                tm_workspace_add_source_file_noupdate(source_file);
                update_source_file(source_file, NULL, 0, FALSE, FALSE);
        }

        tm_workspace_update();
}


/** Removes multiple source files from the workspace and updates the workspace tag
 arrays. This is more efficient than calling tm_workspace_remove_source_file()
 separately for each of the files. To completely free the TMSourceFile pointers
 call tm_source_file_free() on each of them.
 @param source_files @elementtype{TMSourceFile} The source files to be removed from the workspace.
*/
GEANY_API_SYMBOL
void tm_workspace_remove_source_files(GPtrArray *source_files)
{
        guint i, j;

        g_return_if_fail(source_files != NULL);

        //TODO: sort both arrays by pointer value and remove in single pass
        for (i = 0; i < source_files->len; i++)
        {
                TMSourceFile *source_file = source_files->pdata[i];

                for (j = 0; j < theWorkspace->source_files->len; j++)
                {
                        if (theWorkspace->source_files->pdata[j] == source_file)
                        {
                                g_ptr_array_remove_index_fast(theWorkspace->source_files, j);
                                break;
                        }
                }
        }

        tm_workspace_update();
}


/* Loads the global tag list from the specified file. The global tag list should
 have been first created using tm_workspace_create_global_tags().
 @param tags_file The file containing global tags.
 @return TRUE on success, FALSE on failure.
 @see tm_workspace_create_global_tags()
*/
gboolean tm_workspace_load_global_tags(const char *tags_file, TMParserType mode)
{
        GPtrArray *file_tags, *new_tags;

        file_tags = tm_source_file_read_tags_file(tags_file, mode);
        if (!file_tags)
                return FALSE;

        tm_tags_sort(file_tags, global_tags_sort_attrs, TRUE, TRUE);

        /* reorder the whole array, because tm_tags_find expects a sorted array */
        new_tags = tm_tags_merge(theWorkspace->global_tags,
                file_tags, global_tags_sort_attrs, TRUE);
        g_ptr_array_free(theWorkspace->global_tags, TRUE);
        g_ptr_array_free(file_tags, TRUE);
        theWorkspace->global_tags = new_tags;

        g_ptr_array_free(theWorkspace->global_typename_array, TRUE);
        theWorkspace->global_typename_array = tm_tags_extract(new_tags, TM_GLOBAL_TYPE_MASK);

        return TRUE;
}


static gboolean write_includes_file(const gchar *outf, GList *includes_files)
{
        FILE *fp = g_fopen(outf, "w");
        GList *node = includes_files;

        if (!fp)
                return FALSE;

        while (node)
        {
                char *str = g_strdup_printf("#include \"%s\"\n", (char*)node->data);
                size_t str_len = strlen(str);

                fwrite(str, str_len, 1, fp);
                g_free(str);
                node = g_list_next(node);
        }

        return fclose(fp) == 0;
}


static gboolean combine_include_files(const gchar *outf, GList *file_list)
{
        FILE *fp = g_fopen(outf, "w");
        GList *node = file_list;

        if (!fp)
                return FALSE;

        while (node)
        {
                const char *fname = node->data;
                char *contents;
                size_t length;
                GError *err = NULL;

                if (! g_file_get_contents(fname, &contents, &length, &err))
                {
                        fprintf(stderr, "Unable to read file: %s\n", err->message);
                        g_error_free(err);
                }
                else
                {
                        fwrite(contents, length, 1, fp);
                        fwrite("\n", 1, 1, fp); /* in case file doesn't end in newline (e.g. windows). */
                        g_free(contents);
                }
                node = g_list_next (node);
        }

        return fclose(fp) == 0;
}


static gchar *create_temp_file(const gchar *tpl)
{
        gchar *name;
        gint fd;

        fd = g_file_open_tmp(tpl, &name, NULL);
        if (fd < 0)
                name = NULL;
        else
                close(fd);

        return name;
}

static GList *lookup_includes(const gchar **includes, gint includes_count)
{
        GList *includes_files = NULL;
        GHashTable *table; /* used for deduping */
        gint i;
#ifdef HAVE_GLOB_H
        glob_t globbuf;
        size_t idx_glob;
#endif

        table = g_hash_table_new_full(g_str_hash, g_str_equal, NULL, NULL);

#ifdef HAVE_GLOB_H
        globbuf.gl_offs = 0;

        if (includes[0][0] == '"')      /* leading \" char for glob matching */
        {
                for (i = 0; i < includes_count; i++)
                {
                        size_t dirty_len = strlen(includes[i]);
                        gchar *clean_path;

                        if (dirty_len < 2)
                                continue;

                        clean_path = g_malloc(dirty_len - 1);

                        strncpy(clean_path, includes[i] + 1, dirty_len - 1);
                        clean_path[dirty_len - 2] = 0;

#ifdef TM_DEBUG
                        g_message ("[o][%s]\n", clean_path);
#endif
                        glob(clean_path, 0, NULL, &globbuf);

#ifdef TM_DEBUG
                        g_message ("matches: %d\n", globbuf.gl_pathc);
#endif

                        for (idx_glob = 0; idx_glob < globbuf.gl_pathc; idx_glob++)
                        {
#ifdef TM_DEBUG
                                g_message (">>> %s\n", globbuf.gl_pathv[idx_glob]);
#endif
                                if (!g_hash_table_lookup(table, globbuf.gl_pathv[idx_glob]))
                                {
                                        gchar *file_name_copy = g_strdup(globbuf.gl_pathv[idx_glob]);

                                        includes_files = g_list_prepend(includes_files, file_name_copy);
                                        g_hash_table_insert(table, file_name_copy, file_name_copy);
#ifdef TM_DEBUG
                                        g_message ("Added ...\n");
#endif
                                }
                        }
                        globfree(&globbuf);
                        g_free(clean_path);
                }
        }
        else
#endif /* HAVE_GLOB_H */
        {
                /* no glob support or globbing not wanted */
                for (i = 0; i < includes_count; i++)
                {
                        if (!g_hash_table_lookup(table, includes[i]))
                        {
                                gchar* file_name_copy = g_strdup(includes[i]);

                                includes_files = g_list_prepend(includes_files, file_name_copy);
                                g_hash_table_insert(table, file_name_copy, file_name_copy);
                        }
                }
        }

        g_hash_table_destroy(table);

        return g_list_reverse(includes_files);
}

static gchar *pre_process_file(const gchar *cmd, const gchar *inf)
{
        gint ret;
        gchar *outf = create_temp_file("tmp_XXXXXX.cpp");
        gchar *tmp_errfile;
        gchar *errors = NULL;
        gchar *command;

        if (!outf)
                return NULL;

        tmp_errfile = create_temp_file("tmp_XXXXXX");
        if (!tmp_errfile)
        {
                g_unlink(outf);
                g_free(outf);
                return NULL;
        }

        command = g_strdup_printf("%s %s >%s 2>%s",
                cmd, inf, outf, tmp_errfile);
#ifdef TM_DEBUG
        g_message("Executing: %s", command);
#endif
        ret = system(command);
        g_free(command);

        g_file_get_contents(tmp_errfile, &errors, NULL, NULL);
        if (errors && *errors)
                g_printerr("%s\n", errors);
        g_free(errors);
        g_unlink(tmp_errfile);
        g_free(tmp_errfile);

        if (ret == -1)
        {
                g_unlink(outf);
                g_free(outf);
                return NULL;
        }

        return outf;
}

/* Creates a list of global tags. Ideally, this should be created once during
 installations so that all users can use the same file. This is because a full
 scale global tag list can occupy several megabytes of disk space.
 @param pre_process The pre-processing command. This is executed via system(),
 so you can pass stuff like 'gcc -E -dD -P `gnome-config --cflags gnome`'.
 @param includes Include files to process. Wildcards such as '/usr/include/a*.h'
 are allowed.
 @param tags_file The file where the tags will be stored.
 @param lang The language to use for the tags file.
 @return TRUE on success, FALSE on failure.
*/
gboolean tm_workspace_create_global_tags(const char *pre_process, const char **includes,
        int includes_count, const char *tags_file, TMParserType lang)
{
        gboolean ret = FALSE;
        TMSourceFile *source_file;
        GList *includes_files;
        gchar *temp_file = create_temp_file("tmp_XXXXXX.cpp");
        GPtrArray *filtered_tags;

        if (!temp_file)
                return FALSE;

        includes_files = lookup_includes(includes, includes_count);

#ifdef TM_DEBUG
        g_message ("writing out files to %s\n", temp_file);
#endif
        if (pre_process)
                ret = write_includes_file(temp_file, includes_files);
        else
                ret = combine_include_files(temp_file, includes_files);

        g_list_free_full(includes_files, g_free);
        if (!ret)
                goto cleanup;
        ret = FALSE;

        if (pre_process)
        {
                gchar *temp_file2 = pre_process_file(pre_process, temp_file);

                if (temp_file2)
                {
                        g_unlink(temp_file);
                        g_free(temp_file);
                        temp_file = temp_file2;
                }
                else
                        goto cleanup;
        }

        source_file = tm_source_file_new(temp_file, tm_source_file_get_lang_name(lang));
        if (!source_file)
                goto cleanup;
        update_source_file(source_file, NULL, 0, FALSE, FALSE);
        if (source_file->tags_array->len == 0)
        {
                tm_source_file_free(source_file);
                goto cleanup;
        }

        tm_tags_sort(source_file->tags_array, global_tags_sort_attrs, TRUE, FALSE);
        filtered_tags = tm_tags_extract(source_file->tags_array, ~tm_tag_local_var_t);
        ret = tm_source_file_write_tags_file(tags_file, filtered_tags);
        g_ptr_array_free(filtered_tags, TRUE);
        tm_source_file_free(source_file);

cleanup:
        g_unlink(temp_file);
        g_free(temp_file);
        return ret;
}


static void fill_find_tags_array(GPtrArray *dst, const GPtrArray *src,
        const char *name, const char *scope, TMTagType type, TMParserType lang)
{
        TMTag **tag;
        guint i, num;

        if (!src || !dst || !name || !*name)
                return;

        tag = tm_tags_find(src, name, FALSE, &num);
        for (i = 0; i < num; ++i)
        {
                if ((type & (*tag)->type) &&
                        tm_parser_langs_compatible(lang, (*tag)->lang) &&
                        (!scope || g_strcmp0((*tag)->scope, scope) == 0))
                {
                        g_ptr_array_add(dst, *tag);
                }
                tag++;
        }
}


/* Returns all matching tags found in the workspace.
 @param name The name of the tag to find.
 @param scope The scope name of the tag to find, or NULL.
 @param type The tag types to return (TMTagType). Can be a bitmask.
 @param attrs The attributes to sort and dedup on (0 terminated integer array).
 @param lang Specifies the language(see the table in tm_parsers.h) of the tags to be found,
             -1 for all
 @return Array of matching tags.
*/
GPtrArray *tm_workspace_find(const char *name, const char *scope, TMTagType type,
        TMTagAttrType *attrs, TMParserType lang)
{
        GPtrArray *tags = g_ptr_array_new();

        fill_find_tags_array(tags, theWorkspace->tags_array, name, scope, type, lang);
        fill_find_tags_array(tags, theWorkspace->global_tags, name, scope, type, lang);

        if (attrs)
                tm_tags_sort(tags, attrs, TRUE, FALSE);

        return tags;
}


gboolean tm_workspace_is_autocomplete_tag(TMTag *tag,
        TMSourceFile *current_file,
        guint current_line,
        const gchar *current_scope)
{
        TMParserType lang = current_file ? current_file->lang : TM_PARSER_NONE;

        /* ignore local variables from other files/functions or after current line */
        gboolean valid = !(tag->type & tm_tag_local_var_t) ||
                (current_file == tag->file &&
                 current_line >= tag->line &&
                 g_strcmp0(current_scope, tag->scope) == 0);
        return valid && !tm_tag_is_anon(tag) && tm_parser_langs_compatible(lang, tag->lang);
}


typedef struct
{
        TMSourceFile *file;
        guint line;
        const gchar *scope;
} CopyInfo;

static gboolean is_any_tag(TMTag *tag, CopyInfo *info)
{
        return TRUE;
}

static gboolean is_local_tag(TMTag *tag, CopyInfo *info)
{
        return tag->type & tm_tag_local_var_t;
}

static gboolean is_non_local_tag(TMTag *tag, CopyInfo *info)
{
        return !is_local_tag(tag, info);
}

/* non-local tag not from current file */
static gboolean is_workspace_tag(TMTag *tag, CopyInfo *info)
{
        return  tag->file != info->file &&
                is_non_local_tag(tag, info);
}


static guint copy_tags(GPtrArray *dst, TMTag **src, guint src_len, GHashTable *name_table,
        gint num, gboolean (*predicate) (TMTag *, CopyInfo *), CopyInfo *info)
{
        guint i;

        g_return_val_if_fail(src && dst, 0);

        for (i = 0; i < src_len && num > 0; i++)
        {
                TMTag *tag = *src;
                if (predicate(tag, info) &&
                        tm_workspace_is_autocomplete_tag(tag, info->file, info->line, info->scope) &&
                        !g_hash_table_contains(name_table, tag->name))
                {
                        g_ptr_array_add(dst, tag);
                        g_hash_table_add(name_table, tag->name);
                        num--;
                }
                src++;
        }
}


static void fill_find_tags_array_prefix(GPtrArray *dst, const char *name,
        CopyInfo *info, guint max_num)
{
        TMTag **found;
        guint count;
        GHashTable *name_table;

        if (!dst || !name || !*name)
                return;

        name_table = g_hash_table_new_full(g_str_hash, g_str_equal, NULL, NULL);

        if (info->file)
        {
                found = tm_tags_find(info->file->tags_array, name, TRUE, &count);
                if (found)
                {
                        copy_tags(dst, found, count, name_table, max_num - dst->len, is_local_tag, info);
                        if (dst->len < max_num)
                                copy_tags(dst, found, count, name_table, max_num - dst->len, is_non_local_tag, info);
                }
        }
        if (dst->len < max_num)
        {
                found = tm_tags_find(theWorkspace->tags_array, name, TRUE, &count);
                if (found)
                        copy_tags(dst, found, count, name_table, max_num - dst->len, is_workspace_tag, info);
        }
        if (dst->len < max_num)
        {
                found = tm_tags_find(theWorkspace->global_tags, name, TRUE, &count);
                if (found)
                        copy_tags(dst, found, count, name_table, max_num - dst->len, is_any_tag, info);
        }

        g_hash_table_unref(name_table);
}


typedef struct
{
        TMSourceFile *file;
        gboolean sort_by_name;
} SortInfo;


static gint sort_found_tags(gconstpointer a, gconstpointer b, gpointer user_data)
{
        SortInfo *info = user_data;
        const TMTag *t1 = *((TMTag **) a);
        const TMTag *t2 = *((TMTag **) b);

        /* sort local vars first (with highest line number first), followed
         * by tags from current file, followed by workspace tags, followed by
         * global tags */
        if (t1->type & tm_tag_local_var_t && t2->type & tm_tag_local_var_t)
                return info->sort_by_name ? g_strcmp0(t1->name, t2->name) : t2->line - t1->line;
        else if (t1->type & tm_tag_local_var_t)
                return -1;
        else if (t2->type & tm_tag_local_var_t)
                return 1;
        else if (t1->file == info->file && t2->file != info->file)
                return -1;
        else if (t2->file == info->file && t1->file != info->file)
                return 1;
        else if (t1->file && !t2->file)
                return -1;
        else if (t2->file && !t1->file)
                return 1;
        return g_strcmp0(t1->name, t2->name);
}


/* Returns tags with the specified prefix sorted by name, ignoring local
 variables from other files/functions or after current line. If there are several
 tags with the same name, only one of them appears in the resulting array.
 @param prefix The prefix of the tag to find.
 @param lang Specifies the language(see the table in tm_parsers.h) of the tags to be found,
             -1 for all.
 @param max_num The maximum number of tags to return.
 @return Array of matching tags sorted by their name.
*/
GPtrArray *tm_workspace_find_prefix(const char *prefix,
        TMSourceFile *current_file,
        guint current_line,
        const gchar *current_scope,
        guint max_num)
{
        TMTagAttrType attrs[] = { tm_tag_attr_name_t, 0 };
        GPtrArray *tags = g_ptr_array_new();
        SortInfo sort_info;
        CopyInfo copy_info;

        copy_info.file = current_file;
        copy_info.line = current_line;
        copy_info.scope = current_scope;
        fill_find_tags_array_prefix(tags, prefix, &copy_info, max_num);

        /* sort based on how "close" the tag is to current line with local
         * variables first */
        sort_info.file = current_file;
        sort_info.sort_by_name = TRUE;
        g_ptr_array_sort_with_data(tags, sort_found_tags, &sort_info);

        return tags;
}


static gboolean replace_with_char(gchar *haystack, const gchar *needle, char replacement)
{
        gchar *pos = strstr(haystack, needle);
        if (pos)
        {
                while (*needle)
                {
                        *pos = replacement;
                        needle++;
                        pos++;
                }
                return TRUE;
        }
        return FALSE;
}


static gboolean replace_parens_with_char(gchar *haystack, gchar paren_begin, gchar paren_end, char replacement)
{
        gchar needle[2] = {paren_begin, '\0'};
        gchar *pos = strstr(haystack, needle);
        gint nesting = 0;

        if (pos)
        {
                while (*pos)
                {
                        if (*pos == paren_begin)
                                nesting++;
                        else if (*pos == paren_end)
                                nesting--;
                        *pos = replacement;
                        if (nesting == 0)
                                break;
                        pos++;
                }
                return TRUE;
        }
        return FALSE;
}


static gchar *strip_type(const gchar *scoped_name, TMParserType lang, gboolean remove_scope)
{
        if (scoped_name != NULL)
        {
                const gchar *sep = tm_parser_scope_separator(lang);
                gchar *name = g_strdup(scoped_name);
                gchar *scope_suffix;

                /* remove pointers, parens and keywords appearing in types */
                g_strdelimit(name, "*^&", ' ');
                while (replace_parens_with_char(name, '[', ']', ' ')) {}
                while (replace_parens_with_char(name, '<', '>', ' ')) {}
                while (replace_with_char(name, "const ", ' ')) {}
                while (replace_with_char(name, " const", ' ')) {}
                while (replace_with_char(name, " struct", ' ')) {}
                /* remove everything before final scope separator */
                if (remove_scope && (scope_suffix = g_strrstr(name, sep)))
                {
                        scope_suffix += strlen(sep);
                        scope_suffix = g_strdup(scope_suffix);
                        g_free(name);
                        name = scope_suffix;
                }
                g_strstrip(name);

                return name;
        }
        return NULL;
}


/* Gets all members of type_tag; search them inside the all array.
 * The namespace parameter determines whether we are performing the "namespace"
 * search (user has typed something like "A::" where A is a type) or "scope" search
 * (user has typed "a." where a is a global struct-like variable). With the
 * namespace search we return all direct descendants of any type while with the
 * scope search we return only those which can be invoked on a variable (member,
 * method, etc.). */
static GPtrArray *
find_scope_members_tags (const GPtrArray *all, TMTag *type_tag, gboolean namespace, guint depth)
{
        TMTagType member_types = tm_tag_max_t & ~(TM_TYPE_WITH_MEMBERS | tm_tag_typedef_t);
        GPtrArray *tags;
        gchar *scope;
        guint i;

        if (depth == 10)
                return NULL;  /* simple inheritence cycle avoidance */

        tags = g_ptr_array_new();

        if (namespace)
                member_types = tm_tag_max_t;

        if (type_tag->scope && *(type_tag->scope))
                scope = g_strconcat(type_tag->scope, tm_parser_scope_separator(type_tag->lang), type_tag->name, NULL);
        else
                scope = g_strdup(type_tag->name);

        for (i = 0; i < all->len; ++i)
        {
                TMTag *tag = TM_TAG (all->pdata[i]);

                if (tag && (tag->type & member_types) &&
                        tag->scope && tag->scope[0] != '\0' &&
                        tm_parser_langs_compatible(tag->lang, type_tag->lang) &&
                        strcmp(scope, tag->scope) == 0 &&
                        (!namespace || !tm_tag_is_anon(tag)))
                {
                        g_ptr_array_add (tags, tag);
                }
        }

        /* add members from parent classes */
        if (!namespace && (type_tag->type & (tm_tag_class_t | tm_tag_struct_t)) &&
                type_tag->inheritance && *type_tag->inheritance)
        {
                gchar *stripped = strip_type(type_tag->inheritance, type_tag->lang, FALSE);
                gchar **split_strv = g_strsplit(stripped, ",", -1);  /* parent classes */
                const gchar *parent;

                g_free(stripped);

                for (i = 0; parent = split_strv[i]; i++)
                {
                        GPtrArray *parent_tags;

                        stripped = strip_type(parent, type_tag->lang, TRUE);
                        parent_tags = tm_workspace_find(stripped, NULL, tm_tag_class_t | tm_tag_struct_t,
                                NULL, type_tag->lang);

                        if (parent_tags->len > 0)
                        {
                                TMTag *parent_tag = parent_tags->pdata[0];
                                GPtrArray *parent_members = find_scope_members_tags(
                                        parent_tag->file ? parent_tag->file->tags_array : all, parent_tag,
                                        FALSE, depth + 1);

                                if (parent_members)
                                {
                                        guint j;
                                        for (j = 0; j < parent_members->len; j++)
                                                g_ptr_array_add (tags, parent_members->pdata[j]);
                                        g_ptr_array_free(parent_members, TRUE);
                                }
                        }

                        g_ptr_array_free(parent_tags, TRUE);
                        g_free(stripped);
                }

                g_strfreev(split_strv);
        }

        g_free(scope);

        if (tags->len == 0)
        {
                g_ptr_array_free(tags, TRUE);
                return NULL;
        }

        if (depth == 0)
        {
                TMTagAttrType sort_attrs[] = {tm_tag_attr_name_t, 0};
                tm_tags_sort(tags, sort_attrs, TRUE, FALSE);
        }

        return tags;
}


/* Gets all members of the type with the given name; search them inside tags_array */
static GPtrArray *
find_scope_members (const GPtrArray *tags_array, const gchar *name, TMSourceFile *file,
        TMParserType lang, gboolean namespace)
{
        GPtrArray *res = NULL;
        gchar *type_name;
        guint i;

        g_return_val_if_fail(name && *name, NULL);

        type_name = g_strdup(name);

        /* Check if type_name is a type that can possibly contain members.
         * Try to resolve intermediate typedefs to get the real type name. Also
         * add scope information to the name if applicable.
         * The loop below loops only when resolving typedefs - avoid possibly infinite
         * loop when typedefs create a cycle by adding some limits. */
        for (i = 0; i < 5; i++)
        {
                guint j;
                GPtrArray *type_tags;
                TMTagType types = TM_TYPE_WITH_MEMBERS | tm_tag_typedef_t;
                TMTag *tag = NULL;

                if (!namespace)
                        types &= ~tm_tag_enum_t;

                type_tags = g_ptr_array_new();
                fill_find_tags_array(type_tags, tags_array, type_name, NULL, types, lang);

                for (j = 0; j < type_tags->len; j++)
                {
                        TMTag *test_tag = TM_TAG(type_tags->pdata[j]);

                        /* anonymous type defined in a different file than the variable -
                         * this isn't the type we are looking for */
                        if (tm_tag_is_anon(test_tag) && (file != test_tag->file || test_tag->file == NULL))
                                continue;

                        tag = test_tag;

                        /* prefer non-typedef tags because we can be sure they contain members */
                        if (test_tag->type != tm_tag_typedef_t)
                                break;
                }

                g_ptr_array_free(type_tags, TRUE);

                if (!tag) /* not a type that can contain members */
                        break;

                /* intermediate typedef - resolve to the real type */
                if (tag->type == tm_tag_typedef_t)
                {
                        if (tag->var_type && tag->var_type[0] != '\0')
                        {
                                g_free(type_name);
                                type_name = strip_type(tag->var_type, tag->lang, TRUE);
                                file = tag->file;
                                continue;
                        }
                        break;
                }
                else /* real type with members */
                {
                        /* use the same file as the composite type if file information available */
                        res = find_scope_members_tags(tag->file ? tag->file->tags_array : tags_array, tag, namespace, 0);
                        break;
                }
        }

        g_free(type_name);

        return res;
}


/* Checks whether a member tag is directly accessible from method */
static gboolean member_accessible(const GPtrArray *tags, const gchar *method_scope, TMTag *member_tag,
        TMParserType lang)
{
        const gchar *sep = tm_parser_scope_separator(lang);
        gboolean ret = FALSE;
        gchar **comps;
        guint len;

        /* method scope is in the form ...::class_name::method_name */
        comps = g_strsplit (method_scope, sep, 0);
        len = g_strv_length(comps);
        if (len > 1)
        {
                gchar *cls = comps[len - 2];

                if (*cls)
                {
                        /* find method's class members */
                        GPtrArray *cls_tags = find_scope_members(tags, cls, NULL, lang, FALSE);

                        if (cls_tags)
                        {
                                guint i;

                                /* check if one of the class members is member_tag */
                                for (i = 0; i < cls_tags->len; i++)
                                {
                                        TMTag *t = cls_tags->pdata[i];

                                        if (t == member_tag)
                                        {
                                                ret = TRUE;
                                                break;
                                        }
                                }
                                g_ptr_array_free(cls_tags, TRUE);
                        }
                }
        }

        g_strfreev(comps);
        return ret;
}


/* For an array of variable/type tags, find members inside the types */
static GPtrArray *
find_scope_members_all(const GPtrArray *tags, const GPtrArray *searched_array, TMParserType lang,
        gboolean member, const gchar *current_scope)
{
        GPtrArray *member_tags = NULL;
        guint i;

        /* there may be several variables/types with the same name - try each of them until
         * we find something */
        for (i = 0; i < tags->len && !member_tags; i++)
        {
                TMTag *tag = TM_TAG(tags->pdata[i]);
                TMTagType member_types = tm_tag_member_t | tm_tag_field_t | tm_tag_method_t;
                TMTagType types = TM_TYPE_WITH_MEMBERS | tm_tag_typedef_t;

                if (tag->type & types)  /* type: namespace search */
                {
                        if (tag->type & tm_tag_typedef_t)
                                member_tags = find_scope_members(searched_array, tag->name, tag->file, lang, TRUE);
                        else
                                member_tags = find_scope_members_tags(tag->file ? tag->file->tags_array : searched_array,
                                        tag, TRUE, 0);
                }
                else if (tag->var_type)  /* variable: scope search */
                {
                        /* The question now is whether we should use member tags (such as
                         * tm_tag_field_t, tm_tag_member_t) or not. We want them if member==TRUE
                         * (which means user has typed something like foo.bar.) or if we are
                         * inside a method where foo is a class member, we want scope completion
                         * for foo. */
                        if (!(tag->type & member_types) || member ||
                                member_accessible(searched_array, current_scope, tag, lang))
                        {
                                gchar *tag_type = strip_type(tag->var_type, tag->lang, TRUE);

                                member_tags = find_scope_members(searched_array, tag_type, tag->file, lang, FALSE);
                                g_free(tag_type);
                        }
                }
        }

        return member_tags;
}


static GPtrArray *find_namespace_members_all(const GPtrArray *tags, const GPtrArray *searched_array)
{
        GPtrArray *member_tags = NULL;
        guint i;

        for (i = 0; i < tags->len && !member_tags; i++)
        {
                TMTag *tag = TM_TAG(tags->pdata[i]);

                member_tags = find_scope_members_tags(searched_array, tag, TRUE, 0);
        }

        return member_tags;
}


/* Returns all member tags of a struct/union/class if the provided name is a variable
 of such a type or the name of the type.
 @param source_file TMSourceFile of the edited source file
 @param name Name of the variable/type whose members are searched
 @param function TRUE if the name is a name of a function
 @param member TRUE if invoked on class/struct member (e.g. after the last dot in foo.bar.)
 @param current_scope The current scope in the editor
 @param current_line The current line in the editor
 @param search_namespace Whether to search the contents of namespace (e.g. after MyNamespace::)
 @return A GPtrArray of TMTag pointers to struct/union/class members or NULL when not found */
GPtrArray *
tm_workspace_find_scope_members (TMSourceFile *source_file, const char *name,
        gboolean function, gboolean member, const gchar *current_scope, guint current_line,
        gboolean search_namespace)
{
        TMParserType lang = source_file ? source_file->lang : TM_PARSER_NONE;
        GPtrArray *tags, *member_tags = NULL;
        TMTagType function_types = tm_tag_function_t | tm_tag_method_t |
                tm_tag_macro_with_arg_t | tm_tag_prototype_t;
        TMTagType tag_type = tm_tag_max_t &
                ~(function_types | tm_tag_enumerator_t | tm_tag_namespace_t | tm_tag_package_t);
        TMTagAttrType sort_attr[] = {tm_tag_attr_name_t, 0};

        if (search_namespace)
        {
                tags = tm_workspace_find(name, NULL, tm_tag_namespace_t, NULL, lang);

                member_tags = find_namespace_members_all(tags, theWorkspace->tags_array);
                if (!member_tags)
                        member_tags = find_namespace_members_all(tags, theWorkspace->global_tags);

                g_ptr_array_free(tags, TRUE);
        }

        if (!member_tags)
        {
                SortInfo info;
                guint i;

                if (function)
                        tag_type = function_types;

                /* tags corresponding to the variable/type name */
                tags = tm_workspace_find(name, NULL, tag_type, NULL, lang);

                /* remove invalid local tags and sort tags so "nearest" tags are first */
                for (i = 0; i < tags->len; i++)
                {
                        TMTag *tag = tags->pdata[i];
                        if (!tm_workspace_is_autocomplete_tag(tag, source_file, current_line, current_scope))
                                tags->pdata[i] = NULL;
                }
                tm_tags_prune(tags);

                info.file = source_file;
                info.sort_by_name = FALSE;
                g_ptr_array_sort_with_data(tags, sort_found_tags, &info);

                /* Start searching inside the source file, continue with workspace tags and
                 * end with global tags. This way we find the "closest" tag to the current
                 * file in case there are more of them. */
                if (source_file)
                        member_tags = find_scope_members_all(tags, source_file->tags_array,
                                                                                                 lang, member, current_scope);
                if (!member_tags)
                        member_tags = find_scope_members_all(tags, theWorkspace->tags_array, lang,
                                                                                                 member, current_scope);
                if (!member_tags)
                        member_tags = find_scope_members_all(tags, theWorkspace->global_tags, lang,
                                                                                                 member, current_scope);

                g_ptr_array_free(tags, TRUE);
        }

        if (member_tags)
                tm_tags_dedup(member_tags, sort_attr, FALSE);

        return member_tags;
}


#ifdef TM_DEBUG

/* Dumps the workspace tree - useful for debugging */
void tm_workspace_dump(void)
{
        guint i;

#ifdef TM_DEBUG
        g_message("Dumping TagManager workspace tree..");
#endif
        for (i=0; i < theWorkspace->source_files->len; ++i)
        {
                TMSourceFile *source_file = theWorkspace->source_files->pdata[i];
                fprintf(stderr, "%s", source_file->file_name);
        }
}
#endif /* TM_DEBUG */