cppcheck/cli/cppcheckexecutor.h

215 lines
6.2 KiB
C
Raw Normal View History

2008-12-18 22:28:57 +01:00
/*
* Cppcheck - A tool for static C/C++ code analysis
2022-02-05 11:45:17 +01:00
* Copyright (C) 2007-2022 Cppcheck team.
2008-12-18 22:28:57 +01:00
*
* 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 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
2008-12-18 22:28:57 +01:00
*/
#ifndef CPPCHECKEXECUTOR_H
#define CPPCHECKEXECUTOR_H
2021-07-08 21:21:35 +02:00
#include "color.h"
#include "config.h"
2008-12-18 22:28:57 +01:00
#include "errorlogger.h"
2017-05-27 04:33:47 +02:00
#include <cstdio>
#include <ctime>
#include <iosfwd>
2017-05-27 04:33:47 +02:00
#include <map>
#include <set>
#include <string>
#include <vector>
2008-12-18 22:28:57 +01:00
class CppCheck;
class Library;
2017-05-27 04:33:47 +02:00
class Settings;
2008-12-18 22:28:57 +01:00
/**
* This class works as an example of how CppCheck can be used in external
* programs without very little knowledge of the internal parts of the
* program itself. If you wish to use cppcheck e.g. as a part of IDE,
* just rewrite this class for your needs and possibly use other methods
* from CppCheck class instead the ones used here.
*/
2011-10-13 20:53:06 +02:00
class CppCheckExecutor : public ErrorLogger {
2008-12-18 22:28:57 +01:00
public:
/**
* Constructor
*/
CppCheckExecutor();
CppCheckExecutor(const CppCheckExecutor &) = delete;
void operator=(const CppCheckExecutor&) = delete;
2008-12-18 22:28:57 +01:00
/**
* Destructor
*/
~CppCheckExecutor() OVERRIDE;
2008-12-18 22:28:57 +01:00
/**
* Starts the checking.
*
* @param argc from main()
* @param argv from main()
* @return EXIT_FAILURE if arguments are invalid or no input files
* were found.
* If errors are found and --error-exitcode is used,
* given value is returned instead of default 0.
* If no errors are found, 0 is returned.
2008-12-18 22:28:57 +01:00
*/
int check(int argc, const char* const argv[]);
2008-12-18 22:28:57 +01:00
/**
* Information about progress is directed here. This should be
* called by the CppCheck class only.
*
* @param outmsg Progress message e.g. "Checking main.cpp..."
2008-12-18 22:28:57 +01:00
*/
2021-07-08 21:21:35 +02:00
void reportOut(const std::string &outmsg, Color c = Color::Reset) OVERRIDE;
2009-02-01 19:00:47 +01:00
/** xml output of errors */
2020-05-23 07:16:49 +02:00
void reportErr(const ErrorMessage &msg) OVERRIDE;
2019-01-12 15:42:50 +01:00
void reportProgress(const std::string &filename, const char stage[], const std::size_t value) OVERRIDE;
/**
* Output information messages.
*/
2020-05-23 07:16:49 +02:00
void reportInfo(const ErrorMessage &msg) OVERRIDE;
2020-01-18 07:25:39 +01:00
void bughuntingReport(const std::string &str) OVERRIDE;
2019-12-27 19:05:10 +01:00
/**
* Information about how many files have been checked
*
* @param fileindex This many files have been checked.
* @param filecount This many files there are in total.
* @param sizedone The sum of sizes of the files checked.
* @param sizetotal The total sizes of the files.
*/
static void reportStatus(std::size_t fileindex, std::size_t filecount, std::size_t sizedone, std::size_t sizetotal);
/**
* @param exceptionOutput Output file
*/
static void setExceptionOutput(FILE* exceptionOutput);
/**
2021-08-07 20:51:18 +02:00
* @return file name to be used for output from exception handler. Has to be either "stdout" or "stderr".
*/
static FILE* getExceptionOutput();
/**
2021-08-07 20:51:18 +02:00
* Tries to load a library and prints warning/error messages
* @return false, if an error occurred (except unknown XML elements)
*/
static bool tryLoadLibrary(Library& destination, const char* basepath, const char* filename);
/**
* Execute a shell command and read the output from it. Returns true if command terminated successfully.
*/
static bool executeCommand(std::string exe, std::vector<std::string> args, const std::string &redirect, std::string *output_);
protected:
/**
* Helper function to print out errors. Appends a line change.
* @param errmsg String printed to error stream
*/
void reportErr(const std::string &errmsg);
/**
* @brief Parse command line args and get settings and file lists
* from there.
*
2012-07-08 19:32:33 +02:00
* @param cppcheck cppcheck instance
* @param argc argc from main()
* @param argv argv from main()
* @return false when errors are found in the input
*/
bool parseFromArgs(CppCheck *cppcheck, int argc, const char* const argv[]);
/**
* Helper function to supply settings. This can be used for testing.
* @param settings Reference to an Settings instance
*/
2017-08-21 21:13:01 +02:00
void setSettings(const Settings &settings);
private:
/**
* Wrapper around check_internal
* - installs optional platform dependent signal handling
*
* @param cppcheck cppcheck instance
* @param argc from main()
* @param argv from main()
**/
2014-04-07 20:39:19 +02:00
int check_wrapper(CppCheck& cppcheck, int argc, const char* const argv[]);
/**
2021-08-07 20:51:18 +02:00
* Starts the checking.
*
* @param cppcheck cppcheck instance
* @param argc from main()
* @param argv from main()
* @return EXIT_FAILURE if arguments are invalid or no input files
* were found.
* If errors are found and --error-exitcode is used,
* given value is returned instead of default 0.
* If no errors are found, 0 is returned.
*/
2014-04-07 20:39:19 +02:00
int check_internal(CppCheck& cppcheck, int argc, const char* const argv[]);
/**
* Pointer to current settings; set while check() is running.
*/
2019-07-15 18:24:27 +02:00
const Settings* mSettings;
/**
* Used to filter out duplicate error messages.
*/
2019-07-15 18:29:09 +02:00
std::set<std::string> mShownErrors;
/**
* Filename associated with size of file
*/
2019-07-15 18:21:52 +02:00
std::map<std::string, std::size_t> mFiles;
/**
* Report progress time
*/
std::time_t mLatestProgressOutputTime;
2011-01-16 17:18:09 +01:00
/**
* Output file name for exception handler
*/
static FILE* mExceptionOutput;
/**
2017-05-30 15:53:54 +02:00
* Error output
*/
2019-07-15 18:16:07 +02:00
std::ofstream *mErrorOutput;
2019-12-27 19:05:10 +01:00
/**
2020-01-14 21:17:07 +01:00
* Bug hunting report
2019-12-27 19:05:10 +01:00
*/
2020-01-14 21:17:07 +01:00
std::ostream *mBugHuntingReport;
2019-12-27 19:05:10 +01:00
2011-01-16 17:18:09 +01:00
/**
* Has --errorlist been given?
*/
2019-07-15 18:31:12 +02:00
bool mShowAllErrors;
2008-12-18 22:28:57 +01:00
};
#endif // CPPCHECKEXECUTOR_H