Method parse

server/src/analyzer/sourceFile.ts:251–320

(configOptions: ConfigOptions)

    // (or at least cancel) prior to calling again. It returns true if a parse
    // was required and false if the parse information was up to date already.
    parse(configOptions: ConfigOptions): boolean {
        // If the file is already parsed, we can skip.
        if (!this.isParseRequired()) {
            return false;
        }

        let diagSink = new DiagnosticSink();
        let fileContents = this._fileContents;
        if (this._clientVersion === null) {
            try {
                timingStats.readFileTime.timeOperation(() => {
                    // Read the file's contents.
                    fileContents = fs.readFileSync(this._filePath, { encoding: 'utf8' });
                });
            } catch (error) {
                diagSink.addError(`Source file could not be read`);
                fileContents = '';
            }
        }

        // Use the configuration options to determine the environment in which
        // this source file will be executed.
        let execEnvironment = configOptions.findExecEnvironment(this._filePath);

        let parseOptions = new ParseOptions();
        if (this._filePath.endsWith('pyi')) {
            parseOptions.isStubFile = true;
        }
        parseOptions.pythonVersion = execEnvironment.pythonVersion;

        try {
            // Parse the token stream, building the abstract syntax tree.
            let parser = new Parser();
            let parseResults = parser.parseSourceFile(fileContents!, parseOptions, diagSink);

            // Convert the diagnostic sink into one that knows how to convert
            // to line numbers.
            let textRangeDiagSink = new TextRangeDiagnosticSink(parseResults.lines, diagSink.diagnostics);

            // Fill in the parent links and get the list of imports.
            let walker = new PostParseWalker(textRangeDiagSink, parseResults.parseTree, this._isStubFile);
            timingStats.postParseWalkerTime.timeOperation(() => {
                walker.analyze();
            });

            // Save information in the analysis job.
            this._analysisJob.fileContentsVersion = this._fileContentsVersion;
            this._analysisJob.nextPhaseToRun = AnalysisPhase.SemanticAnalysis;
            this._analysisJob.parseTreeNeedsCleaning = false;
            this._analysisJob.parseResults = parseResults;
            [this._analysisJob.imports, this._analysisJob.builtinsImport] =
                this._resolveImports(parseResults.parseTree,
                    walker.getImportedModules(), configOptions, execEnvironment);

            this._analysisJob.parseDiagnostics = diagSink.diagnostics;
            this._diagnosticVersion++;
        } catch (e) {
            let message: string;