@zzzen/pyright-internal 1.1.254 → 1.1.255

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1265) hide show
  1. package/package.json +3 -2
  2. package/src/analyzer/aliasDeclarationUtils.ts +169 -0
  3. package/src/analyzer/analysis.ts +92 -0
  4. package/src/analyzer/analyzerFileInfo.ts +56 -0
  5. package/src/analyzer/analyzerNodeInfo.ts +198 -0
  6. package/src/analyzer/backgroundAnalysisProgram.ts +311 -0
  7. package/src/analyzer/binder.ts +4081 -0
  8. package/src/analyzer/checker.ts +5507 -0
  9. package/src/analyzer/circularDependency.ts +52 -0
  10. package/src/analyzer/codeFlowEngine.ts +1548 -0
  11. package/src/analyzer/codeFlowTypes.ts +266 -0
  12. package/src/analyzer/codeFlowUtils.ts +436 -0
  13. package/src/analyzer/commentUtils.ts +174 -0
  14. package/src/analyzer/constraintSolver.ts +926 -0
  15. package/src/analyzer/constructorTransform.ts +317 -0
  16. package/src/analyzer/dataClasses.ts +999 -0
  17. package/src/analyzer/declaration.ts +252 -0
  18. package/src/analyzer/declarationUtils.ts +238 -0
  19. package/src/analyzer/docStringConversion.ts +850 -0
  20. package/src/analyzer/docStringUtils.ts +112 -0
  21. package/src/analyzer/functionTransform.ts +137 -0
  22. package/src/analyzer/importResolver.ts +2308 -0
  23. package/src/analyzer/importResult.ts +98 -0
  24. package/src/analyzer/importStatementUtils.ts +834 -0
  25. package/src/analyzer/namedTuples.ts +422 -0
  26. package/src/analyzer/packageTypeReport.ts +108 -0
  27. package/src/analyzer/packageTypeVerifier.ts +1466 -0
  28. package/src/analyzer/parentDirectoryCache.ts +88 -0
  29. package/src/analyzer/parseTreeCleaner.ts +35 -0
  30. package/src/analyzer/parseTreeUtils.ts +2165 -0
  31. package/src/analyzer/parseTreeWalker.ts +663 -0
  32. package/src/analyzer/patternMatching.ts +1356 -0
  33. package/src/analyzer/program.ts +2778 -0
  34. package/src/analyzer/properties.ts +534 -0
  35. package/src/analyzer/protocols.ts +660 -0
  36. package/src/analyzer/pyTypedUtils.ts +52 -0
  37. package/src/analyzer/pythonPathUtils.ts +201 -0
  38. package/src/analyzer/scope.ts +202 -0
  39. package/src/analyzer/scopeUtils.ts +81 -0
  40. package/src/analyzer/service.ts +1679 -0
  41. package/src/analyzer/sourceFile.ts +1401 -0
  42. package/src/analyzer/sourceMapper.ts +717 -0
  43. package/src/analyzer/staticExpressions.ts +308 -0
  44. package/src/analyzer/symbol.ts +249 -0
  45. package/src/analyzer/symbolNameUtils.ts +50 -0
  46. package/src/analyzer/symbolUtils.ts +49 -0
  47. package/src/analyzer/testWalker.ts +101 -0
  48. package/src/analyzer/tracePrinter.ts +264 -0
  49. package/src/analyzer/typeCache.ts +181 -0
  50. package/src/analyzer/typeDocStringUtils.ts +371 -0
  51. package/src/analyzer/typeEvaluator.ts +23395 -0
  52. package/src/analyzer/typeEvaluatorTypes.ts +452 -0
  53. package/src/analyzer/typeEvaluatorWithTracker.ts +161 -0
  54. package/src/analyzer/typeGuards.ts +1828 -0
  55. package/src/analyzer/typePrinter.ts +807 -0
  56. package/src/analyzer/typeStubWriter.ts +727 -0
  57. package/src/analyzer/typeUtils.ts +3126 -0
  58. package/src/analyzer/typeVarContext.ts +330 -0
  59. package/src/analyzer/typedDicts.ts +950 -0
  60. package/src/analyzer/types.ts +2857 -0
  61. package/src/backgroundAnalysis.ts +49 -0
  62. package/src/backgroundAnalysisBase.ts +606 -0
  63. package/src/backgroundThreadBase.ts +143 -0
  64. package/src/commands/commandController.ts +62 -0
  65. package/src/commands/commandResult.ts +21 -0
  66. package/src/commands/commands.ts +16 -0
  67. package/src/commands/createTypeStub.ts +56 -0
  68. package/src/commands/quickActionCommand.ts +40 -0
  69. package/src/commands/restartServer.ts +20 -0
  70. package/src/common/cancellationUtils.ts +71 -0
  71. package/src/common/chokidarFileWatcherProvider.ts +74 -0
  72. package/src/common/collectionUtils.ts +379 -0
  73. package/src/common/commandLineOptions.ts +132 -0
  74. package/src/common/configOptions.ts +1291 -0
  75. package/src/common/console.ts +201 -0
  76. package/src/common/core.ts +152 -0
  77. package/src/common/crypto.ts +60 -0
  78. package/src/common/debug.ts +144 -0
  79. package/src/common/deferred.ts +78 -0
  80. package/src/common/diagnostic.ts +191 -0
  81. package/src/common/diagnosticRules.ts +80 -0
  82. package/src/common/diagnosticSink.ts +150 -0
  83. package/src/common/editAction.ts +46 -0
  84. package/src/common/extensibility.ts +35 -0
  85. package/src/common/extensions.ts +21 -0
  86. package/src/common/fileBasedCancellationUtils.ts +274 -0
  87. package/src/common/fileSystem.ts +152 -0
  88. package/src/common/fullAccessHost.ts +203 -0
  89. package/src/common/host.ts +49 -0
  90. package/src/common/logTracker.ts +157 -0
  91. package/src/common/lspUtils.ts +18 -0
  92. package/src/common/memUtils.ts +36 -0
  93. package/src/common/pathConsts.ts +16 -0
  94. package/src/common/pathUtils.ts +987 -0
  95. package/src/common/positionUtils.ts +78 -0
  96. package/src/common/progressReporter.ts +53 -0
  97. package/src/common/pythonVersion.ts +74 -0
  98. package/src/common/realFileSystem.ts +433 -0
  99. package/src/common/stringUtils.ts +161 -0
  100. package/src/common/textEditUtils.ts +31 -0
  101. package/src/common/textRange.ts +225 -0
  102. package/src/common/textRangeCollection.ts +122 -0
  103. package/src/common/timing.ts +105 -0
  104. package/src/common/uriParser.ts +26 -0
  105. package/src/common/workspaceEditUtils.ts +100 -0
  106. package/src/languageServerBase.ts +1556 -0
  107. package/src/languageService/analyzerServiceExecutor.ts +144 -0
  108. package/src/languageService/autoImporter.ts +926 -0
  109. package/src/languageService/callHierarchyProvider.ts +476 -0
  110. package/src/languageService/codeActionProvider.ts +85 -0
  111. package/src/languageService/completionProvider.ts +3103 -0
  112. package/src/languageService/definitionProvider.ts +235 -0
  113. package/src/languageService/documentHighlightProvider.ts +61 -0
  114. package/src/languageService/documentSymbolCollector.ts +466 -0
  115. package/src/languageService/documentSymbolProvider.ts +466 -0
  116. package/src/languageService/hoverProvider.ts +499 -0
  117. package/src/languageService/importAdder.ts +437 -0
  118. package/src/languageService/importSorter.ts +196 -0
  119. package/src/languageService/indentationUtils.ts +813 -0
  120. package/src/languageService/quickActions.ts +113 -0
  121. package/src/languageService/referencesProvider.ts +316 -0
  122. package/src/languageService/renameModuleProvider.ts +1400 -0
  123. package/src/languageService/signatureHelpProvider.ts +227 -0
  124. package/src/languageService/tooltipUtils.ts +147 -0
  125. package/src/localization/localize.ts +1272 -0
  126. package/src/localization/package.nls.de.json +3 -0
  127. package/src/localization/package.nls.en-us.json +636 -0
  128. package/src/localization/package.nls.es.json +3 -0
  129. package/src/localization/package.nls.fr.json +3 -0
  130. package/src/localization/package.nls.ja.json +3 -0
  131. package/src/localization/package.nls.ru.json +3 -0
  132. package/src/localization/package.nls.zh-cn.json +3 -0
  133. package/src/localization/package.nls.zh-tw.json +3 -0
  134. package/src/nodeMain.ts +21 -0
  135. package/src/nodeServer.ts +30 -0
  136. package/src/parser/characterStream.ts +145 -0
  137. package/src/parser/characters.ts +285 -0
  138. package/src/parser/parseNodes.ts +2338 -0
  139. package/src/parser/parser.ts +4859 -0
  140. package/src/parser/stringTokenUtils.ts +564 -0
  141. package/src/parser/tokenizer.ts +1379 -0
  142. package/src/parser/tokenizerTypes.ts +420 -0
  143. package/src/parser/unicode.ts +2917 -0
  144. package/src/pyright.ts +824 -0
  145. package/src/pyrightFileSystem.ts +237 -0
  146. package/src/readonlyAugmentedFileSystem.ts +204 -0
  147. package/src/server.ts +298 -0
  148. package/src/tests/chainedSourceFiles.test.ts +183 -0
  149. package/src/tests/checker.test.ts +445 -0
  150. package/src/tests/collectionUtils.test.ts +178 -0
  151. package/src/tests/common.test.ts +117 -0
  152. package/src/tests/config.test.ts +291 -0
  153. package/src/tests/debug.test.ts +120 -0
  154. package/src/tests/deferred.test.ts +54 -0
  155. package/src/tests/diagnosticOverrides.test.ts +104 -0
  156. package/src/tests/docStringConversion.test.ts +823 -0
  157. package/src/tests/docStringUtils.test.ts +57 -0
  158. package/src/tests/documentSymbolCollector.test.ts +735 -0
  159. package/src/tests/filesystem.test.ts +215 -0
  160. package/src/tests/fourSlashParser.test.ts +330 -0
  161. package/src/tests/fourSlashRunner.test.ts +36 -0
  162. package/src/tests/fourslash/completions.autoimport.Lib.Found.Type.fourslash.ts +33 -0
  163. package/src/tests/fourslash/completions.autoimport.Lib.Found.duplication.fourslash.ts +47 -0
  164. package/src/tests/fourslash/completions.autoimport.Lib.NotFound.fourslash.ts +14 -0
  165. package/src/tests/fourslash/completions.autoimport.disabled.fourslash.ts +25 -0
  166. package/src/tests/fourslash/completions.autoimport.duplicates.fourslash.ts +36 -0
  167. package/src/tests/fourslash/completions.autoimport.fourslash.ts +29 -0
  168. package/src/tests/fourslash/completions.autoimport.fromImport.fourslash.ts +130 -0
  169. package/src/tests/fourslash/completions.autoimport.plainText.fourslash.ts +29 -0
  170. package/src/tests/fourslash/completions.autoimport.shadow.fourslash.ts +48 -0
  171. package/src/tests/fourslash/completions.autoimport.submodule.fourslash.ts +31 -0
  172. package/src/tests/fourslash/completions.autoimport.topLevel.fourslash.ts +57 -0
  173. package/src/tests/fourslash/completions.builtinDocstrings.fourslash.ts +117 -0
  174. package/src/tests/fourslash/completions.builtinOverride.fourslash.ts +22 -0
  175. package/src/tests/fourslash/completions.call.stringLiteral.fourslash.ts +55 -0
  176. package/src/tests/fourslash/completions.call.typedDict.fourslash.ts +247 -0
  177. package/src/tests/fourslash/completions.call.typedDict.list.fourslash.ts +163 -0
  178. package/src/tests/fourslash/completions.call.typedDict.states.fourslash.ts +135 -0
  179. package/src/tests/fourslash/completions.classVariable.fourslash.ts +37 -0
  180. package/src/tests/fourslash/completions.comment.fourslash.ts +28 -0
  181. package/src/tests/fourslash/completions.declNames.class.fourslash.ts +35 -0
  182. package/src/tests/fourslash/completions.declNames.exception.fourslash.ts +18 -0
  183. package/src/tests/fourslash/completions.declNames.for.fourslash.ts +30 -0
  184. package/src/tests/fourslash/completions.declNames.importAlias.fourslash.ts +15 -0
  185. package/src/tests/fourslash/completions.declNames.lambda.fourslash.ts +45 -0
  186. package/src/tests/fourslash/completions.declNames.method.fourslash.ts +71 -0
  187. package/src/tests/fourslash/completions.declNames.overload.fourslash.ts +156 -0
  188. package/src/tests/fourslash/completions.declNames.topLevelOverload.fourslash.ts +141 -0
  189. package/src/tests/fourslash/completions.dictionary.keys.complex.fourslash.ts +76 -0
  190. package/src/tests/fourslash/completions.dictionary.keys.expression.fourslash.ts +63 -0
  191. package/src/tests/fourslash/completions.dictionary.keys.literalTypes.fourslash.ts +161 -0
  192. package/src/tests/fourslash/completions.dictionary.keys.simple.fourslash.ts +151 -0
  193. package/src/tests/fourslash/completions.dictionary.keys.stringLiterals.fourslash.ts +116 -0
  194. package/src/tests/fourslash/completions.dictionary.keys.symbols.fourslash.ts +53 -0
  195. package/src/tests/fourslash/completions.enums.members.fourslash.ts +44 -0
  196. package/src/tests/fourslash/completions.excluded.fourslash.ts +12 -0
  197. package/src/tests/fourslash/completions.fourslash.ts +51 -0
  198. package/src/tests/fourslash/completions.fstring.fourslash.ts +33 -0
  199. package/src/tests/fourslash/completions.fstring.stringLiteral.fourslash.ts +96 -0
  200. package/src/tests/fourslash/completions.fuzzyMatching.fourslash.ts +30 -0
  201. package/src/tests/fourslash/completions.importDunderNames.fourslash.ts +31 -0
  202. package/src/tests/fourslash/completions.importSubmodule.fourslash.ts +26 -0
  203. package/src/tests/fourslash/completions.importsDuplicates.fourslash.ts +23 -0
  204. package/src/tests/fourslash/completions.inList.fourslash.ts +33 -0
  205. package/src/tests/fourslash/completions.included.fourslash.ts +12 -0
  206. package/src/tests/fourslash/completions.indexer.keys.getitem.fourslash.ts +57 -0
  207. package/src/tests/fourslash/completions.inherited.function.docFromStub.fourslash.ts +28 -0
  208. package/src/tests/fourslash/completions.inherited.overload.docFromScrWithStub.fourslash.ts +52 -0
  209. package/src/tests/fourslash/completions.inherited.overload.docFromStub.fourslash.ts +53 -0
  210. package/src/tests/fourslash/completions.inherited.property.docFromSrc.fourslash.ts +104 -0
  211. package/src/tests/fourslash/completions.inherited.property.docFromStub.fourslash.ts +108 -0
  212. package/src/tests/fourslash/completions.keywords.pythonVersion.fourslash.ts +72 -0
  213. package/src/tests/fourslash/completions.libCodeAndStub.fourslash.ts +79 -0
  214. package/src/tests/fourslash/completions.libCodeNoStub.fourslash.ts +69 -0
  215. package/src/tests/fourslash/completions.libStub.fourslash.ts +69 -0
  216. package/src/tests/fourslash/completions.literals.fourslash.ts +33 -0
  217. package/src/tests/fourslash/completions.localCode.fourslash.ts +74 -0
  218. package/src/tests/fourslash/completions.moduleContext.UnknownMemberOnInstance.fourslash.ts +17 -0
  219. package/src/tests/fourslash/completions.moduleContext.UnknownStaticFunctionOnClass.fourslash.ts +57 -0
  220. package/src/tests/fourslash/completions.moduleContext.libCodeNoStub.fourslash.ts +30 -0
  221. package/src/tests/fourslash/completions.overloads.fourslash.ts +40 -0
  222. package/src/tests/fourslash/completions.override.default.fourslash.ts +47 -0
  223. package/src/tests/fourslash/completions.override.default.importStub.ts +50 -0
  224. package/src/tests/fourslash/completions.override.default.imported.fourslash.ts +61 -0
  225. package/src/tests/fourslash/completions.override.default.stub.fourslash.ts +47 -0
  226. package/src/tests/fourslash/completions.override.fourslash.ts +47 -0
  227. package/src/tests/fourslash/completions.override.property.fourslash.ts +31 -0
  228. package/src/tests/fourslash/completions.override.property.stub.fourslash.ts +31 -0
  229. package/src/tests/fourslash/completions.override.staticAndClassmethod.fourslash.ts +64 -0
  230. package/src/tests/fourslash/completions.override.stub.fourslash.ts +47 -0
  231. package/src/tests/fourslash/completions.override2.fourslash.ts +71 -0
  232. package/src/tests/fourslash/completions.parameters.fourslash.ts +23 -0
  233. package/src/tests/fourslash/completions.params.fourslash.ts +24 -0
  234. package/src/tests/fourslash/completions.parentFolder.fourslash.ts +17 -0
  235. package/src/tests/fourslash/completions.parentFolders.fourslash.ts +77 -0
  236. package/src/tests/fourslash/completions.plainText.fourslash.ts +34 -0
  237. package/src/tests/fourslash/completions.private.fourslash.ts +64 -0
  238. package/src/tests/fourslash/completions.property.fourslash.ts +28 -0
  239. package/src/tests/fourslash/completions.propertyDocStrings.fourslash.ts +64 -0
  240. package/src/tests/fourslash/completions.self.fourslash.ts +43 -0
  241. package/src/tests/fourslash/completions.stringLiteral.escape.fourslash.ts +71 -0
  242. package/src/tests/fourslash/completions.stringLiteral.fourslash.ts +79 -0
  243. package/src/tests/fourslash/completions.typeAlias.fourslash.ts +29 -0
  244. package/src/tests/fourslash/completions.typeshed.fourslash.ts +9 -0
  245. package/src/tests/fourslash/completions.vardecls.fourslash.ts +40 -0
  246. package/src/tests/fourslash/completions.variableDocStrings.fourslash.ts +69 -0
  247. package/src/tests/fourslash/completions.wildcardimports.fourslash.ts +116 -0
  248. package/src/tests/fourslash/completions.with.fourslash.ts +26 -0
  249. package/src/tests/fourslash/diagnostics.missingModuleSource.fourslash.ts +69 -0
  250. package/src/tests/fourslash/findDefinitions.builtinClass.fourslash.ts +29 -0
  251. package/src/tests/fourslash/findDefinitions.classes.fourslash.ts +101 -0
  252. package/src/tests/fourslash/findDefinitions.definitionFilter.preferSource.fourslash.ts +29 -0
  253. package/src/tests/fourslash/findDefinitions.definitionFilter.preferSource.onlyStubs.ts +24 -0
  254. package/src/tests/fourslash/findDefinitions.definitionFilter.preferStub.fourslash.ts +29 -0
  255. package/src/tests/fourslash/findDefinitions.definitionFilter.preferStub.onlySource.fourslash.ts +25 -0
  256. package/src/tests/fourslash/findDefinitions.fields.fourslash.ts +131 -0
  257. package/src/tests/fourslash/findDefinitions.functions.fourslash.ts +87 -0
  258. package/src/tests/fourslash/findDefinitions.methods.fourslash.ts +162 -0
  259. package/src/tests/fourslash/findDefinitions.modules.fourslash.ts +50 -0
  260. package/src/tests/fourslash/findDefinitions.namespaceImport.fourslash.ts +40 -0
  261. package/src/tests/fourslash/findDefinitions.overloads.fourslash.ts +223 -0
  262. package/src/tests/fourslash/findDefinitions.parameters.fourslash.ts +162 -0
  263. package/src/tests/fourslash/findDefinitions.sourceAndStub.function.fourslash.ts +26 -0
  264. package/src/tests/fourslash/findDefinitions.sourceAndStub.innerClass.fourslash.ts +32 -0
  265. package/src/tests/fourslash/findDefinitions.sourceAndStub.innerClassMethod.fourslash.ts +33 -0
  266. package/src/tests/fourslash/findDefinitions.sourceAndStub.outerClass.fourslash.ts +28 -0
  267. package/src/tests/fourslash/findDefinitions.sourceAndStub.outerClassMethod.fourslash.ts +29 -0
  268. package/src/tests/fourslash/findDefinitions.sourceAndStub.outerClassPropertyReadOnly.fourslash.ts +31 -0
  269. package/src/tests/fourslash/findDefinitions.sourceAndStub.outerClassPropertyReadWrite.fourslash.ts +36 -0
  270. package/src/tests/fourslash/findDefinitions.sourceOnly.class.fourslash.ts +29 -0
  271. package/src/tests/fourslash/findDefinitions.sourceOnly.function1.fourslash.ts +28 -0
  272. package/src/tests/fourslash/findDefinitions.sourceOnly.function2.fourslash.ts +28 -0
  273. package/src/tests/fourslash/findDefinitions.sourceOnly.relativeImport1.fourslash.ts +22 -0
  274. package/src/tests/fourslash/findDefinitions.sourceOnly.relativeImport2.fourslash.ts +22 -0
  275. package/src/tests/fourslash/findDefinitions.stubOnly.fourslash.ts +61 -0
  276. package/src/tests/fourslash/findDefinitions.stubPackages.fourslash.ts +71 -0
  277. package/src/tests/fourslash/findDefinitions.typedDict.keys.fourslash.ts +99 -0
  278. package/src/tests/fourslash/findDefinitions.variables.fourslash.ts +88 -0
  279. package/src/tests/fourslash/findDefinitions.wildcardimports.fourslash.ts +117 -0
  280. package/src/tests/fourslash/findTypeDefinitions.builtinClass.fourslash.ts +26 -0
  281. package/src/tests/fourslash/findTypeDefinitions.classes.fourslash.ts +72 -0
  282. package/src/tests/fourslash/findTypeDefinitions.unions.fourslash.ts +26 -0
  283. package/src/tests/fourslash/findallreferences.classPropertyReadWrite.ts +39 -0
  284. package/src/tests/fourslash/findallreferences.fourslash.ts +34 -0
  285. package/src/tests/fourslash/findallreferences.importalias.fourslash.ts +34 -0
  286. package/src/tests/fourslash/findallreferences.invokedFromLibrary.fourslash.ts +52 -0
  287. package/src/tests/fourslash/findallreferences.module.nested.fourslash.ts +67 -0
  288. package/src/tests/fourslash/findallreferences.modules.duplicated.fourslash.ts +59 -0
  289. package/src/tests/fourslash/findallreferences.modules.fourslash.ts +46 -0
  290. package/src/tests/fourslash/findallreferences.modules.shadow.fourslash.ts +95 -0
  291. package/src/tests/fourslash/findallreferences.openFiles.fourslash.ts +37 -0
  292. package/src/tests/fourslash/findallreferences.parameter.fourslash.ts +24 -0
  293. package/src/tests/fourslash/findallreferences.sourceAndStub.class.fourslash.ts +33 -0
  294. package/src/tests/fourslash/findallreferences.sourceAndStub.classMethod.fourslash.ts +37 -0
  295. package/src/tests/fourslash/findallreferences.sourceAndStub.classPropertyReadOnly.fourslash.ts +40 -0
  296. package/src/tests/fourslash/findallreferences.sourceAndStub.classPropertyReadWrite.fourslash.skip.ts +48 -0
  297. package/src/tests/fourslash/findallreferences.sourceAndStub.function.fourslash.ts +35 -0
  298. package/src/tests/fourslash/findallreferences.variable.fourslash.ts +24 -0
  299. package/src/tests/fourslash/fourslash.ts +411 -0
  300. package/src/tests/fourslash/highlightreferences.attributes.fourslash.ts +31 -0
  301. package/src/tests/fourslash/hover.builtinDocstrings.fourslash.ts +64 -0
  302. package/src/tests/fourslash/hover.classNoInit.fourslash.ts +14 -0
  303. package/src/tests/fourslash/hover.docFromScr.stringFormat.fourslash.ts +52 -0
  304. package/src/tests/fourslash/hover.docFromSrc.fourslash.ts +83 -0
  305. package/src/tests/fourslash/hover.docFromSrc.pkg-vs-module1.fourslash.ts +26 -0
  306. package/src/tests/fourslash/hover.docFromSrc.pkg-vs-module2.fourslash.ts +26 -0
  307. package/src/tests/fourslash/hover.docFromSrc.relativeImport1.fourslash.ts +23 -0
  308. package/src/tests/fourslash/hover.docFromSrc.relativeImport2.fourslash.ts +22 -0
  309. package/src/tests/fourslash/hover.docFromSrc.relativeImport3.fourslash.ts +46 -0
  310. package/src/tests/fourslash/hover.docFromSrc.stubs-package.fourslash.ts +29 -0
  311. package/src/tests/fourslash/hover.docFromSrc.typeshed.fourslash.ts +20 -0
  312. package/src/tests/fourslash/hover.docstring.links.fourslash.ts +12 -0
  313. package/src/tests/fourslash/hover.docstring.overloads.fourslash.ts +41 -0
  314. package/src/tests/fourslash/hover.docstring.split.fourslash.ts +24 -0
  315. package/src/tests/fourslash/hover.fourslash.ts +20 -0
  316. package/src/tests/fourslash/hover.import.django.view.fourslash.ts +27 -0
  317. package/src/tests/fourslash/hover.import.fourslash.ts +11 -0
  318. package/src/tests/fourslash/hover.inherited.docFromSrc.fourslash.ts +63 -0
  319. package/src/tests/fourslash/hover.inherited.docFromSrcWithStub.fourslash.ts +54 -0
  320. package/src/tests/fourslash/hover.inherited.docFromStub.fourslash.ts +42 -0
  321. package/src/tests/fourslash/hover.inherited.overload.docFromSrcWithStub.fourslash.ts +46 -0
  322. package/src/tests/fourslash/hover.inherited.overload.docFromStub.fourslash.ts +47 -0
  323. package/src/tests/fourslash/hover.inherited.property.docFromSrcWithStub.fourslash.ts +87 -0
  324. package/src/tests/fourslash/hover.inherited.property.docFromStub.fourslash.ts +91 -0
  325. package/src/tests/fourslash/hover.init.fourslash.ts +39 -0
  326. package/src/tests/fourslash/hover.libCodeAndStub.fourslash.ts +52 -0
  327. package/src/tests/fourslash/hover.libCodeNoStub.fourslash.ts +41 -0
  328. package/src/tests/fourslash/hover.libStub.fourslash.ts +41 -0
  329. package/src/tests/fourslash/hover.optionalAliasParameter.fourslash.ts +14 -0
  330. package/src/tests/fourslash/hover.plainText.fourslash.ts +21 -0
  331. package/src/tests/fourslash/hover.typedDict.key.fourslash.ts +51 -0
  332. package/src/tests/fourslash/hover.variable.docString.fourslash.ts +41 -0
  333. package/src/tests/fourslash/hover.wildcardimports.fourslash.ts +80 -0
  334. package/src/tests/fourslash/import.publicSymbols.fourslash.ts +65 -0
  335. package/src/tests/fourslash/import.pytyped.dunderAll.fourslash.ts +77 -0
  336. package/src/tests/fourslash/import.pytyped.privateSymbols.fourslash.ts +65 -0
  337. package/src/tests/fourslash/import.pytyped.typeCheckingBasic.fourslash.ts +38 -0
  338. package/src/tests/fourslash/import.pytyped.typeCheckingOff.fourslash.ts +38 -0
  339. package/src/tests/fourslash/import.wildcard.fourslash.ts +27 -0
  340. package/src/tests/fourslash/importnotresolved.fourslash.ts +13 -0
  341. package/src/tests/fourslash/missingModuleSource.disablingInStrictMode.fourslash.ts +20 -0
  342. package/src/tests/fourslash/missingModuleSource.fourslash.ts +14 -0
  343. package/src/tests/fourslash/missingTypeStub.codeAction.fourslash.ts +33 -0
  344. package/src/tests/fourslash/missingTypeStub.command.multipart.fourslash.ts +48 -0
  345. package/src/tests/fourslash/missingTypeStub.command.singlefile.fourslash.ts +38 -0
  346. package/src/tests/fourslash/missingTypeStub.command.singlepart.fourslash.ts +38 -0
  347. package/src/tests/fourslash/missingTypeStub.fourslash.ts +20 -0
  348. package/src/tests/fourslash/missingTypeStub.invokeCodeAction.fourslash.ts +36 -0
  349. package/src/tests/fourslash/noerrors.fourslash.ts +9 -0
  350. package/src/tests/fourslash/orderImports1.command.fourslash.ts +20 -0
  351. package/src/tests/fourslash/orderImports2.command.fourslash.ts +24 -0
  352. package/src/tests/fourslash/rename.externallyHidden.fourslash.ts +24 -0
  353. package/src/tests/fourslash/rename.externallyHidden.params.fourslash.ts +24 -0
  354. package/src/tests/fourslash/rename.fourslash.ts +29 -0
  355. package/src/tests/fourslash/rename.library.fourslash.ts +29 -0
  356. package/src/tests/fourslash/rename.library.sourceAndStub.fourslash.ts +33 -0
  357. package/src/tests/fourslash/rename.multipleDecl.fourslash.ts +21 -0
  358. package/src/tests/fourslash/rename.sourceAndStub.fourslash.ts +37 -0
  359. package/src/tests/fourslash/rename.string.excluded.fourslash.ts +43 -0
  360. package/src/tests/fourslash/rename.string.fourslash.ts +26 -0
  361. package/src/tests/fourslash/signature.builtinDocstrings.fourslash.ts +63 -0
  362. package/src/tests/fourslash/signature.complicated.fourslash.ts +100 -0
  363. package/src/tests/fourslash/signature.cornercases.fourslash.ts +23 -0
  364. package/src/tests/fourslash/signature.docstrings.fourslash.ts +43 -0
  365. package/src/tests/fourslash/signature.docstrings.overloaded.fourslash.ts +50 -0
  366. package/src/tests/fourslash/signature.docstrings.wildcardimports.fourslash.ts +122 -0
  367. package/src/tests/fourslash/signature.overload.fourslash.ts +64 -0
  368. package/src/tests/fourslash/signature.simple.fourslash.ts +104 -0
  369. package/src/tests/harness/fourslash/fourSlashParser.ts +441 -0
  370. package/src/tests/harness/fourslash/fourSlashTypes.ts +134 -0
  371. package/src/tests/harness/fourslash/runner.ts +99 -0
  372. package/src/tests/harness/fourslash/testLanguageService.ts +142 -0
  373. package/src/tests/harness/fourslash/testState.Consts.ts +29 -0
  374. package/src/tests/harness/fourslash/testState.ts +1993 -0
  375. package/src/tests/harness/testAccessHost.ts +23 -0
  376. package/src/tests/harness/testHost.ts +177 -0
  377. package/src/tests/harness/utils.ts +355 -0
  378. package/src/tests/harness/vfs/factory.ts +199 -0
  379. package/src/tests/harness/vfs/filesystem.ts +1893 -0
  380. package/src/tests/harness/vfs/pathValidation.ts +154 -0
  381. package/src/tests/importAdder.test.ts +1361 -0
  382. package/src/tests/importResolver.test.ts +534 -0
  383. package/src/tests/importStatementUtils.test.ts +526 -0
  384. package/src/tests/indentationUtils.ptvs.test.ts +388 -0
  385. package/src/tests/indentationUtils.reindent.test.ts +403 -0
  386. package/src/tests/indentationUtils.test.ts +455 -0
  387. package/src/tests/ipythonMode.test.ts +365 -0
  388. package/src/tests/localizer.test.ts +47 -0
  389. package/src/tests/parseTreeUtils.test.ts +281 -0
  390. package/src/tests/parser.test.ts +99 -0
  391. package/src/tests/pathUtils.test.ts +321 -0
  392. package/src/tests/pyrightFileSystem.test.ts +183 -0
  393. package/src/tests/renameModule.folder.test.ts +261 -0
  394. package/src/tests/renameModule.fromImports.test.ts +952 -0
  395. package/src/tests/renameModule.imports.test.ts +450 -0
  396. package/src/tests/renameModule.misc.test.ts +765 -0
  397. package/src/tests/renameModule.relativePath.test.ts +277 -0
  398. package/src/tests/renameModuleTestUtils.ts +210 -0
  399. package/src/tests/samples/abstractClass1.py +51 -0
  400. package/src/tests/samples/abstractClass2.py +25 -0
  401. package/src/tests/samples/abstractClass3.py +30 -0
  402. package/src/tests/samples/abstractClass4.py +30 -0
  403. package/src/tests/samples/abstractClass5.py +42 -0
  404. package/src/tests/samples/abstractClass6.py +25 -0
  405. package/src/tests/samples/abstractClass7.py +22 -0
  406. package/src/tests/samples/abstractClass8.py +27 -0
  407. package/src/tests/samples/annotated1.py +72 -0
  408. package/src/tests/samples/annotatedVar1.py +22 -0
  409. package/src/tests/samples/annotatedVar2.py +28 -0
  410. package/src/tests/samples/annotatedVar3.py +54 -0
  411. package/src/tests/samples/annotatedVar4.py +24 -0
  412. package/src/tests/samples/annotatedVar5.py +37 -0
  413. package/src/tests/samples/annotatedVar6.py +22 -0
  414. package/src/tests/samples/annotatedVar7.py +13 -0
  415. package/src/tests/samples/annotatedVar8.py +29 -0
  416. package/src/tests/samples/annotations1.py +98 -0
  417. package/src/tests/samples/annotations2.py +33 -0
  418. package/src/tests/samples/annotations3.py +43 -0
  419. package/src/tests/samples/annotations4.py +54 -0
  420. package/src/tests/samples/annotations5.py +9 -0
  421. package/src/tests/samples/annotations6.py +29 -0
  422. package/src/tests/samples/assert1.py +22 -0
  423. package/src/tests/samples/assertType1.py +46 -0
  424. package/src/tests/samples/assignment1.py +58 -0
  425. package/src/tests/samples/assignment10.py +14 -0
  426. package/src/tests/samples/assignment2.py +40 -0
  427. package/src/tests/samples/assignment3.py +46 -0
  428. package/src/tests/samples/assignment4.py +20 -0
  429. package/src/tests/samples/assignment5.py +16 -0
  430. package/src/tests/samples/assignment6.py +25 -0
  431. package/src/tests/samples/assignment7.py +13 -0
  432. package/src/tests/samples/assignment8.py +40 -0
  433. package/src/tests/samples/assignment9.py +25 -0
  434. package/src/tests/samples/assignmentExpr1.py +23 -0
  435. package/src/tests/samples/assignmentExpr2.py +49 -0
  436. package/src/tests/samples/assignmentExpr3.py +27 -0
  437. package/src/tests/samples/assignmentExpr4.py +49 -0
  438. package/src/tests/samples/assignmentExpr5.py +15 -0
  439. package/src/tests/samples/assignmentExpr6.py +10 -0
  440. package/src/tests/samples/assignmentExpr7.py +13 -0
  441. package/src/tests/samples/assignmentExpr8.py +11 -0
  442. package/src/tests/samples/assignmentExpr9.py +28 -0
  443. package/src/tests/samples/async1.py +49 -0
  444. package/src/tests/samples/augmentedAssignment1.py +62 -0
  445. package/src/tests/samples/augmentedAssignment2.py +23 -0
  446. package/src/tests/samples/augmentedAssignment3.py +8 -0
  447. package/src/tests/samples/await1.py +23 -0
  448. package/src/tests/samples/await2.py +25 -0
  449. package/src/tests/samples/badToken1.py +6 -0
  450. package/src/tests/samples/builtins1.py +2 -0
  451. package/src/tests/samples/call1.py +93 -0
  452. package/src/tests/samples/call2.py +118 -0
  453. package/src/tests/samples/call3.py +168 -0
  454. package/src/tests/samples/call4.py +13 -0
  455. package/src/tests/samples/call5.py +95 -0
  456. package/src/tests/samples/call6.py +35 -0
  457. package/src/tests/samples/call7.py +57 -0
  458. package/src/tests/samples/callSite1.py +6 -0
  459. package/src/tests/samples/callSite2.py +12 -0
  460. package/src/tests/samples/callable1.py +53 -0
  461. package/src/tests/samples/callable2.py +58 -0
  462. package/src/tests/samples/callable3.py +28 -0
  463. package/src/tests/samples/callable4.py +32 -0
  464. package/src/tests/samples/callable5.py +40 -0
  465. package/src/tests/samples/callable6.py +83 -0
  466. package/src/tests/samples/callbackProtocol1.py +119 -0
  467. package/src/tests/samples/callbackProtocol2.py +29 -0
  468. package/src/tests/samples/callbackProtocol3.py +23 -0
  469. package/src/tests/samples/callbackProtocol4.py +73 -0
  470. package/src/tests/samples/callbackProtocol5.py +66 -0
  471. package/src/tests/samples/callbackProtocol6.py +66 -0
  472. package/src/tests/samples/callbackProtocol7.py +16 -0
  473. package/src/tests/samples/callbackProtocol8.py +16 -0
  474. package/src/tests/samples/capturedVariable1.py +106 -0
  475. package/src/tests/samples/circular1.py +16 -0
  476. package/src/tests/samples/circular2.py +38 -0
  477. package/src/tests/samples/circularBaseClass.py +17 -0
  478. package/src/tests/samples/classGetItem1.py +30 -0
  479. package/src/tests/samples/classVar1.py +41 -0
  480. package/src/tests/samples/classVar2.py +29 -0
  481. package/src/tests/samples/classVar3.py +46 -0
  482. package/src/tests/samples/classVar4.py +36 -0
  483. package/src/tests/samples/classes1.py +50 -0
  484. package/src/tests/samples/classes3.py +48 -0
  485. package/src/tests/samples/classes4.py +15 -0
  486. package/src/tests/samples/classes5.py +260 -0
  487. package/src/tests/samples/classes6.py +16 -0
  488. package/src/tests/samples/classes7.py +18 -0
  489. package/src/tests/samples/classes8.py +47 -0
  490. package/src/tests/samples/codeFlow1.py +65 -0
  491. package/src/tests/samples/codeFlow2.py +26 -0
  492. package/src/tests/samples/codeFlow3.py +8 -0
  493. package/src/tests/samples/codeFlow4.py +133 -0
  494. package/src/tests/samples/codeFlow5.py +10 -0
  495. package/src/tests/samples/codeFlow6.py +35 -0
  496. package/src/tests/samples/codeFlow7.py +35 -0
  497. package/src/tests/samples/comparison1.py +77 -0
  498. package/src/tests/samples/comparison2.py +37 -0
  499. package/src/tests/samples/complex1.py +17 -0
  500. package/src/tests/samples/constant1.py +40 -0
  501. package/src/tests/samples/constants1.py +64 -0
  502. package/src/tests/samples/constructor1.py +30 -0
  503. package/src/tests/samples/constructor10.py +19 -0
  504. package/src/tests/samples/constructor11.py +32 -0
  505. package/src/tests/samples/constructor12.py +20 -0
  506. package/src/tests/samples/constructor13.py +15 -0
  507. package/src/tests/samples/constructor2.py +180 -0
  508. package/src/tests/samples/constructor3.py +18 -0
  509. package/src/tests/samples/constructor4.py +25 -0
  510. package/src/tests/samples/constructor5.py +25 -0
  511. package/src/tests/samples/constructor6.py +70 -0
  512. package/src/tests/samples/constructor7.py +11 -0
  513. package/src/tests/samples/constructor8.py +99 -0
  514. package/src/tests/samples/constructor9.py +19 -0
  515. package/src/tests/samples/coroutines1.py +60 -0
  516. package/src/tests/samples/coroutines2.py +20 -0
  517. package/src/tests/samples/coroutines3.py +37 -0
  518. package/src/tests/samples/dataclass1.py +44 -0
  519. package/src/tests/samples/dataclass10.py +45 -0
  520. package/src/tests/samples/dataclass11.py +53 -0
  521. package/src/tests/samples/dataclass12.py +32 -0
  522. package/src/tests/samples/dataclass13.py +42 -0
  523. package/src/tests/samples/dataclass14.py +38 -0
  524. package/src/tests/samples/dataclass15.py +58 -0
  525. package/src/tests/samples/dataclass16.py +21 -0
  526. package/src/tests/samples/dataclass17.py +46 -0
  527. package/src/tests/samples/dataclass18.py +57 -0
  528. package/src/tests/samples/dataclass19.py +44 -0
  529. package/src/tests/samples/dataclass2.py +30 -0
  530. package/src/tests/samples/dataclass20.py +71 -0
  531. package/src/tests/samples/dataclass21.py +13 -0
  532. package/src/tests/samples/dataclass3.py +18 -0
  533. package/src/tests/samples/dataclass4.py +64 -0
  534. package/src/tests/samples/dataclass5.py +81 -0
  535. package/src/tests/samples/dataclass6.py +29 -0
  536. package/src/tests/samples/dataclass7.py +93 -0
  537. package/src/tests/samples/dataclass8.py +22 -0
  538. package/src/tests/samples/dataclass9.py +24 -0
  539. package/src/tests/samples/dataclassPostInit1.py +61 -0
  540. package/src/tests/samples/dataclassTransform1.py +71 -0
  541. package/src/tests/samples/dataclassTransform2.py +78 -0
  542. package/src/tests/samples/dataclassTransform3.py +83 -0
  543. package/src/tests/samples/dataclassTransform4.py +87 -0
  544. package/src/tests/samples/decorator1.py +20 -0
  545. package/src/tests/samples/decorator2.py +31 -0
  546. package/src/tests/samples/decorator3.py +27 -0
  547. package/src/tests/samples/decorator4.py +37 -0
  548. package/src/tests/samples/decorator5.py +29 -0
  549. package/src/tests/samples/decorator6.py +34 -0
  550. package/src/tests/samples/defaultInitializer1.py +26 -0
  551. package/src/tests/samples/deprecated1.py +37 -0
  552. package/src/tests/samples/descriptor1.py +134 -0
  553. package/src/tests/samples/descriptor2.py +29 -0
  554. package/src/tests/samples/dictionary1.py +42 -0
  555. package/src/tests/samples/dictionary2.py +14 -0
  556. package/src/tests/samples/dictionary3.py +30 -0
  557. package/src/tests/samples/dictionary4.py +106 -0
  558. package/src/tests/samples/dunderAll1.py +32 -0
  559. package/src/tests/samples/dunderAll2.py +16 -0
  560. package/src/tests/samples/dunderAll3.pyi +16 -0
  561. package/src/tests/samples/duplicateDeclaration1.py +115 -0
  562. package/src/tests/samples/duplicateDeclaration2.py +45 -0
  563. package/src/tests/samples/duplicateImports1.py +13 -0
  564. package/src/tests/samples/ellipsis1.pyi +48 -0
  565. package/src/tests/samples/emptyContainers1.py +89 -0
  566. package/src/tests/samples/enums1.py +52 -0
  567. package/src/tests/samples/enums2.py +15 -0
  568. package/src/tests/samples/enums3.py +24 -0
  569. package/src/tests/samples/enums4.py +23 -0
  570. package/src/tests/samples/enums5.py +16 -0
  571. package/src/tests/samples/enums6.py +33 -0
  572. package/src/tests/samples/enums7.py +54 -0
  573. package/src/tests/samples/enums8.py +14 -0
  574. package/src/tests/samples/expressions1.py +54 -0
  575. package/src/tests/samples/expressions2.py +29 -0
  576. package/src/tests/samples/expressions3.py +26 -0
  577. package/src/tests/samples/expressions4.py +23 -0
  578. package/src/tests/samples/expressions5.py +70 -0
  579. package/src/tests/samples/expressions6.py +14 -0
  580. package/src/tests/samples/expressions7.py +40 -0
  581. package/src/tests/samples/expressions8.py +26 -0
  582. package/src/tests/samples/expressions9.py +14 -0
  583. package/src/tests/samples/final1.py +14 -0
  584. package/src/tests/samples/final2.py +86 -0
  585. package/src/tests/samples/final3.py +179 -0
  586. package/src/tests/samples/final4.pyi +21 -0
  587. package/src/tests/samples/final5.py +18 -0
  588. package/src/tests/samples/forLoop1.py +88 -0
  589. package/src/tests/samples/forLoop2.py +48 -0
  590. package/src/tests/samples/fstring1.py +66 -0
  591. package/src/tests/samples/fstring2.py +12 -0
  592. package/src/tests/samples/fstring3.py +35 -0
  593. package/src/tests/samples/fstring4.py +17 -0
  594. package/src/tests/samples/fstring5.py +17 -0
  595. package/src/tests/samples/fstring6.py +14 -0
  596. package/src/tests/samples/function1.py +12 -0
  597. package/src/tests/samples/function10.py +20 -0
  598. package/src/tests/samples/function11.py +36 -0
  599. package/src/tests/samples/function2.py +7 -0
  600. package/src/tests/samples/function3.py +82 -0
  601. package/src/tests/samples/function4.py +13 -0
  602. package/src/tests/samples/function6.py +24 -0
  603. package/src/tests/samples/function7.py +13 -0
  604. package/src/tests/samples/function8.py +38 -0
  605. package/src/tests/samples/function9.py +75 -0
  606. package/src/tests/samples/functionAnnotation1.py +61 -0
  607. package/src/tests/samples/functionAnnotation2.py +26 -0
  608. package/src/tests/samples/functionAnnotation3.py +37 -0
  609. package/src/tests/samples/functionAnnotation4.py +22 -0
  610. package/src/tests/samples/functionMember1.py +18 -0
  611. package/src/tests/samples/functionMember2.py +45 -0
  612. package/src/tests/samples/generators1.py +122 -0
  613. package/src/tests/samples/generators10.py +18 -0
  614. package/src/tests/samples/generators11.py +27 -0
  615. package/src/tests/samples/generators12.py +25 -0
  616. package/src/tests/samples/generators13.py +65 -0
  617. package/src/tests/samples/generators14.py +19 -0
  618. package/src/tests/samples/generators15.py +26 -0
  619. package/src/tests/samples/generators2.py +31 -0
  620. package/src/tests/samples/generators3.py +42 -0
  621. package/src/tests/samples/generators4.py +33 -0
  622. package/src/tests/samples/generators5.py +24 -0
  623. package/src/tests/samples/generators6.py +14 -0
  624. package/src/tests/samples/generators7.py +18 -0
  625. package/src/tests/samples/generators8.py +12 -0
  626. package/src/tests/samples/generators9.py +19 -0
  627. package/src/tests/samples/generic1.py +41 -0
  628. package/src/tests/samples/genericTypes1.py +12 -0
  629. package/src/tests/samples/genericTypes10.py +38 -0
  630. package/src/tests/samples/genericTypes11.py +26 -0
  631. package/src/tests/samples/genericTypes12.py +14 -0
  632. package/src/tests/samples/genericTypes13.py +27 -0
  633. package/src/tests/samples/genericTypes14.py +22 -0
  634. package/src/tests/samples/genericTypes15.py +13 -0
  635. package/src/tests/samples/genericTypes16.py +15 -0
  636. package/src/tests/samples/genericTypes17.py +24 -0
  637. package/src/tests/samples/genericTypes18.py +135 -0
  638. package/src/tests/samples/genericTypes19.py +32 -0
  639. package/src/tests/samples/genericTypes2.py +40 -0
  640. package/src/tests/samples/genericTypes20.py +44 -0
  641. package/src/tests/samples/genericTypes21.py +29 -0
  642. package/src/tests/samples/genericTypes22.py +23 -0
  643. package/src/tests/samples/genericTypes23.py +27 -0
  644. package/src/tests/samples/genericTypes24.py +32 -0
  645. package/src/tests/samples/genericTypes25.py +37 -0
  646. package/src/tests/samples/genericTypes26.py +31 -0
  647. package/src/tests/samples/genericTypes27.py +14 -0
  648. package/src/tests/samples/genericTypes28.py +51 -0
  649. package/src/tests/samples/genericTypes29.py +24 -0
  650. package/src/tests/samples/genericTypes3.py +13 -0
  651. package/src/tests/samples/genericTypes30.py +32 -0
  652. package/src/tests/samples/genericTypes31.py +30 -0
  653. package/src/tests/samples/genericTypes32.py +25 -0
  654. package/src/tests/samples/genericTypes33.py +46 -0
  655. package/src/tests/samples/genericTypes34.py +54 -0
  656. package/src/tests/samples/genericTypes35.py +45 -0
  657. package/src/tests/samples/genericTypes36.py +35 -0
  658. package/src/tests/samples/genericTypes37.py +26 -0
  659. package/src/tests/samples/genericTypes38.py +15 -0
  660. package/src/tests/samples/genericTypes39.py +82 -0
  661. package/src/tests/samples/genericTypes4.py +37 -0
  662. package/src/tests/samples/genericTypes40.py +38 -0
  663. package/src/tests/samples/genericTypes41.py +16 -0
  664. package/src/tests/samples/genericTypes42.py +32 -0
  665. package/src/tests/samples/genericTypes43.py +24 -0
  666. package/src/tests/samples/genericTypes44.py +33 -0
  667. package/src/tests/samples/genericTypes45.py +43 -0
  668. package/src/tests/samples/genericTypes46.py +66 -0
  669. package/src/tests/samples/genericTypes47.py +39 -0
  670. package/src/tests/samples/genericTypes48.py +18 -0
  671. package/src/tests/samples/genericTypes49.py +41 -0
  672. package/src/tests/samples/genericTypes5.py +42 -0
  673. package/src/tests/samples/genericTypes50.py +62 -0
  674. package/src/tests/samples/genericTypes51.py +55 -0
  675. package/src/tests/samples/genericTypes52.py +34 -0
  676. package/src/tests/samples/genericTypes53.py +42 -0
  677. package/src/tests/samples/genericTypes54.py +31 -0
  678. package/src/tests/samples/genericTypes55.py +61 -0
  679. package/src/tests/samples/genericTypes56.py +19 -0
  680. package/src/tests/samples/genericTypes57.py +30 -0
  681. package/src/tests/samples/genericTypes58.py +52 -0
  682. package/src/tests/samples/genericTypes59.py +71 -0
  683. package/src/tests/samples/genericTypes6.py +49 -0
  684. package/src/tests/samples/genericTypes60.py +27 -0
  685. package/src/tests/samples/genericTypes61.py +34 -0
  686. package/src/tests/samples/genericTypes62.py +26 -0
  687. package/src/tests/samples/genericTypes63.py +32 -0
  688. package/src/tests/samples/genericTypes64.py +16 -0
  689. package/src/tests/samples/genericTypes65.py +15 -0
  690. package/src/tests/samples/genericTypes66.py +30 -0
  691. package/src/tests/samples/genericTypes67.py +57 -0
  692. package/src/tests/samples/genericTypes68.py +14 -0
  693. package/src/tests/samples/genericTypes69.py +45 -0
  694. package/src/tests/samples/genericTypes7.py +24 -0
  695. package/src/tests/samples/genericTypes70.py +31 -0
  696. package/src/tests/samples/genericTypes71.py +72 -0
  697. package/src/tests/samples/genericTypes72.py +24 -0
  698. package/src/tests/samples/genericTypes73.py +14 -0
  699. package/src/tests/samples/genericTypes74.py +23 -0
  700. package/src/tests/samples/genericTypes75.py +45 -0
  701. package/src/tests/samples/genericTypes76.py +107 -0
  702. package/src/tests/samples/genericTypes77.py +26 -0
  703. package/src/tests/samples/genericTypes78.py +23 -0
  704. package/src/tests/samples/genericTypes79.py +37 -0
  705. package/src/tests/samples/genericTypes8.py +26 -0
  706. package/src/tests/samples/genericTypes80.py +10 -0
  707. package/src/tests/samples/genericTypes81.py +32 -0
  708. package/src/tests/samples/genericTypes82.py +19 -0
  709. package/src/tests/samples/genericTypes83.py +28 -0
  710. package/src/tests/samples/genericTypes84.py +11 -0
  711. package/src/tests/samples/genericTypes85.py +20 -0
  712. package/src/tests/samples/genericTypes86.py +15 -0
  713. package/src/tests/samples/genericTypes87.py +21 -0
  714. package/src/tests/samples/genericTypes88.py +25 -0
  715. package/src/tests/samples/genericTypes89.py +17 -0
  716. package/src/tests/samples/genericTypes9.py +109 -0
  717. package/src/tests/samples/genericTypes90.py +12 -0
  718. package/src/tests/samples/genericTypes91.py +20 -0
  719. package/src/tests/samples/import1.py +7 -0
  720. package/src/tests/samples/import10.py +11 -0
  721. package/src/tests/samples/import11.py +11 -0
  722. package/src/tests/samples/import12.py +5 -0
  723. package/src/tests/samples/import13.py +6 -0
  724. package/src/tests/samples/import14.py +10 -0
  725. package/src/tests/samples/import2.py +27 -0
  726. package/src/tests/samples/import3.py +8 -0
  727. package/src/tests/samples/import4.py +15 -0
  728. package/src/tests/samples/import5.py +6 -0
  729. package/src/tests/samples/import6.py +17 -0
  730. package/src/tests/samples/import7.py +14 -0
  731. package/src/tests/samples/import8.py +7 -0
  732. package/src/tests/samples/import9.py +7 -0
  733. package/src/tests/samples/inconsistentConstructor1.py +23 -0
  734. package/src/tests/samples/inconsistentSpaceTab1.py +9 -0
  735. package/src/tests/samples/inconsistentSpaceTab2.py +10 -0
  736. package/src/tests/samples/index1.py +97 -0
  737. package/src/tests/samples/inferredTypes1.py +25 -0
  738. package/src/tests/samples/initVar1.py +23 -0
  739. package/src/tests/samples/initsubclass1.py +46 -0
  740. package/src/tests/samples/initsubclass2.py +16 -0
  741. package/src/tests/samples/isinstance1.py +57 -0
  742. package/src/tests/samples/isinstance10.py +15 -0
  743. package/src/tests/samples/isinstance2.py +28 -0
  744. package/src/tests/samples/isinstance3.py +59 -0
  745. package/src/tests/samples/isinstance4.py +57 -0
  746. package/src/tests/samples/isinstance5.py +8 -0
  747. package/src/tests/samples/isinstance6.py +19 -0
  748. package/src/tests/samples/isinstance7.py +42 -0
  749. package/src/tests/samples/isinstance9.py +26 -0
  750. package/src/tests/samples/kwargsUnpack1.py +116 -0
  751. package/src/tests/samples/lambda1.py +77 -0
  752. package/src/tests/samples/lambda2.py +26 -0
  753. package/src/tests/samples/lambda3.py +34 -0
  754. package/src/tests/samples/lambda4.py +70 -0
  755. package/src/tests/samples/lambda5.py +23 -0
  756. package/src/tests/samples/lambda6.py +15 -0
  757. package/src/tests/samples/lines1.py +14 -0
  758. package/src/tests/samples/list1.py +90 -0
  759. package/src/tests/samples/listComprehension1.py +45 -0
  760. package/src/tests/samples/listComprehension2.py +17 -0
  761. package/src/tests/samples/listComprehension3.py +12 -0
  762. package/src/tests/samples/listComprehension4.py +15 -0
  763. package/src/tests/samples/listComprehension5.py +20 -0
  764. package/src/tests/samples/listComprehension6.py +14 -0
  765. package/src/tests/samples/listComprehension7.py +15 -0
  766. package/src/tests/samples/listComprehension8.py +15 -0
  767. package/src/tests/samples/literalString1.py +43 -0
  768. package/src/tests/samples/literals1.py +48 -0
  769. package/src/tests/samples/literals2.py +30 -0
  770. package/src/tests/samples/literals3.py +40 -0
  771. package/src/tests/samples/literals4.py +10 -0
  772. package/src/tests/samples/literals5.py +28 -0
  773. package/src/tests/samples/literals6.py +90 -0
  774. package/src/tests/samples/literals7.py +38 -0
  775. package/src/tests/samples/loops1.py +45 -0
  776. package/src/tests/samples/loops10.py +11 -0
  777. package/src/tests/samples/loops11.py +22 -0
  778. package/src/tests/samples/loops12.py +18 -0
  779. package/src/tests/samples/loops13.py +13 -0
  780. package/src/tests/samples/loops14.py +22 -0
  781. package/src/tests/samples/loops15.py +22 -0
  782. package/src/tests/samples/loops16.py +322 -0
  783. package/src/tests/samples/loops17.py +9 -0
  784. package/src/tests/samples/loops18.py +23 -0
  785. package/src/tests/samples/loops19.py +14 -0
  786. package/src/tests/samples/loops2.py +25 -0
  787. package/src/tests/samples/loops20.py +41 -0
  788. package/src/tests/samples/loops21.py +18 -0
  789. package/src/tests/samples/loops22.py +21 -0
  790. package/src/tests/samples/loops23.py +16 -0
  791. package/src/tests/samples/loops24.py +12 -0
  792. package/src/tests/samples/loops25.py +45 -0
  793. package/src/tests/samples/loops26.py +12 -0
  794. package/src/tests/samples/loops3.py +11 -0
  795. package/src/tests/samples/loops4.py +17 -0
  796. package/src/tests/samples/loops5.py +14 -0
  797. package/src/tests/samples/loops6.py +25 -0
  798. package/src/tests/samples/loops7.py +14 -0
  799. package/src/tests/samples/loops8.py +17 -0
  800. package/src/tests/samples/loops9.py +25 -0
  801. package/src/tests/samples/match1.py +190 -0
  802. package/src/tests/samples/match10.py +67 -0
  803. package/src/tests/samples/match2.py +340 -0
  804. package/src/tests/samples/match3.py +364 -0
  805. package/src/tests/samples/match4.py +100 -0
  806. package/src/tests/samples/match5.py +70 -0
  807. package/src/tests/samples/match6.py +64 -0
  808. package/src/tests/samples/match7.py +65 -0
  809. package/src/tests/samples/match8.py +19 -0
  810. package/src/tests/samples/match9.py +53 -0
  811. package/src/tests/samples/maxParseDepth1.py +499 -0
  812. package/src/tests/samples/maxParseDepth2.py +16 -0
  813. package/src/tests/samples/memberAccess1.py +70 -0
  814. package/src/tests/samples/memberAccess10.py +65 -0
  815. package/src/tests/samples/memberAccess11.py +37 -0
  816. package/src/tests/samples/memberAccess12.py +36 -0
  817. package/src/tests/samples/memberAccess13.py +17 -0
  818. package/src/tests/samples/memberAccess14.py +63 -0
  819. package/src/tests/samples/memberAccess15.py +20 -0
  820. package/src/tests/samples/memberAccess16.py +12 -0
  821. package/src/tests/samples/memberAccess17.py +31 -0
  822. package/src/tests/samples/memberAccess18.py +31 -0
  823. package/src/tests/samples/memberAccess2.py +45 -0
  824. package/src/tests/samples/memberAccess3.py +64 -0
  825. package/src/tests/samples/memberAccess4.py +91 -0
  826. package/src/tests/samples/memberAccess5.py +26 -0
  827. package/src/tests/samples/memberAccess6.py +52 -0
  828. package/src/tests/samples/memberAccess7.py +36 -0
  829. package/src/tests/samples/memberAccess8.py +75 -0
  830. package/src/tests/samples/memberAccess9.py +11 -0
  831. package/src/tests/samples/metaclass1.py +7 -0
  832. package/src/tests/samples/metaclass2.py +35 -0
  833. package/src/tests/samples/metaclass3.py +43 -0
  834. package/src/tests/samples/metaclass4.py +26 -0
  835. package/src/tests/samples/metaclass5.py +33 -0
  836. package/src/tests/samples/metaclass6.py +15 -0
  837. package/src/tests/samples/metaclass7.py +38 -0
  838. package/src/tests/samples/metaclass8.py +20 -0
  839. package/src/tests/samples/metaclass9.py +77 -0
  840. package/src/tests/samples/methodOverride1.py +507 -0
  841. package/src/tests/samples/methodOverride2.py +74 -0
  842. package/src/tests/samples/methodOverride3.py +111 -0
  843. package/src/tests/samples/methodOverride4.py +36 -0
  844. package/src/tests/samples/missingSuper1.py +73 -0
  845. package/src/tests/samples/module1.py +13 -0
  846. package/src/tests/samples/module2.py +7 -0
  847. package/src/tests/samples/mro1.py +16 -0
  848. package/src/tests/samples/mro2.py +45 -0
  849. package/src/tests/samples/mro3.py +30 -0
  850. package/src/tests/samples/mro4.py +30 -0
  851. package/src/tests/samples/nameBindings1.py +48 -0
  852. package/src/tests/samples/nameBindings2.py +9 -0
  853. package/src/tests/samples/nameBindings3.py +36 -0
  854. package/src/tests/samples/nameBindings4.py +10 -0
  855. package/src/tests/samples/nameBindings5.py +53 -0
  856. package/src/tests/samples/namedTuples1.py +103 -0
  857. package/src/tests/samples/namedTuples2.py +56 -0
  858. package/src/tests/samples/namedTuples3.py +15 -0
  859. package/src/tests/samples/namedTuples4.py +24 -0
  860. package/src/tests/samples/namedTuples5.py +15 -0
  861. package/src/tests/samples/namedTuples6.py +31 -0
  862. package/src/tests/samples/namedTuples7.py +27 -0
  863. package/src/tests/samples/never1.py +12 -0
  864. package/src/tests/samples/never2.py +43 -0
  865. package/src/tests/samples/newType1.py +34 -0
  866. package/src/tests/samples/newType2.py +25 -0
  867. package/src/tests/samples/newType3.py +34 -0
  868. package/src/tests/samples/newType4.py +8 -0
  869. package/src/tests/samples/none1.py +29 -0
  870. package/src/tests/samples/none2.py +22 -0
  871. package/src/tests/samples/noreturn1.py +78 -0
  872. package/src/tests/samples/noreturn2.py +37 -0
  873. package/src/tests/samples/noreturn3.py +16 -0
  874. package/src/tests/samples/noreturn4.py +29 -0
  875. package/src/tests/samples/operators1.py +101 -0
  876. package/src/tests/samples/operators2.py +30 -0
  877. package/src/tests/samples/operators3.py +8 -0
  878. package/src/tests/samples/operators4.py +22 -0
  879. package/src/tests/samples/operators5.py +5 -0
  880. package/src/tests/samples/operators6.py +10 -0
  881. package/src/tests/samples/operators7.py +24 -0
  882. package/src/tests/samples/operators8.py +125 -0
  883. package/src/tests/samples/optional1.py +77 -0
  884. package/src/tests/samples/optional2.py +23 -0
  885. package/src/tests/samples/overload1.py +50 -0
  886. package/src/tests/samples/overload10.py +48 -0
  887. package/src/tests/samples/overload2.py +37 -0
  888. package/src/tests/samples/overload3.py +29 -0
  889. package/src/tests/samples/overload4.py +46 -0
  890. package/src/tests/samples/overload5.py +333 -0
  891. package/src/tests/samples/overload6.py +64 -0
  892. package/src/tests/samples/overload7.py +376 -0
  893. package/src/tests/samples/overload8.py +89 -0
  894. package/src/tests/samples/overload9.py +19 -0
  895. package/src/tests/samples/package1/__init__.py +3 -0
  896. package/src/tests/samples/package1/psyche/pysche.py +4 -0
  897. package/src/tests/samples/package1/psyche.py +4 -0
  898. package/src/tests/samples/package1/sub/__init__.py +5 -0
  899. package/src/tests/samples/package1/sub.py +4 -0
  900. package/src/tests/samples/package1/sub.pyi +2 -0
  901. package/src/tests/samples/paramInference1.py +27 -0
  902. package/src/tests/samples/paramNames1.py +39 -0
  903. package/src/tests/samples/paramSpec1.py +64 -0
  904. package/src/tests/samples/paramSpec10.py +57 -0
  905. package/src/tests/samples/paramSpec11.py +36 -0
  906. package/src/tests/samples/paramSpec12.py +88 -0
  907. package/src/tests/samples/paramSpec13.py +112 -0
  908. package/src/tests/samples/paramSpec14.py +30 -0
  909. package/src/tests/samples/paramSpec15.py +28 -0
  910. package/src/tests/samples/paramSpec16.py +28 -0
  911. package/src/tests/samples/paramSpec17.py +34 -0
  912. package/src/tests/samples/paramSpec18.py +43 -0
  913. package/src/tests/samples/paramSpec19.py +93 -0
  914. package/src/tests/samples/paramSpec2.py +29 -0
  915. package/src/tests/samples/paramSpec20.py +87 -0
  916. package/src/tests/samples/paramSpec21.py +58 -0
  917. package/src/tests/samples/paramSpec22.py +26 -0
  918. package/src/tests/samples/paramSpec23.py +21 -0
  919. package/src/tests/samples/paramSpec24.py +67 -0
  920. package/src/tests/samples/paramSpec25.py +36 -0
  921. package/src/tests/samples/paramSpec26.py +25 -0
  922. package/src/tests/samples/paramSpec27.py +57 -0
  923. package/src/tests/samples/paramSpec28.py +39 -0
  924. package/src/tests/samples/paramSpec29.py +37 -0
  925. package/src/tests/samples/paramSpec3.py +71 -0
  926. package/src/tests/samples/paramSpec30.py +49 -0
  927. package/src/tests/samples/paramSpec31.py +16 -0
  928. package/src/tests/samples/paramSpec32.py +57 -0
  929. package/src/tests/samples/paramSpec33.py +29 -0
  930. package/src/tests/samples/paramSpec34.py +29 -0
  931. package/src/tests/samples/paramSpec35.py +24 -0
  932. package/src/tests/samples/paramSpec36.py +43 -0
  933. package/src/tests/samples/paramSpec37.py +25 -0
  934. package/src/tests/samples/paramSpec4.py +109 -0
  935. package/src/tests/samples/paramSpec5.py +29 -0
  936. package/src/tests/samples/paramSpec6.py +17 -0
  937. package/src/tests/samples/paramSpec7.py +22 -0
  938. package/src/tests/samples/paramSpec8.py +45 -0
  939. package/src/tests/samples/paramSpec9.py +57 -0
  940. package/src/tests/samples/paramType1.py +71 -0
  941. package/src/tests/samples/parameters1.py +16 -0
  942. package/src/tests/samples/partial1.py +163 -0
  943. package/src/tests/samples/partial2.py +31 -0
  944. package/src/tests/samples/private1.py +55 -0
  945. package/src/tests/samples/private2.py +11 -0
  946. package/src/tests/samples/project1/pyrightconfig.json +5 -0
  947. package/src/tests/samples/project1/sample1.py +0 -0
  948. package/src/tests/samples/project1/subfolder1/sample2.py +0 -0
  949. package/src/tests/samples/project1/subfolder1/subfolder1-1/sample3.py +0 -0
  950. package/src/tests/samples/project2/pyrightconfig.json +3 -0
  951. package/src/tests/samples/project3/pyrightconfig.json +7 -0
  952. package/src/tests/samples/project4/presentfile.py +0 -0
  953. package/src/tests/samples/project4/pyrightconfig.json +11 -0
  954. package/src/tests/samples/project4/subfolder/presentfile2.py +0 -0
  955. package/src/tests/samples/project4/subfolder/presentfile3.py +0 -0
  956. package/src/tests/samples/project5/pyrightconfig.json +4 -0
  957. package/src/tests/samples/project6/app1.py +0 -0
  958. package/src/tests/samples/project6/app2.py +0 -0
  959. package/src/tests/samples/project6/projectA/foo/__init__.py +0 -0
  960. package/src/tests/samples/project6/projectA/foo/bar/__init__.py +0 -0
  961. package/src/tests/samples/project6/projectB/foo/__init__.py +0 -0
  962. package/src/tests/samples/project6/projectB/foo/baz/__init__.py +0 -0
  963. package/src/tests/samples/project_src/src/module1.py +0 -0
  964. package/src/tests/samples/project_src_is_pkg/src/__init__.py +0 -0
  965. package/src/tests/samples/project_src_is_pkg/src/module1.py +0 -0
  966. package/src/tests/samples/project_src_with_config_extra_paths/pyrightconfig.json +3 -0
  967. package/src/tests/samples/project_src_with_config_extra_paths/src/module1.py +0 -0
  968. package/src/tests/samples/project_src_with_config_no_extra_paths/pyrightconfig.json +2 -0
  969. package/src/tests/samples/project_src_with_config_no_extra_paths/src/module1.py +0 -0
  970. package/src/tests/samples/project_src_with_extra_paths/src/_vendored/vendored1.py +1 -0
  971. package/src/tests/samples/project_src_with_extra_paths/src/module1.py +2 -0
  972. package/src/tests/samples/project_with_pyproject_toml/pyproject.toml +7 -0
  973. package/src/tests/samples/project_with_venv_auto_detect_exclude/myvenv/Lib/site-packages/library1.py +0 -0
  974. package/src/tests/samples/project_with_venv_auto_detect_exclude/myvenv/pyvenv.cfg +0 -0
  975. package/src/tests/samples/project_with_venv_auto_detect_exclude/pyrightconfig.json +2 -0
  976. package/src/tests/samples/project_with_venv_auto_detect_exclude/sample1.py +0 -0
  977. package/src/tests/samples/project_with_venv_auto_detect_exclude/subfolder1/sample2.py +0 -0
  978. package/src/tests/samples/project_with_venv_auto_detect_exclude/subfolder1/subfolder1-1/sample3.py +0 -0
  979. package/src/tests/samples/project_with_venv_auto_detect_include/excluded/excluded1.py +0 -0
  980. package/src/tests/samples/project_with_venv_auto_detect_include/myvenv/Lib/site-packages/library1.py +0 -0
  981. package/src/tests/samples/project_with_venv_auto_detect_include/myvenv/pyvenv.cfg +0 -0
  982. package/src/tests/samples/project_with_venv_auto_detect_include/pyrightconfig.json +3 -0
  983. package/src/tests/samples/project_with_venv_auto_detect_include/sample1.py +0 -0
  984. package/src/tests/samples/project_with_venv_auto_detect_include/subfolder1/sample2.py +0 -0
  985. package/src/tests/samples/project_with_venv_auto_detect_include/subfolder1/subfolder1-1/sample3.py +0 -0
  986. package/src/tests/samples/properties1.py +64 -0
  987. package/src/tests/samples/properties10.py +19 -0
  988. package/src/tests/samples/properties11.py +45 -0
  989. package/src/tests/samples/properties12.py +23 -0
  990. package/src/tests/samples/properties13.py +15 -0
  991. package/src/tests/samples/properties2.py +34 -0
  992. package/src/tests/samples/properties3.py +93 -0
  993. package/src/tests/samples/properties4.py +17 -0
  994. package/src/tests/samples/properties5.py +29 -0
  995. package/src/tests/samples/properties6.py +35 -0
  996. package/src/tests/samples/properties7.py +30 -0
  997. package/src/tests/samples/properties8.py +26 -0
  998. package/src/tests/samples/properties9.py +24 -0
  999. package/src/tests/samples/protocol1.py +132 -0
  1000. package/src/tests/samples/protocol10.py +36 -0
  1001. package/src/tests/samples/protocol11.py +32 -0
  1002. package/src/tests/samples/protocol12.py +12 -0
  1003. package/src/tests/samples/protocol13.py +26 -0
  1004. package/src/tests/samples/protocol14.py +27 -0
  1005. package/src/tests/samples/protocol15.py +27 -0
  1006. package/src/tests/samples/protocol16.py +22 -0
  1007. package/src/tests/samples/protocol17.py +94 -0
  1008. package/src/tests/samples/protocol18.py +27 -0
  1009. package/src/tests/samples/protocol19.py +39 -0
  1010. package/src/tests/samples/protocol2.py +38 -0
  1011. package/src/tests/samples/protocol20.py +22 -0
  1012. package/src/tests/samples/protocol21.py +26 -0
  1013. package/src/tests/samples/protocol22.py +43 -0
  1014. package/src/tests/samples/protocol23.py +41 -0
  1015. package/src/tests/samples/protocol24.py +74 -0
  1016. package/src/tests/samples/protocol25.py +31 -0
  1017. package/src/tests/samples/protocol26.py +40 -0
  1018. package/src/tests/samples/protocol27.py +76 -0
  1019. package/src/tests/samples/protocol28.py +32 -0
  1020. package/src/tests/samples/protocol29.py +26 -0
  1021. package/src/tests/samples/protocol3.py +110 -0
  1022. package/src/tests/samples/protocol30.py +30 -0
  1023. package/src/tests/samples/protocol31.py +22 -0
  1024. package/src/tests/samples/protocol32.py +67 -0
  1025. package/src/tests/samples/protocol33.py +39 -0
  1026. package/src/tests/samples/protocol34.py +21 -0
  1027. package/src/tests/samples/protocol4.py +22 -0
  1028. package/src/tests/samples/protocol5.py +25 -0
  1029. package/src/tests/samples/protocol6.py +65 -0
  1030. package/src/tests/samples/protocol7.py +24 -0
  1031. package/src/tests/samples/protocol8.py +34 -0
  1032. package/src/tests/samples/protocol9.py +35 -0
  1033. package/src/tests/samples/protocolModule1.py +15 -0
  1034. package/src/tests/samples/protocolModule2.py +83 -0
  1035. package/src/tests/samples/protocolModule3.py +14 -0
  1036. package/src/tests/samples/protocolModule4.py +26 -0
  1037. package/src/tests/samples/pseudoGeneric1.py +20 -0
  1038. package/src/tests/samples/pyrightIgnore1.py +11 -0
  1039. package/src/tests/samples/pyrightIgnore2.py +24 -0
  1040. package/src/tests/samples/python2.py +31 -0
  1041. package/src/tests/samples/recursiveTypeAlias1.py +79 -0
  1042. package/src/tests/samples/recursiveTypeAlias2.py +32 -0
  1043. package/src/tests/samples/recursiveTypeAlias3.py +26 -0
  1044. package/src/tests/samples/recursiveTypeAlias4.py +55 -0
  1045. package/src/tests/samples/recursiveTypeAlias5.pyi +10 -0
  1046. package/src/tests/samples/recursiveTypeAlias6.py +25 -0
  1047. package/src/tests/samples/recursiveTypeAlias7.py +15 -0
  1048. package/src/tests/samples/recursiveTypeAlias8.py +38 -0
  1049. package/src/tests/samples/recursiveTypeAlias9.py +22 -0
  1050. package/src/tests/samples/required1.py +47 -0
  1051. package/src/tests/samples/required2.py +56 -0
  1052. package/src/tests/samples/required3.py +22 -0
  1053. package/src/tests/samples/returnTypes1.py +26 -0
  1054. package/src/tests/samples/revealedType1.py +30 -0
  1055. package/src/tests/samples/sample1.py +6 -0
  1056. package/src/tests/samples/self1.py +93 -0
  1057. package/src/tests/samples/self2.py +195 -0
  1058. package/src/tests/samples/self3.py +9 -0
  1059. package/src/tests/samples/self4.py +18 -0
  1060. package/src/tests/samples/self5.py +26 -0
  1061. package/src/tests/samples/setComprehension1.py +34 -0
  1062. package/src/tests/samples/slots1.py +63 -0
  1063. package/src/tests/samples/slots2.py +38 -0
  1064. package/src/tests/samples/slots3.py +35 -0
  1065. package/src/tests/samples/specialization1.py +78 -0
  1066. package/src/tests/samples/specialization2.py +51 -0
  1067. package/src/tests/samples/staticExpressions1.py +52 -0
  1068. package/src/tests/samples/strings1.py +22 -0
  1069. package/src/tests/samples/subscript1.py +74 -0
  1070. package/src/tests/samples/subscript2.py +55 -0
  1071. package/src/tests/samples/subscript3.py +135 -0
  1072. package/src/tests/samples/suiteExpectedColon1.py +4 -0
  1073. package/src/tests/samples/suiteExpectedColon2.py +2 -0
  1074. package/src/tests/samples/suiteExpectedColon3.py +2 -0
  1075. package/src/tests/samples/super1.py +57 -0
  1076. package/src/tests/samples/super2.py +29 -0
  1077. package/src/tests/samples/super3.py +10 -0
  1078. package/src/tests/samples/super4.py +24 -0
  1079. package/src/tests/samples/super5.py +28 -0
  1080. package/src/tests/samples/super6.py +17 -0
  1081. package/src/tests/samples/super7.py +52 -0
  1082. package/src/tests/samples/super8.py +7 -0
  1083. package/src/tests/samples/super9.py +36 -0
  1084. package/src/tests/samples/test_file1.py +0 -0
  1085. package/src/tests/samples/threePartVersion1.py +33 -0
  1086. package/src/tests/samples/totalOrdering1.py +52 -0
  1087. package/src/tests/samples/tryExcept1.py +39 -0
  1088. package/src/tests/samples/tryExcept10.py +12 -0
  1089. package/src/tests/samples/tryExcept2.py +16 -0
  1090. package/src/tests/samples/tryExcept3.py +12 -0
  1091. package/src/tests/samples/tryExcept4.py +28 -0
  1092. package/src/tests/samples/tryExcept5.py +30 -0
  1093. package/src/tests/samples/tryExcept6.py +27 -0
  1094. package/src/tests/samples/tryExcept7.py +17 -0
  1095. package/src/tests/samples/tryExcept8.py +69 -0
  1096. package/src/tests/samples/tryExcept9.py +42 -0
  1097. package/src/tests/samples/tupleUnpack1.py +63 -0
  1098. package/src/tests/samples/tupleUnpack2.py +56 -0
  1099. package/src/tests/samples/tupleUnpack3.py +28 -0
  1100. package/src/tests/samples/tuples1.py +185 -0
  1101. package/src/tests/samples/tuples10.py +30 -0
  1102. package/src/tests/samples/tuples11.py +21 -0
  1103. package/src/tests/samples/tuples12.py +31 -0
  1104. package/src/tests/samples/tuples13.py +26 -0
  1105. package/src/tests/samples/tuples15.py +16 -0
  1106. package/src/tests/samples/tuples16.py +14 -0
  1107. package/src/tests/samples/tuples2.py +23 -0
  1108. package/src/tests/samples/tuples3.py +15 -0
  1109. package/src/tests/samples/tuples4.py +21 -0
  1110. package/src/tests/samples/tuples5.py +16 -0
  1111. package/src/tests/samples/tuples6.py +56 -0
  1112. package/src/tests/samples/tuples7.py +61 -0
  1113. package/src/tests/samples/tuples8.py +98 -0
  1114. package/src/tests/samples/tuples9.py +17 -0
  1115. package/src/tests/samples/typeAlias1.py +37 -0
  1116. package/src/tests/samples/typeAlias10.py +45 -0
  1117. package/src/tests/samples/typeAlias11.py +37 -0
  1118. package/src/tests/samples/typeAlias12.py +20 -0
  1119. package/src/tests/samples/typeAlias13.py +53 -0
  1120. package/src/tests/samples/typeAlias14.py +29 -0
  1121. package/src/tests/samples/typeAlias15.py +24 -0
  1122. package/src/tests/samples/typeAlias16.py +24 -0
  1123. package/src/tests/samples/typeAlias2.py +26 -0
  1124. package/src/tests/samples/typeAlias3.py +35 -0
  1125. package/src/tests/samples/typeAlias4.py +68 -0
  1126. package/src/tests/samples/typeAlias5.py +56 -0
  1127. package/src/tests/samples/typeAlias6.py +51 -0
  1128. package/src/tests/samples/typeAlias7.py +50 -0
  1129. package/src/tests/samples/typeAlias8.py +24 -0
  1130. package/src/tests/samples/typeAlias9.py +35 -0
  1131. package/src/tests/samples/typeGuard1.py +68 -0
  1132. package/src/tests/samples/typeGuard2.py +58 -0
  1133. package/src/tests/samples/typeGuard3.py +98 -0
  1134. package/src/tests/samples/typeIgnore1.py +10 -0
  1135. package/src/tests/samples/typeIgnore2.py +20 -0
  1136. package/src/tests/samples/typeIgnore3.py +22 -0
  1137. package/src/tests/samples/typeIgnore4.py +10 -0
  1138. package/src/tests/samples/typeIgnore5.py +7 -0
  1139. package/src/tests/samples/typeNarrowing1.py +56 -0
  1140. package/src/tests/samples/typeNarrowing2.py +14 -0
  1141. package/src/tests/samples/typeNarrowing3.py +47 -0
  1142. package/src/tests/samples/typeNarrowing4.py +24 -0
  1143. package/src/tests/samples/typeNarrowing5.py +19 -0
  1144. package/src/tests/samples/typeNarrowing6.py +27 -0
  1145. package/src/tests/samples/typeNarrowing7.py +71 -0
  1146. package/src/tests/samples/typeNarrowingAssert1.py +24 -0
  1147. package/src/tests/samples/typeNarrowingCallable1.py +78 -0
  1148. package/src/tests/samples/typeNarrowingEnum1.py +58 -0
  1149. package/src/tests/samples/typeNarrowingEnum2.py +71 -0
  1150. package/src/tests/samples/typeNarrowingFalsy1.py +50 -0
  1151. package/src/tests/samples/typeNarrowingIn1.py +97 -0
  1152. package/src/tests/samples/typeNarrowingIsNone1.py +56 -0
  1153. package/src/tests/samples/typeNarrowingIsNone2.py +8 -0
  1154. package/src/tests/samples/typeNarrowingIsNoneTuple1.py +42 -0
  1155. package/src/tests/samples/typeNarrowingIsNoneTuple2.py +35 -0
  1156. package/src/tests/samples/typeNarrowingIsinstance1.py +162 -0
  1157. package/src/tests/samples/typeNarrowingIsinstance2.py +14 -0
  1158. package/src/tests/samples/typeNarrowingIsinstance3.py +78 -0
  1159. package/src/tests/samples/typeNarrowingIsinstance4.py +50 -0
  1160. package/src/tests/samples/typeNarrowingIsinstance5.py +39 -0
  1161. package/src/tests/samples/typeNarrowingIsinstance6.py +77 -0
  1162. package/src/tests/samples/typeNarrowingIsinstance7.py +19 -0
  1163. package/src/tests/samples/typeNarrowingIsinstance8.py +19 -0
  1164. package/src/tests/samples/typeNarrowingLiteral1.py +35 -0
  1165. package/src/tests/samples/typeNarrowingLiteral2.py +63 -0
  1166. package/src/tests/samples/typeNarrowingLiteralMember1.py +140 -0
  1167. package/src/tests/samples/typeNarrowingLocalConst1.py +136 -0
  1168. package/src/tests/samples/typeNarrowingNoneMember1.py +102 -0
  1169. package/src/tests/samples/typeNarrowingTuple1.py +23 -0
  1170. package/src/tests/samples/typeNarrowingTupleLength1.py +47 -0
  1171. package/src/tests/samples/typeNarrowingTypeIs1.py +95 -0
  1172. package/src/tests/samples/typeNarrowingTypedDict1.py +99 -0
  1173. package/src/tests/samples/typeNarrowingTypedDict2.py +35 -0
  1174. package/src/tests/samples/typeNarrowingTypedDict3.py +45 -0
  1175. package/src/tests/samples/typePromotions1.py +30 -0
  1176. package/src/tests/samples/typeVar1.py +23 -0
  1177. package/src/tests/samples/typeVar10.py +21 -0
  1178. package/src/tests/samples/typeVar11.py +12 -0
  1179. package/src/tests/samples/typeVar2.py +26 -0
  1180. package/src/tests/samples/typeVar3.py +73 -0
  1181. package/src/tests/samples/typeVar4.py +45 -0
  1182. package/src/tests/samples/typeVar5.py +75 -0
  1183. package/src/tests/samples/typeVar6.py +115 -0
  1184. package/src/tests/samples/typeVar7.py +171 -0
  1185. package/src/tests/samples/typeVar8.py +30 -0
  1186. package/src/tests/samples/typeVar9.py +118 -0
  1187. package/src/tests/samples/typedDict1.py +63 -0
  1188. package/src/tests/samples/typedDict10.py +34 -0
  1189. package/src/tests/samples/typedDict11.py +12 -0
  1190. package/src/tests/samples/typedDict12.py +103 -0
  1191. package/src/tests/samples/typedDict13.py +14 -0
  1192. package/src/tests/samples/typedDict14.py +25 -0
  1193. package/src/tests/samples/typedDict15.py +53 -0
  1194. package/src/tests/samples/typedDict16.py +103 -0
  1195. package/src/tests/samples/typedDict17.py +24 -0
  1196. package/src/tests/samples/typedDict18.py +43 -0
  1197. package/src/tests/samples/typedDict2.py +56 -0
  1198. package/src/tests/samples/typedDict3.py +40 -0
  1199. package/src/tests/samples/typedDict4.py +68 -0
  1200. package/src/tests/samples/typedDict5.py +50 -0
  1201. package/src/tests/samples/typedDict6.py +77 -0
  1202. package/src/tests/samples/typedDict7.py +22 -0
  1203. package/src/tests/samples/typedDict8.py +19 -0
  1204. package/src/tests/samples/typedDict9.py +22 -0
  1205. package/src/tests/samples/unbound1.py +18 -0
  1206. package/src/tests/samples/unbound2.py +12 -0
  1207. package/src/tests/samples/unbound3.py +13 -0
  1208. package/src/tests/samples/unbound4.py +25 -0
  1209. package/src/tests/samples/unicode1.py +39 -0
  1210. package/src/tests/samples/uninitializedVariable1.py +27 -0
  1211. package/src/tests/samples/unions1.py +79 -0
  1212. package/src/tests/samples/unions2.py +15 -0
  1213. package/src/tests/samples/unions3.py +48 -0
  1214. package/src/tests/samples/unions4.py +20 -0
  1215. package/src/tests/samples/unions5.py +43 -0
  1216. package/src/tests/samples/unnecessaryCast1.py +13 -0
  1217. package/src/tests/samples/unnecessaryIsInstance1.py +91 -0
  1218. package/src/tests/samples/unnecessaryIsSubclass1.py +22 -0
  1219. package/src/tests/samples/unpack1.py +56 -0
  1220. package/src/tests/samples/unpack2.py +27 -0
  1221. package/src/tests/samples/unpack3.py +16 -0
  1222. package/src/tests/samples/unpack4.py +15 -0
  1223. package/src/tests/samples/unreachable1.py +112 -0
  1224. package/src/tests/samples/unusedCallResult1.py +67 -0
  1225. package/src/tests/samples/unusedCoroutine1.py +23 -0
  1226. package/src/tests/samples/unusedExpression1.py +34 -0
  1227. package/src/tests/samples/unusedVariable1.py +21 -0
  1228. package/src/tests/samples/variadicTypeVar1.py +51 -0
  1229. package/src/tests/samples/variadicTypeVar10.py +65 -0
  1230. package/src/tests/samples/variadicTypeVar11.py +72 -0
  1231. package/src/tests/samples/variadicTypeVar12.py +26 -0
  1232. package/src/tests/samples/variadicTypeVar13.py +35 -0
  1233. package/src/tests/samples/variadicTypeVar14.py +72 -0
  1234. package/src/tests/samples/variadicTypeVar2.py +63 -0
  1235. package/src/tests/samples/variadicTypeVar3.py +86 -0
  1236. package/src/tests/samples/variadicTypeVar4.py +71 -0
  1237. package/src/tests/samples/variadicTypeVar5.py +131 -0
  1238. package/src/tests/samples/variadicTypeVar6.py +78 -0
  1239. package/src/tests/samples/variadicTypeVar7.py +59 -0
  1240. package/src/tests/samples/variadicTypeVar8.py +116 -0
  1241. package/src/tests/samples/variadicTypeVar9.py +38 -0
  1242. package/src/tests/samples/with1.py +117 -0
  1243. package/src/tests/samples/with2.py +63 -0
  1244. package/src/tests/samples/with3.py +66 -0
  1245. package/src/tests/samples/with4.py +24 -0
  1246. package/src/tests/samples/with5.py +33 -0
  1247. package/src/tests/samples/zipfs/bad.egg +1 -0
  1248. package/src/tests/samples/zipfs/bad.zip +1 -0
  1249. package/src/tests/samples/zipfs/basic.egg +0 -0
  1250. package/src/tests/samples/zipfs/basic.zip +0 -0
  1251. package/src/tests/samples/zipfs/corrupt.egg +0 -0
  1252. package/src/tests/samples/zipfs/corrupt.zip +0 -0
  1253. package/src/tests/sourceFile.test.ts +25 -0
  1254. package/src/tests/stringUtils.test.ts +63 -0
  1255. package/src/tests/symbolNameUtils.test.ts +77 -0
  1256. package/src/tests/testState.test.ts +579 -0
  1257. package/src/tests/testUtils.ts +251 -0
  1258. package/src/tests/tokenizer.test.ts +1534 -0
  1259. package/src/tests/typeEvaluator1.test.ts +1372 -0
  1260. package/src/tests/typeEvaluator2.test.ts +1253 -0
  1261. package/src/tests/typeEvaluator3.test.ts +1279 -0
  1262. package/src/tests/typeEvaluator4.test.ts +1178 -0
  1263. package/src/tests/updateSymbolReference.test.ts +1107 -0
  1264. package/src/tests/zipfs.test.ts +116 -0
  1265. package/src/workspaceMap.ts +76 -0
