KVBase.cpp

/***************************************************************************
$Id: KVBase.cpp,v 1.57 2009/04/22 09:38:39 franklan Exp $
                          kvbase.cpp  -  description
                             -------------------
    begin                : Thu May 16 2002
    copyright            : (C) 2002 by J.D. Frankland
    email                : frankland@ganil.fr
 ***************************************************************************/
 
/***************************************************************************
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 ***************************************************************************/
#include <cassert>
#include "KVBase.h"
#include "TClass.h"
#include "KVString.h"
#include "TRandom.h"
#include "TSystem.h"
#include "TInterpreter.h"
#include "TPluginManager.h"
#include "KVNameValueList.h"
#include "KVSystemDirectory.h"
#include "KVVersion.h"
#ifdef WITH_GIT_INFOS
#include "KVGitInfo.h"
#endif
#ifdef WITH_RSQLITE
#include "SQLiteDB.h"
#endif
#include "TROOT.h"
#include "TDatime.h"
#include "THashList.h"
#include "TGMimeTypes.h"
#include "TGClient.h"
#include "TContextMenu.h"
#include <TFileMerger.h>
#include <TH1.h>
#include <TKey.h>
#include <fstream>
 
using namespace std;
 
ClassImp(KVBase)
 
// for multithread safety
std::mutex _kvbase_mutex;
TString KVBase::fWorkingDirectory = "$(HOME)/.kaliveda";
Bool_t KVBase::fEnvIsInit = kFALSE;
 
 
 
const Char_t* KVBase::GetETCDIRFilePath(const Char_t* namefile)
{
   if (strcmp(namefile, "")) return Form("%s/%s", kaliveda::build_infos::ETCDIR.c_str(), namefile);
   return kaliveda::build_infos::ETCDIR.c_str();
}
 
 
 
const Char_t* KVBase::GetDATADIRFilePath(const Char_t* namefile)
{
   if (strcmp(namefile, "")) return Form("%s/%s", kaliveda::build_infos::DATADIR.c_str(), namefile);
   return kaliveda::build_infos::DATADIR.c_str();
}
 
 
 
const Char_t* KVBase::GetTEMPLATEDIRFilePath(const Char_t* namefile)
{
   if (strcmp(namefile, "")) return Form("%s/%s", kaliveda::build_infos::TEMPLATEDIR.c_str(), namefile);
   return kaliveda::build_infos::TEMPLATEDIR.c_str();
}
 
 
 
const Char_t* KVBase::GetDATABASEFilePath()
{
   return Form("%s/db", fWorkingDirectory.Data());
}
 
 
 
const Char_t* KVBase::GetLIBDIRFilePath(const Char_t* namefile)
{
   if (strcmp(namefile, "")) return Form("%s/%s", kaliveda::build_infos::LIBDIR.c_str(), namefile);
   return kaliveda::build_infos::LIBDIR.c_str();
}
 
 
 
const Char_t* KVBase::GetINCDIRFilePath(const Char_t* namefile)
{
   if (strcmp(namefile, "")) return Form("%s/%s", kaliveda::build_infos::INCDIR.c_str(), namefile);
   return kaliveda::build_infos::INCDIR.c_str();
}
 
 
 
const Char_t* KVBase::GetBINDIRFilePath(const Char_t* namefile)
{
   if (strcmp(namefile, "")) return Form("%s/%s", kaliveda::build_infos::BINDIR.c_str(), namefile);
   return kaliveda::build_infos::BINDIR.c_str();
}
 
 
 
const Char_t* KVBase::GetWORKDIRFilePath(const Char_t* namefile)
{
   if (strcmp(namefile, "")) return Form("%s/%s", fWorkingDirectory.Data(), namefile);
   return fWorkingDirectory;
}
 
 
 
int KVBase::GetKVMajorVersion()
{
   return kaliveda::build_infos::KV_MAJOR_VERSION;
}
 
 
 
int KVBase::GetKVMinorVersion()
{
   return kaliveda::build_infos::KV_MINOR_VERSION;
}
 
 
 
int KVBase::GetKVPatchVersion()
{
   return kaliveda::build_infos::KV_PATCH_VERSION;
}
 
 
 
