CMake/Source/cmMakefile.h

497 lines
13 KiB
C
Raw Normal View History

/*=========================================================================
Program: Insight Segmentation & Registration Toolkit
Module: $RCSfile$
Language: C++
Date: $Date$
Version: $Revision$
Copyright (c) 2000 National Library of Medicine
All rights reserved.
See COPYRIGHT.txt for copyright details.
=========================================================================*/
#ifndef cmMakefile_h
#define cmMakefile_h
2001-01-11 22:47:38 +03:00
#include "cmStandardIncludes.h"
2001-04-25 00:49:12 +04:00
#include "cmSourceFile.h"
#include "cmSystemTools.h"
#include "cmSourceGroup.h"
#include "cmTarget.h"
2001-04-20 01:39:03 +04:00
class cmFunctionBlocker;
2001-01-18 19:20:24 +03:00
class cmCommand;
class cmMakefileGenerator;
2001-01-11 22:47:38 +03:00
/** \class cmMakefile
* \brief Process the input CMakeLists.txt file.
*
* Process and store into memory the input CMakeLists.txt file.
2001-01-18 19:20:24 +03:00
* Each CMakeLists.txt file is parsed and the commands found there
2001-01-11 22:47:38 +03:00
* are added into the build process.
*/
class cmMakefile
{
public:
2001-01-11 22:47:38 +03:00
/**
* Construct an empty makefile.
*/
cmMakefile();
2001-01-11 22:47:38 +03:00
/**
* Destructor.
*/
~cmMakefile();
2001-01-11 22:47:38 +03:00
/**
* Read and parse a CMakeLists.txt file.
*/
2001-02-15 21:30:13 +03:00
bool ReadListFile(const char* listfile);
2001-01-11 22:47:38 +03:00
/**
* Add a wrapper generator.
*/
2001-01-18 19:20:24 +03:00
void AddCommand(cmCommand* );
2001-01-11 22:47:38 +03:00
2001-04-20 01:39:03 +04:00
/**
* Add a function blocker to this makefile
*/
void AddFunctionBlocker(cmFunctionBlocker *fb)
{ m_FunctionBlockers.insert(fb);}
void RemoveFunctionBlocker(cmFunctionBlocker *fb)
{ m_FunctionBlockers.erase(fb);}
void RemoveFunctionBlocker(const char *name, const std::vector<std::string> &args);
2001-01-11 22:47:38 +03:00
/**
* Specify the makefile generator. This is platform/compiler
* dependent, although the interface is through a generic
* superclass.
*/
void SetMakefileGenerator(cmMakefileGenerator*);
2001-01-11 22:47:38 +03:00
/**
* Produce the output makefile.
*/
void GenerateMakefile();
2001-01-11 22:47:38 +03:00
/**
* Print the object state to std::cout.
*/
2001-04-20 01:39:03 +04:00
void Print() const;
2001-01-11 22:47:38 +03:00
/**
2001-01-18 19:20:24 +03:00
* Add a custom command to the build.
2001-01-11 22:47:38 +03:00
*/
2001-01-18 19:20:24 +03:00
void AddCustomCommand(const char* source,
const char* command,
const std::vector<std::string>& depends,
const std::vector<std::string>& outputs,
const char *target);
void AddCustomCommand(const char* source,
const char* command,
const std::vector<std::string>& depends,
const char* output,
const char* target);
2001-01-11 22:47:38 +03:00
/**
* Add a define flag to the build.
*/
void AddDefineFlag(const char* definition);
2001-01-11 22:47:38 +03:00
/**
* Add an executable to the build.
*/
void AddExecutable(const char *exename, const std::vector<std::string> &srcs);
2001-01-11 22:47:38 +03:00
/**
2001-04-12 23:34:09 +04:00
* Add a utility on which this project depends. A utility is an executable
* name as would be specified to the ADD_EXECUTABLE or UTILITY_SOURCE
* commands. It is not a full path nor does it have an extension.
*/
void AddUtility(const char*);
/**
* Add a directory in which a utility may be built.
*/
void AddUtilityDirectory(const char*);
2001-01-11 22:47:38 +03:00
/**
* Add a link library to the build.
*/
void AddLinkLibrary(const char*);
2001-01-11 22:47:38 +03:00
/**
* Add a link directory to the build.
*/
void AddLinkDirectory(const char*);
2001-01-11 22:47:38 +03:00
/**
* Add a subdirectory to the build.
*/
void AddSubDirectory(const char*);
2001-01-11 22:47:38 +03:00
/**
* Add an include directory to the build.
*/
void AddIncludeDirectory(const char*);
2001-01-11 22:47:38 +03:00
/**
* Add a variable definition to the build. This variable
* can be used in CMake to refer to lists, directories, etc.
*/
void AddDefinition(const char* name, const char* value);
2001-01-11 22:47:38 +03:00
2001-04-24 20:40:37 +04:00
/**
* Add bool variable definition to the build.
*/
void AddDefinition(const char* name, bool);
2001-01-11 22:47:38 +03:00
/**
* Specify the name of the project for this build.
*/
void SetProjectName(const char*);
2001-01-11 22:47:38 +03:00
/**
* Get the name of the project for this build.
*/
const char* GetProjectName()
{
return m_ProjectName.c_str();
}
/**
* Set the name of the library.
*/
void AddLibrary(const char *libname, const std::vector<std::string> &srcs);
2001-01-11 22:47:38 +03:00
/**
* Add a class/source file to the build.
*/
2001-04-25 00:49:12 +04:00
void AddSource(cmSourceFile& ,const char *srcListName);
2001-01-11 22:47:38 +03:00
/**
* Add a source group for consideration when adding a new source.
*/
void AddSourceGroup(const char* name, const char* regex);
2001-01-11 22:47:38 +03:00
/**
* Add an auxiliary directory to the build.
*/
void AddExtraDirectory(const char* dir);
2001-02-15 21:30:13 +03:00
/**
* Add an auxiliary directory to the build.
*/
void MakeStartDirectoriesCurrent()
{
m_cmCurrentDirectory = m_cmStartDirectory;
m_CurrentOutputDirectory = m_StartOutputDirectory;
}
//@{
2001-01-11 22:47:38 +03:00
/**
2001-02-15 21:30:13 +03:00
* Set/Get the home directory (or output directory) in the project. The
* home directory is the top directory of the project. It is where
* CMakeSetup or configure was run. Remember that CMake processes
* CMakeLists files by recursing up the tree starting at the StartDirectory
* and going up until it reaches the HomeDirectory.
2001-01-11 22:47:38 +03:00
*/
void SetHomeDirectory(const char* dir)
{
2001-01-11 22:47:38 +03:00
m_cmHomeDirectory = dir;
cmSystemTools::ConvertToUnixSlashes(m_cmHomeDirectory);
this->AddDefinition("CMAKE_SOURCE_DIR", this->GetHomeDirectory());
}
2001-04-25 00:49:12 +04:00
const char* GetHomeDirectory() const
{
2001-01-11 22:47:38 +03:00
return m_cmHomeDirectory.c_str();
}
2001-02-15 21:30:13 +03:00
void SetHomeOutputDirectory(const char* lib)
{
2001-02-15 21:30:13 +03:00
m_HomeOutputDirectory = lib;
cmSystemTools::ConvertToUnixSlashes(m_HomeOutputDirectory);
this->AddDefinition("CMAKE_BINARY_DIR", this->GetHomeOutputDirectory());
}
2001-04-25 00:49:12 +04:00
const char* GetHomeOutputDirectory() const
{
2001-02-15 21:30:13 +03:00
return m_HomeOutputDirectory.c_str();
}
2001-02-15 21:30:13 +03:00
//@}
//@{
2001-01-11 22:47:38 +03:00
/**
2001-02-15 21:30:13 +03:00
* Set/Get the start directory (or output directory). The start directory
* is the directory of the CMakeLists.txt file that started the current
* round of processing. Remember that CMake processes CMakeLists files by
* recursing up the tree starting at the StartDirectory and going up until
* it reaches the HomeDirectory.
2001-01-11 22:47:38 +03:00
*/
2001-02-15 21:30:13 +03:00
void SetStartDirectory(const char* dir)
{
2001-02-15 21:30:13 +03:00
m_cmStartDirectory = dir;
cmSystemTools::ConvertToUnixSlashes(m_cmStartDirectory);
}
2001-04-25 00:49:12 +04:00
const char* GetStartDirectory() const
{
2001-02-15 21:30:13 +03:00
return m_cmStartDirectory.c_str();
}
2001-02-15 21:30:13 +03:00
void SetStartOutputDirectory(const char* lib)
{
m_StartOutputDirectory = lib;
cmSystemTools::ConvertToUnixSlashes(m_StartOutputDirectory);
}
2001-04-25 00:49:12 +04:00
const char* GetStartOutputDirectory() const
{
2001-02-15 21:30:13 +03:00
return m_StartOutputDirectory.c_str();
}
2001-02-15 21:30:13 +03:00
//@}
2001-01-11 22:47:38 +03:00
2001-02-15 21:30:13 +03:00
//@{
2001-01-11 22:47:38 +03:00
/**
2001-02-15 21:30:13 +03:00
* Set/Get the current directory (or output directory) in the project. The
* current directory is the directory of the CMakeLists.txt file that is
* currently being processed. Remember that CMake processes CMakeLists
* files by recursing up the tree starting at the StartDirectory and going
* up until it reaches the HomeDirectory.
2001-01-11 22:47:38 +03:00
*/
2001-02-15 21:30:13 +03:00
void SetCurrentDirectory(const char* dir)
{
2001-02-15 21:30:13 +03:00
m_cmCurrentDirectory = dir;
cmSystemTools::ConvertToUnixSlashes(m_cmCurrentDirectory);
}
2001-04-25 00:49:12 +04:00
const char* GetCurrentDirectory() const
2001-02-15 21:30:13 +03:00
{
return m_cmCurrentDirectory.c_str();
}
void SetCurrentOutputDirectory(const char* lib)
{
m_CurrentOutputDirectory = lib;
cmSystemTools::ConvertToUnixSlashes(m_CurrentOutputDirectory);
}
2001-04-25 00:49:12 +04:00
const char* GetCurrentOutputDirectory() const
2001-02-15 21:30:13 +03:00
{
return m_CurrentOutputDirectory.c_str();
}
//@}
/**
* Set a regular expression that include files must match
* in order to be considered as part of the depend information.
*/
void SetIncludeRegularExpression(const char* regex)
{
m_IncludeFileRegularExpression = regex;
}
2001-01-11 22:47:38 +03:00
/**
* Get the list of targets
2001-01-11 22:47:38 +03:00
*/
2001-04-16 18:01:13 +04:00
cmTargets &GetTargets() { return m_Targets; }
2001-01-11 22:47:38 +03:00
/**
* Get a list of the build subdirectories.
*/
const std::vector<std::string>& GetSubDirectories()
{
2001-01-11 22:47:38 +03:00
return m_SubDirectories;
}
2001-01-11 22:47:38 +03:00
/**
* Get a list of include directories in the build.
*/
std::vector<std::string>& GetIncludeDirectories()
{
2001-01-11 22:47:38 +03:00
return m_IncludeDirectories;
}
2001-01-11 22:47:38 +03:00
/**
* Get a list of link directories in the build.
*/
std::vector<std::string>& GetLinkDirectories()
{
2001-01-11 22:47:38 +03:00
return m_LinkDirectories;
}
/**
* Get a list of utilities on which the project depends.
*/
std::vector<std::string>& GetUtilities()
{
return m_Utilities;
}
/**
* Get a list of directories that may contain the Utilities.
*/
std::vector<std::string>& GetUtilityDirectories()
{
return m_UtilityDirectories;
}
2001-01-11 22:47:38 +03:00
/**
* Get a list of link libraries in the build.
*/
std::vector<std::string>& GetLinkLibraries()
{
2001-01-11 22:47:38 +03:00
return m_LinkLibraries;
}
2001-01-11 22:47:38 +03:00
/**
* Get a list of Win32 link libraries in the build.
*/
std::vector<std::string>& GetLinkLibrariesWin32()
{
2001-01-11 22:47:38 +03:00
return m_LinkLibrariesWin32;
}
2001-01-11 22:47:38 +03:00
/**
* Get a list of Unix link libraries in the build.
*/
std::vector<std::string>& GetLinkLibrariesUnix()
{
2001-01-11 22:47:38 +03:00
return m_LinkLibrariesUnix;
}
2001-01-11 22:47:38 +03:00
/**
* Return a list of source files in this makefile.
*/
2001-04-25 00:49:12 +04:00
typedef std::map<std::string,std::vector<cmSourceFile> > SourceMap;
const SourceMap &GetSources() const {return m_Sources;}
SourceMap &GetSources() {return m_Sources;}
cmSourceFile *GetSource(const char *srclist, const char *sourceName);
2001-01-11 22:47:38 +03:00
/**
* Obtain a list of auxiliary source directories.
*/
std::vector<std::string>& GetAuxSourceDirectories()
2001-01-11 22:47:38 +03:00
{return m_AuxSourceDirectories;}
2001-01-11 22:47:38 +03:00
/**
* Do not use this.
*/
std::vector<std::string>& GetMakeVerbatim()
{return m_MakeVerbatim;}
2001-01-11 22:47:38 +03:00
/**
* Given a variable name, return its value (as a string).
*/
2001-01-11 22:47:38 +03:00
const char* GetDefinition(const char*);
/**
2001-01-11 22:47:38 +03:00
* Get a list of preprocessor define flags.
*/
2001-01-11 22:47:38 +03:00
const char* GetDefineFlags()
{return m_DefineFlags.c_str();}
2001-02-27 01:58:54 +03:00
/**
* Get the vector of used command instances.
*/
const std::vector<cmCommand*>& GetUsedCommands() const
{return m_UsedCommands;}
/**
* Get the vector source groups.
*/
const std::vector<cmSourceGroup>& GetSourceGroups() const
{ return m_SourceGroups; }
/**
* Dump documentation to a file. If 0 is returned, the
* operation failed.
*/
int DumpDocumentationToFile(const char *fileName);
/**
* Expand all defined varibles in the string.
* Defined varibles come from the m_Definitions map.
* They are expanded with ${var} where var is the
* entry in the m_Definitions map. Also @var@ is
* expanded to match autoconf style expansions.
*/
void ExpandVariablesInString(std::string& source) const;
/**
* Expand variables in the makefiles ivars such as link directories etc
*/
void ExpandVariables();
2001-02-27 01:17:34 +03:00
2001-02-23 03:24:43 +03:00
/** Recursivly read and create a cmMakefile object for
* all CMakeLists.txt files in the GetSubDirectories list.
* Once the file is found, it ReadListFile is called on
* the cmMakefile created for it.
*/
void FindSubDirectoryCMakeListsFiles(std::vector<cmMakefile*>& makefiles);
/** Generate the cache file only. This is done
* by calling FindSubDirectoryCMakeListsFiles which
* will cause all the rules to fire, and the cache to
* be filled.
*/
void GenerateCacheOnly();
2001-02-27 01:17:34 +03:00
/**
* find what source group this source is in
*/
cmSourceGroup& FindSourceGroup(const char* source,
std::vector<cmSourceGroup> &groups);
protected:
std::string m_Prefix;
std::vector<std::string> m_AuxSourceDirectories; //
2001-02-15 21:30:13 +03:00
std::string m_cmCurrentDirectory;
std::string m_CurrentOutputDirectory;
std::string m_cmStartDirectory;
std::string m_StartOutputDirectory;
std::string m_cmHomeDirectory;
std::string m_HomeOutputDirectory;
std::string m_ProjectName; // project name
// libraries, classes, and executables
cmTargets m_Targets;
2001-04-25 00:49:12 +04:00
SourceMap m_Sources;
std::vector<std::string> m_SubDirectories; // list of sub directories
std::vector<std::string> m_MakeVerbatim; // lines copied from input file
std::vector<std::string> m_IncludeDirectories;
std::vector<std::string> m_LinkDirectories;
std::vector<std::string> m_Utilities;
std::vector<std::string> m_UtilityDirectories;
std::vector<std::string> m_LinkLibraries;
std::vector<std::string> m_LinkLibrariesWin32;
std::vector<std::string> m_LinkLibrariesUnix;
std::string m_IncludeFileRegularExpression;
std::string m_DefineFlags;
std::vector<cmSourceGroup> m_SourceGroups;
2001-01-18 19:20:24 +03:00
typedef std::map<std::string, cmCommand*> RegisteredCommandsMap;
typedef std::map<std::string, std::string> DefinitionMap;
DefinitionMap m_Definitions;
2001-01-18 19:20:24 +03:00
RegisteredCommandsMap m_Commands;
std::vector<cmCommand*> m_UsedCommands;
cmMakefileGenerator* m_MakefileGenerator;
2001-04-20 01:39:03 +04:00
bool IsFunctionBlocked(const char *name, std::vector<std::string> &args) const;
2001-01-11 22:47:38 +03:00
private:
2001-02-15 21:30:13 +03:00
/**
* Get the name of the parent directories CMakeLists file
* given a current CMakeLists file name
2001-01-11 22:47:38 +03:00
*/
2001-02-15 21:30:13 +03:00
std::string GetParentListFileName(const char *listFileName);
2001-01-11 22:47:38 +03:00
2001-04-25 00:49:12 +04:00
void ReadSources(std::ifstream& fin, bool t);
2001-01-11 22:47:38 +03:00
friend class cmMakeDepend; // make depend needs direct access
2001-04-25 00:49:12 +04:00
// to the m_Sources array
2001-04-20 01:39:03 +04:00
void PrintStringVector(const char* s, const std::vector<std::string>& v) const;
2001-01-18 19:20:24 +03:00
void AddDefaultCommands();
void AddDefaultDefinitions();
2001-04-20 01:39:03 +04:00
std::set<cmFunctionBlocker *> m_FunctionBlockers;
};
#endif