polyglot-integration

SKILL.md

Polyglot Integration

Table of Contents

Overview

When to Use

Quick Start

Reference Guides

Best Practices

Overview

Integrate code written in different programming languages to leverage their unique strengths and ecosystems.

When to Use

Performance-critical code in C/C++/Rust

ML models in Python from other languages

Legacy system integration

Leveraging language-specific libraries

Microservices polyglot architecture

Quick Start

Minimal working example:

// addon.cc
#include <node.h>

namespace demo {

using v8::FunctionCallbackInfo;
using v8::Isolate;
using v8::Local;
using v8::Object;
using v8::String;
using v8::Value;
using v8::Number;

void Add(const FunctionCallbackInfo<Value>& args) {
  Isolate* isolate = args.GetIsolate();

  if (args.Length() < 2) {
    isolate->ThrowException(v8::Exception::TypeError(
        String::NewFromUtf8(isolate, "Wrong number of arguments")));
    return;
  }

  if (!args[0]->IsNumber() || !args[1]->IsNumber()) {
    isolate->ThrowException(v8::Exception::TypeError(
        String::NewFromUtf8(isolate, "Arguments must be numbers")));
// ... (see reference guides for full implementation)

Reference Guides

Detailed implementations in the references/ directory:

Guide
Contents

Node.js Native Addons (C++)
Node.js Native Addons (C++)

Python from Node.js
Python from Node.js

Rust from Python (PyO3)
Rust from Python (PyO3)

gRPC Polyglot Communication
gRPC Polyglot Communication

Java from Python (Py4J)
Java from Python (Py4J)

Best Practices

✅ DO

Use appropriate IPC mechanism

Handle serialization carefully

Implement proper error handling

Consider performance overhead

Use type-safe interfaces

Document integration points

❌ DON'T

Pass complex objects across boundaries

Ignore memory management

Skip error handling

Use blocking calls in async code

1d:[