void KVBase::init()
{
   //Default initialisation
 
   InitEnvironment();
   fNumber = 0;
   fLabel = "";
   SetBit(kIsKaliVedaObject);
}
 
 
 
 
void KVBase::InitEnvironment()
{
   // STATIC method to Initialise KaliVeda environment
   // Reads config files in <code>\$(pkgdatadir)/etc</code> and sets up environment
   // (data repositories, datasets, etc. etc.).
   // Adds directory where kaliveda shared libs are installed to the dynamic
   // path - for finding and loading plugins.
   // Resets the `gRandom` random number sequence using a clock-based seed
   // (i.e. random sequences do not repeat).
   //
   // Normally, the first object created which inherits from KVBase will
   // perform this initialisation; if you need to set up the environment before
   // creating a KVBase object, or if you just want to be absolutely sure that
   // the environment has been initialised, you can call this method.
   //
   // #### Note for GNU-style installations
   // If KaliVeda is built with the cmake option `-Dgnuinstall=yes` then each
   // user will have a working directory which will be used to store any files
   // generated by KaliVeda at runtime.
   //
   // By default the location of user's working directory is set to
   //~~~~~~~~~
   //    $(HOME)/.kaliveda
   //~~~~~~~~~
   // but can be changed with variable
   //~~~~~~~~~
   //    KaliVeda.WorkingDirectory:   [directory]
   //~~~~~~~~~
   // in configuration file `.kvrootrc`.
   //`[directory]` must be an absolute pathname, but can use shell variables like <code>\$(HOME)</code>.
 
   std::lock_guard<std::mutex> lk(_kvbase_mutex); // prevent multiple initialisation in different threads
 
   if (!fEnvIsInit) {//test if environment already initialised
 
      // enable ROOT thread safety
      ROOT::EnableThreadSafety();
 
      // Add path to kaliveda libraries to dynamic loader path
      // This is needed to find plugins
      // and also to be able to compile with kaliveda in the interpreter
      TString libdir = GetLIBDIRFilePath();
      gSystem->AddDynamicPath(libdir);
      // force re-reading of rootmap files in new dynamic path
      gInterpreter->LoadLibraryMap();
      // Add path to kaliveda header files
      // This is needed to be able to compile with kaliveda in the interpreter
      TString incdir = GetINCDIRFilePath();
      incdir.Prepend("-I");
      gSystem->AddIncludePath(incdir);
 
      //set up environment using kvrootrc file
      if (!gEnv->Defined("DataSet.DatabaseFile")) {
         ReadConfigFiles();
      }
#ifdef WITH_GNU_INSTALL
      // set working directory & create if needed
      fWorkingDirectory = gEnv->GetValue("KaliVeda.WorkingDirectory", "$(HOME)/.kaliveda");
      gSystem->ExpandPathName(fWorkingDirectory);
      gSystem->mkdir(fWorkingDirectory, kTRUE);
#else
      // set environment variable used in database makefiles
      fWorkingDirectory = KV_ROOT;
#endif
      // set environment variable used in database makefiles
      gSystem->Setenv("KV_WORK_DIR", fWorkingDirectory);
 
      //generate new seed from system clock
      gRandom->SetSeed(0);
 
      // initialisation has been performed
      fEnvIsInit = kTRUE;
   }
}
 
 
 
 
void KVBase::ReadConfigFiles()
{
   // Read all configuration files
   // System config files are read first in the order they appear in file
   //    ${ETCDIR}/config.files
   // Then we read any of the following files if they exist:
   //    ${HOME}/.kvrootrc
   //    ${PWD}/.kvrootrc (if PWD!=HOME)
 
   TString tmp = GetETCDIRFilePath("config.files");
   ifstream conflist;
   conflist.open(tmp.Data());
   if (!conflist.good()) {
      ::Fatal("KVBase::ReadConfigFiles", "Cannot open %s", tmp.Data());
      return;
   }
   KVString file;
   file.ReadLine(conflist);
   conflist.close();
   file.Begin(";");
   while (!file.End()) {
      tmp = GetETCDIRFilePath(file.Next().Data());
      //skip over any missing files - this is needed when installing from
      //e.g. ubuntu packages if not all packages are installed
      if (!gSystem->AccessPathName(tmp.Data())) gEnv->ReadFile(tmp.Data(), kEnvChange);
   }
 
   AssignAndDelete(tmp, gSystem->ConcatFileName(gSystem->Getenv("HOME"), ".kvrootrc"));
   gEnv->ReadFile(tmp.Data(), kEnvChange);
 
   if (TString(gSystem->pwd()) != gSystem->HomeDirectory()) {
      tmp = "./.kvrootrc";
      gEnv->ReadFile(tmp.Data(), kEnvChange);
   }
 
   // load plugin handlers
   gROOT->GetPluginManager()->LoadHandlersFromEnv(gEnv);
 
   // load mime types/icon definitions when not in batch (i.e. GUI-less) mode
   if (!gROOT->IsBatch()) ReadGUIMimeTypes();
}
 
 
 
 
KVBase::KVBase()
{
   //Default constructor.
   init();
}
 
 
 
 
KVBase::KVBase(const Char_t* name, const Char_t* type): TNamed(name, type)
{
   //Ctor for object with given name and type.
   init();
}
 
 
 
 
KVBase::KVBase(const KVBase& obj) : TNamed()
{
   //copy ctor
   init();
#if ROOT_VERSION_CODE >= ROOT_VERSION(3,4,0)
   obj.Copy(*this);
#else
   ((KVBase&) obj).Copy(*this);
#endif
}
 
 
 
 
KVBase& KVBase::operator=(const KVBase& other)
{
   // copy assignment operator
 
   if (&other != this) {
      other.Copy(*this);
   }
   return (*this);
}
 
 
 
 
 
void KVBase::Clear(Option_t* opt)
{
   //Clear object properties : name, type/title, number, label
   TNamed::Clear(opt);
   fNumber = 0;
   fLabel = "";
}
 
 
#if ROOT_VERSION_CODE >= ROOT_VERSION(3,4,0)
 
 
void KVBase::Copy(TObject& obj) const
#else
void KVBase::Copy(TObject& obj)
#endif
{
   //Make a copy of this object
 
   TNamed::Copy(obj);
   ((KVBase&) obj).SetNumber(fNumber);
   ((KVBase&) obj).SetLabel(fLabel);
}
 
 
 
 
void KVBase::Print(Option_t*) const
{
   cout << "KVBase object: Name=" << GetName() << " Type=" << GetType();
   if (fLabel != "")
      cout << " Label=" << GetLabel();
   if (fNumber != 0)
      cout << " Number=" << GetNumber();
   cout << endl;
}
 
 
 
 
void KVBase::Streamer(TBuffer& R__b)
{
   //Backwards compatible streamer for KVBase objects
   //Needed to handle 'fLabel' char array in class version 1
   //Objects written with version < 3 did not have kIsKaliVedaObject bit set,
   //we set it here when reading object.
 
   if (R__b.IsReading()) {
      UInt_t R__s, R__c;
      Version_t R__v = R__b.ReadVersion(&R__s, &R__c);
      if (R__v > 1) {
         if (R__v < 4) {
            TNamed::Streamer(R__b);
            R__b >> fNumber;
            R__b >> fLabel;
            if (R__v < 3) SetBit(kIsKaliVedaObject);
            R__b.CheckByteCount(R__s, R__c, KVBase::IsA());
         }
         else {
            //AUTOMATIC STREAMER EVOLUTION FOR CLASS VERSION > 3
            KVBase::Class()->ReadBuffer(R__b, this, R__v, R__s, R__c);
         }
         return;
      }
      //OLD STREAMER FOR CLASS VERSION 1
      TNamed::Streamer(R__b);
      R__b >> fNumber;
      UInt_t LabelLength;
      R__b >> LabelLength;
      if (LabelLength) {
         Char_t* Label = new Char_t[LabelLength];
         R__b.ReadFastArray(Label, LabelLength);
         fLabel = Label;
         delete[]Label;
      }
      SetBit(kIsKaliVedaObject);
      R__b.CheckByteCount(R__s, R__c, KVBase::IsA());
   }
   else {
      KVBase::Class()->WriteBuffer(R__b, this);
   }
}
 
 
 
 
 
