php-parser-py 1.0.0__tar.gz → 1.1.0__tar.gz

{php_parser_py-1.0.0 → php_parser_py-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: php-parser-py
-Version: 1.0.0
+Version: 1.1.0
 Summary: Python wrapper for PHP-Parser using cpg2py
 Author: samhsu-dev
 Author-email: samhsu-dev <yxu166@jh.edu>
@@ -52,7 +52,7 @@ nodes = parse_code(code)
 # Returns list of Node instances (no project/file structure)
 
 for node in nodes:
-    print(f"Node type: {node.label}")
+    print(f"Node type: {node.node_type}")
 ```
 
 ### Parse PHP File (With Project Structure)
@@ -69,7 +69,7 @@ files = ast.files()
 print(f"Project has {len(files)} file(s)")
 
 # Get file containing a specific node
-stmt_node = ast.first_node(lambda n: n.label == "Stmt_Function")
+stmt_node = ast.first_node(lambda n: n.node_type == "Stmt_Function")
 file_node = ast.get_file(stmt_node.id)
 print(f"Function is in file: {file_node.get_property('filePath')}")
 ```
@@ -86,8 +86,8 @@ ast = parse_project(["file1.php", "file2.php", "file3.php"])
 for file_node in ast.files():
     print(f"File: {file_node.get_property('filePath')}")
     # Get statements in this file
-    for stmt in ast.children(file_node):
-        print(f"  Statement: {stmt.label}")
+    for stmt in ast.succ(file_node):
+        print(f"  Statement: {stmt.node_type}")
 
 # Access project and file paths
 ast = parse_project(["file1.php", "subdir/file2.php"])
@@ -107,19 +107,19 @@ from php_parser_py import parse_file
 ast = parse_file("example.php")
 
 # Find all echo statements
-for echo in ast.nodes(lambda n: n.label == "Stmt_Echo"):
-    print(f"Echo at line {echo.get_property('startLine')}")
+for echo in ast.nodes(lambda n: n.node_type == "Stmt_Echo"):
+    print(f"Echo at line {echo.start_line}")
 
 # Get children of a node (via PARENT_OF edges)
 for child in ast.succ(some_node):
-    print(f"Child type: {child.label}")
+    print(f"Child type: {child.node_type}")
 
 # Get all descendants
 for descendant in ast.descendants(some_node):
-    print(f"Descendant: {descendant.label}")
+    print(f"Descendant: {descendant.node_type}")
 
 # Get file containing a node
-stmt_node = ast.first_node(lambda n: n.label == "Stmt_Function")
+stmt_node = ast.first_node(lambda n: n.node_type == "Stmt_Function")
 file_node = ast.get_file(stmt_node.id)
 if file_node:
     print(f"Function is in: {file_node.get_property('filePath')}")
@@ -200,10 +200,12 @@ ast = parser.parse("<?php echo 'hello';")
 
 - **`Node`**: Wraps a single AST node
   - `id`: Node identifier
-  - `label`: Node type (e.g., "Stmt_Function")
-  - `node_type`: Alias for label (PHP-Parser node type)
-  - `properties`: All node properties
+  - `node_type`: Node type (e.g., "Stmt_Function") - returns `nodeType` property
+  - `all_properties`: All node properties as dict
   - `get_property(*names)`: Get property value
+  - `start_line`, `end_line`: Line number properties
+  - `__getitem__(key)`: Dict-like access (e.g., `node["name"]`)
+  - `get(key, default)`: Get property with default value
 
 - **`Parser`**: Parses PHP code
   - `__init__(php_binary_path=None, php_binary_url=None)`: Initialize parser

{php_parser_py-1.0.0 → php_parser_py-1.1.0}/README.md

@@ -41,7 +41,7 @@ nodes = parse_code(code)
 # Returns list of Node instances (no project/file structure)
 
 for node in nodes:
-    print(f"Node type: {node.label}")
+    print(f"Node type: {node.node_type}")
 ```
 
 ### Parse PHP File (With Project Structure)
@@ -58,7 +58,7 @@ files = ast.files()
 print(f"Project has {len(files)} file(s)")
 
 # Get file containing a specific node
-stmt_node = ast.first_node(lambda n: n.label == "Stmt_Function")
+stmt_node = ast.first_node(lambda n: n.node_type == "Stmt_Function")
 file_node = ast.get_file(stmt_node.id)
 print(f"Function is in file: {file_node.get_property('filePath')}")
 ```
@@ -75,8 +75,8 @@ ast = parse_project(["file1.php", "file2.php", "file3.php"])
 for file_node in ast.files():
     print(f"File: {file_node.get_property('filePath')}")
     # Get statements in this file
-    for stmt in ast.children(file_node):
-        print(f"  Statement: {stmt.label}")
+    for stmt in ast.succ(file_node):
+        print(f"  Statement: {stmt.node_type}")
 
 # Access project and file paths
 ast = parse_project(["file1.php", "subdir/file2.php"])
@@ -96,19 +96,19 @@ from php_parser_py import parse_file
 ast = parse_file("example.php")
 
 # Find all echo statements
-for echo in ast.nodes(lambda n: n.label == "Stmt_Echo"):
-    print(f"Echo at line {echo.get_property('startLine')}")
+for echo in ast.nodes(lambda n: n.node_type == "Stmt_Echo"):
+    print(f"Echo at line {echo.start_line}")
 
 # Get children of a node (via PARENT_OF edges)
 for child in ast.succ(some_node):
-    print(f"Child type: {child.label}")
+    print(f"Child type: {child.node_type}")
 
 # Get all descendants
 for descendant in ast.descendants(some_node):
-    print(f"Descendant: {descendant.label}")
+    print(f"Descendant: {descendant.node_type}")
 
 # Get file containing a node
-stmt_node = ast.first_node(lambda n: n.label == "Stmt_Function")
+stmt_node = ast.first_node(lambda n: n.node_type == "Stmt_Function")
 file_node = ast.get_file(stmt_node.id)
 if file_node:
     print(f"Function is in: {file_node.get_property('filePath')}")
@@ -189,10 +189,12 @@ ast = parser.parse("<?php echo 'hello';")
 
 - **`Node`**: Wraps a single AST node
   - `id`: Node identifier
-  - `label`: Node type (e.g., "Stmt_Function")
-  - `node_type`: Alias for label (PHP-Parser node type)
-  - `properties`: All node properties
+  - `node_type`: Node type (e.g., "Stmt_Function") - returns `nodeType` property
+  - `all_properties`: All node properties as dict
   - `get_property(*names)`: Get property value
+  - `start_line`, `end_line`: Line number properties
+  - `__getitem__(key)`: Dict-like access (e.g., `node["name"]`)
+  - `get(key, default)`: Get property with default value
 
 - **`Parser`**: Parses PHP code
   - `__init__(php_binary_path=None, php_binary_url=None)`: Initialize parser

{php_parser_py-1.0.0 → php_parser_py-1.1.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "php-parser-py"
-version = "1.0.0"
+version = "1.1.0"
 description = "Python wrapper for PHP-Parser using cpg2py"
 readme = "README.md"
 authors = [

{php_parser_py-1.0.0 → php_parser_py-1.1.0}/src/php_parser_py/_ast.py

@@ -213,12 +213,12 @@ class AST(AbcGraphQuerier[Node, Edge]):
                 # Exclude project node if it exists
                 all_nodes = set(self._storage.get_nodes())
                 nodes_with_parents = set()
-                
+
                 for edge_id in self._storage.get_edges():
                     from_id, to_id, edge_type = edge_id
                     if edge_type == "PARENT_OF":
                         nodes_with_parents.add(to_id)
-                
+
                 root_nodes = all_nodes - nodes_with_parents
                 # Exclude project node if present
                 root_nodes.discard(self._root_node_id)

{php_parser_py-1.0.0 → php_parser_py-1.1.0}/src/php_parser_py/_parser.py

@@ -94,7 +94,7 @@ class Parser:
             if "Syntax error" in str(e):
                 raise ParseError("Syntax error in PHP code", line=1) from e
             raise
-
+        
         # Normalize to list
         if not isinstance(json_data, list):
             json_data = [json_data]

{php_parser_py-1.0.0 → php_parser_py-1.1.0}/src/php_parser_py/_printer.py

@@ -44,34 +44,66 @@ class PrettyPrinter:
 
         Returns:
             Dictionary mapping file paths to generated PHP source code strings.
-            If AST has no file structure, returns a single entry with key "code"
-            or empty string.
+            If AST has no file structure, returns a single entry with key ""
+            as the filename.
 
         Raises:
             RunnerError: If PHP-Parser execution fails.
         """
         file_nodes = ast.files()
-        
+
         if not file_nodes:
             # No file structure - export all statements as a single code block
             json_str = ast.to_json()
             code = self._runner.print(json_str)
             return {"": code}
-        
+
         # Generate code for each file
         result: dict[str, str] = {}
         for file_node in file_nodes:
             file_path = file_node.get_property("filePath", "")
             file_hash = file_node.id
-            
+
             # Get JSON for this file only
             json_str = ast.to_json(file_hash=file_hash)
-            
+
             # Generate code
             code = self._runner.print(json_str)
-            
+
             # Use file path as key, or file hash if path not available
             key = file_path if file_path else file_hash
             result[key] = code
-        
+
         return result
+
+    def print_file(self, ast: AST, relative_path: str) -> str:
+        """Generate PHP code string for a single file selected by relative path.
+
+        This method looks up the file node whose ``path`` property matches the
+        given relative path (as stored on file nodes), reconstructs JSON for
+        that file only, and returns the generated PHP source code string.
+
+        Args:
+            ast: AST instance containing project and file nodes.
+            relative_path: Relative file path stored in the ``path`` property
+                of the target file node (for example, ``"src/file.php"`` or
+                just ``"file.php"`` for single-file projects).
+
+        Returns:
+            Generated PHP source code string for the specified file.
+
+        Raises:
+            KeyError: If no file node with the given relative path exists
+                in the AST.
+            RunnerError: If PHP-Parser execution fails.
+        """
+        # Find file node by its relative path property
+        for file_node in ast.files():
+            if file_node.get_property("path") == relative_path:
+                file_hash = file_node.id
+                json_str = ast.to_json(file_hash=file_hash)
+                return self._runner.print(json_str)
+
+        raise KeyError(
+            f"File with relative path '{relative_path}' not found in AST."
+        )