cpg2py 1.0.5__py3-none-any.whl → 1.2.0__py3-none-any.whl

cpg2py/cpg/node.py

@@ -1,65 +0,0 @@
-from __future__ import annotations
-from typing import List, Optional
-
-from ..abc import AbcNodeQuerier, AbcGraphQuerier
-
-class _Node(AbcNodeQuerier):  
-    
-    def __init__(self, graph: AbcGraphQuerier, nid: str) -> None:
-        super().__init__(graph, nid)
-        return None
-    
-    @property
-    def id(self) -> str: return self.node_id
-
-    @property
-    def code(self) -> Optional[str]: 
-        return self.get_property('code')
-    
-    @property
-    def label(self) -> Optional[str]: 
-        return self.get_property('labels:label', 'labels')
-    
-    @property
-    def flags(self) -> List[str]: 
-        flags_str = self.get_property('flags:string_array', 'flags:string[]', 'flags')
-        return str(flags_str).split(' ') if flags_str is not None else []
-    
-    @property
-    def line_num(self) -> Optional[int]: 
-        linenum_str = str(self.get_property('lineno:int', 'lineno'))
-        return int(linenum_str) if linenum_str.isnumeric() else None
-    
-    @property
-    def children_num(self) -> Optional[int]: 
-        num_str = str(self.get_property('childnum:int', 'childnum'))
-        return int(num_str) if num_str.isnumeric() else None
-
-    @property
-    def func_id(self) -> Optional[int]: 
-        fid_str = str(self.get_property('funcid:int', 'funcid'))
-        return int(fid_str) if fid_str.isnumeric() else None
-    
-    @property
-    def class_name(self) -> Optional[str]: 
-        return self.get_property('classname')
-
-    @property
-    def namespace(self) -> Optional[str]: 
-        return self.get_property('namespace')
-        
-    @property
-    def name(self) -> Optional[str]: return self.get_property('name')
-
-    @property
-    def end_num(self) -> Optional[int]:
-        end_str = str(self.get_property('endlineno:int', 'endlineno'))
-        return int(end_str) if end_str.isnumeric() else None
-
-    @property
-    def comment(self) -> Optional[str]: 
-        return self.get_property('doccomment')
-
-    @property 
-    def type(self) -> Optional[str]: 
-        return self.get_property('type')

cpg2py-1.0.5.dist-info/METADATA