Bool_t SearchFile(const Char_t* name, TString& fullpath, int ndirs, ...)
{
   //Search for file in an arbitrary number of locations, return kTRUE if file found and put full path to file in 'fullpath"
   //
   //'name' is a filename (not an absolute pathname) i.e. "toto.dat"
   //'fullpath" will contain the full path to the file if it is found (if file not found, fullpath="")
   //'ndirs" is the number of directories to search in
   //the remaining arguments are the names of 'ndirs' paths to search in, i.e.
   //
   //      SearchFile("toto.dat", fullpath, 2, gSystem->pwd(), gSystem->HomeDirectory());
   //
   //means: search for a file 'toto.dat' in current working directory, then user's home directory.
 
   if (ndirs <= 0)
      return kFALSE;
 
   va_list args;
   va_start(args, ndirs);
 
   for (; ndirs; ndirs--) {     //loop over directories
 
      AssignAndDelete(fullpath,
                      gSystem->ConcatFileName(va_arg(args, const char*),
                                              name));
      if (!gSystem->AccessPathName(fullpath.Data())) {
         va_end(args);
         return kTRUE;
      }
 
   }
 
   va_end(args);
   fullpath = "";               //clear fullpath string to avoid using it by mistake
   return kFALSE;
}
 
 
 
 
Bool_t KVBase::SearchKVFile(const Char_t* name, TString& fullpath,
                            const Char_t* kvsubdir)
{
   //search for files in the following order:
   //  if 'name' = absolute path the function returns kTRUE if the file exists
   //  if name != absolute path:
   //      1. a. if 'kvsubdir'="" (default) look for file in $(pkgdatadir) directory
   //      1. b. if 'kvsubdir'!="":
   //               if 'kvsubdir' is an absolute pathname, look in 'kvsubdir'
   //               if 'kvsubdir' is not an absolute pathname,
   //                    look in '$(pkdatadir)/kvsubdir'
   //      2. look for file with this name in user's home directory
   //      3. look for file with this name in current working directory
   //in all cases the function returns kTRUE if the file was found.
   //'fullpath' then contains the absolute path to the file
 
   if (gSystem->IsAbsoluteFileName(name)) {
      // absolute path
      fullpath = name;
      return !gSystem->AccessPathName(name);
   }
 
   TString kvfile_dir;
   if (strcmp(kvsubdir, "")) {
      // subdirectory hint given
      if (!gSystem->IsAbsoluteFileName(kvsubdir))
         kvfile_dir = GetDATADIRFilePath(kvsubdir); // relative path - assume in $(pkgdatadir)
      else
         kvfile_dir = kvsubdir; // absolute path - use as is
   }
   else // no subdirectory hint given
      kvfile_dir = GetDATADIRFilePath();
 
   return SearchFile(name, fullpath, 3, kvfile_dir.Data(),
                     gSystem->HomeDirectory(), gSystem->pwd());
}
 
 
 
 
 
Bool_t KVBase::SearchAndOpenKVFile(const Char_t* name, ifstream& file, const Char_t* kvsubdir, KVLockfile* locks)
{
   //Search and open for READING a file:
   //
   //search for ascii file (and open it, if found) in the following order:
   //  if 'name' = absolute path the function returns kTRUE if the file exists
   //  if name != absolute path:
   //      1. a. if 'kvsubdir'="" (default) look for file in $(pkdatadir) directory
   //      1. b. if 'kvsubdir'!="" look for file in $(pkdatadir)/'kvsubdir'
   //               if 'kvsubdir' is an absolute pathname, look in 'kvsubdir'
   //               if 'kvsubdir' is not an absolute pathname,
   //                    look in '$(pkdatadir)/kvsubdir'
   //      2. look for file with this name in user's home directory
   //      3. look for file with this name in working directory
   //if the file is not found, kFALSE is returned.
   //if file is found and can be opened, 'file' is then an ifstream connected to the open (ascii) file
   //
   //LOCKFILE:
   //If a KVLockfile pointer is given, we use it to get a lock on the file before opening it.
   //If this lock is not successful, the file is not opened and we return an error message.
 
   TString fullpath;
   if (SearchKVFile(name, fullpath, kvsubdir)) {
      //put lock on file if required
      if (locks && !locks->Lock(fullpath.Data())) return kFALSE;
      file.open(fullpath.Data());
      if (file.good()) {
         //cout << "Opened file : " << fullpath.Data() << endl;
         return kTRUE;
      }
      //unlock file if not opened successfully
      if (locks) locks->Release();
   }
   return kFALSE;
}
 
 
#ifdef WITH_RSQLITE
 
 
Bool_t KVBase::SearchAndOpenKVFile(const Char_t* name, KVSQLite::database& dbfile, const Char_t* kvsubdir)
{
   //Search and open for reading/writing a sqlite database file:
   //
   //search for file (and open it, if found) in the following order:
   //  if 'name' = absolute path the function returns kTRUE if the file exists
   //  if name != absolute path:
   //      1. a. if 'kvsubdir'="" (default) look for file in $(pkdatadir) directory
   //      1. b. if 'kvsubdir'!="" look for file in $(pkdatadir)/'kvsubdir'
   //      2. look for file with this name in user's home directory
   //      3. look for file with this name in working directory
   //if the file is not found, kFALSE is returned.
 
   TString fullpath;
   if (SearchKVFile(name, fullpath, kvsubdir)) {
      dbfile.open(fullpath);
      if (dbfile.good()) {
         //cout << "Opened file : " << fullpath.Data() << endl;
         return kTRUE;
      }
   }
   return kFALSE;
}
 
#endif
 
 
 
