MAJOR CLEANUP:

1. renamed package to langgraph_compare
2. rewrote docs and README.md to use new name
3. fixed imports in tests to use new name
4. moved main examples to separate folder inside examples dir, fixed imports
5. added examples for comparing different architectures

Author: serafinski

README.md

@@ -1,7 +1,7 @@
-# LangGraph Log Parser
+# LangGraph Compare
 
 # Documentation
-Documentation is available at: https://serafinski.github.io/LangGraph-Log-Parser/
+Documentation is available at: https://serafinski.github.io/LangGraph-Compare/
 
 # Purpose
 This Python package facilitates the parsing of run logs generated by [LangGraph](https://langchain-ai.github.io/langgraph/). During execution, logs are stored in an SQLite database in an encoded format _(using msgpack)_. These logs are then decoded and exported to a `json` format. Subsequently, the `json` files are transformed into `csv` files for further analysis.
@@ -45,14 +45,14 @@ sudo dnf install graphviz
 ## Environment setup
 To create virtual environment (using conda), use the following commands:
 ```dotenv
-conda create -n langgraph_log_parser python=3.9
-conda activate langgraph_log_parser
-pip install langgraph_log_parser
+conda create -n langgraph_compare python=3.9
+conda activate langgraph_compare
+pip install langgraph_compare
 ```
 # Basic Example
 This example is based on the [Building a Basic Chatbot](https://langchain-ai.github.io/langgraph/tutorials/introduction/#part-1-build-a-basic-chatbot) from LangGraph documentation.
 
-It will require You to install the following packages _(besides `langgraph_log_parser`)_:
+It will require You to install the following packages _(besides `langgraph_compare`)_:
 ```dotenv
 pip install python-dotenv langchain-openai
 ```
@@ -67,7 +67,7 @@ from langchain_openai import ChatOpenAI
 from langgraph.graph import StateGraph, START, END
 from langgraph.graph.message import add_messages
 
-from langgraph_log_parser import *
+from langgraph_compare import *
 
 exp = create_experiment("main")
 memory = exp.memory
@@ -110,7 +110,7 @@ generate_artifacts(event_log, graph, exp)
 ```
 When You have multiple architectures analyzed, You can use the following code to compare them _(by default, it will look in `experiments` directory)_:
 ```python
-from langgraph_log_parser import compare
+from langgraph_compare import compare
 
 infrastructures = ["main", "other1", "other2"]
 

docs/advanced_examples.rst

@@ -15,7 +15,7 @@ As advanced examples, we are going to use the following tutorials from LangGraph
 * `Agent Architectures - Multi-Agent Supervisor <https://langchain-ai.github.io/langgraph/tutorials/multi_agent/agent_supervisor/>`_
 * `Agent Architectures - Hierarchical Agent Teams <https://langchain-ai.github.io/langgraph/tutorials/multi_agent/hierarchical_agent_teams/>`_
 
-We are also not going to focus on a basic usage - the main focus is going to be on :class:`langgraph_log_parser.jsons_to_csv.GraphConfig`.
+We are also not going to focus on a basic usage - the main focus is going to be on :class:`langgraph_compare.jsons_to_csv.GraphConfig`.
 
 If You want to check basic usage, refer to: :ref:`getting_started`.
 
@@ -38,8 +38,8 @@ In case of this example - we will have 2 nodes - :code:`researcher`, :code:`char
 .. code-block:: python
 
     # Needed imports
-    from langgraph_log_parser.experiment import create_experiment
-    from langgraph_log_parser.jsons_to_csv import GraphConfig, export_jsons_to_csv
+    from langgraph_compare.experiment import create_experiment
+    from langgraph_compare.jsons_to_csv import GraphConfig, export_jsons_to_csv
 
     # Init for experiment project structure
     exp = create_experiment("test")
@@ -62,15 +62,15 @@ This example is based on `Agent Architectures - Multi-Agent Supervisor <https://
 
   `Multi-Agent Supervisor diagram - LangGraph Documentation <https://langchain-ai.github.io/langgraph/tutorials/multi_agent/agent_supervisor/>`_
 
-In this example, we will introduce :class:`langgraph_log_parser.jsons_to_csv.SupervisorConfig`. It will supervise the graph - working more or less work the same as :code:`GraphConfig`. The concept of supervisors will make more sense in :ref:`hierarchical_agent_teams`.
+In this example, we will introduce :class:`langgraph_compare.jsons_to_csv.SupervisorConfig`. It will supervise the graph - working more or less work the same as :code:`GraphConfig`. The concept of supervisors will make more sense in :ref:`hierarchical_agent_teams`.
 
 **Example:**
 
 .. code-block:: python
 
     # Needed imports
-    from langgraph_log_parser.experiment import create_experiment
-    from langgraph_log_parser.jsons_to_csv import GraphConfig, SupervisorConfig, export_jsons_to_csv
+    from langgraph_compare.experiment import create_experiment
+    from langgraph_compare.jsons_to_csv import GraphConfig, SupervisorConfig, export_jsons_to_csv
 
     # Init for experiment project structure
     exp = create_experiment("test")
@@ -112,8 +112,8 @@ IMPORTANT: Be sure to call supervisors with different names - so you can differe
 .. code-block:: python
 
     # Needed imports
-    from langgraph_log_parser.experiment import create_experiment
-    from langgraph_log_parser.jsons_to_csv import GraphConfig, SubgraphConfig, SupervisorConfig, export_jsons_to_csv
+    from langgraph_compare.experiment import create_experiment
+    from langgraph_compare.jsons_to_csv import GraphConfig, SubgraphConfig, SupervisorConfig, export_jsons_to_csv
 
     # Init for experiment project structure
     exp = create_experiment("test")

docs/conf.py

@@ -6,16 +6,14 @@
 # -- Project information -----------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
 
-
-# sphinx-apidoc -o docs langgraph_log_parser
 import os
 import sys
 sys.path.insert(0, os.path.abspath('..'))
 
-project = 'LangGraph Log Parser'
+project = 'LangGraph Compare'
 copyright = '2025, Tomasz Serafiński'
 author = 'Tomasz Serafiński'
-release = '0.1.14'
+release = '0.1.2'
 
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration