ifs-cloud-parser 0.4.0

Parses the IFS Cloud source code, including nested SQL support.

Tree-sitter PL/SQL IFS

🚀 High-performance parser for IFS Cloud PL/SQL variant

Status: ✅ 100% success rate on entire IFS Cloud codebase (9,748 files)

Quick Start

# 1. Clone and setup
git clone <repository>
cd ifs-parser/grammars/ifs-cloud-parser

# 2. Generate grammar
npm run generate

# 3. Run tests
npm test
npm run full-codebase-test

# 4. Package for your language
npm run package python    # Creates Python wheel
npm run package node      # Creates Node.js package
npm run package csharp    # Creates C# package
npm run package all       # Creates all packages

That's it! 🎉

What You Get

Python Package (npm run package python)

dist/
├── ifs_cloud_parser-0.1.0-py3-none-any.whl  # Ready to install
└── python/                                        # Source package
    ├── setup.py                                   # Build config
    ├── pyproject.toml                            # Modern Python config
    ├── binding.cc                                # C++ binding
    ├── src/parser.c                              # Generated parser
    ├── src/tree_sitter/parser.h                  # Headers
    └── README.md                                 # Usage instructions

Install anywhere:

pip install ifs_cloud_parser-0.1.0-py3-none-any.whl

Use immediately:

import ifs_cloud_parser
from tree_sitter import Language, Parser

# Create language and parser (tree-sitter 0.25.0)
language = Language(ifs_cloud_parser.language())
parser = Parser(language)

# Parse IFS Cloud PL/SQL code
code = b"PROCEDURE Test___ IS BEGIN NULL; END;"
tree = parser.parse(code)

# Explore the syntax tree
print(tree.root_node.sexp())
print(f"Root node type: {tree.root_node.type}")
print(f"Child count: {tree.root_node.child_count}")

Features

• ✅ 100% compatibility with IFS Cloud codebase
• 🚀 Ultra-fast parsing with Tree-sitter
• 📦 Simple packaging - one command creates distributable packages
• 🔧 Auto-dependency handling - installs required build tools
• 🎯 Clean output - flat directory structure, ready to use
• 🔄 Multiple languages - Python, Node.js, C# support

Architecture

The parser supports:

• Complete IFS Cloud PL/SQL variant syntax
• IFS-specific annotations and pragmas
• Advanced expression handling
• EXTRACT function and built-ins
• Comprehensive error recovery

Development

# Generate grammar from grammar.js
npm run generate

# Run grammar tests
npm test

# Test against full IFS codebase
npm run full-codebase-test

# Clean build artifacts
npm run clean

Package Structure

Each language package includes:

• Generated parser (src/parser.c) - The core Tree-sitter parser
• Headers (src/tree_sitter/parser.h) - Tree-sitter interface
• Metadata (grammar.json, node-types.json) - Grammar definitions
• Language bindings - Native interface for target language
• Build configuration - Ready-to-build package structure
• Usage examples - Complete documentation

Requirements

• Node.js 16+ (for grammar generation and packaging)
• Python 3.8+ (for Python packages)
• C++ compiler (for building native extensions)

The packaging script automatically installs language-specific build dependencies.

---

Built for IFS Cloud development - This parser has been tested and validated on the complete IFS Cloud codebase, ensuring maximum compatibility and reliability.