Bool_t KVBase::SearchAndOpenKVFile(const Char_t* name, ofstream& file, const Char_t* kvsubdir, KVLockfile* locks)
{
   //Search and CREATE i.e. open for WRITING a file:
   //
   //open for writing an ascii file in the location determined in the following way:
   //  if 'name' = absolute path we use the full path
   //  if name != absolute path:
   //      1. a. if 'kvsubdir'="" (default) file will be in $(pkdatadir) directory
   //      1. b. if 'kvsubdir'!="":
   //               if 'kvsubdir' is an absolute pathname, file in 'kvsubdir'
   //               if 'kvsubdir' is not an absolute pathname,
   //                    file will be in '$(pkdatadir)/kvsubdir'
   //if an existing file is found, a warning is printed and the existing file 'toto' is renamed
   //"toto.date". where 'date' is created with TDatime::AsSQLDate
   // file' is then an ofstream connected to the opened file
   //
   //LOCKFILE:
   //If a KVLockfile pointer is given, we use it to get a lock on the file before opening it.
   //If this lock is not successful, the file is not opened and we return an error message.
 
   KVString fullpath;
   if (gSystem->IsAbsoluteFileName(name)) {
      fullpath = name;
   }
   else if (gSystem->IsAbsoluteFileName(kvsubdir)) {
      AssignAndDelete(fullpath,
                      gSystem->ConcatFileName(kvsubdir, name));
   }
   else if (strcmp(kvsubdir, "")) {
      KVString path = GetDATADIRFilePath(kvsubdir);
      AssignAndDelete(fullpath,
                      gSystem->ConcatFileName(path.Data(), name));
   }
   else {
      fullpath = GetDATADIRFilePath(name);
   }
   //Backup file if necessary
   BackupFileWithDate(fullpath.Data());
   //put lock on file if required
   if (locks && !locks->Lock(fullpath.Data())) return kFALSE;
   file.open(fullpath.Data());
   return kTRUE;
}
 
 
 
 
 
void KVBase::BackupFileWithDate(const Char_t* path)
{
   //`path` gives the full path (can include environment variables, special symbols)
   //to a file which will be renamed with an extension containing the current date and time
   //(in SQL format).
   //
   //Example:
   //
   //    KVBase::BackupFileWithDate("$(HOME)/toto.txt")
   //
   //The file `toto.txt` will be renamed `toto.txt.2007-05-02_16:22:37`
 
   KVString fullpath = path;
   gSystem->ExpandPathName(fullpath);
   if (!gSystem->AccessPathName(fullpath.Data())) {//does the file exist ?
      //backup file
      TDatime now;
      KVString date(now.AsSQLString());
      date.ReplaceAll(' ', '_');
      TString backup = fullpath + "." + date;
      //lock both files
      KVLockfile lf1(fullpath.Data()), lf2(backup.Data());
      if (lf1.Lock() && lf2.Lock()) {
         gSystem->Rename(fullpath.Data(), backup.Data());
         printf("Info in <KVBase::BackupFileWithDate(const Char_t *)> : Existing file %s renamed %s\n",
                fullpath.Data(), backup.Data());
      }
   }
}
 
 
 
 
 
TPluginHandler* KVBase::LoadPlugin(const Char_t* base, const Char_t* uri)
{
   //Load plugin library in order to extend capabilities of base class "base", depending on
   //the given uri (these arguments are used to call TPluginManager::FindHandler).
   //Returns pointer to TPluginHandler.
   //Returns 0 in case of problems.
 
   //does plugin exist for given name ?
   TPluginHandler* ph =
      (TPluginHandler*) gROOT->GetPluginManager()->FindHandler(base,
            uri);
   if (!ph)
      return 0;
 
   //check plugin library/macro is available
   if (ph->CheckPlugin() != 0)
      return 0;
 
   //load plugin module
   if (ph->LoadPlugin() != 0)
      return 0;
 
   return ph;
}
 
 
 
 
 
void KVBase::OpenTempFile(TString& base, ofstream& fp)
{
   //Opens a uniquely-named file in system temp directory (gSystem->TempDirectory)
   //Name of file is "basexxxxxxxxxx" where "xxxxxxxxx" is current time as returned
   //by gSystem->Now().
   //After opening file, 'base' contains full path to file.
 
   GetTempFileName(base);
   fp.open(base.Data());
}
 
 
 
 
 
void KVBase::GetTempFileName(TString& base)
{
   //When called with base="toto.dat", the returned value of 'base' is
   //"/full/path/to/temp/dir/toto.dat15930693"
   //i.e. the full path to a file in the system temp directory (gSystem->TempDirectory)
   //appended with the current time as returned by gSystem->Now() in order to make
   //its name unique
 
   TString tmp1;
   AssignAndDelete(tmp1,
                   gSystem->ConcatFileName(gSystem->TempDirectory(),
                                           base.Data()));
   long lnow = (long) gSystem->Now();
   base = tmp1 + lnow;
   //make sure no existing file with same name
   while (!gSystem->AccessPathName(base)) {
      base = tmp1 + (++lnow);
   }
}
 
 
 
 
 
const Char_t* KVBase::GetKVVersion()
{
   //Returns KaliVeda version string
   return kaliveda::build_infos::KV_VERSION.c_str();
}
 
 
 
 
 
const Char_t* KVBase::GetKVBuildUser()
{
   // Returns username of person who performed build
   return kaliveda::build_infos::KV_BUILD_USER.c_str();
}
 
 
 
 
 
const Char_t* KVBase::GetKVBuildDate()
{
   //Returns KaliVeda build date
   return kaliveda::build_infos::KV_BUILD_DATE.c_str();
}
 
 
 
 
const Char_t* KVBase::GetKVBuildTime()
{
   //Returns KaliVeda build time
   return kaliveda::build_infos::KV_BUILD_TIME.c_str();
}
 
 
 
 
 
const Char_t* KVBase::GetKVBuildType()
{
   //Returns KaliVeda build type (cmake build: Release, Debug, RelWithDebInfo, ...)
   return kaliveda::build_infos::KV_BUILD_TYPE.c_str();
}
 
 
 
 
 
