polyglot-piranha 0.3.33__tar.gz → 0.3.35__tar.gz

{polyglot_piranha-0.3.33 → polyglot_piranha-0.3.35}/Cargo.lock

@@ -13,9 +13,9 @@ dependencies = [
 
 [[package]]
 name = "anstream"
-version = "0.6.18"
+version = "0.6.19"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8acc5369981196006228e28809f761875c0327210a891e941f4c683b3a99529b"
+checksum = "301af1932e46185686725e0fad2f8f2aa7da69dd70bf6ecc44d6b703844a3933"
 dependencies = [
  "anstyle",
  "anstyle-parse",
@@ -28,33 +28,33 @@ dependencies = [
 
 [[package]]
 name = "anstyle"
-version = "1.0.10"
+version = "1.0.11"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "55cc3b69f167a1ef2e161439aa98aed94e6028e5f9a59be9a6ffb47aef1651f9"
+checksum = "862ed96ca487e809f1c8e5a8447f6ee2cf102f846893800b20cebdf541fc6bbd"
 
 [[package]]
 name = "anstyle-parse"
-version = "0.2.6"
+version = "0.2.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3b2d16507662817a6a20a9ea92df6652ee4f94f914589377d69f3b21bc5798a9"
+checksum = "4e7644824f0aa2c7b9384579234ef10eb7efb6a0deb83f9630a49594dd9c15c2"
 dependencies = [
  "utf8parse",
 ]
 
 [[package]]
 name = "anstyle-query"
-version = "1.1.2"
+version = "1.1.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "79947af37f4177cfead1110013d678905c37501914fba0efea834c3fe9a8d60c"
+checksum = "6c8bdeb6047d8983be085bab0ba1472e6dc604e7041dbf6fcd5e71523014fae9"
 dependencies = [
  "windows-sys",
 ]
 
 [[package]]
 name = "anstyle-wincon"
-version = "3.0.8"
+version = "3.0.9"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6680de5231bd6ee4c6191b8a1325daa282b415391ec9d3a37bd34f2060dc73fa"
+checksum = "403f75924867bb1033c59fbf0797484329750cfbe3c4325cd33127941fabc882"
 dependencies = [
  "anstyle",
  "once_cell_polyfill",
@@ -114,9 +114,9 @@ checksum = "066fce287b1d4eafef758e89e09d724a24808a9196fe9756b8ca90e86d0719a2"
 
 [[package]]
 name = "cfg-if"
-version = "1.0.0"
+version = "1.0.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "baf1de4339761588bc0619e3cbc0120ee582ebb74b53b4efbf79117bd2da40fd"
+checksum = "9555578bc9e57714c812a1f84e4fc5b4d21fcb063490c624de019f7464c91268"
 
 [[package]]
 name = "cfg_aliases"
@@ -126,9 +126,9 @@ checksum = "613afe47fcd5fac7ccf1db93babcb082c5994d996f20b8b159f2ad1658eb5724"
 
 [[package]]
 name = "clap"
-version = "4.5.39"
+version = "4.5.40"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "fd60e63e9be68e5fb56422e397cf9baddded06dae1d2e523401542383bc72a9f"
+checksum = "40b6887a1d8685cebccf115538db5c0efe625ccac9696ad45c409d96566e910f"
 dependencies = [
  "clap_builder",
  "clap_derive",
@@ -136,9 +136,9 @@ dependencies = [
 
 [[package]]
 name = "clap_builder"
-version = "4.5.39"
+version = "4.5.40"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "89cc6392a1f72bbeb820d71f32108f61fdaf18bc526e1d23954168a67759ef51"
+checksum = "e0c66c08ce9f0c698cbce5c0279d0bb6ac936d8674174fe48f736533b964f59e"
 dependencies = [
  "anstream",
  "anstyle",
@@ -148,27 +148,27 @@ dependencies = [
 
 [[package]]
 name = "clap_derive"
-version = "4.5.32"
+version = "4.5.40"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "09176aae279615badda0765c0c0b3f6ed53f4709118af73cf4655d85d1530cd7"
+checksum = "d2c7947ae4cc3d851207c1adb5b5e260ff0cca11446b1d6d1423788e442257ce"
 dependencies = [
  "heck 0.5.0",
  "proc-macro2",
  "quote",
- "syn 2.0.101",
+ "syn 2.0.102",
 ]
 
 [[package]]
 name = "clap_lex"
-version = "0.7.4"
+version = "0.7.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f46ad14479a25103f283c0f10005961cf086d8dc42205bb44c46ac563475dca6"
+checksum = "b94f61472cee1439c0b966b47e3aca9ae07e45d070759512cd390ea2bebc6675"
 
 [[package]]
 name = "colorchoice"
-version = "1.0.3"
+version = "1.0.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5b63caa9aa9397e2d9480a9b13673856c78d8ac123288526c37d7839f2a86990"
+checksum = "b05b61dc5112cbb17e4b6cd61790d9845d13888356391624cbe7e41efeac1e75"
 
 [[package]]
 name = "colored"
@@ -379,7 +379,7 @@ dependencies = [
  "proc-macro-error2",
  "proc-macro2",
  "quote",
- "syn 2.0.101",
+ "syn 2.0.102",
 ]
 
 [[package]]
@@ -390,9 +390,9 @@ checksum = "a8d1add55171497b4705a648c6b583acafb01d58050a51727785f0b2c8e0a2b2"
 
 [[package]]
 name = "hashbrown"
-version = "0.15.3"
+version = "0.15.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "84b26c544d002229e640969970a2e74021aadf6e2f96372b9c58eff97de08eb3"
+checksum = "5971ac85611da7067dbfcabef3c70ebb5606018acd9e2a3903a0da507521e0d5"
 
 [[package]]
 name = "heck"
@@ -518,9 +518,9 @@ checksum = "13dc2df351e3202783a1fe0d44375f7295ffb4049267b0f3018346dc122a1d94"
 
 [[package]]
 name = "memchr"
-version = "2.7.4"
+version = "2.7.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "78ca9ab1a0babb1e7d5695e3530886289c18cf2f87ec19a575a0abdce112e3a3"
+checksum = "32a282da65faaf38286cf3be983213fcf1d2e2a58700e808f83f4ea9a4804bc0"
 
 [[package]]
 name = "memoffset"
@@ -595,7 +595,7 @@ dependencies = [
 
 [[package]]
 name = "piranha"
-version = "0.3.33"
+version = "0.3.35"
 dependencies = [
  "assert_cmd",
  "cc",
@@ -638,9 +638,9 @@ dependencies = [
 
 [[package]]
 name = "portable-atomic"
-version = "1.11.0"
+version = "1.11.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "350e9b48cbc6b0e028b0473b114454c6316e57336ee184ceab6e53f72c178b3e"
+checksum = "f84267b20a16ea918e43c6a88433c2d54fa145c92a811b5b047ccbe153674483"
 
 [[package]]
 name = "predicates"
@@ -691,7 +691,7 @@ dependencies = [
  "proc-macro-error-attr2",
  "proc-macro2",
  "quote",
- "syn 2.0.101",
+ "syn 2.0.102",
 ]
 
 [[package]]
@@ -761,7 +761,7 @@ dependencies = [
  "proc-macro2",
  "pyo3-macros-backend",
  "quote",
- "syn 2.0.101",
+ "syn 2.0.102",
 ]
 
 [[package]]
@@ -774,7 +774,7 @@ dependencies = [
  "proc-macro2",
  "pyo3-build-config",
  "quote",
- "syn 2.0.101",
+ "syn 2.0.102",
 ]
 
 [[package]]
@@ -919,7 +919,7 @@ checksum = "5b0276cf7f2c73365f7157c8123c21cd9a50fbbd844757af28ca1f5925fc2a00"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.101",
+ "syn 2.0.102",
 ]
 
 [[package]]
@@ -936,18 +936,18 @@ dependencies = [
 
 [[package]]
 name = "serde_spanned"
-version = "0.6.8"
+version = "0.6.9"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "87607cb1398ed59d48732e575a4c28a7a8ebf2454b964fe3f224f2afc07909e1"
+checksum = "bf41e0cfaf7226dca15e8197172c295a782857fcb97fad1808a166870dee75a3"
 dependencies = [
  "serde",
 ]
 
 [[package]]
 name = "smallvec"
-version = "1.15.0"
+version = "1.15.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8917285742e9f3e1683f0a9c4e6b57960b7314d0b08d30d1ecd426713ee2eee9"
+checksum = "67b1b7a3b5fe4f1376887184045fcf45c69e92af734b7aaddc05fb777b6fbd03"
 
 [[package]]
 name = "strsim"
@@ -974,9 +974,9 @@ dependencies = [
 
 [[package]]
 name = "syn"
-version = "2.0.101"
+version = "2.0.102"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8ce2b7fc941b3a24138a0a7cf8e858bfc6a992e7978a068a5c760deb0ed43caf"
+checksum = "f6397daf94fa90f058bd0fd88429dd9e5738999cca8d701813c80723add80462"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -1016,9 +1016,9 @@ checksum = "8f50febec83f5ee1df3015341d8bd429f2d1cc62bcba7ea2076759d315084683"
 
 [[package]]
 name = "toml"
-version = "0.8.22"
+version = "0.8.23"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "05ae329d1f08c4d17a59bed7ff5b5a769d062e64a62d34a3261b219e62cd5aae"
+checksum = "dc1beb996b9d83529a9e75c17a1686767d148d70663143c7854d8b4a09ced362"
 dependencies = [
  "serde",
  "serde_spanned",
@@ -1028,18 +1028,18 @@ dependencies = [
 
 [[package]]
 name = "toml_datetime"
-version = "0.6.9"
+version = "0.6.11"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3da5db5a963e24bc68be8b17b6fa82814bb22ee8660f192bb182771d498f09a3"
+checksum = "22cddaf88f4fbc13c51aebbf5f8eceb5c7c5a9da2ac40a13519eb5b0a0e8f11c"
 dependencies = [
  "serde",
 ]
 
 [[package]]
 name = "toml_edit"
-version = "0.22.26"
+version = "0.22.27"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "310068873db2c5b3e7659d2cc35d21855dbafa50d1ce336397c666e3cb08137e"
+checksum = "41fe8c660ae4257887cf66394862d21dbca4a6ddd26f04a3560410406a2f819a"
 dependencies = [
  "indexmap",
  "serde",
@@ -1051,9 +1051,9 @@ dependencies = [
 
 [[package]]
 name = "toml_write"
-version = "0.1.1"
+version = "0.1.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bfb942dfe1d8e29a7ee7fcbde5bd2b9a25fb89aa70caea2eba3bee836ff41076"
+checksum = "5d99f8c9a7727884afe522e9bd5edbfc91a3312b36a77b5fb8926e4c31a41801"
 
 [[package]]
 name = "tree-sitter"
@@ -1068,7 +1068,7 @@ dependencies = [
 [[package]]
 name = "tree-sitter-go"
 version = "0.20.0"
-source = "git+https://github.com/uber/tree-sitter-go.git?rev=f8cffd0af7baaf7bf6062e403efe7c0d06319c41#f8cffd0af7baaf7bf6062e403efe7c0d06319c41"
+source = "git+https://github.com/danieltrt/tree-sitter-go.git?rev=ea5ceb716012db8813a2c05fab23c3a020988724#ea5ceb716012db8813a2c05fab23c3a020988724"
 dependencies = [
  "cc",
  "tree-sitter",
@@ -1323,9 +1323,9 @@ checksum = "589f6da84c646204747d1270a2a5661ea66ed1cced2631d546fdfb155959f9ec"
 
 [[package]]
 name = "winnow"
-version = "0.7.10"
+version = "0.7.11"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c06928c8748d81b05c9be96aad92e1b6ff01833332f281e8cfca3be4b35fc9ec"
+checksum = "74c7b26e3480b707944fc872477815d29a8e429d2f93a1ce000f5fa84a15cbcd"
 dependencies = [
  "memchr",
 ]

{polyglot_piranha-0.3.33 → polyglot_piranha-0.3.35}/Cargo.toml

@@ -2,7 +2,7 @@
 authors = ["Uber Technologies Inc."]
 name = "piranha"
 description = "Polyglot Piranha is a library for performing structural find and replace with deep cleanup."
-version = "0.3.33"
+version = "0.3.35"
 edition = "2021"
 include = ["pyproject.toml", "src/"]
 exclude = ["legacy"]
@@ -57,7 +57,7 @@ tree-sitter-python = "0.20.2"
 tree-sitter-ruby = "0.20.1"
 tree-sitter-typescript = "0.20.1"
 # TODO: Update after https://github.com/tree-sitter/tree-sitter-go/pull/103 lands
-tree-sitter-go = { git = "https://github.com/uber/tree-sitter-go.git", rev = "f8cffd0af7baaf7bf6062e403efe7c0d06319c41" }
+tree-sitter-go = { git = "https://github.com/danieltrt/tree-sitter-go.git", rev = "ea5ceb716012db8813a2c05fab23c3a020988724" }
 tree-sitter-thrift = "0.5.0"
 tree-sitter-strings = { git = "https://github.com/uber/tree-sitter-strings.git" }
 tree-sitter-query = "0.1.0"

{polyglot_piranha-0.3.33 → polyglot_piranha-0.3.35}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: polyglot_piranha
-Version: 0.3.33
+Version: 0.3.35
 License-File: LICENSE
 License-File: NOTICE
 Summary: Polyglot Piranha is a library for performing structural find and replace with deep cleanup.

polyglot_piranha-0.3.35/polyglot_piranha.pyi

@@ -0,0 +1,326 @@
+# Copyright (c) 2023 Uber Technologies, Inc.
+#
+# <p>Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file
+# except in compliance with the License. You may obtain a copy of the License at
+# <p>http://www.apache.org/licenses/LICENSE-2.0
+#
+# <p>Unless required by applicable law or agreed to in writing, software distributed under the
+# License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
+# express or implied. See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import annotations
+from typing import List, Optional, Literal
+
+# Languages that Piranha supports (see ./src/models/language.rs)
+PiranhaLanguage = Literal["java", "kt", "kotlin", "go", "python", "swift", "typescript", "tsx", "thrift", "strings", "scm", "scala", "ruby", "yaml", "yml"]
+
+
+def execute_piranha(piranha_argument: PiranhaArguments) -> list[PiranhaOutputSummary]:
+    """
+    Executes piranha for the given `piranha_arguments` and returns `PiranhaOutputSummary` for each file analyzed by Piranha
+    Parameters
+    ------------
+        piranha_arguments: Piranha Arguments
+            Configurations for piranha
+    Returns
+    ------------
+    List of `PiranhaOutPutSummary`
+    """
+    ...
+
+class PiranhaArguments:
+    """
+    A class to capture Piranha's configurations
+    """
+
+    def __init__(
+        self,
+        language: PiranhaLanguage,
+        paths_to_codebase: Optional[List[str]] = None,
+        include: Optional[List[str]] = None,
+        exclude: Optional[List[str]] = None,
+        substitutions: Optional[dict[str, str]] = None,
+        path_to_configurations: Optional[str] = None,
+        rule_graph: Optional[RuleGraph] = None,
+        code_snippet: Optional[str] = None,
+        dry_run: Optional[bool] = None,
+        cleanup_comments: Optional[bool] = None,
+        cleanup_comments_buffer: Optional[int] = None,
+        number_of_ancestors_in_parent_scope: Optional[int] = None,
+        delete_consecutive_new_lines: Optional[bool] = None,
+        global_tag_prefix: Optional[str] = "GLOBAL_TAG",
+        delete_file_if_empty: Optional[bool] = None,
+        path_to_output: Optional[str] = None,
+        allow_dirty_ast: Optional[bool] = None,
+        should_validate: Optional[bool] = None,
+        experiment_dyn: Optional[bool] = None,
+        path_to_custom_builtin_rules: Optional[str] = None,
+    ):
+        """
+        Constructs `PiranhaArguments`
+
+        Parameters
+        ------------
+            language: PiranhaLanguage
+                the target language
+            paths_to_codebase: List[str]
+                Paths to source code folder or file
+            keyword arguments: _
+                 substitutions (dict): Substitutions to instantiate the initial set of rules
+                 path_to_configurations (str): Directory containing the configuration files - `piranha_arguments.toml`, `rules.toml`, and  `edges.toml`
+                 rule_graph (RuleGraph): The rule graph constructed via RuleGraph DSL
+                 code_snippet (str): The input code snippet to transform
+                 dry_run (bool): Disables in-place rewriting of code
+                 cleanup_comments (bool): Enables deletion of associated comments
+                 cleanup_comments_buffer (int): The number of lines to consider for cleaning up the comments
+                 number_of_ancestors_in_parent_scope (int): The number of ancestors considered when PARENT rules
+                 delete_consecutive_new_lines (bool): Replaces consecutive \ns  with a \n
+                 global_tag_prefix (str): the prefix for global tags
+                 delete_file_if_empty (bool): User option that determines whether an empty file will be deleted
+                 path_to_output (str): Path to the output json file
+                 allow_dirty_ast (bool): Allows syntax errors in the input source code
+                 path_to_custom_builtin_rules (str): If provided, the default built-in rules will be ignored
+        """
+        ...
+
+class PiranhaOutputSummary:
+    """
+    A class to represent Piranha's output
+
+    Attributes
+    ----------
+    path: path to the file
+    content: content of the file after all the rewrites
+    matches: All the occurrences of "match-only" rules
+    rewrites: All the applied edits
+    """
+
+    path: str
+    "path to the file"
+
+    original_content: str
+    "Original content of the file before any rewrites"
+
+    content: str
+    "Final content of the file after all the rewrites"
+
+    matches: list[tuple[str, Match]]
+    'All the occurrences of "match-only" rules'
+
+    rewrites: list[Edit]
+    "All the applied edits"
+
+class Edit:
+    """
+     A class to represent an edit performed by Piranha
+
+    Attributes
+    ----------
+    p_match: The match representing the target site of the edit
+    replacement_string: The string to replace the substring encompassed by the match
+    matched_rule: The rule used for creating this match-replace
+    """
+
+    p_match: Match
+    "The match representing the target site of the edit"
+
+    matched_rule: str
+    "The rule used for creating this match-replace"
+
+    replacement_string: str
+    "The string to replace the substring encompassed by the match"
+
+class Match:
+    """
+     A class to represent a match
+
+    Attributes
+    ----------
+    matched_sting: Code snippet that matched
+    range: Range of the entire AST node captured by the match
+    matches: The mapping between tags and string representation of the AST captured
+    """
+
+    matched_string: str
+    "Code snippet that matched"
+
+    range: Range
+    "Range of the entire AST node captured by the match"
+
+    matches: dict[str, str]
+    "The mapping between tags and string representation of the AST captured"
+    ""
+
+class Range:
+    """A range of positions in a multi-line text document,
+    both in terms of bytes and of rows and columns.
+    """
+
+    start_byte: int
+    end_byte: int
+    start_point: Point
+    end_point: Point
+
+class Point:
+    row: int
+    column: int
+
+class Filter:
+    """A class to capture filters of a Piranha Rule"""
+
+    enclosing_node: TSQuery
+    "AST patterns that some ancestor node of the primary match should comply"
+    not_contains: list[TSQuery]
+    "AST patterns that SHOULD NOT match any subtree of node matching `enclosing_node` pattern"
+    contains: TSQuery
+    "AST pattern that SHOULD match subtrees of `enclosing_node`. " "Number of matches should be within the range of `at_least` and `at_most`."
+    at_least: int
+    "The minimum number of times the contains query should match in the enclosing node"
+    at_most: int
+    "The maximum number of times the contains query should match in the enclosing node"
+    child_count: int
+    "Number of named children under the primary matched node"
+    sibling_count: int
+    "Number of named siblings of the primary matched node"
+    def __init__(
+        self,
+        enclosing_node: Optional[str] = None,
+        not_enclosing_node: Optional[str] = None,
+        not_contains: list[str] = [],
+        contains: Optional[str] = None,
+        at_least: int = 1,
+        at_most: int = 4294967295,  # u32::MAX
+        child_count: int = 4294967295,  # u32::MAX
+        sibling_count: int = 4294967295,  # u32::MAX
+    ):
+        """
+        Constructs `Filter`
+
+        Parameters
+        ------------
+            enclosing_node: str
+                AST patterns that some ancestor node of the primary match should comply
+            not_contains: list[str]
+                 AST patterns that should not match any subtree of node matching `enclosing_node` pattern
+        """
+        ...
+
+class Rule:
+    """A class to capture Piranha Rule"""
+
+    name: str
+    "Name of the rule"
+    query: TSQuery
+    "Tree-sitter query as string"
+    replace_node: str
+    "The tag corresponding to the node to be replaced"
+    replace_node_idx: str
+    "The i'th child of node corresponding to the replace_node tag will be replaced"
+    replace: str
+    "Replacement pattern"
+    groups: set[str]
+    "Group(s) to which the rule belongs"
+    holes: set[str]
+    "Holes that need to be filled, in order to instantiate a rule"
+    filters: set[Filter]
+    "Filters to test before applying a rule"
+    is_seed_rule: bool
+    "Marks a rule as a seed rule"
+    keep_comment_regexes: set[str]
+    "Make comment deleting optional"
+
+    def __init__(
+        self,
+        name: str,
+        query: Optional[str] = None,
+        replace_node: Optional[str] = None,
+        replace: Optional[str] = None,
+        groups: set[str] = set(),
+        holes: set[str] = set(),
+        filters: set[Filter] = set(),
+        is_seed_rule: bool = True,
+        keep_comment_regexes: Optional[set[str]] = None,
+    ):
+        """
+        Constructs `Rule`
+
+        Parameters
+        ------------
+            name: str
+                Name of the rule
+            query: str
+                Tree-sitter query as string
+            replace_node: str
+                The tag corresponding to the node to be replaced
+            replace: str
+                Replacement pattern
+            groups: set[str]
+                Group(s) to which the rule belongs
+            holes: set[str]
+                Holes that need to be filled, in order to instantiate a rule
+            filters: set[Filter]
+                Filters to test before applying a rule
+            is_seed_rule: bool
+                Marks a rule as a seed rule
+        """
+        ...
+
+class OutgoingEdges:
+    frm: str
+    "The source rule or group of rules"
+    to: list[str]
+    "The target edges or groups of edges"
+    scope: str
+    "The scope label for the edge"
+
+    def __init__(
+        self,
+        frm: str,
+        to: list[str],
+        scope: str,
+    ):
+        """
+        Constructs `OutgoingEdge`
+
+        Parameters
+        ------------
+            frm: str
+                The source rule or group of rules
+            to: list[str]
+                The target edges or groups of edges
+            scope: str
+                The scope label for the edge
+        """
+        ...
+
+class RuleGraph:
+    rules: list[Rule]
+    "The rules in the graph"
+    edges: list[OutgoingEdges]
+    "The edges in the graph"
+    graph: dict[str, list[tuple[str, str]]]
+    "The graph itself (as an adjacency list)"
+
+    def __init__(
+        self,
+        rules: list[Rule],
+        edges: list[OutgoingEdges],
+    ):
+        """
+        Constructs `OutgoingEdge`
+
+        Parameters
+        ------------
+            rules: list[Rule]
+                The rules in the graph
+            edges: list[OutgoingEdges]
+                The edges in the graph
+        """
+        ...
+
+class TSQuery:
+    "Captures a Tree sitter query"
+    def query(self):
+        """The query"""
+        ...

{polyglot_piranha-0.3.33 → polyglot_piranha-0.3.35}/pyproject.toml

@@ -25,4 +25,4 @@ build-backend = "maturin"
 
 [tool.maturin]
 bindings = "pyo3"
-include = ["LICENSE", "NOTICE"]
+include = ["LICENSE", "NOTICE", "polyglot_piranha.pyi"]