物联网嵌入式开发-ESP32通过USB口实现板载SD卡实现U盘功能（ESP-IDF +VSCode编程）.rar

ceedling-gcov ============= # Plugin Overview Plugin for integrating GNU GCov code coverage tool into Ceedling projects. Currently only designed for the gcov command (like LCOV for example). In the future we could configure this to work with other code coverage tools. This plugin currently uses [gcovr](https://www.gcovr.com/) and / or [ReportGenerator](https://danielpalme.github.io/ReportGenerator/) as utilities to generate HTML, XML, JSON, or Text reports. The normal gcov plugin _must_ be run first for these reports to generate. ## Installation gcovr can be installed via pip like so: ```sh pip install gcovr ``` ReportGenerator can be installed via .NET Core like so: ```sh dotnet tool install -g dotnet-reportgenerator-globaltool ``` It is not required to install both `gcovr` and `ReportGenerator`. Either utility may be installed to create reports. ## Configuration The gcov plugin supports configuration options via your `project.yml` provided by Ceedling. ### Utilities Gcovr and / or ReportGenerator may be enabled to create coverage reports. ```yaml :gcov: :utilities: - gcovr # Use gcovr to create the specified reports (default). - ReportGenerator # Use ReportGenerator to create the specified reports. ``` ### Reports Various reports are available and may be enabled with the following configuration item. See the specific report sections in this README for additional options and information. All generated reports will be found in `build/artifacts/gcov`. ```yaml :gcov: # Specify one or more reports to generate. # Defaults to HtmlBasic. :reports: # Make an HTML summary report. # Supported utilities: gcovr, ReportGenerator - HtmlBasic # Make an HTML report with line by line coverage of each source file. # Supported utilities: gcovr, ReportGenerator - HtmlDetailed # Make a Text report, which may be output to the console with gcovr or a file in both gcovr and ReportGenerator. # Supported utilities: gcovr, ReportGenerator - Text # Make a Cobertura XML report. # Supported utilities: gcovr, ReportGenerator - Cobertura # Make a SonarQube XML report. # Supported utilities: gcovr, ReportGenerator - SonarQube # Make a JSON report. # Supported utilities: gcovr - JSON # Make a detailed HTML report with CSS and JavaScript included in every HTML page. Useful for build servers. # Supported utilities: ReportGenerator - HtmlInline # Make a detailed HTML report with a light theme and CSS and JavaScript included in every HTML page for Azure DevOps. # Supported utilities: ReportGenerator - HtmlInlineAzure # Make a detailed HTML report with a dark theme and CSS and JavaScript included in every HTML page for Azure DevOps. # Supported utilities: ReportGenerator - HtmlInlineAzureDark # Make a single HTML file containing a chart with historic coverage information. # Supported utilities: ReportGenerator - HtmlChart # Make a detailed HTML report in a single file. # Supported utilities: ReportGenerator - MHtml # Make SVG and PNG files that show line and / or branch coverage information. # Supported utilities: ReportGenerator - Badges # Make a single CSV file containing coverage information per file. # Supported utilities: ReportGenerator - CsvSummary # Make a single TEX file containing a summary for all files and detailed reports for each files. # Supported utilities: ReportGenerator - Latex # Make a single TEX file containing a summary for all files. # Supported utilities: ReportGenerator - LatexSummary # Make a single PNG file containing a chart with historic coverage information. # Supported utilities: ReportGenerator - PngChart # Command line output interpreted by TeamCity. # Supported utilities: ReportGenerator - TeamCitySummary # Make a text file in lcov format. # Supported utilities: ReportGenerator - lcov # Make a XML file containing a summary for all classes and detailed reports for each class. # Supported utilities: ReportGenerator - Xml # Make a single XML file containing a summary for all files. # Supported utilities: ReportGenerator - XmlSummary ``` ### Gcovr HTML Reports Generation of Gcovr HTML reports may be modified with the following configuration items. ```yaml :gcov: # Set to 'true' to enable HTML reports or set to 'false' to disable. # Defaults to enabled. (gcovr --html) # Deprecated - See the :reports: configuration option. :html_report: [true|false] # Gcovr supports generating two types of HTML reports. Use 'basic' to create # an HTML report with only the overall file information. Use 'detailed' to create # an HTML report with line by line coverage of each source file. # Defaults to 'basic'. Set to 'detailed' for (gcovr --html-details). # Deprecated - See the :reports: configuration option. :html_report_type: [basic|detailed] :gcovr: # HTML report filename. :html_artifact_filename: <output> # Use 'title' as title for the HTML report. # Default is 'Head'. (gcovr --html-title) :html_title: <title> # If the coverage is below MEDIUM, the value is marked as low coverage in the HTML report. # MEDIUM has to be lower than or equal to value of html_high_threshold. # If MEDIUM is equal to value of html_high_threshold the report has only high and low coverage. # Default is 75.0. (gcovr --html-medium-threshold) :html_medium_threshold: 75 # If the coverage is below HIGH, the value is marked as medium coverage in the HTML report. # HIGH has to be greater than or equal to value of html_medium_threshold. # If HIGH is equal to value of html_medium_threshold the report has only high and low coverage. # Default is 90.0. (gcovr -html-high-threshold) :html_high_threshold: 90 # Set to 'true' to use absolute paths to link the 'detailed' reports. # Defaults to relative links. (gcovr --html-absolute-paths) :html_absolute_paths: [true|false] # Override the declared HTML report encoding. Defaults to UTF-8. (gcovr --html-encoding) :html_encoding: <html_encoding> ``` ### Cobertura XML Reports Generation of Cobertura XML reports may be modified with the following configuration items. ```yaml :gcov: # Set to 'true' to enable Cobertura XML reports or set to 'false' to disable. # Defaults to disabled. (gcovr --xml) # Deprecated - See the :reports: configuration option. :xml_report: [true|false] :gcovr: # Set to 'true' to pretty-print the Cobertura XML report, otherwise set to 'false'. # Defaults to disabled. (gcovr --xml-pretty) :xml_pretty: [true|false] :cobertura_pretty: [true|false] # Cobertura XML report filename. :xml_artifact_filename: <output> :cobertura_artifact_filename: <output> ``` ### SonarQube XML Reports Generation of SonarQube XML reports may be modified with the following configuration items. ```yaml :gcov: :gcovr: # SonarQube XML report filename. :sonarqube_artifact_filename: <output> ``` ### JSON Reports Generation of JSON reports may be modified with the following configuration items. ```yaml :gcov: :gcovr: # Set to 'true' to pretty-print the JSON report, otherwise set 'false'. # Defaults to disabled. (gcovr --json-pretty) :json_pretty: [true|false] # JSON report filename. :json_artifact_filename: <output> ``` ### Text Reports Generation of text reports may be modified with the following configuration items. Text reports may be printed to the console or output to a file. ```yaml :gcov: :gcovr: # Text report filename. # The text repo