const Char_t* KVBase::GetKVSourceDir()
{
   //Returns top-level directory of source tree used for build
   return kaliveda::build_infos::KV_SOURCE_DIR.c_str();
}
 
 
 
 
 
const Char_t* KVBase::GetKVBuildDir()
{
   //Returns top-level directory used for build
   return kaliveda::build_infos::KV_BUILD_DIR.c_str();
}
 
 
#ifdef WITH_GIT_INFOS
 
 
const Char_t* KVBase::gitBranch()
{
   // Returns git branch of sources
   return kaliveda::git_infos::KV_GIT_BRANCH.c_str();
}
 
 
 
 
const Char_t* KVBase::gitCommit()
{
   // Returns last git commit of sources
   return kaliveda::git_infos::KV_GIT_COMMIT.c_str();
}
 
#endif
 
 
 
Bool_t KVBase::FindExecutable(TString& exec, const Char_t* path)
{
   //By default, `FindExecutable(exec)` will look for the executable named by `exec`
   //in the directories contained in the environment variable `PATH`. You can override
   //this by giving your own search `path` as second argument (remember to write
   //environment variables as <code>\$(PATH)</code>, for cross-platform compatibility).
   //
   //If `exec` is not found, and if it does not end with `.exe`, we look for `exec.exe`
   //This is for compatibility with Windows/cygwin environments.
   //
   //If the executable is found, returns `kTRUE` and `exec` then holds full path to executable.
   //Returns `kFALSE` if `exec` not found in paths.
   //
   //If `exec` is an absolute pathname, we return `kTRUE` if the file exists
   //(we do not use `path`).
 
   TString spath(path), backup(exec), backup2(exec), expandexec(exec);
   gSystem->ExpandPathName(expandexec);
   if (gSystem->IsAbsoluteFileName(expandexec.Data())) {
      //executable given as absolute path
      //we check if it exists
      if (!gSystem->AccessPathName(expandexec)) {
         exec = expandexec;
         return kTRUE;
      }
      else {
         //try with ".exe" in case of Windows system
         if (!expandexec.EndsWith(".exe")) {
            expandexec += ".exe";
            if (!gSystem->AccessPathName(expandexec)) {
               exec = expandexec;
               return kTRUE;
            }
         }
      }
      exec = backup;
      return kFALSE;
   }
   gSystem->ExpandPathName(spath);
   if (KVBase::FindFile(spath.Data(), exec))
      return kTRUE;
   if (!backup.EndsWith(".exe")) {
      backup += ".exe";
      if (KVBase::FindFile(spath.Data(), backup)) {
         exec = backup;
         return kTRUE;
      }
   }
   exec = backup2;
   return kFALSE;
}
 
 
 
 
 
const Char_t* KVBase::FindFile(const Char_t* search, TString& wfil)
{
   //Backwards compatible fix for `TSystem::FindFile` which only exists from ROOT version 5.12/00 onwards.
   //Use this method as a replacement for `gSystem->FindFile` (same arguments)
#ifdef __WITHOUT_TSYSTEM_FINDFILE
   Char_t* result = gSystem->Which(search, wfil.Data());
   if (result) {
      wfil = result;
      delete[]result;
   }
   else {
      wfil = "";
   }
   return wfil.Data();
#else
   return gSystem->FindFile(search, wfil);
#endif
}
 
 
 
 
 
Bool_t KVBase::FindClassSourceFiles(const KVString& class_name, KVString& imp_file, KVString& dec_file, const KVString& dir_name)
{
   //Look for the source files corresponding to `class_name`
   //i.e. taking class_name as a base, we look for one of
   //
   //~~~~~~~
   //class_name.C,class_name.cpp,class_name.cxx
   //~~~~~~~
   //
   //and one of
   //
   //~~~~~~~
   //class_name.h,class_name.hh,class_name.H
   //~~~~~~~
   //
   //By default we look in the current working directory, unless argument `dir_name`
   //is given
   //
   //If found, the names of the two files are written in `imp_file` and
   //`dec_file`
 
   KVNameValueList impl_alt;
   int i = 0;
   impl_alt.SetValue("%s.C", i);
   impl_alt.SetValue("%s.cpp", i);
   impl_alt.SetValue("%s.cxx", i);
   KVNameValueList decl_alt;
   decl_alt.SetValue("%s.h", i);
   decl_alt.SetValue("%s.hh", i);
   decl_alt.SetValue("%s.H", i);
 
   TString _dir_name = dir_name;
   KVSystemDirectory dir("LocDir", _dir_name);
   TList* lf = dir.GetListOfFiles();
   Bool_t ok_imp, ok_dec;
   ok_imp = ok_dec = kFALSE;
 
   //look for implementation file
   for (i = 0; i < impl_alt.GetNpar(); i++) {
      if (lf->FindObject(Form(impl_alt.GetParameter(i)->GetName(), class_name.Data()))) {
         imp_file = Form(impl_alt.GetParameter(i)->GetName(), class_name.Data());
         ok_imp = kTRUE;
      }
   }
   //look for header file
   for (i = 0; i < decl_alt.GetNpar(); i++) {
      if (lf->FindObject(Form(decl_alt.GetParameter(i)->GetName(), class_name.Data()))) {
         dec_file = Form(decl_alt.GetParameter(i)->GetName(), class_name.Data());
         ok_dec = kTRUE;
      }
   }
   return (ok_imp && ok_dec);
}
 
 
 
 
 
