cppcheck/cli/cppcheckexecutor.h

203 lines
5.8 KiB
C
Raw Normal View History

2008-12-18 22:28:57 +01:00
/*
* Cppcheck - A tool for static C/C++ code analysis
2023-01-28 10:16:34 +01:00
* Copyright (C) 2007-2023 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"
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:
friend class TestSuppressions;
2008-12-18 22:28:57 +01:00
/**
* Constructor
*/
CppCheckExecutor() = default;
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
*/
void reportOut(const std::string &outmsg, Color c = Color::Reset) override;
2009-02-01 19:00:47 +01:00
/** xml output of errors */
void reportErr(const ErrorMessage &msg) override;
void reportProgress(const std::string &filename, const char stage[], const std::size_t value) override;
/**
* @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 std::string& basepath, const char* filename);
/**
* Execute a shell command and read the output from it. Returns exitcode of the executed command,.
*/
static int executeCommand(std::string exe, std::vector<std::string> args, 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.
*
* @param settings the settings to store into
* @param argc argc from main()
* @param argv argv from main()
* @return false when errors are found in the input
*/
bool parseFromArgs(Settings &settings, int argc, const char* const argv[]);
private:
static bool reportSuppressions(const Settings &settings, bool unusedFunctionCheckEnabled, const std::map<std::string, std::size_t> &files, ErrorLogger& errorLogger);
/**
* Wrapper around check_internal
* - installs optional platform dependent signal handling
*
* @param cppcheck cppcheck instance
**/
int check_wrapper(CppCheck& cppcheck);
/**
2021-08-07 20:51:18 +02:00
* Starts the checking.
*
* @param cppcheck cppcheck instance
* @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.
*/
int check_internal(CppCheck& cppcheck);
/**
* @brief Load libraries
* @param settings Settings
* @return Returns true if successful
*/
bool loadLibraries(Settings& settings);
/**
* @brief Write the checkers report
*/
void writeCheckersReport(const Settings& settings) const;
/**
* Pointer to current settings; set while check() is running for reportError().
*/
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
*/
std::ofstream* mErrorOutput{};
/**
* Checkers that has been executed
*/
std::set<std::string> mActiveCheckers;
/**
* True if there are critical errors
*/
std::string mCriticalErrors;
2008-12-18 22:28:57 +01:00
};
#endif // CPPCHECKEXECUTOR_H