polyspace.project.parseCode

(Python) Parse C/C++ source code added to project

Since R2025a

Syntax

codeInfo = polyspace.project.parseCode(proj, ForceReparse=reparseOrNot)

Description

codeInfo = polyspace.project.parseCode(proj, ForceReparse=reparseOrNot) parses the source code in the project proj and stores information about data types, functions, and global variables in the polyspace.project.CodeInfo object codeInfo.

If an error occurs during code parsing, the function throws an exception of type polyspace.ErrorWithLog. (since R2026a)

Input Arguments

proj — Polyspace^® Platform project

polyspace.project.Project object

Polyspace Platform project, specified as a polyspace.project.Project object.

reparseOrNot — Whether to perform full code analysis

False (default) | True

Whether to perform full or incremental code analysis, specified as a bool value.

If you omit the ForceReparse argument or specify a value of False for this argument, the parseCode function only reanalyzes files that were modified since the previous code analysis (and uses previous code analysis information for unmodified files). If you want all files to be reanalyzed, set the ForceReparse argument to True.

Output Arguments

codeInfo — Source code information

polyspace.project.CodeInfo object

Source code information, returned as a polyspace.project.CodeInfo object. This object contains information about data types, functions, and global variables in your source code. You can author tests for your source code by For more information, see polyspace.project.CodeInfo.

Version History

Introduced in R2025a

R2026a: Support for reading parse logs and full code reparsing

Starting in R2026a, the function polyspace.project.parseCode() provides programmatic access to the code parse logs:

• The polyspace.project.CodeInfo object returned from the function contains a ParseLog property that contains logs from the code parsing.

• If an error occurs during code parsing, the function throws an exception of type polyspace.ErrorWithLog.

The function also supports a syntax that allows you to force a full code parsing irrespective of whether code was previously parsed or not:

codeInfo = polyspace.project.parseCode(proj, ForceReparse=True)