const Char_t* KVBase::GetPluginURI(const Char_t* base, const Char_t* derived)
{
   //Inverse of `gPluginMgr->FindHandler(const Char_t* base, const Char_t* uri)`
   //
   //Given a base class `base` and a derived class `derived`, we search `gEnv` to find the
   //URI corresponding to this plugin.
   //
   //Example: given a plugin such as
   //
   //~~~~~~~~
   //Plugin.KVIDTelescope:      ^PHOS$           KVIDPhoswich         KVIndra         "KVIDPhoswich()"
   //~~~~~~~~
   //
   //then calling `KVBase::GetPluginURI("KVIDTelescope", "KVIDPhoswich")` will return `"PHOS"`.
   //
   //Most of the code is copied from `TPluginManager::LoadHandlersFromEnv`
 
   TIter next(gEnv->GetTable());
   TEnvRec* er;
   static TString tmp;
 
   while ((er = (TEnvRec*) next())) {
      const char* s;
      if ((s = strstr(er->GetName(), "Plugin."))) {
         // use s, i.e. skip possible OS and application prefix to Plugin.
         // so that GetValue() takes properly care of returning the value
         // for the specified OS and/or application
         const char* val = gEnv->GetValue(s, (const char*)0);
         if (val) {
            Int_t cnt = 0;
            s += 7;
            //is it the right base class ?
            if (strcmp(s, base)) continue;  //skip to next env var if not right base
 
            char* v = StrDup(val);
            while (1) {
               TString regexp = strtok(!cnt ? v : 0, "; ");
               if (regexp.IsNull()) break;
               TString clss   = strtok(0, "; ");
               if (clss.IsNull()) break;
               TString plugin = strtok(0, "; ");
               if (plugin.IsNull()) break;
               TString ctor = strtok(0, ";\"");
               if (!ctor.Contains("("))
                  ctor = strtok(0, ";\"");
               if (clss == derived) {
                  //found the required plugin
                  //we remove the 'regexp' operator '^' from the beginning
                  //and '$' from the end of the URI, if necessary
                  if (regexp.MaybeRegexp()) {
                     regexp.Remove(TString::kBoth, '^');
                     regexp.Remove(TString::kBoth, '$');
                  }
                  tmp = regexp;
                  delete [] v;
                  return tmp.Data();
               }
               cnt++;
            }
            delete [] v;
         }
      }
   }
   tmp = "";
   return tmp;
}
 
 
 
 
 
const Char_t* KVBase::GetListOfPlugins(const Char_t* base)
{
   // Return whitespace-separated list of all plugin classes defined for
   // the given base class.
   //
   // E.g. if plugins exist for BaseClass:
   //
   //  Plugin.BaseClass:    URI     PluginClass     PluginLibrary    "PluginClassConstructor(arguments)"
   //  +Plugin.BaseClass:    URI2     PluginClass2     PluginLibrary2    "PluginClass2Constructor(arguments)"
   //
   // then KVBase::GetListOfPlugins("BaseClass") will return "PluginClass PluginClass2"
   //
   // Most of the code is copied from `TPluginManager::LoadHandlersFromEnv`
 
   TIter next(gEnv->GetTable());
   TEnvRec* er;
   static TString tmp;
   tmp = "";
   while ((er = (TEnvRec*) next())) {
      const char* s;
      if ((s = strstr(er->GetName(), "Plugin."))) {
         // use s, i.e. skip possible OS and application prefix to Plugin.
         // so that GetValue() takes properly care of returning the value
         // for the specified OS and/or application
         const char* val = gEnv->GetValue(s, (const char*)0);
         if (val) {
            Int_t cnt = 0;
            s += 7;
            //is it the right base class ?
            if (strcmp(s, base)) continue;  //skip to next env var if not right base
 
            char* v = StrDup(val);
            while (1) {
               TString regexp = strtok(!cnt ? v : 0, "; ");
               if (regexp.IsNull()) break;
               TString clss   = strtok(0, "; ");
               if (clss.IsNull()) break;
               TString plugin = strtok(0, "; ");
               if (plugin.IsNull()) break;
               TString ctor = strtok(0, ";\"");
               if (!ctor.Contains("("))
                  ctor = strtok(0, ";\"");
               tmp += clss;
               tmp += " ";
               cnt++;
            }
            delete [] v;
         }
      }
   }
   //remove final trailing whitespace
   tmp.Remove(TString::kTrailing, ' ');
   return tmp;
}
 
 
 
 
const Char_t* KVBase::GetListOfPluginURIs(const Char_t* base)
{
   // For a given base class, return a whitespace-separated list of plugin identifiers
   // which are known/defined.
   // E.g. if plugins exist for BaseClass:
   //
   //  Plugin.BaseClass:    URI     PluginClass     PluginLibrary    "PluginClassConstructor(arguments)"
   //  +Plugin.BaseClass:    URI2     PluginClass2     PluginLibrary2    "PluginClass2Constructor(arguments)"
   //
   // then KVBase::GetListOfPluginURIs("BaseClass") will return "URI URI2"
 
   static TString tmp;
   KVString plugs = KVBase::GetListOfPlugins(base);
   plugs.Begin(" ");
   tmp = "";
   while (!plugs.End()) {
      if (tmp != "") tmp += " ";
      tmp += KVBase::GetPluginURI(base, plugs.Next());
   }
   return tmp;
}
 
 
 
 
Bool_t KVBase::IsThisAPlugin(const TString& uri, TString& base)
{
   // Returns kTRUE if 'uri' is the name of a defined plugin, in which case 'base'
   // is the name of the base class extended by this plugin.
   //
   // Most of the code is copied from `TPluginManager::LoadHandlersFromEnv`
 
   TIter next(gEnv->GetTable());
   TEnvRec* er;
   while ((er = (TEnvRec*) next())) {
      KVString ername = er->GetName();
      if (ername.BeginsWith("Plugin.")) {
         base = ername;
         base.Remove(0, 7);
         KVString erval = gEnv->GetValue(ername, "");
         erval.Begin(" ");
         while (!erval.End()) {
            if (erval.Next() == uri) return kTRUE;
         }
      }
   }
   return kFALSE;
}
 
 
 
 
 
