Memory Graph VS Code Extension v0.1.0

🎉 Memory Graph VS Code Extension v0.1.0

First official release of the Memory Graph extension for Visual Studio Code!

✨ Features

Core Functionality

• 📊 Visualize Python Code Selections - Select code and see memory graphs instantly
• 📁 Visualize Complete Files - Execute entire programs and visualize final state
• 🖥️ Program Output Display - View print statements alongside graphs
• 🎨 Interactive Webview Panel - Zoom, refresh, and explore graphs inline in VS Code
• 🔍 Auto Environment Detection - Finds Python, memory_graph, and Graphviz automatically
• 🌍 Cross-Platform Support - Works on Windows, macOS, and Linux

Educational Focus

Perfect for students learning Python:

• Understand references and mutation
• See shared data between variables
• Debug data structure issues visually
• Learn with complete program execution

📦 Installation

Download & Install

1. Download memory-graph-0.1.0.vsix from the assets below
2. Open VS Code
3. Go to Extensions (Cmd+Shift+X / Ctrl+Shift+X)
4. Click ⋯ menu → "Install from VSIX..."
5. Select the downloaded .vsix file

Or via Command Line

code --install-extension memory-graph-0.1.0.vsix

📋 Requirements

Before using the extension, install:

1. Python 3.6+

   # Check version
   python3 --version

2. memory_graph package

   # macOS/Linux
   pip3 install memory_graph
   
   # Windows
   pip install memory_graph

3. Graphviz
   • macOS: brew install graphviz
   • Linux (Ubuntu): sudo apt-get install graphviz
   • Windows: Download from graphviz.org

🚀 Quick Start

Method 1: Visualize Complete Files (Recommended for Students)

1. Open a Python file
2. Right-click anywhere → "Memory Graph: Visualize Current File"
3. See program output + memory graph!

Method 2: Visualize Code Selections

1. Select Python code
2. Right-click → "Memory Graph: Visualize Selection"
3. View the memory graph

Example

print("Starting...")

students = ['Alice', 'Bob']
backup = students  # Creates reference!
backup.append('Charlie')

print(f"Students: {students}")  # ['Alice', 'Bob', 'Charlie']
print(f"Backup: {backup}")      # Same list!

Run "Visualize Current File" to see:

• Program output showing both lists changed
• Graph showing students and backup point to same list
• Understanding: need .copy() to avoid this!

📖 Commands

• Memory Graph: Visualize Current File - Execute and visualize entire file
• Memory Graph: Visualize Selection - Visualize selected code
• Memory Graph: Open Visualization Panel - Open the graph panel
• Memory Graph: Check Environment - Verify dependencies

🔧 Configuration

Access via VS Code Settings:

• memoryGraph.pythonPath - Custom Python interpreter path
• memoryGraph.outputFormat - Graph format (svg/png)

📚 Documentation

Full documentation: README

🐛 Known Issues

• Large programs (1000+ lines) may take longer to execute
• Complex nested structures may require zoom to see details

🙏 Credits

• Built on memory_graph by Bas Terwijn
• Extension by Akshen Doke

💬 Feedback & Issues

Found a bug or have a suggestion? Open an issue

---

Happy visualizing! 🎨📊