Tools for handling dynamic code compilation. More...
Public Types | |
typedef Tuple2< fileName, string > | fileAndContent |
Public Member Functions | |
dynamicCode (const word &codeName, const word &codeDirName="") | |
Construct for a specified code name and code directory name. More... | |
dynamicCode (const dynamicCode &)=delete | |
Disallow default bitwise copy construction. More... | |
const word & | codeName () const |
Return the code-name. More... | |
const word & | codeDirName () const |
Return the code-dirname. More... | |
const fileName & | codeRoot () const |
Root for dynamic code compilation. More... | |
fileName | libSubDir () const |
Subdirectory name for loading libraries. More... | |
fileName | codePath () const |
Path for specified code name. More... | |
fileName | libPath () const |
Library path for specified code name. More... | |
fileName | codeRelPath () const |
Path for specified code name relative to $FOAM_CASE. More... | |
fileName | libRelPath () const |
Library path for specified code name relative to $FOAM_CASE. More... | |
fileName | digestFile () const |
Path for SHA1Digest. More... | |
void | clear () |
Clear files and variables. More... | |
void | reset (const dynamicCodeContext &) |
Clear files and reset variables to specified context. More... | |
void | addCompileFile (const fileName &name) |
Add a file template name, which will be found and filtered. More... | |
void | addCopyFile (const fileName &name) |
Add a file template name, which will be found and filtered. More... | |
void | addCreateFile (const fileName &name, const string &contents) |
Add a file to create with its contents. Will not be filtered. More... | |
void | setFilterVariable (const word &key, const std::string &value) |
Define a filter variable. More... | |
void | setMakeOptions (const std::string &content) |
Define contents for Make/options. More... | |
bool | upToDate (const dynamicCodeContext &context) const |
Verify if the copied code is up-to-date, based on Make/SHA1Digest. More... | |
bool | upToDate (const SHA1Digest &sha1) const |
Verify if the copied code is up-to-date, based on Make/SHA1Digest. More... | |
bool | copyOrCreateFiles (const bool verbose=false) const |
Copy/create files prior to compilation. More... | |
bool | wmakeLibso () const |
Compile a libso. More... | |
void | operator= (const dynamicCode &)=delete |
Disallow default bitwise assignment. More... | |
Static Public Member Functions | |
static void | checkSecurity (const char *title, const dictionary &) |
Check security for creating dynamic code. More... | |
static word | libraryBaseName (const fileName &libPath) |
Return the library basename without leading 'lib' or trailing '.so'. More... | |
static fileName | resolveTemplate (const fileName &templateName) |
Resolve code-template via the codeTemplateEnvName. More... | |
Static Public Attributes | |
static const word | codeTemplateEnvName = "FOAM_CODE_TEMPLATES" |
Name of the code template environment variable. More... | |
static const fileName | codeTemplateDirName = "codeTemplates/dynamicCode" |
Name of the code template sub-directory. More... | |
static int | allowSystemOperations |
Flag if system operations are allowed. More... | |
Protected Member Functions | |
bool | writeCommentSHA1 (Ostream &) const |
Write SHA1 value as C-comment. More... | |
bool | createMakeFiles () const |
Copy/create Make/files prior to compilation. More... | |
bool | createMakeOptions () const |
Copy/create Make/options prior to compilation. More... | |
bool | writeDigest (const SHA1Digest &) const |
Write digest to Make/SHA1Digest. More... | |
bool | writeDigest (const std::string &) const |
Write digest to Make/SHA1Digest. More... | |
Static Protected Member Functions | |
static void | copyAndFilter (ISstream &, OSstream &, const HashTable< string > &mapping) |
Copy lines while expanding variables. More... | |
static bool | resolveTemplates (const UList< fileName > &templateNames, DynamicList< fileName > &resolvedFiles, DynamicList< fileName > &badFiles) |
Resolve code-templates via the codeTemplateEnvName. More... | |
Static Protected Attributes | |
static const char *const | libTargetRoot |
Root of the LIB target for Make/files. More... | |
static const char *const | topDirName = "dynamicCode" |
Top-level directory name for copy/compiling. More... | |
Tools for handling dynamic code compilation.
Definition at line 56 of file dynamicCode.H.
typedef Tuple2<fileName, string> fileAndContent |
Definition at line 61 of file dynamicCode.H.
dynamicCode | ( | const word & | codeName, |
const word & | codeDirName = "" |
||
) |
Construct for a specified code name and code directory name.
Defaults to using the code name for the code directory name
Definition at line 323 of file dynamicCode.C.
References dynamicCode::clear().
|
delete |
Disallow default bitwise copy construction.
|
staticprotected |
Copy lines while expanding variables.
Definition at line 104 of file dynamicCode.C.
References Foam::exit(), Foam::FatalError, FatalErrorInFunction, ISstream::getLine(), IOstream::good(), Foam::stringOps::inplaceExpandCodeTemplate(), ISstream::name(), OSstream::name(), Foam::nl, and OSstream::writeQuoted().
|
staticprotected |
Resolve code-templates via the codeTemplateEnvName.
alternatively in the codeTemplateDirName via Foam::findEtcFile
Definition at line 170 of file dynamicCode.C.
References DynamicList< T, SizeInc, SizeMult, SizeDiv >::append(), Foam::file, Foam::findEtcFile(), forAll, Foam::getEnv(), Foam::isDir(), and Foam::isFile().
|
protected |
Write SHA1 value as C-comment.
Definition at line 216 of file dynamicCode.C.
References Ostream::writeQuoted().
|
protected |
Copy/create Make/files prior to compilation.
Definition at line 230 of file dynamicCode.C.
References Foam::exit(), Foam::FatalError, FatalErrorInFunction, forAll, IOstream::good(), Foam::mkDir(), Foam::name(), Foam::nl, fileName::path(), and OSstream::writeQuoted().
|
protected |
Copy/create Make/options prior to compilation.
Definition at line 267 of file dynamicCode.C.
References Foam::exit(), Foam::FatalError, FatalErrorInFunction, IOstream::good(), Foam::mkDir(), Foam::nl, fileName::path(), and OSstream::writeQuoted().
|
protected |
Write digest to Make/SHA1Digest.
Definition at line 296 of file dynamicCode.C.
References Foam::file, IOstream::good(), Foam::mkDir(), Foam::nl, and SHA1Digest::write().
|
protected |
Write digest to Make/SHA1Digest.
Definition at line 308 of file dynamicCode.C.
References Foam::file, IOstream::good(), Foam::mkDir(), Foam::nl, and OSstream::writeQuoted().
|
static |
Check security for creating dynamic code.
Definition at line 57 of file dynamicCode.C.
References dynamicCode::allowSystemOperations, dict, Foam::endl(), Foam::exit(), Foam::FatalIOError, FatalIOErrorInFunction, Foam::isAdministrator(), and Foam::nl.
Referenced by codedBase::updateLibrary().
|
static |
Return the library basename without leading 'lib' or trailing '.so'.
Definition at line 93 of file dynamicCode.C.
References fileName::name().
Referenced by codedBase::updateLibrary().
|
inline |
Return the code-name.
Definition at line 185 of file dynamicCode.H.
Referenced by codedBase::updateLibrary().
|
inline |
Return the code-dirname.
Definition at line 191 of file dynamicCode.H.
|
inline |
Root for dynamic code compilation.
Expanded from $FOAM_CASE/dynamicCode
Definition at line 198 of file dynamicCode.H.
|
inline |
Subdirectory name for loading libraries.
Expanded from platforms/$WM_OPTIONS/lib
Definition at line 205 of file dynamicCode.H.
|
inline |
Path for specified code name.
Corresponds to codeRoot()/codeDirName()
Definition at line 212 of file dynamicCode.H.
|
inline |
Library path for specified code name.
Corresponds to codeRoot()/libSubDir()/lib<codeName>.so
Definition at line 219 of file dynamicCode.H.
Referenced by codedBase::updateLibrary().
Foam::fileName codeRelPath | ( | ) | const |
Path for specified code name relative to $FOAM_CASE.
Corresponds to topDirName/codeDirName()
Definition at line 341 of file dynamicCode.C.
Foam::fileName libRelPath | ( | ) | const |
Library path for specified code name relative to $FOAM_CASE.
Corresponds to dynamicCode/codeDirName()/libSubDir()/lib<codeName>.so
Definition at line 347 of file dynamicCode.C.
|
inline |
Path for SHA1Digest.
Corresponds to codePath()/Make/SHA1Digest
Definition at line 235 of file dynamicCode.H.
|
static |
Resolve code-template via the codeTemplateEnvName.
alternatively in the codeTemplateDirName via Foam::findEtcFile
Definition at line 142 of file dynamicCode.C.
References Foam::file, Foam::findEtcFile(), Foam::getEnv(), Foam::isDir(), and Foam::isFile().
Referenced by basicThermo::lookupCstrIter(), and basicChemistryModel::New().
void clear | ( | ) |
Clear files and variables.
Definition at line 353 of file dynamicCode.C.
Referenced by dynamicCode::dynamicCode().
void reset | ( | const dynamicCodeContext & | context | ) |
Clear files and reset variables to specified context.
Definition at line 369 of file dynamicCode.C.
References clear(), dynamicCodeContext::code(), forAllConstIter, dynamicCodeContext::sha1(), and SHA1Digest::str().
void addCompileFile | ( | const fileName & | name | ) |
Add a file template name, which will be found and filtered.
Definition at line 385 of file dynamicCode.C.
References Foam::name().
void addCopyFile | ( | const fileName & | name | ) |
Add a file template name, which will be found and filtered.
Definition at line 391 of file dynamicCode.C.
References Foam::name().
Add a file to create with its contents. Will not be filtered.
Definition at line 397 of file dynamicCode.C.
References Foam::name().
void setFilterVariable | ( | const word & | key, |
const std::string & | value | ||
) |
Define a filter variable.
Definition at line 407 of file dynamicCode.C.
void setMakeOptions | ( | const std::string & | content | ) |
Define contents for Make/options.
Definition at line 417 of file dynamicCode.C.
bool upToDate | ( | const dynamicCodeContext & | context | ) | const |
Verify if the copied code is up-to-date, based on Make/SHA1Digest.
Definition at line 549 of file dynamicCode.C.
References dynamicCodeContext::sha1().
bool upToDate | ( | const SHA1Digest & | sha1 | ) | const |
Verify if the copied code is up-to-date, based on Make/SHA1Digest.
Definition at line 536 of file dynamicCode.C.
References Foam::exists(), and Foam::file.
bool copyOrCreateFiles | ( | const bool | verbose = false | ) | const |
Copy/create files prior to compilation.
Definition at line 423 of file dynamicCode.C.
References UList< T >::empty(), Foam::endl(), Foam::exit(), Foam::stringOps::expandEnvVar(), Foam::FatalError, FatalErrorInFunction, Foam::first(), forAll, IOstream::good(), Foam::Info, Foam::mkDir(), fileName::name(), Foam::nl, fileName::path(), Foam::second(), and OSstream::writeQuoted().
bool wmakeLibso | ( | ) | const |
Compile a libso.
Definition at line 520 of file dynamicCode.C.
References Foam::endl(), Foam::Info, and Foam::system().
|
delete |
Disallow default bitwise assignment.
|
staticprotected |
Root of the LIB target for Make/files.
Definition at line 101 of file dynamicCode.H.
|
staticprotected |
Top-level directory name for copy/compiling.
Definition at line 104 of file dynamicCode.H.
|
static |
Name of the code template environment variable.
Used to located the codeTemplateName
Definition at line 149 of file dynamicCode.H.
|
static |
Name of the code template sub-directory.
Used when locating the codeTemplateName via Foam::findEtcFile
Definition at line 153 of file dynamicCode.H.
|
static |
Flag if system operations are allowed.
Definition at line 156 of file dynamicCode.H.
Referenced by dynamicCode::checkSecurity(), basicThermo::lookupCstrIter(), basicChemistryModel::New(), argList::parse(), and systemCall::read().