vadalog-extension 3.0.0

JupyterLab extension for Vadalog language support with syntax highlighting, linting, and execution control

Vadalog Extension for JupyterLab

A JupyterLab extension that provides comprehensive support for the Vadalog knowledge graph system, including syntax highlighting, code linting, and execution control.

Features

✨ Syntax Highlighting - Beautiful CodeMirror 6-based syntax highlighting for Vadalog code
🔍 Code Linting - Real-time error detection and code analysis
⏱️ Execution Timer - Displays accurate execution time from the backend
🛑 Stop Button Integration - Intercepts the standard Jupyter stop button to gracefully halt Vadalog execution
📊 Beautiful Output Tables - Modern styled result tables with JetBrains Mono font
🎨 Modern UI - Clean, professional interface integrated seamlessly with JupyterLab 4

Requirements

• JupyterLab >= 4.5.0
• Python >= 3.8
• Vadalog kernel (included in the vadalog-parallel repository)

Installation

From PyPI

pip install vadalog-extension

From Source

git clone https://github.com/prometheuxresearch/vadalog-parallel.git
cd vadalog-parallel/jupyter-lab-extensions/vadalog-extension
pip install -e .

Usage

1. Start JupyterLab:

   jupyter lab
   

2. Create a new notebook and select the Vadalog kernel

3. Write your Vadalog code:

   % Define facts
   @input("person").
   person("Alice").
   person("Bob").
   
   % Define rules
   @output("greeting").
   greeting(X, "Hello " + X) :- person(X).
   

4. Run the cell - enjoy syntax highlighting, execution timing, and beautiful output!

Development

Setup Development Environment

# Clone the repository
git clone https://github.com/prometheuxresearch/vadalog-parallel.git
cd vadalog-parallel

# Create virtual environment
python3 -m venv venv
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Install extension in development mode
cd jupyter-lab-extensions/vadalog-extension
pip install -e .

Watch Mode for Development

# Terminal 1 - TypeScript watch
cd jupyter-lab-extensions/vadalog-extension
jlpm watch

# Terminal 2 - JupyterLab
jupyter lab

Changes to TypeScript files will be automatically rebuilt!

Architecture

This extension is built using:

• TypeScript - Main extension logic
• CodeMirror 6 - Syntax highlighting engine
• React 18 - UI components (shared with JupyterLab)
• Lumino - Widget framework
• Hatchling - Modern Python build system

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

BSD 3-Clause License - see LICENSE file for details.

About Vadalog

Vadalog is a powerful knowledge graph system developed by Prometheux Limited. It combines the expressiveness of Datalog with advanced reasoning capabilities for complex data analysis and knowledge representation.

Support

For issues, questions, or contributions, please visit:

• Homepage: http://www.prometheux.co.uk
• Repository: https://github.com/prometheuxresearch/vadalog-parallel

---

Made with ❤️ by Prometheux Limited