qmake/option.h

   1 /****************************************************************************
   2 **
   3 ** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies).
   4 ** Contact: http://www.qt-project.org/
   5 **
   6 ** This file is part of the qmake application of the Qt Toolkit.
   7 **
   8 ** $QT_BEGIN_LICENSE:LGPL$
   9 ** GNU Lesser General Public License Usage
  10 ** This file may be used under the terms of the GNU Lesser General Public
  11 ** License version 2.1 as published by the Free Software Foundation and
  12 ** appearing in the file LICENSE.LGPL included in the packaging of this
  13 ** file. Please review the following information to ensure the GNU Lesser
  14 ** General Public License version 2.1 requirements will be met:
  15 ** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
  16 **
  17 ** In addition, as a special exception, Nokia gives you certain additional
  18 ** rights. These rights are described in the Nokia Qt LGPL Exception
  19 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
  20 **
  21 ** GNU General Public License Usage
  22 ** Alternatively, this file may be used under the terms of the GNU General
  23 ** Public License version 3.0 as published by the Free Software Foundation
  24 ** and appearing in the file LICENSE.GPL included in the packaging of this
  25 ** file. Please review the following information to ensure the GNU General
  26 ** Public License version 3.0 requirements will be met:
  27 ** http://www.gnu.org/copyleft/gpl.html.
  28 **
  29 ** Other Usage
  30 ** Alternatively, this file may be used in accordance with the terms and
  31 ** conditions contained in a signed written agreement between you and Nokia.
  32 **
  33 **
  34 **
  35 **
  36 **
  37 **
  38 ** $QT_END_LICENSE$
  39 **
  40 ****************************************************************************/
  41
  42 #ifndef OPTION_H
  43 #define OPTION_H
  44
  45 #include "project.h"
  46 #include <qstring.h>
  47 #include <qstringlist.h>
  48 #include <qfile.h>
  49
  50 QT_BEGIN_NAMESPACE
  51
  52 #define QMAKE_VERSION_MAJOR 2
  53 #define QMAKE_VERSION_MINOR 1
  54 #define QMAKE_VERSION_PATCH 0
  55 const char *qmake_version();
  56
  57 QString qmake_getpwd();
  58 bool qmake_setpwd(const QString &p);
  59
  60 #define debug_msg if(Option::debug_level) debug_msg_internal
  61 void debug_msg_internal(int level, const char *fmt, ...); //don't call directly, use debug_msg
  62 enum QMakeWarn {
  63     WarnNone    = 0x00,
  64     WarnParser  = 0x01,
  65     WarnLogic   = 0x02,
  66     WarnDeprecated = 0x04,
  67     WarnAll     = 0xFF
  68 };
  69 void warn_msg(QMakeWarn t, const char *fmt, ...);
  70
  71 struct Option
  72 {
  73     //simply global convenience
  74     static QString js_ext;
  75     static QString libtool_ext;
  76     static QString pkgcfg_ext;
  77     static QString prf_ext;
  78     static QString prl_ext;
  79     static QString ui_ext;
  80     static QStringList h_ext;
  81     static QStringList cpp_ext;
  82     static QStringList c_ext;
  83     static QString h_moc_ext;
  84     static QString cpp_moc_ext;
  85     static QString obj_ext;
  86     static QString lex_ext;
  87     static QString yacc_ext;
  88     static QString h_moc_mod;
  89     static QString cpp_moc_mod;
  90     static QString lex_mod;
  91     static QString yacc_mod;
  92     static QString dir_sep;
  93     static QString dirlist_sep;
  94     static QString sysenv_mod;
  95     static QString pro_ext;
  96     static QString mmp_ext;
  97     static QString res_ext;
  98     static char field_sep;
  99     static const char *application_argv0;
 100
 101     enum CmdLineFlags {
 102         QMAKE_CMDLINE_SUCCESS       = 0x00,
 103         QMAKE_CMDLINE_SHOW_USAGE    = 0x01,
 104         QMAKE_CMDLINE_BAIL          = 0x02,
 105         QMAKE_CMDLINE_ERROR         = 0x04
 106     };
 107
 108     //both of these must be called..
 109     static int init(int argc=0, char **argv=0); //parse cmdline
 110     static void applyHostMode();
 111     static bool prepareProject();
 112     static bool postProcessProject(QMakeProject *);
 113
 114     enum StringFixFlags {
 115         FixNone                 = 0x00,
 116         FixEnvVars              = 0x01,
 117         FixPathCanonicalize     = 0x02,
 118         FixPathToLocalSeparators  = 0x04,
 119         FixPathToTargetSeparators = 0x08,
 120         FixPathToNormalSeparators = 0x10
 121     };
 122     static QString fixString(QString string, uchar flags);
 123
 124     //and convenience functions
 125     inline static QString fixPathToLocalOS(const QString &in, bool fix_env=true, bool canonical=true)
 126     {
 127         uchar flags = FixPathToLocalSeparators;
 128         if(fix_env)
 129             flags |= FixEnvVars;
 130         if(canonical)
 131             flags |= FixPathCanonicalize;
 132         return fixString(in, flags);
 133     }
 134     inline static QString fixPathToTargetOS(const QString &in, bool fix_env=true, bool canonical=true)
 135     {
 136         uchar flags = FixPathToTargetSeparators;
 137         if(fix_env)
 138             flags |= FixEnvVars;
 139         if(canonical)
 140             flags |= FixPathCanonicalize;
 141         return fixString(in, flags);
 142     }
 143     inline static QString normalizePath(const QString &in, bool fix_env=true, bool canonical=true)
 144     {
 145         uchar flags = FixPathToNormalSeparators;
 146         if (fix_env)
 147             flags |= FixEnvVars;
 148         if (canonical)
 149             flags |= FixPathCanonicalize;
 150         return fixString(in, flags);
 151     }
 152
 153     inline static bool hasFileExtension(const QString &str, const QStringList &extensions)
 154     {
 155         foreach (const QString &ext, extensions)
 156             if (str.endsWith(ext))
 157                 return true;
 158         return false;
 159     }
 160
 161     //global qmake mode, can only be in one mode per invocation!
 162     enum QMAKE_MODE { QMAKE_GENERATE_NOTHING,
 163                       QMAKE_GENERATE_PROJECT, QMAKE_GENERATE_MAKEFILE, QMAKE_GENERATE_PRL,
 164                       QMAKE_SET_PROPERTY, QMAKE_UNSET_PROPERTY, QMAKE_QUERY_PROPERTY };
 165     static QMAKE_MODE qmake_mode;
 166
 167     //all modes
 168     static QString qmake_abslocation;
 169     static QFile output;
 170     static QString output_dir;
 171     static int debug_level;
 172     static int warn_level;
 173     enum QMAKE_RECURSIVE { QMAKE_RECURSIVE_DEFAULT, QMAKE_RECURSIVE_YES, QMAKE_RECURSIVE_NO };
 174     static QMAKE_RECURSIVE recursive;
 175     static QStringList before_user_vars, after_user_vars, user_configs, after_user_configs;
 176     enum HOST_MODE { HOST_UNKNOWN_MODE, HOST_UNIX_MODE, HOST_WIN_MODE, HOST_MACX_MODE };
 177     static HOST_MODE host_mode;
 178     enum TARG_MODE { TARG_UNKNOWN_MODE, TARG_UNIX_MODE, TARG_WIN_MODE, TARG_MACX_MODE,
 179                      TARG_INTEGRITY_MODE };
 180     static TARG_MODE target_mode;
 181     static bool target_mode_overridden;
 182     static QString user_template, user_template_prefix;
 183     static QStringList shellPath;
 184
 185     //QMAKE_*_PROPERTY options
 186     struct prop {
 187         static QStringList properties;
 188     };
 189
 190     //QMAKE_GENERATE_PROJECT options
 191     struct projfile {
 192         static bool do_pwd;
 193         static QStringList project_dirs;
 194     };
 195
 196     //QMAKE_GENERATE_MAKEFILE options
 197     struct mkfile {
 198         static QString qmakespec;
 199         static bool do_cache;
 200         static bool do_deps;
 201         static bool do_mocs;
 202         static bool do_dep_heuristics;
 203         static bool do_preprocess;
 204         static bool do_stub_makefile;
 205         static QString project_build_root;
 206         static QString cachefile;
 207         static int cachefile_depth;
 208         static QStringList project_files;
 209         static QString qmakespec_commandline;
 210     };
 211
 212 private:
 213     static int parseCommandLine(int, char **, int=0);
 214 };
 215
 216 inline QString fixEnvVariables(const QString &x) { return Option::fixString(x, Option::FixEnvVars); }
 217 inline QStringList splitPathList(const QString &paths) { return paths.split(Option::dirlist_sep); }
 218
 219 // this is a stripped down version of the one found in QtCore
 220 class QLibraryInfo
 221 {
 222 public:
 223     enum LibraryLocation
 224     {
 225         PrefixPath,
 226         DocumentationPath,
 227         HeadersPath,
 228         LibrariesPath,
 229         BinariesPath,
 230         PluginsPath,
 231         DataPath,
 232         TranslationsPath,
 233         SettingsPath,
 234         ExamplesPath,
 235         ImportsPath,
 236         TestsPath
 237     };
 238     static QString location(LibraryLocation);
 239 };
 240
 241 QT_END_NAMESPACE
 242
 243 #endif // OPTION_H