@suss/adapter-python 0.35.0 → 0.36.0

package/dist/index.d.cts

@@ -2,8 +2,8 @@ import { RequestSpellingMetadata, TypeShape, WrapperReference, BehavioralSummary
 import { Tree, Node } from 'web-tree-sitter';
 export { Node as PyNode, Tree as PyTree } from 'web-tree-sitter';
 import { Database } from '@suss/datalog';
-import { RedirectOption, RawCodeStructure, ExtractorOptions, TimingReport, ExtractionReport, CacheDiagnostic, DeclaredModule, KeptParses } from '@suss/extractor';
-import { UnwrapsByName, WhyExplained } from '@suss/resolution';
+import { DeclaredEntryPoint, LibraryEnvVars, RedirectOption, RawCodeStructure, ExtractorOptions, TimingReport, ExtractionReport, CacheDiagnostic, DeclaredModule, KeptParses } from '@suss/extractor';
+import { UnwrapsByName, SubclassPlace, WhyExplained } from '@suss/resolution';
 
 /**
  * Loads the Python grammar into web-tree-sitter and parses a file.
@@ -105,6 +105,14 @@ interface PythonPack {
     /** Wire protocol for the produced boundary bindings, e.g. "http". */
     protocol: string;
     discovery: PythonDiscoveryPattern[];
+    /**
+     * The functions a deploy manifest says the platform calls in a file,
+     * given the file's absolute path. The adapter builds the units on each
+     * function it finds by name, and the call walk starts there.
+     */
+    entryPoints?: (file: string) => DeclaredEntryPoint[];
+    /** Environment variables the library reads from its own installed code, where no walk over the project goes. */
+    libraryEnvVars?: LibraryEnvVars[];
     /**
      * Wrapper modules around the library that a person lists when
      * configuring the pack. The library's own module does not go here. The adapter
@@ -1033,6 +1041,12 @@ interface ReachedFunction {
     readonly name: string;
     /** `[name]` for a module function, `[Class, name]` for a method. */
     readonly exportPath: string[];
+    /** The subclass the method runs on, when the call reached it through a class that inherits it. Calls on `self` or `cls` then resolve against that class. */
+    readonly receiverClass?: PythonSubclass;
+}
+/** A class that inherits a method: its name, the file that declares it, and its key in the value facts. */
+interface PythonSubclass extends SubclassPlace {
+    readonly key: string;
 }
 
 /**

package/dist/index.d.ts

@@ -2,8 +2,8 @@ import { RequestSpellingMetadata, TypeShape, WrapperReference, BehavioralSummary
 import { Tree, Node } from 'web-tree-sitter';
 export { Node as PyNode, Tree as PyTree } from 'web-tree-sitter';
 import { Database } from '@suss/datalog';
-import { RedirectOption, RawCodeStructure, ExtractorOptions, TimingReport, ExtractionReport, CacheDiagnostic, DeclaredModule, KeptParses } from '@suss/extractor';
-import { UnwrapsByName, WhyExplained } from '@suss/resolution';
+import { DeclaredEntryPoint, LibraryEnvVars, RedirectOption, RawCodeStructure, ExtractorOptions, TimingReport, ExtractionReport, CacheDiagnostic, DeclaredModule, KeptParses } from '@suss/extractor';
+import { UnwrapsByName, SubclassPlace, WhyExplained } from '@suss/resolution';
 
 /**
  * Loads the Python grammar into web-tree-sitter and parses a file.
@@ -105,6 +105,14 @@ interface PythonPack {
     /** Wire protocol for the produced boundary bindings, e.g. "http". */
     protocol: string;
     discovery: PythonDiscoveryPattern[];
+    /**
+     * The functions a deploy manifest says the platform calls in a file,
+     * given the file's absolute path. The adapter builds the units on each
+     * function it finds by name, and the call walk starts there.
+     */
+    entryPoints?: (file: string) => DeclaredEntryPoint[];
+    /** Environment variables the library reads from its own installed code, where no walk over the project goes. */
+    libraryEnvVars?: LibraryEnvVars[];
     /**
      * Wrapper modules around the library that a person lists when
      * configuring the pack. The library's own module does not go here. The adapter
@@ -1033,6 +1041,12 @@ interface ReachedFunction {
     readonly name: string;
     /** `[name]` for a module function, `[Class, name]` for a method. */
     readonly exportPath: string[];
+    /** The subclass the method runs on, when the call reached it through a class that inherits it. Calls on `self` or `cls` then resolve against that class. */
+    readonly receiverClass?: PythonSubclass;
+}
+/** A class that inherits a method: its name, the file that declares it, and its key in the value facts. */
+interface PythonSubclass extends SubclassPlace {
+    readonly key: string;
 }
 
 /**