src/filetypes.h

   1 /*
   2  *      filetypes.h - this file is part of Geany, a fast and lightweight IDE
   3  *
   4  *      Copyright 2005-2012 Enrico Tröger <enrico(dot)troeger(at)uvena(dot)de>
   5  *      Copyright 2006-2012 Nick Treleaven <nick(dot)treleaven(at)btinternet(dot)com>
   6  *
   7  *      This program is free software; you can redistribute it and/or modify
   8  *      it under the terms of the GNU General Public License as published by
   9  *      the Free Software Foundation; either version 2 of the License, or
  10  *      (at your option) any later version.
  11  *
  12  *      This program is distributed in the hope that it will be useful,
  13  *      but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  *      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15  *      GNU General Public License for more details.
  16  *
  17  *      You should have received a copy of the GNU General Public License along
  18  *      with this program; if not, write to the Free Software Foundation, Inc.,
  19  *      51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  20  */
  21
  22
  23 #ifndef GEANY_FILETYPES_H
  24 #define GEANY_FILETYPES_H 1
  25
  26 G_BEGIN_DECLS
  27
  28 #include "Scintilla.h"
  29 #include "ScintillaWidget.h"
  30
  31 #ifdef GEANY_PRIVATE
  32 #include "build.h"
  33 #endif
  34
  35
  36 /* Do not change the order, only append. */
  37 typedef enum
  38 {
  39         GEANY_FILETYPES_NONE = 0,       /* first filetype is always None & must be 0 */
  40
  41         GEANY_FILETYPES_PHP,
  42         GEANY_FILETYPES_BASIC,  /* FreeBasic */
  43         GEANY_FILETYPES_MATLAB,
  44         GEANY_FILETYPES_RUBY,
  45         GEANY_FILETYPES_LUA,
  46         GEANY_FILETYPES_FERITE,
  47         GEANY_FILETYPES_YAML,
  48         GEANY_FILETYPES_C,
  49         GEANY_FILETYPES_NSIS,
  50         GEANY_FILETYPES_GLSL,
  51         GEANY_FILETYPES_PO,
  52         GEANY_FILETYPES_MAKE,
  53         GEANY_FILETYPES_TCL,
  54         GEANY_FILETYPES_XML,
  55         GEANY_FILETYPES_CSS,
  56         GEANY_FILETYPES_REST,
  57         GEANY_FILETYPES_HASKELL,
  58         GEANY_FILETYPES_JAVA,
  59         GEANY_FILETYPES_CAML,
  60         GEANY_FILETYPES_AS,
  61         GEANY_FILETYPES_R,
  62         GEANY_FILETYPES_DIFF,
  63         GEANY_FILETYPES_HTML,
  64         GEANY_FILETYPES_PYTHON,
  65         GEANY_FILETYPES_CS,
  66         GEANY_FILETYPES_PERL,
  67         GEANY_FILETYPES_VALA,
  68         GEANY_FILETYPES_PASCAL,
  69         GEANY_FILETYPES_LATEX,
  70         GEANY_FILETYPES_ASM,
  71         GEANY_FILETYPES_CONF,
  72         GEANY_FILETYPES_HAXE,
  73         GEANY_FILETYPES_CPP,
  74         GEANY_FILETYPES_SH,
  75         GEANY_FILETYPES_FORTRAN,
  76         GEANY_FILETYPES_SQL,
  77         GEANY_FILETYPES_F77,
  78         GEANY_FILETYPES_DOCBOOK,
  79         GEANY_FILETYPES_D,
  80         GEANY_FILETYPES_JS,
  81         GEANY_FILETYPES_VHDL,
  82         GEANY_FILETYPES_ADA,
  83         GEANY_FILETYPES_CMAKE,
  84         GEANY_FILETYPES_MARKDOWN,
  85         GEANY_FILETYPES_TXT2TAGS,
  86         GEANY_FILETYPES_ABC,
  87         GEANY_FILETYPES_VERILOG,
  88         GEANY_FILETYPES_FORTH,
  89         GEANY_FILETYPES_LISP,
  90         GEANY_FILETYPES_ERLANG,
  91         GEANY_FILETYPES_COBOL,
  92         GEANY_FILETYPES_OBJECTIVEC,
  93         GEANY_FILETYPES_ASCIIDOC,
  94         GEANY_FILETYPES_ABAQUS,
  95         GEANY_FILETYPES_BATCH,
  96         GEANY_FILETYPES_POWERSHELL,
  97         GEANY_FILETYPES_RUST,
  98         /* ^ append items here */
  99         GEANY_MAX_BUILT_IN_FILETYPES    /* Don't use this, use filetypes_array->len instead */
 100 }
 101 filetype_id;
 102
 103 typedef enum
 104 {
 105         GEANY_FILETYPE_GROUP_NONE,
 106         GEANY_FILETYPE_GROUP_COMPILED,
 107         GEANY_FILETYPE_GROUP_SCRIPT,
 108         GEANY_FILETYPE_GROUP_MARKUP,
 109         GEANY_FILETYPE_GROUP_MISC,
 110         GEANY_FILETYPE_GROUP_COUNT
 111 }
 112 GeanyFiletypeGroupID;
 113
 114
 115 /* Safe wrapper to get the id field of a possibly NULL filetype pointer.
 116  * This shouldn't be necessary since GeanyDocument::file_type is always non-NULL. */
 117 #define FILETYPE_ID(filetype_ptr) \
 118         (((filetype_ptr) != NULL) ? (filetype_ptr)->id : GEANY_FILETYPES_NONE)
 119
 120 /** Represents a filetype. */
 121 struct GeanyFiletype
 122 {
 123         filetype_id               id;                           /**< Index in @c filetypes_array. */
 124         /** Represents the langType of tagmanager (see the table
 125          * in tagmanager/parsers.h), -1 represents all, -2 none. */
 126         langType                  lang;
 127         /** Untranslated short name, such as "C", "None".
 128          * Must not be translated as it's used for hash table lookups - use
 129          * filetypes_get_display_name() instead. */
 130         gchar                    *name;
 131         /** Shown in the file open dialog, such as "C source file". */
 132         gchar                    *title;
 133         gchar                    *extension;            /**< Default file extension for new files, or @c NULL. */
 134         gchar                   **pattern;                      /**< Array of filename-matching wildcard strings. */
 135         gchar                    *context_action_cmd;
 136         gchar                    *comment_open;
 137         gchar                    *comment_close;
 138         gboolean                  comment_use_indent;
 139         GeanyFiletypeGroupID group;
 140         gchar                    *error_regex_string;
 141         GeanyFiletype    *lexer_filetype;
 142         gchar                    *mime_type;
 143         GdkPixbuf                *icon;
 144         gchar                    *comment_single; /* single-line comment */
 145         /* filetype indent settings, -1 if not set */
 146         gint                      indent_type;
 147         gint                      indent_width;
 148
 149         struct GeanyFiletypePrivate     *priv;  /* must be last, append fields before this item */
 150 #ifdef GEANY_PRIVATE
 151         /* Do not use following fields in plugins */
 152         /* TODO: move these fields into filetypesprivate.h */
 153         GeanyBuildCommand *filecmds;
 154         GeanyBuildCommand *ftdefcmds;
 155         GeanyBuildCommand *execcmds;
 156         GeanyBuildCommand *homefilecmds;
 157         GeanyBuildCommand *homeexeccmds;
 158         GeanyBuildCommand *projfilecmds;
 159         GeanyBuildCommand *projexeccmds;
 160         gint                     project_list_entry;
 161         gchar                    *projerror_regex_string;
 162         gchar                    *homeerror_regex_string;
 163 #endif
 164 };
 165
 166 extern GPtrArray *filetypes_array;
 167
 168 /** Wraps filetypes_array so it can be used with C array syntax.
 169  * Example: filetypes[GEANY_FILETYPES_C]->name = ...;
 170  * @see filetypes_index(). */
 171 #define filetypes       ((GeanyFiletype **)GEANY(filetypes_array)->pdata)
 172
 173 extern GSList *filetypes_by_title;
 174
 175
 176 GeanyFiletype *filetypes_lookup_by_name(const gchar *name);
 177
 178 GeanyFiletype *filetypes_find(GCompareFunc predicate, gpointer user_data);
 179
 180
 181 void filetypes_init(void);
 182
 183 void filetypes_init_types(void);
 184
 185 void filetypes_reload_extensions(void);
 186
 187 void filetypes_reload(void);
 188
 189
 190 GeanyFiletype *filetypes_index(gint idx);
 191
 192 const GSList *filetypes_get_sorted_by_name(void);
 193
 194 const gchar *filetypes_get_display_name(GeanyFiletype *ft);
 195
 196 GeanyFiletype *filetypes_detect_from_document(GeanyDocument *doc);
 197
 198 GeanyFiletype *filetypes_detect_from_extension(const gchar *utf8_filename);
 199
 200 GeanyFiletype *filetypes_detect_from_file(const gchar *utf8_filename);
 201
 202 void filetypes_free_types(void);
 203
 204 void filetypes_load_config(guint ft_id, gboolean reload);
 205
 206 void filetypes_save_commands(GeanyFiletype *ft);
 207
 208 void filetypes_select_radio_item(const GeanyFiletype *ft);
 209
 210 GtkFileFilter *filetypes_create_file_filter(const GeanyFiletype *ft);
 211
 212 GtkFileFilter *filetypes_create_file_filter_all_source(void);
 213
 214 gboolean filetype_has_tags(GeanyFiletype *ft);
 215
 216 gboolean filetypes_parse_error_message(GeanyFiletype *ft, const gchar *message,
 217                 gchar **filename, gint *line);
 218
 219 gboolean filetype_get_comment_open_close(const GeanyFiletype *ft, gboolean single_first,
 220                 const gchar **co, const gchar **cc);
 221
 222 G_END_DECLS
 223
 224 #endif