@@ -1,261 +0,0 @@
-Metadata-Version: 2.2
-Name: cpg2py
-Version: 1.0.5
-Summary: A graph-based data structure designed for querying CSV files in Joern format in Python
-Home-page: https://github.com/YichaoXu/cpg2py
-Author: Yichao Xu
-Author-email: Yichao Xu <yxu166@jhu.edu>
-License: MIT License
-        
-        Copyright (c) 2025 Yichao Xu
-        
-        Permission is hereby granted, free of charge, to any person obtaining a copy
-        of this software and associated documentation files (the "Software"), to deal
-        in the Software without restriction, including without limitation the rights
-        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-        copies of the Software, and to permit persons to whom the Software is
-        furnished to do so, subject to the following conditions:
-        
-        The above copyright notice and this permission notice shall be included in all
-        copies or substantial portions of the Software.
-        
-        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-        SOFTWARE.
-        
-Project-URL: Homepage, https://github.com/YichaoXu/cpg2py
-Project-URL: Repository, https://github.com/YichaoXu/cpg2py
-Keywords: Joern,CPG,Graph,CSV
-Requires-Python: >=3.6
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Dynamic: author
-Dynamic: home-page
-Dynamic: requires-python
-
-# **cpg2py: Graph-Based Query Engine for Joern CSV Files**
-
-`cpg2py` is a Python library that provides a lightweight **graph-based query engine** for analyzing **Code Property Graphs (CPG)** extracted from Joern CSV files. The library offers an **abstract base class (ABC) architecture**, allowing users to extend and implement their own custom graph queries.
-
----
-
-## **🚀 Features**
-
-- **MultiDiGraph Representation**: A directed multi-graph with support for multiple edges between nodes.
-- **CSV-Based Graph Construction**: Reads `nodes.csv` and `rels.csv` to construct a graph structure.
-- **Extensible Abstract Base Classes (ABC)**:
-  - `AbcGraphQuerier` for implementing **custom graph queries**.
-  - `AbcNodeQuerier` for interacting with **nodes**.
-  - `AbcEdgeQuerier` for interacting with **edges**.
-- **Built-in Query Mechanisms**:
-  - **Retrieve all edges**.
-  - **Get incoming (**``**) and outgoing (**``**) edges of a node**.
-  - **Find successors (**``**) and predecessors (**``**)**.
-  - **Traverse AST, Control Flow, and Data Flow Graphs**.
-
----
-
-## **📚 Installation**
-
-To install the package, use:
-
-```bash
-pip install git+https://github.com/YichaoXu/cpg2py.git
-```
-
-Or clone the pip repository:
-
-```bash
-pip install cpg2py
-```
-
----
-
-## **📂 File Structure**
-
-- **`nodes.csv`** (Example):
-```csv
-id:int	labels:label	type	flags:string_array	lineno:int	code	childnum:int	funcid:int	classname	namespace	endlineno:int	name	doccomment
-0	Filesystem	Directory									"input"	
-1	Filesystem	File									"example.php"	
-2	AST	AST_TOPLEVEL	TOPLEVEL_FILE	1					""	25	"/input/example.php"	
-
-````
-- **`rels.csv`** (Example):
-```csv
-start	end	type
-2	3	ENTRY
-2	4	EXIT
-6	7	ENTRY
-6	9	PARENT_OF
-````
-
----
-
-## **📚 Usage**
-
-### **1️⃣ Load Graph from Joern CSVs**
-
-```python
-from cpg2py import cpg_graph
-
-# Load graph from CSV files
-graph = cpg_graph("nodes.csv", "rels.csv")
-```
-
----
-
-### **2️⃣ Query Nodes & Edges**
-
-```python
-# Get a specific node
-node = graph.node("2")
-print(node.name, node.type)  # Example output: "/tmp/example.php" AST_TOPLEVEL
-
-# Get a specific edge
-edge = graph.edge("2", "3", "ENTRY")
-print(edge.type)  # Output: ENTRY
-```
-
----
-
-### **3️⃣ Get Node Connections**
-
-```python
-# Get all outgoing edges from a node
-outgoing_edges = graph.succ(node)
-for out_node in outgoing_edges:
-    print(out_node.id, out_node.name)
-
-# Get all incoming edges to a node
-incoming_edges = graph.prev(node)
-for in_node in incoming_edges:
-    print(in_node.id, in_node.name)
-```
-
----
-
-### **4️⃣ AST and Flow Queries**
-
-```python
-# Get top-level file node for a given node
-top_file = graph.topfile_node("5")
-print(top_file.name)  # Output: "example.php"
-
-# Get child nodes in the AST hierarchy
-children = graph.children(node)
-print([child.id for child in children])
-
-# Get data flow successors
-flow_successors = graph.flow_to(node)
-print([succ.id for succ in flow_successors])
-```
-
----
-
-## **🛠 Abstract Base Classes (ABC)**
-
-The following abstract base classes (`ABC`) provide interfaces for extending **node**, **edge**, and **graph** querying behavior.
-
----
-
-### **🔹 AbcNodeQuerier (Abstract Node Interface)**
-
-This class defines how nodes interact with the graph storage.
-
-```python
-from cpg2py.abc import AbcNodeQuerier
-
-class MyNodeQuerier(AbcNodeQuerier):
-    def __init__(self, graph, nid):
-        super().__init__(graph, nid)
-
-    @property
-    def name(self):
-        return self.get_property("name")
-```
-
----
-
-### **🔹 AbcEdgeQuerier (Abstract Edge Interface)**
-
-Defines the querying mechanisms for edges in the graph.
-
-```python
-from cpg2py.abc import AbcEdgeQuerier
-
-class MyEdgeQuerier(AbcEdgeQuerier):
-    def __init__(self, graph, f_nid, t_nid, e_type):
-        super().__init__(graph, f_nid, t_nid, e_type)
-
-    @property
-    def type(self):
-        return self.get_property("type")
-```
-
----
-
-### **🔹 AbcGraphQuerier (Abstract Graph Interface)**
-
-This class provides an interface for implementing custom graph query mechanisms.
-
-```python
-from cpg2py.abc import AbcGraphQuerier
-
-class MyGraphQuerier(AbcGraphQuerier):
-    def node(self, nid: str):
-        return MyNodeQuerier(self.storage, nid)
-
-    def edge(self, fid, tid, eid):
-        return MyEdgeQuerier(self.storage, fid, tid, eid)
-```
-
----
-
-## **🔍 Querying The Graph**
-
-After implementing the abstract classes, you can perform advanced queries:
-
-```python
-graph = MyGraphQuerier(storage)
-
-# Query node properties
-node = graph.node("5")
-print(node.name)  # Example Output: "main"
-
-# Query edge properties
-edge = graph.edge("5", "6", "FLOWS_TO")
-print(edge.type)  # Output: "FLOWS_TO"
-```
-
----
-
-## **🐝 API Reference**
-
-For a more detail APIs document please see our [APIs doc](docs/APIs.md) 
-
-- **Graph Functions**:
-  - `cpg_graph(node_csv, edge_csv)`: Loads graph from CSV files.
-  - `graph.node(nid)`: Retrieves a node by ID.
-  - `graph.edge(fid, tid, eid)`: Retrieves an edge.
-  - `graph.succ(node)`: Gets successor nodes.
-  - `graph.prev(node)`: Gets predecessor nodes.
-- **Node Properties**:
-  - `.name`: Node name.
-  - `.type`: Node type.
-  - `.line_num`: Source code line number.
-- **Edge Properties**:
-  - `.start`: Edge start node.
-  - `.end`: Edge end node.
-  - `.type`: Edge type.
-
----
-
-## **🌟 License**
-
-This project is licensed under the **MIT License**.
-