@@ -0,0 +1,1679 @@
1
+ /*
2
+ * service.ts
3
+ * Copyright (c) Microsoft Corporation.
4
+ * Licensed under the MIT license.
5
+ * Author: Eric Traut
6
+ *
7
+ * A persistent service that is able to analyze a collection of
8
+ * Python files.
9
+ */
10
+
11
+ import * as TOML from '@iarna/toml';
12
+ import * as JSONC from 'jsonc-parser';
13
+ import {
14
+ AbstractCancellationTokenSource,
15
+ CancellationToken,
16
+ CompletionItem,
17
+ DocumentSymbol,
18
+ } from 'vscode-languageserver';
19
+ import { TextDocumentContentChangeEvent } from 'vscode-languageserver-textdocument';
20
+ import {
21
+ CallHierarchyIncomingCall,
22
+ CallHierarchyItem,
23
+ CallHierarchyOutgoingCall,
24
+ DocumentHighlight,
25
+ MarkupKind,
26
+ } from 'vscode-languageserver-types';
27
+
28
+ import { BackgroundAnalysisBase, IndexOptions } from '../backgroundAnalysisBase';
29
+ import { CancellationProvider, DefaultCancellationProvider } from '../common/cancellationUtils';
30
+ import { CommandLineOptions } from '../common/commandLineOptions';
31
+ import { ConfigOptions } from '../common/configOptions';
32
+ import { ConsoleInterface, log, LogLevel, StandardConsole } from '../common/console';
33
+ import { Diagnostic } from '../common/diagnostic';
34
+ import { FileEditActions, TextEditAction } from '../common/editAction';
35
+ import { LanguageServiceExtension } from '../common/extensibility';
36
+ import { FileSystem, FileWatcher, FileWatcherEventType, ignoredWatchEventFunction } from '../common/fileSystem';
37
+ import { Host, HostFactory, NoAccessHost } from '../common/host';
38
+ import {
39
+ combinePaths,
40
+ FileSpec,
41
+ forEachAncestorDirectory,
42
+ getDirectoryPath,
43
+ getFileName,
44
+ getFileSpec,
45
+ getFileSystemEntries,
46
+ hasPythonExtension,
47
+ isDirectory,
48
+ isFile,
49
+ makeDirectories,
50
+ normalizePath,
51
+ normalizeSlashes,
52
+ stripFileExtension,
53
+ tryRealpath,
54
+ tryStat,
55
+ } from '../common/pathUtils';
56
+ import { DocumentRange, Position, Range } from '../common/textRange';
57
+ import { timingStats } from '../common/timing';
58
+ import { AbbreviationMap, CompletionOptions, CompletionResultsList } from '../languageService/completionProvider';
59
+ import { DefinitionFilter } from '../languageService/definitionProvider';
60
+ import { IndexResults, WorkspaceSymbolCallback } from '../languageService/documentSymbolProvider';
61
+ import { HoverResults } from '../languageService/hoverProvider';
62
+ import { ReferenceCallback } from '../languageService/referencesProvider';
63
+ import { SignatureHelpResults } from '../languageService/signatureHelpProvider';
64
+ import { AnalysisCompleteCallback } from './analysis';
65
+ import { BackgroundAnalysisProgram, BackgroundAnalysisProgramFactory } from './backgroundAnalysisProgram';
66
+ import { createImportedModuleDescriptor, ImportResolver, ImportResolverFactory } from './importResolver';
67
+ import { MaxAnalysisTime, Program } from './program';
68
+ import { findPythonSearchPaths } from './pythonPathUtils';
69
+ import { TypeEvaluator } from './typeEvaluatorTypes';
70
+
71
+ export const configFileNames = ['pyrightconfig.json'];
72
+ export const pyprojectTomlName = 'pyproject.toml';
73
+
74
+ // How long since the last user activity should we wait until running
75
+ // the analyzer on any files that have not yet been analyzed?
76
+ const _userActivityBackoffTimeInMs = 250;
77
+
78
+ const _gitDirectory = normalizeSlashes('/.git/');
79
+ const _includeFileRegex = /\.pyi?$/;
80
+
81
+ // How long since the last library activity should we wait until
82
+ // re-analyzing the libraries? (10min)
83
+ const _libraryActivityBackoffTimeInMs = 60 * 1000 * 10;
84
+
85
+ export class AnalyzerService {
86
+ private _hostFactory: HostFactory;
87
+ private _instanceName: string;
88
+ private _importResolverFactory: ImportResolverFactory;
89
+ private _executionRootPath: string;
90
+ private _typeStubTargetPath: string | undefined;
91
+ private _typeStubTargetIsSingleFile = false;
92
+ private _console: ConsoleInterface;
93
+ private _sourceFileWatcher: FileWatcher | undefined;
94
+ private _reloadConfigTimer: any;
95
+ private _libraryReanalysisTimer: any;
96
+ private _configFilePath: string | undefined;
97
+ private _configFileWatcher: FileWatcher | undefined;
98
+ private _libraryFileWatcher: FileWatcher | undefined;
99
+ private _librarySearchPathsToWatch: string[] | undefined;
100
+ private _onCompletionCallback: AnalysisCompleteCallback | undefined;
101
+ private _commandLineOptions: CommandLineOptions | undefined;
102
+ private _analyzeTimer: any;
103
+ private _requireTrackedFileUpdate = true;
104
+ private _lastUserInteractionTime = Date.now();
105
+ private _extension: LanguageServiceExtension | undefined;
106
+ private _backgroundAnalysisProgram: BackgroundAnalysisProgram;
107
+ private _backgroundAnalysisCancellationSource: AbstractCancellationTokenSource | undefined;
108
+ private _maxAnalysisTimeInForeground: MaxAnalysisTime | undefined;
109
+ private _backgroundAnalysisProgramFactory: BackgroundAnalysisProgramFactory | undefined;
110
+ private _disposed = false;
111
+ private _cancellationProvider: CancellationProvider;
112
+
113
+ constructor(
114
+ instanceName: string,
115
+ fs: FileSystem,
116
+ console?: ConsoleInterface,
117
+ hostFactory?: HostFactory,
118
+ importResolverFactory?: ImportResolverFactory,
119
+ configOptions?: ConfigOptions,
120
+ extension?: LanguageServiceExtension,
121
+ backgroundAnalysis?: BackgroundAnalysisBase,
122
+ maxAnalysisTime?: MaxAnalysisTime,
123
+ backgroundAnalysisProgramFactory?: BackgroundAnalysisProgramFactory,
124
+ cancellationProvider?: CancellationProvider
125
+ ) {
126
+ this._instanceName = instanceName;
127
+ this._console = console || new StandardConsole();
128
+ this._executionRootPath = '';
129
+ this._extension = extension;
130
+ this._importResolverFactory = importResolverFactory || AnalyzerService.createImportResolver;
131
+ this._maxAnalysisTimeInForeground = maxAnalysisTime;
132
+ this._backgroundAnalysisProgramFactory = backgroundAnalysisProgramFactory;
133
+ this._cancellationProvider = cancellationProvider ?? new DefaultCancellationProvider();
134
+ this._hostFactory = hostFactory ?? (() => new NoAccessHost());
135
+
136
+ configOptions = configOptions ?? new ConfigOptions(process.cwd());
137
+ const importResolver = this._importResolverFactory(fs, configOptions, this._hostFactory());
138
+
139
+ this._backgroundAnalysisProgram =
140
+ backgroundAnalysisProgramFactory !== undefined
141
+ ? backgroundAnalysisProgramFactory(
142
+ this._console,
143
+ configOptions,
144
+ importResolver,
145
+ this._extension,
146
+ backgroundAnalysis,
147
+ this._maxAnalysisTimeInForeground
148
+ )
149
+ : new BackgroundAnalysisProgram(
150
+ this._console,
151
+ configOptions,
152
+ importResolver,
153
+ this._extension,
154
+ backgroundAnalysis,
155
+ this._maxAnalysisTimeInForeground
156
+ );
157
+ }
158
+
159
+ clone(instanceName: string, backgroundAnalysis?: BackgroundAnalysisBase, fs?: FileSystem): AnalyzerService {
160
+ const service = new AnalyzerService(
161
+ instanceName,
162
+ fs ?? this._fs,
163
+ this._console,
164
+ this._hostFactory,
165
+ this._importResolverFactory,
166
+ this._backgroundAnalysisProgram.configOptions,
167
+ this._extension,
168
+ backgroundAnalysis,
169
+ this._maxAnalysisTimeInForeground,
170
+ this._backgroundAnalysisProgramFactory,
171
+ this._cancellationProvider
172
+ );
173
+
174
+ // Make sure we keep editor content (open file) which could be different than one in the file system.
175
+ for (const fileInfo of this.backgroundAnalysisProgram.program.getOpened()) {
176
+ const version = fileInfo.sourceFile.getClientVersion();
177
+ if (version !== undefined) {
178
+ service.setFileOpened(
179
+ fileInfo.sourceFile.getFilePath(),
180
+ version,
181
+ fileInfo.sourceFile.getOpenFileContents()!
182
+ );
183
+ }
184
+ }
185
+
186
+ return service;
187
+ }
188
+
189
+ dispose() {
190
+ this._disposed = true;
191
+ this._removeSourceFileWatchers();
192
+ this._removeConfigFileWatcher();
193
+ this._removeLibraryFileWatcher();
194
+ this._clearReloadConfigTimer();
195
+ this._clearReanalysisTimer();
196
+ this._clearLibraryReanalysisTimer();
197
+ }
198
+
199
+ get librarySearchPathsToWatch() {
200
+ return this._librarySearchPathsToWatch;
201
+ }
202
+
203
+ get backgroundAnalysisProgram(): BackgroundAnalysisProgram {
204
+ return this._backgroundAnalysisProgram;
205
+ }
206
+
207
+ static createImportResolver(fs: FileSystem, options: ConfigOptions, host: Host): ImportResolver {
208
+ return new ImportResolver(fs, options, host);
209
+ }
210
+
211
+ setCompletionCallback(callback: AnalysisCompleteCallback | undefined): void {
212
+ this._onCompletionCallback = callback;
213
+ this._backgroundAnalysisProgram.setCompletionCallback(callback);
214
+ }
215
+
216
+ setOptions(commandLineOptions: CommandLineOptions): void {
217
+ this._commandLineOptions = commandLineOptions;
218
+
219
+ const host = this._hostFactory();
220
+ const configOptions = this._getConfigOptions(host, commandLineOptions);
221
+
222
+ if (configOptions.pythonPath) {
223
+ // Make sure we have default python environment set.
224
+ configOptions.ensureDefaultPythonVersion(host, this._console);
225
+ }
226
+
227
+ configOptions.ensureDefaultPythonPlatform(host, this._console);
228
+
229
+ this._backgroundAnalysisProgram.setConfigOptions(configOptions);
230
+
231
+ this._executionRootPath = normalizePath(
232
+ combinePaths(commandLineOptions.executionRoot, configOptions.projectRoot)
233
+ );
234
+ this._applyConfigOptions(host);
235
+ }
236
+
237
+ isTracked(filePath: string): boolean {
238
+ for (const includeSpec of this._configOptions.include) {
239
+ if (this._matchIncludeFileSpec(includeSpec.regExp, this._configOptions.exclude, filePath)) {
240
+ return true;
241
+ }
242
+ }
243
+
244
+ return false;
245
+ }
246
+
247
+ setFileOpened(
248
+ path: string,
249
+ version: number | null,
250
+ contents: string,
251
+ ipythonMode = false,
252
+ chainedFilePath?: string
253
+ ) {
254
+ this._backgroundAnalysisProgram.setFileOpened(path, version, contents, {
255
+ isTracked: this.isTracked(path),
256
+ ipythonMode,
257
+ chainedFilePath,
258
+ });
259
+ this._scheduleReanalysis(/* requireTrackedFileUpdate */ false);
260
+ }
261
+
262
+ updateChainedFilePath(path: string, chainedFilePath: string | undefined) {
263
+ this._backgroundAnalysisProgram.updateChainedFilePath(path, chainedFilePath);
264
+ this._scheduleReanalysis(/*requireTrackedFileUpdate*/ false);
265
+ }
266
+
267
+ updateOpenFileContents(
268
+ path: string,
269
+ version: number | null,
270
+ contents: TextDocumentContentChangeEvent[],
271
+ ipythonMode = false,
272
+ chainedFilePath?: string
273
+ ) {
274
+ this._backgroundAnalysisProgram.updateOpenFileContents(path, version, contents, {
275
+ isTracked: this.isTracked(path),
276
+ ipythonMode,
277
+ chainedFilePath,
278
+ });
279
+ this._scheduleReanalysis(/* requireTrackedFileUpdate */ false);
280
+ }
281
+
282
+ test_setIndexing(
283
+ workspaceIndices: Map<string, IndexResults>,
284
+ libraryIndices: Map<string | undefined, Map<string, IndexResults>>
285
+ ) {
286
+ this._backgroundAnalysisProgram.test_setIndexing(workspaceIndices, libraryIndices);
287
+ }
288
+
289
+ startIndexing(indexOptions: IndexOptions) {
290
+ this._backgroundAnalysisProgram.startIndexing(indexOptions);
291
+ }
292
+
293
+ setFileClosed(path: string) {
294
+ this._backgroundAnalysisProgram.setFileClosed(path);
295
+ this._scheduleReanalysis(/* requireTrackedFileUpdate */ false);
296
+ }
297
+
298
+ getParseResult(path: string) {
299
+ return this._program.getBoundSourceFile(path)?.getParseResults();
300
+ }
301
+
302
+ getTextOnRange(filePath: string, range: Range, token: CancellationToken) {
303
+ return this._program.getTextOnRange(filePath, range, token);
304
+ }
305
+
306
+ getAutoImports(
307
+ filePath: string,
308
+ range: Range,
309
+ similarityLimit: number,
310
+ nameMap: AbbreviationMap | undefined,
311
+ lazyEdit: boolean,
312
+ allowVariableInAll: boolean,
313
+ token: CancellationToken
314
+ ) {
315
+ return this._program.getAutoImports(
316
+ filePath,
317
+ range,
318
+ similarityLimit,
319
+ nameMap,
320
+ this._backgroundAnalysisProgram.getIndexing(filePath),
321
+ lazyEdit,
322
+ allowVariableInAll,
323
+ token
324
+ );
325
+ }
326
+
327
+ getDefinitionForPosition(
328
+ filePath: string,
329
+ position: Position,
330
+ filter: DefinitionFilter,
331
+ token: CancellationToken
332
+ ): DocumentRange[] | undefined {
333
+ return this._program.getDefinitionsForPosition(filePath, position, filter, token);
334
+ }
335
+
336
+ getTypeDefinitionForPosition(
337
+ filePath: string,
338
+ position: Position,
339
+ token: CancellationToken
340
+ ): DocumentRange[] | undefined {
341
+ return this._program.getTypeDefinitionsForPosition(filePath, position, token);
342
+ }
343
+
344
+ reportReferencesForPosition(
345
+ filePath: string,
346
+ position: Position,
347
+ includeDeclaration: boolean,
348
+ reporter: ReferenceCallback,
349
+ token: CancellationToken
350
+ ) {
351
+ this._program.reportReferencesForPosition(filePath, position, includeDeclaration, reporter, token);
352
+ }
353
+
354
+ addSymbolsForDocument(filePath: string, symbolList: DocumentSymbol[], token: CancellationToken) {
355
+ this._program.addSymbolsForDocument(filePath, symbolList, token);
356
+ }
357
+
358
+ reportSymbolsForWorkspace(query: string, reporter: WorkspaceSymbolCallback, token: CancellationToken) {
359
+ this._program.reportSymbolsForWorkspace(query, reporter, token);
360
+ }
361
+
362
+ getHoverForPosition(
363
+ filePath: string,
364
+ position: Position,
365
+ format: MarkupKind,
366
+ token: CancellationToken
367
+ ): HoverResults | undefined {
368
+ return this._program.getHoverForPosition(filePath, position, format, token);
369
+ }
370
+
371
+ getDocumentHighlight(
372
+ filePath: string,
373
+ position: Position,
374
+ token: CancellationToken
375
+ ): DocumentHighlight[] | undefined {
376
+ return this._program.getDocumentHighlight(filePath, position, token);
377
+ }
378
+
379
+ getSignatureHelpForPosition(
380
+ filePath: string,
381
+ position: Position,
382
+ format: MarkupKind,
383
+ token: CancellationToken
384
+ ): SignatureHelpResults | undefined {
385
+ return this._program.getSignatureHelpForPosition(filePath, position, format, token);
386
+ }
387
+
388
+ getCompletionsForPosition(
389
+ filePath: string,
390
+ position: Position,
391
+ workspacePath: string,
392
+ options: CompletionOptions,
393
+ nameMap: AbbreviationMap | undefined,
394
+ token: CancellationToken
395
+ ): Promise<CompletionResultsList | undefined> {
396
+ return this._program.getCompletionsForPosition(
397
+ filePath,
398
+ position,
399
+ workspacePath,
400
+ options,
401
+ nameMap,
402
+ this._backgroundAnalysisProgram.getIndexing(filePath),
403
+ token
404
+ );
405
+ }
406
+
407
+ getEvaluator(): TypeEvaluator | undefined {
408
+ return this._program.evaluator;
409
+ }
410
+
411
+ resolveCompletionItem(
412
+ filePath: string,
413
+ completionItem: CompletionItem,
414
+ options: CompletionOptions,
415
+ nameMap: AbbreviationMap | undefined,
416
+ token: CancellationToken
417
+ ) {
418
+ this._program.resolveCompletionItem(
419
+ filePath,
420
+ completionItem,
421
+ options,
422
+ nameMap,
423
+ this._backgroundAnalysisProgram.getIndexing(filePath),
424
+ token
425
+ );
426
+ }
427
+
428
+ performQuickAction(
429
+ filePath: string,
430
+ command: string,
431
+ args: any[],
432
+ token: CancellationToken
433
+ ): TextEditAction[] | undefined {
434
+ return this._program.performQuickAction(filePath, command, args, token);
435
+ }
436
+
437
+ renameModule(filePath: string, newFilePath: string, token: CancellationToken): FileEditActions | undefined {
438
+ return this._program.renameModule(filePath, newFilePath, token);
439
+ }
440
+
441
+ canRenameSymbolAtPosition(
442
+ filePath: string,
443
+ position: Position,
444
+ isDefaultWorkspace: boolean,
445
+ allowModuleRename: boolean,
446
+ token: CancellationToken
447
+ ): Range | undefined {
448
+ return this._program.canRenameSymbolAtPosition(
449
+ filePath,
450
+ position,
451
+ isDefaultWorkspace,
452
+ allowModuleRename,
453
+ token
454
+ );
455
+ }
456
+
457
+ renameSymbolAtPosition(
458
+ filePath: string,
459
+ position: Position,
460
+ newName: string,
461
+ isDefaultWorkspace: boolean,
462
+ allowModuleRename: boolean,
463
+ token: CancellationToken
464
+ ): FileEditActions | undefined {
465
+ return this._program.renameSymbolAtPosition(
466
+ filePath,
467
+ position,
468
+ newName,
469
+ isDefaultWorkspace,
470
+ allowModuleRename,
471
+ token
472
+ );
473
+ }
474
+
475
+ getCallForPosition(filePath: string, position: Position, token: CancellationToken): CallHierarchyItem | undefined {
476
+ return this._program.getCallForPosition(filePath, position, token);
477
+ }
478
+
479
+ getIncomingCallsForPosition(
480
+ filePath: string,
481
+ position: Position,
482
+ token: CancellationToken
483
+ ): CallHierarchyIncomingCall[] | undefined {
484
+ return this._program.getIncomingCallsForPosition(filePath, position, token);
485
+ }
486
+
487
+ getOutgoingCallsForPosition(
488
+ filePath: string,
489
+ position: Position,
490
+ token: CancellationToken
491
+ ): CallHierarchyOutgoingCall[] | undefined {
492
+ return this._program.getOutgoingCallsForPosition(filePath, position, token);
493
+ }
494
+
495
+ printStats() {
496
+ this._console.info('');
497
+ this._console.info('Analysis stats');
498
+
499
+ const boundFileCount = this._program.getFileCount();
500
+ this._console.info('Total files parsed and bound: ' + boundFileCount.toString());
501
+
502
+ const checkedFileCount = this._program.getUserFileCount();
503
+ this._console.info('Total files checked: ' + checkedFileCount.toString());
504
+ }
505
+
506
+ printDetailedAnalysisTimes() {
507
+ this._program.printDetailedAnalysisTimes();
508
+ }
509
+
510
+ printDependencies(verbose: boolean) {
511
+ this._program.printDependencies(this._executionRootPath, verbose);
512
+ }
513
+
514
+ getDiagnosticsForRange(filePath: string, range: Range, token: CancellationToken): Promise<Diagnostic[]> {
515
+ return this._backgroundAnalysisProgram.getDiagnosticsForRange(filePath, range, token);
516
+ }
517
+
518
+ getConfigOptions() {
519
+ return this._configOptions;
520
+ }
521
+
522
+ getImportResolver(): ImportResolver {
523
+ return this._backgroundAnalysisProgram.importResolver;
524
+ }
525
+
526
+ recordUserInteractionTime() {
527
+ this._lastUserInteractionTime = Date.now();
528
+
529
+ // If we have a pending timer for reanalysis, cancel it
530
+ // and reschedule for some time in the future.
531
+ if (this._analyzeTimer) {
532
+ this._scheduleReanalysis(/* requireTrackedFileUpdate */ false);
533
+ }
534
+ }
535
+
536
+ // test only APIs
537
+ get test_program() {
538
+ return this._program;
539
+ }
540
+
541
+ test_getConfigOptions(commandLineOptions: CommandLineOptions): ConfigOptions {
542
+ return this._getConfigOptions(this._backgroundAnalysisProgram.host, commandLineOptions);
543
+ }
544
+
545
+ test_getFileNamesFromFileSpecs(): string[] {
546
+ return this._getFileNamesFromFileSpecs();
547
+ }
548
+
549
+ // Calculates the effective options based on the command-line options,
550
+ // an optional config file, and default values.
551
+ private _getConfigOptions(host: Host, commandLineOptions: CommandLineOptions): ConfigOptions {
552
+ let projectRoot = commandLineOptions.executionRoot;
553
+ let configFilePath: string | undefined;
554
+ let pyprojectFilePath: string | undefined;
555
+
556
+ if (commandLineOptions.configFilePath) {
557
+ // If the config file path was specified, determine whether it's
558
+ // a directory (in which case the default config file name is assumed)
559
+ // or a file.
560
+ configFilePath = combinePaths(
561
+ commandLineOptions.executionRoot,
562
+ normalizePath(commandLineOptions.configFilePath)
563
+ );
564
+ if (!this._fs.existsSync(configFilePath)) {
565
+ this._console.info(`Configuration file not found at ${configFilePath}.`);
566
+ configFilePath = commandLineOptions.executionRoot;
567
+ } else {
568
+ if (configFilePath.toLowerCase().endsWith('.json')) {
569
+ projectRoot = getDirectoryPath(configFilePath);
570
+ } else {
571
+ projectRoot = configFilePath;
572
+ configFilePath = this._findConfigFile(configFilePath);
573
+ if (!configFilePath) {
574
+ this._console.info(`Configuration file not found at ${projectRoot}.`);
575
+ }
576
+ }
577
+ }
578
+ } else if (projectRoot) {
579
+ // In a project-based IDE like VS Code, we should assume that the
580
+ // project root directory contains the config file.
581
+ configFilePath = this._findConfigFile(projectRoot);
582
+
583
+ // If pyright is being executed from the command line, the working
584
+ // directory may be deep within a project, and we need to walk up the
585
+ // directory hierarchy to find the project root.
586
+ if (!configFilePath && !commandLineOptions.fromVsCodeExtension) {
587
+ configFilePath = this._findConfigFileHereOrUp(projectRoot);
588
+ }
589
+
590
+ if (configFilePath) {
591
+ projectRoot = getDirectoryPath(configFilePath);
592
+ } else {
593
+ this._console.info(`No configuration file found.`);
594
+ configFilePath = undefined;
595
+ }
596
+ }
597
+
598
+ if (!configFilePath) {
599
+ // See if we can find a pyproject.toml file in this directory.
600
+ pyprojectFilePath = this._findPyprojectTomlFile(projectRoot);
601
+
602
+ if (!pyprojectFilePath && !commandLineOptions.fromVsCodeExtension) {
603
+ pyprojectFilePath = this._findPyprojectTomlFileHereOrUp(projectRoot);
604
+ }
605
+
606
+ if (pyprojectFilePath) {
607
+ projectRoot = getDirectoryPath(pyprojectFilePath);
608
+ this._console.info(`pyproject.toml file found at ${projectRoot}.`);
609
+ } else {
610
+ this._console.info(`No pyproject.toml file found.`);
611
+ }
612
+ }
613
+
614
+ const configOptions = new ConfigOptions(projectRoot, this._typeCheckingMode);
615
+ const defaultExcludes = ['**/node_modules', '**/__pycache__', '**/.*'];
616
+
617
+ if (commandLineOptions.pythonPath) {
618
+ this._console.info(
619
+ `Setting pythonPath for service "${this._instanceName}": ` + `"${commandLineOptions.pythonPath}"`
620
+ );
621
+ configOptions.pythonPath = commandLineOptions.pythonPath;
622
+ }
623
+
624
+ // The pythonPlatform and pythonVersion from the command-line can be overridden
625
+ // by the config file, so initialize them upfront.
626
+ configOptions.defaultPythonPlatform = commandLineOptions.pythonPlatform;
627
+ configOptions.defaultPythonVersion = commandLineOptions.pythonVersion;
628
+ configOptions.ensureDefaultExtraPaths(
629
+ this._fs,
630
+ commandLineOptions.autoSearchPaths || false,
631
+ commandLineOptions.extraPaths
632
+ );
633
+
634
+ if (commandLineOptions.fileSpecs.length > 0) {
635
+ commandLineOptions.fileSpecs.forEach((fileSpec) => {
636
+ configOptions.include.push(getFileSpec(this._fs, projectRoot, fileSpec));
637
+ });
638
+ } else if (!configFilePath) {
639
+ // If no config file was found and there are no explicit include
640
+ // paths specified, assume the caller wants to include all source
641
+ // files under the execution root path.
642
+ if (commandLineOptions.executionRoot) {
643
+ configOptions.include.push(getFileSpec(this._fs, commandLineOptions.executionRoot, '.'));
644
+
645
+ // Add a few common excludes to avoid long scan times.
646
+ defaultExcludes.forEach((exclude) => {
647
+ configOptions.exclude.push(getFileSpec(this._fs, commandLineOptions.executionRoot, exclude));
648
+ });
649
+ }
650
+ }
651
+
652
+ this._configFilePath = configFilePath || pyprojectFilePath;
653
+
654
+ // If we found a config file, parse it to compute the effective options.
655
+ let configJsonObj: object | undefined;
656
+ if (configFilePath) {
657
+ this._console.info(`Loading configuration file at ${configFilePath}`);
658
+ configJsonObj = this._parseJsonConfigFile(configFilePath);
659
+ } else if (pyprojectFilePath) {
660
+ this._console.info(`Loading pyproject.toml file at ${pyprojectFilePath}`);
661
+ configJsonObj = this._parsePyprojectTomlFile(pyprojectFilePath);
662
+ }
663
+
664
+ if (configJsonObj) {
665
+ configOptions.initializeFromJson(
666
+ configJsonObj,
667
+ this._typeCheckingMode,
668
+ this._console,
669
+ this._fs,
670
+ host,
671
+ commandLineOptions.diagnosticSeverityOverrides,
672
+ commandLineOptions.fileSpecs.length > 0
673
+ );
674
+
675
+ const configFileDir = getDirectoryPath(this._configFilePath!);
676
+
677
+ // If no include paths were provided, assume that all files within
678
+ // the project should be included.
679
+ if (configOptions.include.length === 0) {
680
+ this._console.info(`No include entries specified; assuming ${configFileDir}`);
681
+ configOptions.include.push(getFileSpec(this._fs, configFileDir, '.'));
682
+ }
683
+
684
+ // If there was no explicit set of excludes, add a few common ones to avoid long scan times.
685
+ if (configOptions.exclude.length === 0) {
686
+ defaultExcludes.forEach((exclude) => {
687
+ this._console.info(`Auto-excluding ${exclude}`);
688
+ configOptions.exclude.push(getFileSpec(this._fs, configFileDir, exclude));
689
+ });
690
+
691
+ if (configOptions.autoExcludeVenv === undefined) {
692
+ configOptions.autoExcludeVenv = true;
693
+ }
694
+ }
695
+ } else {
696
+ configOptions.autoExcludeVenv = true;
697
+ configOptions.applyDiagnosticOverrides(commandLineOptions.diagnosticSeverityOverrides);
698
+ }
699
+
700
+ configOptions.analyzeUnannotatedFunctions = commandLineOptions.analyzeUnannotatedFunctions ?? true;
701
+
702
+ const reportDuplicateSetting = (settingName: string, configValue: number | string | boolean) => {
703
+ const settingSource = commandLineOptions.fromVsCodeExtension
704
+ ? 'the client settings'
705
+ : 'a command-line option';
706
+ this._console.warn(
707
+ `The ${settingName} has been specified in both the config file and ` +
708
+ `${settingSource}. The value in the config file (${configValue}) ` +
709
+ `will take precedence`
710
+ );
711
+ };
712
+
713
+ // Apply the command-line options if the corresponding
714
+ // item wasn't already set in the config file. Report any
715
+ // duplicates.
716
+ if (commandLineOptions.venvPath) {
717
+ if (!configOptions.venvPath) {
718
+ configOptions.venvPath = commandLineOptions.venvPath;
719
+ } else {
720
+ reportDuplicateSetting('venvPath', configOptions.venvPath);
721
+ }
722
+ }
723
+
724
+ if (commandLineOptions.typeshedPath) {
725
+ if (!configOptions.typeshedPath) {
726
+ configOptions.typeshedPath = commandLineOptions.typeshedPath;
727
+ } else {
728
+ reportDuplicateSetting('typeshedPath', configOptions.typeshedPath);
729
+ }
730
+ }
731
+
732
+ configOptions.verboseOutput = commandLineOptions.verboseOutput ?? configOptions.verboseOutput;
733
+ configOptions.checkOnlyOpenFiles = !!commandLineOptions.checkOnlyOpenFiles;
734
+ configOptions.autoImportCompletions = !!commandLineOptions.autoImportCompletions;
735
+ configOptions.indexing = !!commandLineOptions.indexing;
736
+ configOptions.logTypeEvaluationTime = !!commandLineOptions.logTypeEvaluationTime;
737
+ configOptions.typeEvaluationTimeThreshold = commandLineOptions.typeEvaluationTimeThreshold;
738
+
739
+ // If useLibraryCodeForTypes was not specified in the config, allow the settings
740
+ // or command line to override it.
741
+ if (configOptions.useLibraryCodeForTypes === undefined) {
742
+ configOptions.useLibraryCodeForTypes = !!commandLineOptions.useLibraryCodeForTypes;
743
+ } else if (commandLineOptions.useLibraryCodeForTypes !== undefined) {
744
+ reportDuplicateSetting('useLibraryCodeForTypes', configOptions.useLibraryCodeForTypes);
745
+ }
746
+
747
+ // If there was no stub path specified, use a default path.
748
+ if (commandLineOptions.stubPath) {
749
+ if (!configOptions.stubPath) {
750
+ configOptions.stubPath = commandLineOptions.stubPath;
751
+ } else {
752
+ reportDuplicateSetting('stubPath', configOptions.stubPath);
753
+ }
754
+ } else {
755
+ if (!configOptions.stubPath) {
756
+ configOptions.stubPath = normalizePath(combinePaths(configOptions.projectRoot, 'typings'));
757
+ }
758
+ }
759
+
760
+ // Do some sanity checks on the specified settings and report missing
761
+ // or inconsistent information.
762
+ if (configOptions.venvPath) {
763
+ if (!this._fs.existsSync(configOptions.venvPath) || !isDirectory(this._fs, configOptions.venvPath)) {
764
+ this._console.error(`venvPath ${configOptions.venvPath} is not a valid directory.`);
765
+ }
766
+
767
+ // venvPath without venv means it won't do anything while resolveImport.
768
+ // so first, try to set venv from existing configOption if it is null. if both are null,
769
+ // then, resolveImport won't consider venv
770
+ configOptions.venv = configOptions.venv ?? this._configOptions.venv;
771
+ if (configOptions.venv) {
772
+ const fullVenvPath = combinePaths(configOptions.venvPath, configOptions.venv);
773
+
774
+ if (!this._fs.existsSync(fullVenvPath) || !isDirectory(this._fs, fullVenvPath)) {
775
+ this._console.error(
776
+ `venv ${configOptions.venv} subdirectory not found in venv path ${configOptions.venvPath}.`
777
+ );
778
+ } else {
779
+ const importFailureInfo: string[] = [];
780
+ if (findPythonSearchPaths(this._fs, configOptions, host, importFailureInfo) === undefined) {
781
+ this._console.error(
782
+ `site-packages directory cannot be located for venvPath ` +
783
+ `${configOptions.venvPath} and venv ${configOptions.venv}.`
784
+ );
785
+
786
+ if (configOptions.verboseOutput) {
787
+ importFailureInfo.forEach((diag) => {
788
+ this._console.error(` ${diag}`);
789
+ });
790
+ }
791
+ }
792
+ }
793
+ }
794
+ }
795
+
796
+ // Is there a reference to a venv? If so, there needs to be a valid venvPath.
797
+ if (configOptions.venv) {
798
+ if (!configOptions.venvPath) {
799
+ this._console.warn(`venvPath not specified, so venv settings will be ignored.`);
800
+ }
801
+ }
802
+
803
+ if (configOptions.typeshedPath) {
804
+ if (
805
+ !this._fs.existsSync(configOptions.typeshedPath) ||
806
+ !isDirectory(this._fs, configOptions.typeshedPath)
807
+ ) {
808
+ this._console.error(`typeshedPath ${configOptions.typeshedPath} is not a valid directory.`);
809
+ }
810
+ }
811
+
812
+ if (configOptions.stubPath) {
813
+ if (!this._fs.existsSync(configOptions.stubPath) || !isDirectory(this._fs, configOptions.stubPath)) {
814
+ this._console.warn(`stubPath ${configOptions.stubPath} is not a valid directory.`);
815
+ }
816
+ }
817
+
818
+ return configOptions;
819
+ }
820
+
821
+ writeTypeStub(token: CancellationToken): void {
822
+ const typingsSubdirPath = this._getTypeStubFolder();
823
+
824
+ this._program.writeTypeStub(
825
+ this._typeStubTargetPath ?? '',
826
+ this._typeStubTargetIsSingleFile,
827
+ typingsSubdirPath,
828
+ token
829
+ );
830
+ }
831
+
832
+ writeTypeStubInBackground(token: CancellationToken): Promise<any> {
833
+ const typingsSubdirPath = this._getTypeStubFolder();
834
+
835
+ return this._backgroundAnalysisProgram.writeTypeStub(
836
+ this._typeStubTargetPath ?? '',
837
+ this._typeStubTargetIsSingleFile,
838
+ typingsSubdirPath,
839
+ token
840
+ );
841
+ }
842
+
843
+ // This is called after a new type stub has been created. It allows
844
+ // us to invalidate caches and force reanalysis of files that potentially
845
+ // are affected by the appearance of a new type stub.
846
+ invalidateAndForceReanalysis(
847
+ rebuildUserFileIndexing = true,
848
+ rebuildLibraryIndexing = true,
849
+ updateTrackedFileList = false
850
+ ) {
851
+ if (updateTrackedFileList) {
852
+ this._updateTrackedFileList(/* markFilesDirtyUnconditionally */ false);
853
+ }
854
+
855
+ // Mark all files with one or more errors dirty.
856
+ this._backgroundAnalysisProgram.invalidateAndForceReanalysis(rebuildUserFileIndexing, rebuildLibraryIndexing);
857
+ }
858
+
859
+ // Forces the service to stop all analysis, discard all its caches,
860
+ // and research for files.
861
+ restart() {
862
+ this._applyConfigOptions(this._hostFactory());
863
+
864
+ this._backgroundAnalysisProgram.restart();
865
+ }
866
+
867
+ private get _fs() {
868
+ return this._backgroundAnalysisProgram.importResolver.fileSystem;
869
+ }
870
+
871
+ private get _program() {
872
+ return this._backgroundAnalysisProgram.program;
873
+ }
874
+
875
+ private get _configOptions() {
876
+ return this._backgroundAnalysisProgram.configOptions;
877
+ }
878
+
879
+ private get _watchForSourceChanges() {
880
+ return !!this._commandLineOptions?.watchForSourceChanges;
881
+ }
882
+
883
+ private get _watchForLibraryChanges() {
884
+ return !!this._commandLineOptions?.watchForLibraryChanges;
885
+ }
886
+
887
+ private get _watchForConfigChanges() {
888
+ return !!this._commandLineOptions?.watchForConfigChanges;
889
+ }
890
+
891
+ private get _typeCheckingMode() {
892
+ return this._commandLineOptions?.typeCheckingMode;
893
+ }
894
+
895
+ private get _verboseOutput(): boolean {
896
+ return !!this._configOptions.verboseOutput;
897
+ }
898
+
899
+ private get _typeStubTargetImportName() {
900
+ return this._commandLineOptions?.typeStubTargetImportName;
901
+ }
902
+
903
+ private _getTypeStubFolder() {
904
+ const stubPath = this._configOptions.stubPath;
905
+ if (!this._typeStubTargetPath || !this._typeStubTargetImportName) {
906
+ const errMsg = `Import '${this._typeStubTargetImportName}'` + ` could not be resolved`;
907
+ this._console.error(errMsg);
908
+ throw new Error(errMsg);
909
+ }
910
+
911
+ if (!stubPath) {
912
+ // We should never get here because we always generate a
913
+ // default typings path if none was specified.
914
+ const errMsg = 'No typings path was specified';
915
+ this._console.info(errMsg);
916
+ throw new Error(errMsg);
917
+ }
918
+
919
+ const typeStubInputTargetParts = this._typeStubTargetImportName.split('.');
920
+ if (typeStubInputTargetParts[0].length === 0) {
921
+ // We should never get here because the import resolution
922
+ // would have failed.
923
+ const errMsg = `Import '${this._typeStubTargetImportName}'` + ` could not be resolved`;
924
+ this._console.error(errMsg);
925
+ throw new Error(errMsg);
926
+ }
927
+
928
+ try {
929
+ // Generate a new typings directory if necessary.
930
+ if (!this._fs.existsSync(stubPath)) {
931
+ this._fs.mkdirSync(stubPath);
932
+ }
933
+ } catch (e: any) {
934
+ const errMsg = `Could not create typings directory '${stubPath}'`;
935
+ this._console.error(errMsg);
936
+ throw new Error(errMsg);
937
+ }
938
+
939
+ // Generate a typings subdirectory hierarchy.
940
+ const typingsSubdirPath = combinePaths(stubPath, typeStubInputTargetParts[0]);
941
+ const typingsSubdirHierarchy = combinePaths(stubPath, ...typeStubInputTargetParts);
942
+
943
+ try {
944
+ // Generate a new typings subdirectory if necessary.
945
+ if (!this._fs.existsSync(typingsSubdirHierarchy)) {
946
+ makeDirectories(this._fs, typingsSubdirHierarchy, stubPath);
947
+ }
948
+ } catch (e: any) {
949
+ const errMsg = `Could not create typings subdirectory '${typingsSubdirHierarchy}'`;
950
+ this._console.error(errMsg);
951
+ throw new Error(errMsg);
952
+ }
953
+
954
+ return typingsSubdirPath;
955
+ }
956
+
957
+ private _findConfigFileHereOrUp(searchPath: string): string | undefined {
958
+ return forEachAncestorDirectory(searchPath, (ancestor) => this._findConfigFile(ancestor));
959
+ }
960
+
961
+ private _findConfigFile(searchPath: string): string | undefined {
962
+ for (const name of configFileNames) {
963
+ const fileName = combinePaths(searchPath, name);
964
+ if (this._fs.existsSync(fileName)) {
965
+ return fileName;
966
+ }
967
+ }
968
+ return undefined;
969
+ }
970
+
971
+ private _findPyprojectTomlFileHereOrUp(searchPath: string): string | undefined {
972
+ return forEachAncestorDirectory(searchPath, (ancestor) => this._findPyprojectTomlFile(ancestor));
973
+ }
974
+
975
+ private _findPyprojectTomlFile(searchPath: string) {
976
+ const fileName = combinePaths(searchPath, pyprojectTomlName);
977
+ if (this._fs.existsSync(fileName)) {
978
+ return fileName;
979
+ }
980
+ return undefined;
981
+ }
982
+
983
+ private _parseJsonConfigFile(configPath: string): object | undefined {
984
+ return this._attemptParseFile(configPath, (fileContents) => {
985
+ return JSONC.parse(fileContents);
986
+ });
987
+ }
988
+
989
+ private _parsePyprojectTomlFile(pyprojectPath: string): object | undefined {
990
+ return this._attemptParseFile(pyprojectPath, (fileContents, attemptCount) => {
991
+ try {
992
+ const configObj = TOML.parse(fileContents);
993
+ if (configObj && configObj.tool && (configObj.tool as TOML.JsonMap).pyright) {
994
+ return (configObj.tool as TOML.JsonMap).pyright as object;
995
+ }
996
+ } catch (e: any) {
997
+ this._console.error(`Pyproject file parse attempt ${attemptCount} error: ${JSON.stringify(e)}`);
998
+ throw e;
999
+ }
1000
+
1001
+ this._console.error(`Pyproject file "${pyprojectPath}" is missing "[tool.pyright]" section.`);
1002
+ return undefined;
1003
+ });
1004
+ }
1005
+
1006
+ private _attemptParseFile(
1007
+ filePath: string,
1008
+ parseCallback: (contents: string, attempt: number) => object | undefined
1009
+ ): object | undefined {
1010
+ let fileContents = '';
1011
+ let parseAttemptCount = 0;
1012
+
1013
+ while (true) {
1014
+ // Attempt to read the file contents.
1015
+ try {
1016
+ fileContents = this._fs.readFileSync(filePath, 'utf8');
1017
+ } catch {
1018
+ this._console.error(`Config file "${filePath}" could not be read.`);
1019
+ this._reportConfigParseError();
1020
+ return undefined;
1021
+ }
1022
+
1023
+ // Attempt to parse the file.
1024
+ let parseFailed = false;
1025
+ try {
1026
+ return parseCallback(fileContents, parseAttemptCount + 1);
1027
+ } catch (e: any) {
1028
+ parseFailed = true;
1029
+ }
1030
+
1031
+ if (!parseFailed) {
1032
+ break;
1033
+ }
1034
+
1035
+ // If we attempt to read the file immediately after it was saved, it
1036
+ // may have been partially written when we read it, resulting in parse
1037
+ // errors. We'll give it a little more time and try again.
1038
+ if (parseAttemptCount++ >= 5) {
1039
+ this._console.error(`Config file "${filePath}" could not be parsed. Verify that format is correct.`);
1040
+ this._reportConfigParseError();
1041
+ return undefined;
1042
+ }
1043
+ }
1044
+
1045
+ return undefined;
1046
+ }
1047
+
1048
+ private _getFileNamesFromFileSpecs(): string[] {
1049
+ // Use a map to generate a list of unique files.
1050
+ const fileMap = new Map<string, string>();
1051
+
1052
+ timingStats.findFilesTime.timeOperation(() => {
1053
+ const matchedFiles = this._matchFiles(this._configOptions.include, this._configOptions.exclude);
1054
+
1055
+ for (const file of matchedFiles) {
1056
+ fileMap.set(file, file);
1057
+ }
1058
+ });
1059
+
1060
+ return [...fileMap.values()];
1061
+ }
1062
+
1063
+ // If markFilesDirtyUnconditionally is true, we need to reparse
1064
+ // and reanalyze all files in the program. If false, we will
1065
+ // reparse and reanalyze only those files whose on-disk contents
1066
+ // have changed. Unconditional dirtying is needed in the case where
1067
+ // configuration options have changed.
1068
+ private _updateTrackedFileList(markFilesDirtyUnconditionally: boolean) {
1069
+ // Are we in type stub generation mode? If so, we need to search
1070
+ // for a different set of files.
1071
+ if (this._typeStubTargetImportName) {
1072
+ const execEnv = this._configOptions.findExecEnvironment(this._executionRootPath);
1073
+ const moduleDescriptor = createImportedModuleDescriptor(this._typeStubTargetImportName);
1074
+ const importResult = this._backgroundAnalysisProgram.importResolver.resolveImport(
1075
+ '',
1076
+ execEnv,
1077
+ moduleDescriptor
1078
+ );
1079
+
1080
+ if (importResult.isImportFound) {
1081
+ const filesToImport: string[] = [];
1082
+
1083
+ // Determine the directory that contains the root package.
1084
+ const finalResolvedPath = importResult.resolvedPaths[importResult.resolvedPaths.length - 1];
1085
+ const isFinalPathFile = isFile(this._fs, finalResolvedPath);
1086
+ const isFinalPathInitFile =
1087
+ isFinalPathFile && stripFileExtension(getFileName(finalResolvedPath)) === '__init__';
1088
+
1089
+ let rootPackagePath = finalResolvedPath;
1090
+
1091
+ if (isFinalPathFile) {
1092
+ // If the module is a __init__.pyi? file, use its parent directory instead.
1093
+ rootPackagePath = getDirectoryPath(rootPackagePath);
1094
+ }
1095
+
1096
+ for (let i = importResult.resolvedPaths.length - 2; i >= 0; i--) {
1097
+ if (importResult.resolvedPaths[i]) {
1098
+ rootPackagePath = importResult.resolvedPaths[i];
1099
+ } else {
1100
+ // If there was no file corresponding to this portion
1101
+ // of the name path, assume that it's contained
1102
+ // within its parent directory.
1103
+ rootPackagePath = getDirectoryPath(rootPackagePath);
1104
+ }
1105
+ }
1106
+
1107
+ if (isDirectory(this._fs, rootPackagePath)) {
1108
+ this._typeStubTargetPath = rootPackagePath;
1109
+ } else if (isFile(this._fs, rootPackagePath)) {
1110
+ // This can occur if there is a "dir/__init__.py" at the same level as a
1111
+ // module "dir/module.py" that is specifically targeted for stub generation.
1112
+ this._typeStubTargetPath = getDirectoryPath(rootPackagePath);
1113
+ }
1114
+
1115
+ if (!finalResolvedPath) {
1116
+ this._typeStubTargetIsSingleFile = false;
1117
+ } else {
1118
+ filesToImport.push(finalResolvedPath);
1119
+ this._typeStubTargetIsSingleFile = importResult.resolvedPaths.length === 1 && !isFinalPathInitFile;
1120
+ }
1121
+
1122
+ // Add the implicit import paths.
1123
+ importResult.filteredImplicitImports.forEach((implicitImport) => {
1124
+ filesToImport.push(implicitImport.path);
1125
+ });
1126
+
1127
+ this._backgroundAnalysisProgram.setAllowedThirdPartyImports([this._typeStubTargetImportName]);
1128
+ this._backgroundAnalysisProgram.setTrackedFiles(filesToImport);
1129
+ } else {
1130
+ this._console.error(`Import '${this._typeStubTargetImportName}' not found`);
1131
+ }
1132
+ } else {
1133
+ let fileList: string[] = [];
1134
+ this._console.info(`Searching for source files`);
1135
+ fileList = this._getFileNamesFromFileSpecs();
1136
+
1137
+ this._backgroundAnalysisProgram.setTrackedFiles(fileList);
1138
+ this._backgroundAnalysisProgram.markAllFilesDirty(markFilesDirtyUnconditionally);
1139
+
1140
+ if (fileList.length === 0) {
1141
+ this._console.info(`No source files found.`);
1142
+ } else {
1143
+ this._console.info(`Found ${fileList.length} ` + `source ${fileList.length === 1 ? 'file' : 'files'}`);
1144
+ }
1145
+ }
1146
+
1147
+ this._requireTrackedFileUpdate = false;
1148
+ }
1149
+
1150
+ private _matchFiles(include: FileSpec[], exclude: FileSpec[]): string[] {
1151
+ const envMarkers = [['bin', 'activate'], ['Scripts', 'activate'], ['pyvenv.cfg']];
1152
+ const results: string[] = [];
1153
+ const startTime = Date.now();
1154
+ const longOperationLimitInSec = 10;
1155
+ let loggedLongOperationError = false;
1156
+
1157
+ const visitDirectoryUnchecked = (absolutePath: string, includeRegExp: RegExp) => {
1158
+ if (!loggedLongOperationError) {
1159
+ const secondsSinceStart = (Date.now() - startTime) * 0.001;
1160
+
1161
+ // If this is taking a long time, log an error to help the user
1162
+ // diagnose and mitigate the problem.
1163
+ if (secondsSinceStart >= longOperationLimitInSec) {
1164
+ this._console.error(
1165
+ `Enumeration of workspace source files is taking longer than ${longOperationLimitInSec} seconds.\n` +
1166
+ 'This may be because:\n' +
1167
+ '* You have opened your home directory or entire hard drive as a workspace\n' +
1168
+ '* Your workspace contains a very large number of directories and files\n' +
1169
+ '* Your workspace contains a symlink to a directory with many files\n' +
1170
+ '* Your workspace is remote, and file enumeration is slow\n' +
1171
+ 'To reduce this time, open a workspace directory with fewer files ' +
1172
+ 'or add a pyrightconfig.json configuration file with an "exclude" section to exclude ' +
1173
+ 'subdirectories from your workspace. For more details, refer to ' +
1174
+ 'https://github.com/microsoft/pyright/blob/main/docs/configuration.md.'
1175
+ );
1176
+ loggedLongOperationError = true;
1177
+ }
1178
+ }
1179
+
1180
+ if (this._configOptions.autoExcludeVenv) {
1181
+ if (envMarkers.some((f) => this._fs.existsSync(combinePaths(absolutePath, ...f)))) {
1182
+ this._console.info(`Auto-excluding ${absolutePath}`);
1183
+ return;
1184
+ }
1185
+ }
1186
+
1187
+ const { files, directories } = getFileSystemEntries(this._fs, absolutePath);
1188
+
1189
+ for (const file of files) {
1190
+ const filePath = combinePaths(absolutePath, file);
1191
+
1192
+ if (this._matchIncludeFileSpec(includeRegExp, exclude, filePath)) {
1193
+ results.push(filePath);
1194
+ }
1195
+ }
1196
+
1197
+ for (const directory of directories) {
1198
+ const dirPath = combinePaths(absolutePath, directory);
1199
+ if (includeRegExp.test(dirPath)) {
1200
+ if (!this._isInExcludePath(dirPath, exclude)) {
1201
+ visitDirectory(dirPath, includeRegExp);
1202
+ }
1203
+ }
1204
+ }
1205
+ };
1206
+
1207
+ const seenDirs = new Set<string>();
1208
+ const visitDirectory = (absolutePath: string, includeRegExp: RegExp) => {
1209
+ const realDirPath = tryRealpath(this._fs, absolutePath);
1210
+ if (!realDirPath) {
1211
+ this._console.warn(`Skipping broken link "${absolutePath}"`);
1212
+ return;
1213
+ }
1214
+
1215
+ if (seenDirs.has(realDirPath)) {
1216
+ this._console.warn(`Skipping recursive symlink "${absolutePath}" -> "${realDirPath}"`);
1217
+ return;
1218
+ }
1219
+ seenDirs.add(realDirPath);
1220
+
1221
+ try {
1222
+ visitDirectoryUnchecked(absolutePath, includeRegExp);
1223
+ } finally {
1224
+ seenDirs.delete(realDirPath);
1225
+ }
1226
+ };
1227
+
1228
+ include.forEach((includeSpec) => {
1229
+ if (!this._isInExcludePath(includeSpec.wildcardRoot, exclude)) {
1230
+ let foundFileSpec = false;
1231
+ let isFileIncluded = true;
1232
+
1233
+ const stat = tryStat(this._fs, includeSpec.wildcardRoot);
1234
+ if (stat?.isFile()) {
1235
+ if (this._shouldIncludeFile(includeSpec.wildcardRoot)) {
1236
+ results.push(includeSpec.wildcardRoot);
1237
+ } else {
1238
+ isFileIncluded = false;
1239
+ }
1240
+ foundFileSpec = true;
1241
+ } else if (stat?.isDirectory()) {
1242
+ visitDirectory(includeSpec.wildcardRoot, includeSpec.regExp);
1243
+ foundFileSpec = true;
1244
+ }
1245
+
1246
+ if (!foundFileSpec) {
1247
+ this._console.error(`File or directory "${includeSpec.wildcardRoot}" does not exist.`);
1248
+ } else if (!isFileIncluded) {
1249
+ this._console.error(`File "${includeSpec.wildcardRoot}" is not a Python source file.`);
1250
+ }
1251
+ }
1252
+ });
1253
+
1254
+ return results;
1255
+ }
1256
+
1257
+ private _removeSourceFileWatchers() {
1258
+ if (this._sourceFileWatcher) {
1259
+ this._sourceFileWatcher.close();
1260
+ this._sourceFileWatcher = undefined;
1261
+ }
1262
+ }
1263
+
1264
+ private _updateSourceFileWatchers() {
1265
+ this._removeSourceFileWatchers();
1266
+
1267
+ if (!this._watchForSourceChanges) {
1268
+ return;
1269
+ }
1270
+
1271
+ if (this._configOptions.include.length > 0) {
1272
+ const fileList = this._configOptions.include.map((spec) => {
1273
+ return combinePaths(this._executionRootPath, spec.wildcardRoot);
1274
+ });
1275
+
1276
+ try {
1277
+ if (this._verboseOutput) {
1278
+ this._console.info(`Adding fs watcher for directories:\n ${fileList.join('\n')}`);
1279
+ }
1280
+
1281
+ const isIgnored = ignoredWatchEventFunction(fileList);
1282
+ this._sourceFileWatcher = this._fs.createFileSystemWatcher(fileList, (event, path) => {
1283
+ if (!path) {
1284
+ return;
1285
+ }
1286
+
1287
+ if (this._verboseOutput) {
1288
+ this._console.info(`SourceFile: Received fs event '${event}' for path '${path}'`);
1289
+ }
1290
+
1291
+ if (isIgnored(path)) {
1292
+ return;
1293
+ }
1294
+
1295
+ // Wholesale ignore events that appear to be from tmp file / .git modification.
1296
+ if (path.endsWith('.tmp') || path.endsWith('.git') || path.includes(_gitDirectory)) {
1297
+ return;
1298
+ }
1299
+
1300
+ const eventInfo = getEventInfo(this._fs, this._console, this._program, event, path);
1301
+ if (!eventInfo) {
1302
+ // no-op event, return.
1303
+ return;
1304
+ }
1305
+
1306
+ // For file change, we only care python file change.
1307
+ if (
1308
+ eventInfo.isFile &&
1309
+ (!hasPythonExtension(path) || isTemporaryFile(path) || !this.isTracked(path))
1310
+ ) {
1311
+ return;
1312
+ }
1313
+
1314
+ if (eventInfo.isFile && (eventInfo.event === 'change' || eventInfo.event === 'unlink')) {
1315
+ this._backgroundAnalysisProgram.markFilesDirty([path], /* evenIfContentsAreSame */ false);
1316
+ this._scheduleReanalysis(/* requireTrackedFileUpdate */ false);
1317
+ } else {
1318
+ // Added files or folder changes impact imports,
1319
+ // clear the import resolver cache and reanalyze everything.
1320
+ //
1321
+ // Here we don't need to rebuild any indexing since this kind of change can't affect
1322
+ // indices. For library, since the changes are on workspace files, it won't affect library
1323
+ // indices. For user file, since user file indices don't contains import alias symbols,
1324
+ // it won't affect those indices. we only need to rebuild user file indices when symbols
1325
+ // defined in the file are changed. ex) user modified the file.
1326
+ // Newly added file will be scanned since it doesn't have existing indices.
1327
+ this.invalidateAndForceReanalysis(
1328
+ /* rebuildUserFileIndexing */ false,
1329
+ /* rebuildLibraryIndexing */ false
1330
+ );
1331
+ this._scheduleReanalysis(/* requireTrackedFileUpdate */ true);
1332
+ }
1333
+ });
1334
+ } catch {
1335
+ this._console.error(`Exception caught when installing fs watcher for:\n ${fileList.join('\n')}`);
1336
+ }
1337
+ }
1338
+
1339
+ function isTemporaryFile(path: string) {
1340
+ // Determine if this is an add or delete event related to a temporary
1341
+ // file. Some tools (like auto-formatters) create temporary files
1342
+ // alongside the original file and name them "x.py.<temp-id>.py" where
1343
+ // <temp-id> is a 32-character random string of hex digits. We don't
1344
+ // want these events to trigger a full reanalysis.
1345
+ const fileName = getFileName(path);
1346
+ const fileNameSplit = fileName.split('.');
1347
+ if (fileNameSplit.length === 4) {
1348
+ if (fileNameSplit[3] === fileNameSplit[1] && fileNameSplit[2].length === 32) {
1349
+ return true;
1350
+ }
1351
+ }
1352
+
1353
+ return false;
1354
+ }
1355
+
1356
+ function getEventInfo(
1357
+ fs: FileSystem,
1358
+ console: ConsoleInterface,
1359
+ program: Program,
1360
+ event: FileWatcherEventType,
1361
+ path: string
1362
+ ) {
1363
+ // Due to the way we implemented file watcher, we will only get 2 events; 'add' and 'change'.
1364
+ // Here, we will convert those 2 to 3 events. 'add', 'change' and 'unlink';
1365
+ const stats = tryStat(fs, path);
1366
+ if (event === 'add') {
1367
+ if (!stats) {
1368
+ // If we are told that the path is added, but if we can't access it, then consider it as already deleted.
1369
+ // there is nothing we need to do.
1370
+ return undefined;
1371
+ }
1372
+
1373
+ return { event, isFile: stats.isFile() };
1374
+ }
1375
+
1376
+ if (event === 'change') {
1377
+ // If we got 'change', but can't access the path, then we consider it as delete.
1378
+ if (!stats) {
1379
+ // See whether it is a file that got deleted.
1380
+ const isFile = !!program.getSourceFile(path);
1381
+
1382
+ // If not, check whether it is a part of the workspace at all.
1383
+ if (!isFile && !program.containsSourceFileIn(path)) {
1384
+ // There is no source file under the given path. There is nothing we need to do.
1385
+ return undefined;
1386
+ }
1387
+
1388
+ return { event: 'unlink', isFile };
1389
+ }
1390
+
1391
+ return { event, isFile: stats.isFile() };
1392
+ }
1393
+
1394
+ // We have unknown event.
1395
+ console.warn(`Received unknown file change event: '${event}' for '${path}'`);
1396
+ return undefined;
1397
+ }
1398
+ }
1399
+
1400
+ private _removeLibraryFileWatcher() {
1401
+ if (this._libraryFileWatcher) {
1402
+ this._libraryFileWatcher.close();
1403
+ this._libraryFileWatcher = undefined;
1404
+ }
1405
+ }
1406
+
1407
+ private _updateLibraryFileWatcher() {
1408
+ this._removeLibraryFileWatcher();
1409
+
1410
+ if (!this._watchForLibraryChanges) {
1411
+ return;
1412
+ }
1413
+
1414
+ // Watch the library paths for package install/uninstall.
1415
+ const importFailureInfo: string[] = [];
1416
+ this._librarySearchPathsToWatch = findPythonSearchPaths(
1417
+ this._fs,
1418
+ this._backgroundAnalysisProgram.configOptions,
1419
+ this._backgroundAnalysisProgram.host,
1420
+ importFailureInfo,
1421
+ true,
1422
+ this._executionRootPath
1423
+ );
1424
+
1425
+ const watchList = this._librarySearchPathsToWatch;
1426
+ if (watchList && watchList.length > 0) {
1427
+ try {
1428
+ if (this._verboseOutput) {
1429
+ this._console.info(`Adding fs watcher for library directories:\n ${watchList.join('\n')}`);
1430
+ }
1431
+ const isIgnored = ignoredWatchEventFunction(watchList);
1432
+ this._libraryFileWatcher = this._fs.createFileSystemWatcher(watchList, (event, path) => {
1433
+ if (!path) {
1434
+ return;
1435
+ }
1436
+
1437
+ if (this._verboseOutput) {
1438
+ this._console.info(`LibraryFile: Received fs event '${event}' for path '${path}'`);
1439
+ }
1440
+
1441
+ if (isIgnored(path)) {
1442
+ return;
1443
+ }
1444
+
1445
+ this._scheduleLibraryAnalysis();
1446
+ });
1447
+ } catch {
1448
+ this._console.error(`Exception caught when installing fs watcher for:\n ${watchList.join('\n')}`);
1449
+ }
1450
+ }
1451
+ }
1452
+
1453
+ private _clearLibraryReanalysisTimer() {
1454
+ if (this._libraryReanalysisTimer) {
1455
+ clearTimeout(this._libraryReanalysisTimer);
1456
+ this._libraryReanalysisTimer = undefined;
1457
+ this._backgroundAnalysisProgram?.cancelIndexing();
1458
+ }
1459
+ }
1460
+
1461
+ private _scheduleLibraryAnalysis() {
1462
+ if (this._disposed) {
1463
+ // Already disposed.
1464
+ return;
1465
+ }
1466
+
1467
+ this._clearLibraryReanalysisTimer();
1468
+
1469
+ // Wait for a little while, since library changes
1470
+ // tend to happen in big batches when packages
1471
+ // are installed or uninstalled.
1472
+ this._libraryReanalysisTimer = setTimeout(() => {
1473
+ this._clearLibraryReanalysisTimer();
1474
+
1475
+ // Invalidate import resolver, mark all files dirty unconditionally,
1476
+ // and reanalyze.
1477
+ this.invalidateAndForceReanalysis(/* rebuildUserFileIndexing */ false);
1478
+ this._scheduleReanalysis(/* requireTrackedFileUpdate */ false);
1479
+ }, _libraryActivityBackoffTimeInMs);
1480
+ }
1481
+
1482
+ private _removeConfigFileWatcher() {
1483
+ if (this._configFileWatcher) {
1484
+ this._configFileWatcher.close();
1485
+ this._configFileWatcher = undefined;
1486
+ }
1487
+ }
1488
+
1489
+ private _updateConfigFileWatcher() {
1490
+ this._removeConfigFileWatcher();
1491
+
1492
+ if (!this._watchForConfigChanges) {
1493
+ return;
1494
+ }
1495
+
1496
+ if (this._configFilePath) {
1497
+ this._configFileWatcher = this._fs.createFileSystemWatcher([this._configFilePath], (event) => {
1498
+ if (this._verboseOutput) {
1499
+ this._console.info(`Received fs event '${event}' for config file`);
1500
+ }
1501
+ this._scheduleReloadConfigFile();
1502
+ });
1503
+ } else if (this._executionRootPath) {
1504
+ this._configFileWatcher = this._fs.createFileSystemWatcher([this._executionRootPath], (event, path) => {
1505
+ if (!path) {
1506
+ return;
1507
+ }
1508
+
1509
+ if (event === 'add' || event === 'change') {
1510
+ const fileName = getFileName(path);
1511
+ if (fileName && configFileNames.some((name) => name === fileName)) {
1512
+ if (this._verboseOutput) {
1513
+ this._console.info(`Received fs event '${event}' for config file`);
1514
+ }
1515
+ if (this._commandLineOptions) {
1516
+ this.setOptions(this._commandLineOptions);
1517
+ }
1518
+ }
1519
+ }
1520
+ });
1521
+ }
1522
+ }
1523
+
1524
+ private _clearReloadConfigTimer() {
1525
+ if (this._reloadConfigTimer) {
1526
+ clearTimeout(this._reloadConfigTimer);
1527
+ this._reloadConfigTimer = undefined;
1528
+ }
1529
+ }
1530
+
1531
+ private _scheduleReloadConfigFile() {
1532
+ this._clearReloadConfigTimer();
1533
+
1534
+ // Wait for a little while after we receive the
1535
+ // change update event because it may take a while
1536
+ // for the file to be written out. Plus, there may
1537
+ // be multiple changes.
1538
+ this._reloadConfigTimer = setTimeout(() => {
1539
+ this._clearReloadConfigTimer();
1540
+ this._reloadConfigFile();
1541
+ }, 100);
1542
+ }
1543
+
1544
+ private _reloadConfigFile() {
1545
+ this._updateConfigFileWatcher();
1546
+
1547
+ if (this._configFilePath) {
1548
+ this._console.info(`Reloading configuration file at ${this._configFilePath}`);
1549
+
1550
+ const host = this._backgroundAnalysisProgram.host;
1551
+
1552
+ // We can't just reload config file when it is changed; we need to consider
1553
+ // command line options as well to construct new config Options.
1554
+ const configOptions = this._getConfigOptions(host, this._commandLineOptions!);
1555
+ this._backgroundAnalysisProgram.setConfigOptions(configOptions);
1556
+
1557
+ this._applyConfigOptions(host);
1558
+ }
1559
+ }
1560
+
1561
+ private _applyConfigOptions(host: Host) {
1562
+ // Allocate a new import resolver because the old one has information
1563
+ // cached based on the previous config options.
1564
+ const importResolver = this._importResolverFactory(
1565
+ this._fs,
1566
+ this._backgroundAnalysisProgram.configOptions,
1567
+ host
1568
+ );
1569
+
1570
+ this._backgroundAnalysisProgram.setImportResolver(importResolver);
1571
+
1572
+ if (this._commandLineOptions?.fromVsCodeExtension || this._configOptions.verboseOutput) {
1573
+ const logLevel = this._configOptions.verboseOutput ? LogLevel.Info : LogLevel.Log;
1574
+ for (const execEnv of this._configOptions.getExecutionEnvironments()) {
1575
+ log(this._console, logLevel, `Search paths for ${execEnv.root || '<default>'}`);
1576
+ const roots = importResolver.getImportRoots(execEnv, /* forLogging */ true);
1577
+ roots.forEach((path) => {
1578
+ log(this._console, logLevel, ` ${path}`);
1579
+ });
1580
+ }
1581
+ }
1582
+
1583
+ this._updateLibraryFileWatcher();
1584
+ this._updateConfigFileWatcher();
1585
+ this._updateSourceFileWatchers();
1586
+ this._updateTrackedFileList(/* markFilesDirtyUnconditionally */ true);
1587
+
1588
+ this._scheduleReanalysis(/* requireTrackedFileUpdate */ false);
1589
+ }
1590
+
1591
+ private _clearReanalysisTimer() {
1592
+ if (this._analyzeTimer) {
1593
+ clearTimeout(this._analyzeTimer);
1594
+ this._analyzeTimer = undefined;
1595
+ }
1596
+ }
1597
+
1598
+ private _scheduleReanalysis(requireTrackedFileUpdate: boolean) {
1599
+ if (this._disposed || !this._commandLineOptions?.enableAmbientAnalysis) {
1600
+ // already disposed
1601
+ return;
1602
+ }
1603
+
1604
+ if (requireTrackedFileUpdate) {
1605
+ this._requireTrackedFileUpdate = true;
1606
+ }
1607
+
1608
+ this._backgroundAnalysisCancellationSource?.cancel();
1609
+
1610
+ // Remove any existing analysis timer.
1611
+ this._clearReanalysisTimer();
1612
+
1613
+ // How long has it been since the user interacted with the service?
1614
+ // If the user is actively typing, back off to let him or her finish.
1615
+ const timeSinceLastUserInteractionInMs = Date.now() - this._lastUserInteractionTime;
1616
+ const minBackoffTimeInMs = _userActivityBackoffTimeInMs;
1617
+
1618
+ // We choose a small non-zero value here. If this value
1619
+ // is too small (like zero), the VS Code extension becomes
1620
+ // unresponsive during heavy analysis. If this number is too
1621
+ // large, analysis takes longer.
1622
+ const minTimeBetweenAnalysisPassesInMs = 20;
1623
+
1624
+ const timeUntilNextAnalysisInMs = Math.max(
1625
+ minBackoffTimeInMs - timeSinceLastUserInteractionInMs,
1626
+ minTimeBetweenAnalysisPassesInMs
1627
+ );
1628
+
1629
+ // Schedule a new timer.
1630
+ this._analyzeTimer = setTimeout(() => {
1631
+ this._analyzeTimer = undefined;
1632
+
1633
+ if (this._requireTrackedFileUpdate) {
1634
+ this._updateTrackedFileList(/* markFilesDirtyUnconditionally */ false);
1635
+ }
1636
+
1637
+ // This creates a cancellation source only if it actually gets used.
1638
+ this._backgroundAnalysisCancellationSource = this._cancellationProvider.createCancellationTokenSource();
1639
+ const moreToAnalyze = this._backgroundAnalysisProgram.startAnalysis(
1640
+ this._backgroundAnalysisCancellationSource.token
1641
+ );
1642
+ if (moreToAnalyze) {
1643
+ this._scheduleReanalysis(/* requireTrackedFileUpdate */ false);
1644
+ }
1645
+ }, timeUntilNextAnalysisInMs);
1646
+ }
1647
+
1648
+ private _reportConfigParseError() {
1649
+ if (this._onCompletionCallback) {
1650
+ this._onCompletionCallback({
1651
+ diagnostics: [],
1652
+ filesInProgram: 0,
1653
+ filesRequiringAnalysis: 0,
1654
+ checkingOnlyOpenFiles: true,
1655
+ fatalErrorOccurred: false,
1656
+ configParseErrorOccurred: true,
1657
+ elapsedTime: 0,
1658
+ });
1659
+ }
1660
+ }
1661
+
1662
+ private _shouldIncludeFile(filePath: string) {
1663
+ return _includeFileRegex.test(filePath);
1664
+ }
1665
+
1666
+ private _isInExcludePath(path: string, excludePaths: FileSpec[]) {
1667
+ return !!excludePaths.find((excl) => excl.regExp.test(path));
1668
+ }
1669
+
1670
+ private _matchIncludeFileSpec(includeRegExp: RegExp, exclude: FileSpec[], filePath: string) {
1671
+ if (includeRegExp.test(filePath)) {
1672
+ if (!this._isInExcludePath(filePath, exclude) && this._shouldIncludeFile(filePath)) {
1673
+ return true;
1674
+ }
1675
+ }
1676
+
1677
+ return false;
1678
+ }
1679
+ }