/* This file is part of solidity. solidity 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. solidity 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 solidity. If not, see . */ // SPDX-License-Identifier: GPL-3.0 /** * @author Lefteris * @date 2014 * Solidity command line interface. */ #pragma once #include #include #include #include #include #include #include namespace solidity::frontend { class CommandLineInterface { public: explicit CommandLineInterface(CommandLineOptions const& _options = CommandLineOptions{}): m_options(_options) {} /// Parse command line arguments and return false if we should not continue bool parseArguments(int _argc, char const* const* _argv); /// Parse the files and create source code objects bool processInput(); /// Perform actions on the input depending on provided compiler arguments /// @returns true on success. bool actOnInput(); CommandLineOptions const& options() const { return m_options; } FileReader const& fileReader() const { return m_fileReader; } private: bool compile(); bool link(); void writeLinkedFiles(); /// @returns the ``// -> name`` hint for library placeholders. static std::string libraryPlaceholderHint(std::string const& _libraryName); /// @returns the full object with library placeholder hints in hex. static std::string objectWithLinkRefsHex(evmasm::LinkerObject const& _obj); bool assemble( yul::AssemblyStack::Language _language, yul::AssemblyStack::Machine _targetMachine, bool _optimize, std::optional _yulOptimiserSteps = std::nullopt ); void outputCompilationResults(); void handleCombinedJSON(); void handleAst(); void handleBinary(std::string const& _contract); void handleOpcode(std::string const& _contract); void handleIR(std::string const& _contract); void handleIROptimized(std::string const& _contract); void handleEwasm(std::string const& _contract); void handleBytecode(std::string const& _contract); void handleSignatureHashes(std::string const& _contract); void handleMetadata(std::string const& _contract); void handleABI(std::string const& _contract); void handleNatspec(bool _natspecDev, std::string const& _contract); void handleGasEstimation(std::string const& _contract); void handleStorageLayout(std::string const& _contract); /// Reads the content of input files specified on the command line and passes them to FileReader. /// @return false if there are no input files or input files cannot be read. bool readInputFilesAndConfigureFileReader(); /// Tries to read @ m_sourceCodes as a JSONs holding ASTs /// such that they can be imported into the compiler (importASTs()) /// (produced by --combined-json ast,compact-format /// or standard-json output std::map parseAstFromInput(); /// Create a file in the given directory /// @arg _fileName the name of the file /// @arg _data to be written void createFile(std::string const& _fileName, std::string const& _data); /// Create a json file in the given directory /// @arg _fileName the name of the file (the extension will be replaced with .json) /// @arg _json json string to be written void createJson(std::string const& _fileName, std::string const& _json); bool m_error = false; ///< If true, some error occurred. FileReader m_fileReader; std::unique_ptr m_compiler; CommandLineOptions m_options; }; }