LCOV - code coverage report
Current view: top level - core - CLTool.cpp (source / functions) Hit Total Coverage
Test: plumed test coverage Lines: 85 100 85.0 %
Date: 2024-10-11 08:09:47 Functions: 9 10 90.0 %

          Line data    Source code
       1             : /* +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
       2             :    Copyright (c) 2012-2023 The plumed team
       3             :    (see the PEOPLE file at the root of the distribution for a list of names)
       4             : 
       5             :    See http://www.plumed.org for more information.
       6             : 
       7             :    This file is part of plumed, version 2.
       8             : 
       9             :    plumed is free software: you can redistribute it and/or modify
      10             :    it under the terms of the GNU Lesser General Public License as published by
      11             :    the Free Software Foundation, either version 3 of the License, or
      12             :    (at your option) any later version.
      13             : 
      14             :    plumed is distributed in the hope that it will be useful,
      15             :    but WITHOUT ANY WARRANTY; without even the implied warranty of
      16             :    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      17             :    GNU Lesser General Public License for more details.
      18             : 
      19             :    You should have received a copy of the GNU Lesser General Public License
      20             :    along with plumed.  If not, see <http://www.gnu.org/licenses/>.
      21             : +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ */
      22             : #include "CLTool.h"
      23             : 
      24             : namespace PLMD {
      25             : 
      26             : Keywords CLToolOptions::emptyKeys;
      27             : 
      28        2345 : CLToolOptions::CLToolOptions(const std::string &name):
      29        2345 :   line(1,name),
      30        2345 :   keys(emptyKeys)
      31             : {
      32        2345 : }
      33             : 
      34        2345 : CLToolOptions::CLToolOptions(const CLToolOptions& co, const Keywords& k):
      35        2345 :   line(co.line),
      36        2345 :   keys(k)
      37             : {
      38        2345 : }
      39             : 
      40       45149 : void CLTool::registerKeywords( Keywords& keys ) {
      41       90298 :   keys.addFlag("--help/-h",false,"print this help");
      42       45149 : }
      43             : 
      44        2345 : CLTool::CLTool(const CLToolOptions& co ):
      45        2345 :   name(co.line[0]),
      46        2345 :   keywords(co.keys),
      47        2345 :   inputdata(unset)
      48             : {
      49        2345 : }
      50             : 
      51       14795 : void CLTool::parseFlag( const std::string&key, bool&t ) {
      52       14795 :   plumed_massert(keywords.exists(key),"keyword " + key + " has not been registered");
      53       29590 :   plumed_massert(keywords.style(key,"flag"),"keyword " + key + " has not been registered as a flag");
      54           0 :   plumed_assert(inputData.count(key)>0);
      55       29590 :   if( inputData[key]=="true") t=true;
      56       26438 :   else if( inputData[key]=="false") t=false;
      57           0 :   else plumed_error();
      58       14795 : }
      59             : 
      60        2285 : bool CLTool::readInput( int argc, char**argv, FILE* in, FILE*out ) {
      61        2285 :   plumed_massert( inputdata!=unset,"You have not specified where your tool reads its input. "
      62             :                   "If it is from the command line (like driver) add inputdata=commandline to the "
      63             :                   "tools constructor. If it reads everything from an input file (like simplemd) "
      64             :                   "add inputdata=ifile to the tools constructor");
      65        2285 :   if(inputdata==commandline) return readCommandLineArgs( argc, argv, out );
      66          52 :   if(inputdata==ifile) return readInputFile( argc, argv, in, out );
      67             :   return true;
      68             : }
      69             : 
      70        2233 : bool CLTool::readCommandLineArgs( int argc, char**argv, FILE*out ) {
      71        2233 :   plumed_assert(inputdata==commandline);
      72        2233 :   std::string prefix(""), a(""), thiskey;
      73             : 
      74             :   // Set all flags to default false
      75       44957 :   for(unsigned k=0; k<keywords.size(); ++k) {
      76       42724 :     thiskey=keywords.get(k);
      77      102766 :     if( keywords.style(thiskey,"flag") ) inputData.insert(std::pair<std::string,std::string>(thiskey,"false"));
      78             :   }
      79             : 
      80             :   // Read command line arguments
      81             :   bool printhelp=false;
      82       10523 :   for(int i=1; i<argc; i++) {
      83       16580 :     a=prefix+argv[i];
      84        8290 :     if(a.length()==0) continue;
      85       16580 :     if(a=="-h" || a=="--help") {
      86             :       printhelp=true;
      87             :     } else {
      88             :       bool found=false;
      89      274673 :       for(unsigned k=0; k<keywords.size(); ++k) {
      90      266383 :         thiskey=keywords.get(k);
      91      532766 :         if( keywords.style(thiskey,"flag") ) {
      92       51589 :           if( a==thiskey ) { found=true; inputData[thiskey]="true"; }
      93             :         } else {
      94      214794 :           if( a==thiskey ) {
      95        3100 :             prefix=thiskey+"="; found=true;
      96        6200 :             inputData.insert(std::pair<std::string,std::string>(thiskey,""));
      97      423388 :           } else if(Tools::startWith(a,thiskey+"=")) {
      98        3616 :             a.erase(0,a.find("=")+1); prefix=""; found=true;
      99             :             if(inputData.count(thiskey)==0) {
     100        1034 :               inputData.insert(std::pair<std::string,std::string>(thiskey,a));
     101             :             } else {
     102        3099 :               inputData[thiskey]=a;
     103             :             }
     104             :           }
     105             :         }
     106             :       }
     107        8290 :       if(!found) {
     108           0 :         std::fprintf(stderr,"ERROR in input for command line tool %s : %s option is unknown \n\n", name.c_str(), a.c_str() );
     109             :         std::fprintf(out,"Usage: %s < inputFile \n", name.c_str() );
     110             :         std::fprintf(out,"inputFile should contain one directive per line.  The directives should come from amongst the following\n\n");
     111           0 :         keywords.print( out );
     112             :         printhelp=true;
     113             :       }
     114             :     }
     115        8290 :     if(printhelp) break;
     116             :   }
     117             : 
     118        2233 :   if(!printhelp) setRemainingToDefault(out);
     119             : 
     120        2233 :   if(printhelp) {
     121             :     std::fprintf(out,"Usage: %s [options] \n\n", name.c_str() );
     122           0 :     keywords.print( out );
     123             :   }
     124             : 
     125        2233 :   return !printhelp;
     126             : }
     127             : 
     128        2285 : void CLTool::setRemainingToDefault(FILE* out) {
     129             :   std::string def, thiskey;
     130       46008 :   for(unsigned k=0; k<keywords.size(); ++k) {
     131       43723 :     thiskey=keywords.get(k);
     132       87446 :     if( keywords.style(thiskey,"compulsory") ) {
     133             :       if( inputData.count(thiskey)==0 ) {
     134        2728 :         if( keywords.getDefaultValue(thiskey,def) ) {
     135        1364 :           plumed_assert( def.length()>0 );
     136        2728 :           inputData.insert(std::pair<std::string,std::string>(thiskey,def));
     137             :         } else {
     138             :           std::fprintf(out,"ERROR : argument %s is compulsory. Use --help option for help\n",thiskey.c_str() );
     139           0 :           plumed_error();
     140             :         }
     141             :       }
     142             :     }
     143             :   }
     144        2285 : }
     145             : 
     146          52 : bool CLTool::readInputFile( int argc, char**argv, FILE* in, FILE*out ) {
     147          52 :   plumed_assert(inputdata==ifile);
     148             : 
     149             :   // Check if use is just asking for help
     150             :   std::string a;
     151          95 :   for(int i=1; i<argc; i++) {
     152          43 :     a=argv[i];
     153          43 :     if(a.length()==0) continue;
     154          86 :     if(a=="-h" || a=="--help") {
     155             :       std::fprintf(out,"Usage: %s < inputFile \n", name.c_str() );
     156             :       std::fprintf(out,"inputFile should contain one directive per line.  The directives should come from amongst the following\n\n");
     157           0 :       keywords.print( out );
     158             :       return false;
     159             :     }
     160             :   }
     161             : 
     162             :   FILE* mystdin=in;
     163          52 :   if(argc==2) {
     164          43 :     mystdin=fopen(argv[1],"r");
     165          43 :     if(!mystdin) {
     166           0 :       std::fprintf(stderr,"ERROR: cannot open file %s\n\n",argv[1]);
     167             :       std::fprintf(out,"Usage: %s < inputFile \n", name.c_str() );
     168             :       std::fprintf(out,"inputFile should contain one directive per line.  The directives should come from amongst the following\n\n");
     169           0 :       keywords.print( out );
     170             :       return false;
     171             :     }
     172             :   }
     173             : 
     174          52 :   plumed_assert(mystdin);
     175             : 
     176             :   char buffer[256]; std::string line; line.resize(256);
     177         864 :   while(fgets(buffer,256,mystdin)) {
     178             :     line=buffer;
     179       24516 :     for(unsigned i=0; i<line.length(); ++i) if(line[i]=='#' || line[i]=='\n') line.erase(i);
     180         812 :     Tools::stripLeadingAndTrailingBlanks( line );
     181         812 :     if(line.length()==0) continue;
     182         775 :     std::sscanf(line.c_str(),"%255s",buffer);
     183         775 :     std::string keyword=buffer; bool found=false;
     184       16142 :     for(unsigned i=0; i<keywords.size(); ++i) {
     185       15367 :       std::string thiskey=keywords.get(i);
     186       15367 :       if(thiskey==keyword) {
     187             :         found=true;
     188         775 :         std::size_t keypos=line.find_first_of(keyword)+keyword.length();
     189        1550 :         inputData.insert(std::pair<std::string,std::string>(thiskey,line.substr(keypos)));
     190         775 :         Tools::stripLeadingAndTrailingBlanks( inputData[thiskey] );
     191             :       }
     192             :     }
     193         775 :     if(!found) {
     194           0 :       std::fprintf(stderr,"ERROR in input for command line tool %s : unknown keyword %s found in input file\n\n",name.c_str(),keyword.c_str());
     195             :       std::fprintf(out,"Usage: %s < inputFile \n", name.c_str() );
     196             :       std::fprintf(out,"inputFile should contain one directive per line.  The directives should come from amongst the following\n\n");
     197           0 :       keywords.print( out );
     198           0 :       fclose(mystdin);
     199             :       return false;
     200             :     }
     201             :   }
     202             : 
     203          52 :   if(argc==2) fclose(mystdin);
     204          52 :   setRemainingToDefault(out);
     205             :   return true;
     206             : }
     207             : 
     208           0 : [[noreturn]] void CLTool::error( const std::string& msg ) {
     209           0 :   std::fprintf(stderr,"ERROR : in input for command line tool %s : %s\n",name.c_str(),msg.c_str());
     210           0 :   plumed_error();
     211             : }
     212             : 
     213             : }

Generated by: LCOV version 1.15