void KVBase::ReadGUIMimeTypes()
{
   // Add to standard ROOT mime types some new ones defined in `.kvrootrc`
   // for icons associated with graphs, runs, etc. by lines such as:
   //
   //~~~~~~~~~
   //  KaliVeda.GUI.MimeTypes :   KVIDMap
   //  KaliVeda.GUI.MimeTypes.KVIDMap.Icon :   rootdb_t.xpm
   //  +KaliVeda.GUI.MimeTypes :   KVIDZAGrid
   //  KaliVeda.GUI.MimeTypes.KVIDZAGrid.Icon :   draw_t.xpm
   //~~~~~~~~~
   //
   // etc.
 
   KVString mimetypes = gEnv->GetValue("KaliVeda.GUI.MimeTypes", "");
   if (mimetypes != "") {
 
      mimetypes.Begin(" ");
      while (!mimetypes.End()) {
 
         KVString classname = mimetypes.Next(kTRUE);
         KVString icon = gEnv->GetValue(Form("KaliVeda.GUI.MimeTypes.%s.Icon", classname.Data()), "draw_t.xpm");
         KVString type = classname;
         type.ToLower();
 
         if (gClient) gClient->GetMimeTypeList()->AddType(Form("[kaliveda/%s]", type.Data()),
                  classname.Data(), icon.Data(), icon.Data(), "");
 
      }
   }
}
 
 
 
 
Bool_t KVBase::AreEqual(Double_t A, Double_t B, Long64_t maxdif)
{
   // \brief Comparison between two 64-bit floating-point values
   //
   // Returns `kTRUE` if the integer representations of the two values are within
   // `maxdif` of each other. By default `maxdif=1`, which means that we consider that `x==y` if the
   // difference between them is no greater than the precision of `Double_t`
   // variables, i.e. `4.94065645841246544e-324`
   //
   // Based on the function `AlmostEqual2sComplement(float, float, int)`
   // by Bruce Dawson http://www.cygnus-software.com/papers/comparingfloats/comparingfloats.htm
 
   union converter {
      Double_t f;
      Long64_t i;
   } zero, val1, val2;
 
   assert(maxdif > 0);
 
   if (A == B) return true;
 
   /* rustine to obtain the (64-bit) constant value 0x8000000000000000
      even on 32-bit machines (there is probably an easier way!)      */
   zero.i = 1;
   zero.f = -zero.f;
   zero.i -= 1;
 
   val1.f = A;
   val2.f = B;
   Long64_t Aint, Bint;
   Aint = val1.i;
   Bint = val2.i;
   if (Aint < 0) Aint = zero.i - Aint;
   if (Bint < 0) Bint = zero.i - Bint;
 
   Long64_t intDiff = abs(val1.i - val2.i);
 
   if (intDiff <= maxdif) return true;
 
   return false;
}
 
 
 
 
Bool_t KVBase::OpenContextMenu(const char* method, TObject* obj, const char* alt_method_name)
{
   // Open context menu for given method of object *obj.
   // By default title of menu is 'obj->ClassName()::method'
   // You can give an alternative method name in 'alt_method_name'
   // Returns kFALSE if the given method is not defined for the class of object in question.
   //
   // WARNING: even if this method returns kTRUE, this is no guarantee that the method
   // has indeed been executed. The user may have pressed the 'Cancel' button...
 
   TMethod* m = obj->IsA()->GetMethodAllAny(method);
   if (!m) {
      KVError::Warning(obj, "OpenContextMenu", "%s is not a method of %s", method, obj->ClassName());
      return kFALSE;
   }
   TString Method = alt_method_name;
   if (Method == "") Method = method;
   TContextMenu* cm = new TContextMenu(Method, Form("%s::%s", obj->ClassName(), Method.Data()));
   cm->Action(obj, m);
   delete cm;
   return kTRUE;
}
 
 
 
 
void KVBase::CombineFiles(const Char_t* file1, const Char_t* file2, const Char_t* newfilename, Bool_t keep)
{
   // STATIC method which allows to combine the contents of two ROOT files
   // (file1 and file2) into a new ROOT file (newfilename).
   // All objects from the two files will be written in the new file.
   //
   // if keep=kFALSE, the two files will be deleted after the operation
 
   ::Info("KVBase::CombineFiles", "Copying all objects from %s and %s ===> into new file %s", file1, file2, newfilename);
 
   TFileMerger file_merge;
   file_merge.AddFile(file1, kFALSE);
   file_merge.AddFile(file2, kFALSE);
   file_merge.OutputFile(newfilename);
   file_merge.Merge();
 
   // remove physical files from disk if required
   if (!keep) {
      gSystem->Unlink(file1);
      gSystem->Unlink(file2);
   }
}
 
 
 
 
TObject* KVBase::GetObject() const
{
   // Dummy method (returns NULL).
   // This method may be used in 'container' classes used with KVListView.
   // In order to open the context menu of the 'contained' object,
   // GetLabel() should return the real class of the object,
   // and this method should return its address.
   // Then call KVListView::SetUseObjLabelAsRealClass(kTRUE).
   return nullptr;
}
 
 
 
 
 
const Char_t* KVBase::GetExampleFilePath(const Char_t* library, const Char_t* namefile)
{
   // Return full path to example file for given library (="KVMultiDet", "BackTrack", etc.)
   static TString path;
   path = KVBase::GetDATADIRFilePath("examples/");
   path += library;
   path += "/";
   path += namefile;
   return path.Data();
}
 
 
 
 
void KVBase::PrintSplashScreen()
{
   // Prints welcome message and infos on version etc.
 
   cout << "/----------------------------------------------------------------------\\" << endl;
   cout << "| Welcome to KaliVeda v" << GetKVVersion() << "    gitlab.in2p3.fr/kaliveda-dev/kaliveda |" << endl;
   cout << "| (c) 2002-2026, The KaliVeda development team                         |" << endl;
   cout << "|                                                                      |" << endl;
   cout << "| Built with ROOT " << kaliveda::build_infos::KV_ROOT_VERSION << " on " << KVBase::GetKVBuildDate() << ", " << KVBase::GetKVBuildTime() << "                      |" << endl;
#ifdef WITH_GIT_INFOS
   TString gitinfo;
   gitinfo.Form("%s@%s", gitBranch(), gitCommit());
   printf("| From %-63s |\n", gitinfo.Data());
#endif
   cout << "| See https://kaliveda.in2p3.fr for help                               |" << endl;
   cout << "\\----------------------------------------------------------------------/" << endl << endl;
}
 
 
 
 
 
