ExternalModule
Represents an external module, like datetime
, that can be referenced
These are only added to the graph during import resolution and will not exist in a local file’s subgraph. This is because we don’t know what an import is referencing or resolves to until we see the full codebase.
Inherits from
GraphSitterBase, Callable, Exportable, HasName, Expression, Editable
Properties
call_sites
All invocations of this function elsewhere in the codebase
export
Returns the export object that exports this symbol. Returns none if this symbol is not exported.
exported_name
Returns the name the symbol is exported as. If the symbol is not exported, returns None.
extended
Returns a SymbolGroup of all extended nodes. This allows a common edit interface for all of extended nodes.
extended_source
Text representation of all its extended nodes
file
Will always return None as ExternalModule is not part of a file
filepath
The file path of the file that this Editable instance belongs to
full_name
The full name including the object lookup (if applicable).
Examples: For a.b, the full name is a.b
function_calls
Returns all contained function calls. Useful for renaming function invocations etc.
is_exported
Returns True iff the symbol is exported from the file it’s defined in
is_reexported
Returns True if the symbol is re-exported from a file it is not defined in (if applicable)
name
The name of the object excluding whichever namespace precedes it, as a string.
Examples: For a.b, the name is b
parameters
Returns list of named parameters from an external function symbol
resolved_value
If the expression is a resolvable value, returns the last assigned expression value. Else, returns itself.
Example: a = 1 b = a foo(b)
If we call resolve_value on b, it returns 1.
source
Text representation of the Editable instance
variable_usages
Returns Editables for all TreeSitter node instances of variable usages. (Excludes: property identifiers and argument keywords) This is useful for renaming variables locally and analyzing variable usages.
Methods
call_graph_successors
Returns all Callable
objects that are reachable from this Callable
.
Args: include_classes (bool): If True, includes class definitions in the code paths. include_external (bool): If True, includes external modules in the code paths.
Returns:
list[Function | ExternalModule]: A list of Function
or ExternalModule
objects that are reachable from this Callable
.
commit
Commit just this node
edit
Replace the source of this Editable
with new_src
.
When fix_indentation
is True, the indentation of new_src
will be adjusted to match the current text’s indentation.
find
Returns a list of all substring match in strings_to_match
, similar to python’s str.find(..)
Args: exact: Only match individual nodes which exactly match the query
find_string_literals
Returns a list of all editable substrings within string literals that match strings_to_match
flag
Adds a comment so the developer can see this Editable
from_import
Returns an ExternalModule instance from an Import instance
get_all_symbol_usages
Returns a list of all symbols that uses this exportable object, via direct or indirect usages. Equivalent to get_symbol_usages(UsageType.DIRECT | UsageType.INDIRECT | UsageType.ALIASED)
get_all_usages
Returns a list of all usages of this exportable object, via direct or indirect usages. Equivalent to get_usages(UsageType.DIRECT | UsageType.INDIRECT | UsageType.ALIASED)
get_import_string
Returns the import string used to import this module
get_name
Returns the Name of the object, as a Name
(editable)
get_parameter
Returns the parameter with the given name, or None if it doesn’t exist.
get_parameter_by_index
Returns the parameter with the given index, or None if it doesn’t exist.
get_parameter_by_type
Returns the parameter of specified type, or None if it doesn’t exist.
get_symbol_usages
Symbols that uses this exportable object, or imports that imports this exportable object.
By default, only returns direct usages, such as Imports or usages within the same file. In other words, it will tell you where this symbol is imported, but not where it is used.
Inverse of dependencies
.
Arguments: usage_types: What kind of usages to search for
get_usages
Returns a list of usages of the exportable object. By default, only returns direct usages, such as Imports or usages within the same file. In other words, it will tell you where this symbol is imported, but not where it is used. Useful for dead code deletion.
Arguments: usage_types: What kind of usages to search for
get_variable_usages
Returns Editables for all TreeSitter nodes corresponding to instances of variable usage that matches the given variable name.
(Excludes: property identifiers and argument keywords)
fuzzy_match
allows for partial matching of variable names and effectively does var_name in usage.name
insert_after
Inserts new_src after this node
insert_before
Inserts new_src before this node
remove
Deletes this Node, and optionally its related extended nodes (e.g. decorators, comments, etc.)
rename
Sets the name of the object as well its usages
replace
Search and replace an instance of substring
within this node’s source. Similar to python’s string.replace(..)
Throws ValueError if there are more than one occurrence of substring in this node’s source.
Arguments:
old: the occurrences of this string to replace
new: the string to replace with
count: the max number of occurrences to replace. Default value: -1 (replace all)
is_regex: whether old
is a regex pattern. Default value: False
Returns:
The total count of old
occurrences replaced.
search
Returns a list of all regex match of regex_pattern
, similar to python’s re.search(…)
When include_strings
is False, the search will exclude the contents of string literals from the search.
When include_comments
is False, the search will exclude the contents of comments from the search.
set_name
Sets the name of the object
Was this page helpful?