PySymbol

Extends Symbol for Python codebases.

Inherits from

Symbol, Usable, Importable, Expression, HasName, Editable

Attributes

comment

extended

extended_nodes

extended_source

file

filepath

full_name

function_calls

inline_comment

is_exported

name

parent

parent_class

parent_function

parent_statement

resolved_value

source

symbol_type

variable_usages

Methods

add_comment

Adds a new comment to the symbol.

add_keyword

Insert a keyword in the appropriate place before this symbol if it doesn’t already exist.

ancestors

Find all ancestors of the node of the given type. Does not return itself

dependencies

Returns a list of symbols that this symbol depends on.

edit

Replace the source of this node with new_src.

find

Find and return matching nodes or substrings within an Editable instance.

find_string_literals

Returns a list of string literals within this node’s source that match any of the given

flag

Flags a Python symbol by adding a flag comment and returning a CodeFlag.

get_import_string

Generates an import string for a Python symbol.

get_name

Returns the name node of the object.

get_variable_usages

Returns Editables for all TreeSitter nodes corresponding to instances of variable usage

insert_after

Inserts code after this node.

insert_before

Inserts text before the current symbol node in the Abstract Syntax Tree.

is_child_of

Checks if this node is a descendant of the given editable instance in the AST.

is_wrapped_in

Check if this node is contained another node of the given class

move_to_file

Moves the given symbol to a new file and updates its imports and references.

parent_of_type

Find the first ancestor of the node of the given type. Does not return itself

parent_of_types

Find the first ancestor of the node of the given type. Does not return itself

reduce_condition

Reduces an editable to the following condition

remove

Deletes this Node and its related extended nodes (e.g. decorators, comments).

rename

Renames a symbol and updates all its references in the codebase.

replace

Search and replace occurrences of text within this node’s source and its extended nodes.

search

Returns a list of all regex match of regex_pattern, similar to python’s re.search().

set_comment

Sets a comment for the Python symbol.

set_inline_comment

Sets an inline comment to the symbol.

set_name

Sets the name of a code element.

symbol_usages

Returns a list of symbols that use or import the exportable object.

usages

Returns a list of usages of the exportable object.