Double_t KVBase::ProtectedGetX(const TF1* func, Double_t val, GetX_status& status, std::optional<Double_t> xmin, std::optional<Double_t> xmax)
{
   // For a given function, \f$f(x)\f$, find a solution for the equation
   //
   //\f[
   //f(x)=y
   //\f]
   //
   // If several solutions exist, the one with the smallest \f$x\f$ value is returned.
   //
   // \param[in] xmin,xmax if xmin!=xmax, limit to the given range (default: use range of function)
   // \param[out] status takes one of the values of enum class KVBase::GetX_status:
   //    + GetX_status::ok : good solution
   //    + GetX_status::above_maximum: val is > maximum of function in given range, value returned is func->GetMaximumX(xmin,xmax) [no solution]
   //    + GetX_status::at_maximum: val is within 1.e-5 of the maximum of function, value returned is func->GetMaximumX() [solution corresponds to maximum]
   //    + GetX_status::below_minimum: val is < minimum of function, value returned is func->GetMinimumX() [no solution]
   //    + GetX_status::at_minimum: val is within 1.e-5 of the minimum of function, value returned is func->GetMinimumX() [solution corresponds to minimum]
 
   auto test_val = [](double x, double y){ return TMath::AreEqualAbs(x,y,1.e-5); };
   bool at_min_max = false;
   if(xmin || xmax)
   {
      if(!(xmin && xmax))
      {
         double _xmin,_xmax;
         func->GetRange(_xmin,_xmax);
         if(!xmin) xmin = _xmin;
         else xmax = _xmax;
      }
      auto fmax = func->GetMaximum(*xmin,*xmax);
      if (std::fdim(val,fmax) || (at_min_max=test_val(val,fmax))) {
         status = at_min_max ? GetX_status::at_maximum : GetX_status::above_maximum;
         return func->GetMaximumX(*xmin,*xmax);
      }
      auto fmin = func->GetMinimum(*xmin,*xmax);
      if (std::fdim(fmin,val) || (at_min_max=test_val(val,fmin))) {
         status = at_min_max ? GetX_status::at_minimum : GetX_status::below_minimum;
         return func->GetMinimumX(*xmin,*xmax);
      }
      status = GetX_status::ok;
      return func->GetX(val,*xmin,*xmax);
   }
   else
   {
      auto fmax = func->GetMaximum();
      if (std::fdim(val,fmax) || (at_min_max=test_val(val,fmax))) {
         status = at_min_max ? GetX_status::at_maximum : GetX_status::above_maximum;
         return func->GetMaximumX();
      }
      auto fmin = func->GetMinimum();
      if (std::fdim(fmin,val) || (at_min_max=test_val(val,fmin))) {
         status = at_min_max ? GetX_status::at_minimum : GetX_status::below_minimum;
         return func->GetMinimumX();
      }
      status = GetX_status::ok;
      return func->GetX(val);
   }
   return 0;
}
 
 
 
 
Double_t KVBase::ProtectedGetX(const TF1& func, Double_t val, GetX_status& status, std::optional<Double_t> xmin, std::optional<Double_t> xmax)
{
   return ProtectedGetX(&func, val, status, xmin, xmax);
}
 
 
 
 
void KVBase::Deprecated(const char* where, const char* advice)
{
   // Print a message to indicate when the called method is deprecated and give advice how to do better
   //
   // Don't call directly: use the macro Deprecate(advice) which will automatically fill in the method name
   // (see KVMacros.h)
 
   printf("Warning in <%s>: Method is deprecated in v%s and will be removed in future.\n%s\n",
          where, KVBase::GetKVVersion(), advice);
}
 
 
 
 
std::optional<TString> KVBase::AbsoluteUnixPath(const TString& _path)
{
   // Turn any arbitrary unix-style path into an absolute path, working around limitations of
   // TSystem::ExpandPathName() (which doesn't handle '.' or '..')
   //
   //   - if the path is not absolute but can be accessed, then it is a valid relative path from current working directory:
   //      we prefix it with the current absolute working directory;
   //   - if the path contains '.' (just a single dot, not 2!), we replace with the current working directory;
   //   - if the path contains '..' (possibly more than once), we work out the equivalent absolute path.
   //
   // \returns std::nullopt if expansion fails
 
   TString path(_path);
   gSystem->ExpandPathName(path);
   if (!gSystem->IsAbsoluteFileName(path)) {
      if (!gSystem->AccessPathName(path)) {
         // path is valid starting from current directory: prefix it
         path.Prepend(TString(gSystem->WorkingDirectory()) + "/");
      }
      else {
         KVError::Error(KVBase{}, "AbsoluteUnixPath", "path is not absolute and not reachable from $(PWD)=%s: %s",
                 gSystem->WorkingDirectory(), path.Data());
         return {};
      }
   }
   else if (gSystem->AccessPathName(path)) {
      KVError::Error(KVBase{}, "AbsoluteUnixPath", "absolute path is not valid: %s", path.Data());
      return {};
   }
   // if path has a trailing '/', remove it here to avoid losing the last part of the path
   // due to gSystem->BaseName() returning "" in this case.
   Bool_t trailing_slash = false;
   if (path.EndsWith("/")) {
      trailing_slash = true;
      while (path.EndsWith("/")) {
         path.Remove(path.Length() - 1, 1);
      }
   }
   // split into parts in order to deal with '..' and '.'
   std::vector<TString> parts;
   do {
      parts.push_back(gSystem->BaseName(path));
      path = gSystem->DirName(path);
   }
   while (path != "/");
   int nparts = parts.size() - 1;
   int end_path = 0;
   std::vector<TString> new_parts(parts.size());
   while (nparts >= 0) {
      if (parts[nparts] == "..")
         --end_path;
      else if (parts[nparts] != ".") {
         new_parts[end_path] = parts[nparts];
         ++end_path;
      }
      --nparts;
   }
   // stick all parts back together
   path = "/";
   for (int i = 0; i < end_path; ++i) {
      path += new_parts[i];
      if (i < end_path - 1)
         path += "/";
   }
   if (trailing_slash)
      path += "/";
   return path;
}