cpg2py-1.0.5.dist-info/RECORD

@@ -1,15 +0,0 @@
-cpg2py/__init__.py,sha256=mmQSyd9j3QeCMY5__jcs1DG_MBDbdTag6RsjddxeV18,2013
-cpg2py/abc/__init__.py,sha256=HgDXsJkGcPQvr6ac3hMrUU9TuQibMaP7-oXbXLs_iLI,207
-cpg2py/abc/edge.py,sha256=zLlRebDKT2qK5XOJq23_UUCESgGsvgalbXdx_uUcKks,1240
-cpg2py/abc/graph.py,sha256=DbeHN6qsNaqcqL9cUquJWC16BihDxy1MEhyuL-qVMBI,3902
-cpg2py/abc/node.py,sha256=E2EQv_KisEPuslFaglZZvSBm-VY5LYCFBOFY1yiPzDY,844
-cpg2py/abc/storage.py,sha256=BF82Vs_7FxGYSPiM_6JwQVzmaqMzGy2r-WSk8pQQclY,5976
-cpg2py/cpg/__init__.py,sha256=fO59Yd7OISyxdjdZDJ5zFM41r4cYKawOsvpqV4gWrGM,48
-cpg2py/cpg/edge.py,sha256=brG7cQl7tjihbUCBYyjNUnMLsKIif-XQc_TFdGz8ZYo,1007
-cpg2py/cpg/graph.py,sha256=n4EjAhhjzl0XRJBwlAmK5AcSrECiqhjA6dXt2Ucf7IM,3448
-cpg2py/cpg/node.py,sha256=-2xl8c-eSbe4Kv4xPAEf6POlCYOV4j0voxJAKDZj3Cc,2037
-cpg2py-1.0.5.dist-info/LICENSE,sha256=vTjbt7iL1hUilI8E87FoQerEDa9nbpeip26iA6bguHI,1066
-cpg2py-1.0.5.dist-info/METADATA,sha256=tm9g9zkTpqdLhAn_Y6oFTlnzQcD26tyJcadYTD5RtRw,7077
-cpg2py-1.0.5.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-cpg2py-1.0.5.dist-info/top_level.txt,sha256=xDY8faKh5Rczvsqb5Jt9Sq-Y7EOImh7jh-m1oVTnH5k,7
-cpg2py-1.0.5.dist-info/RECORD,,