استفاده به‌عنوان SDK

interface پایدار برای یکپارچگی، خودِ CLI‌ست. هر زبونی که می‌تونه subprocess اجرا کنه، می‌تونه از aira -p با خروجی JSON یا stream-json استفاده کنه.

از Node.js

import { execa } from 'execa';

const { stdout } = await execa('aira', [
  '-p', 'Summarize this codebase.',
  '--model', 'aira-deep',
  '--output-format', 'json',
], {
  env: { ...process.env, AIRA_API_KEY: process.env.AIRA_API_KEY },
});

const result = JSON.parse(stdout);

از Python

import json
import os
import subprocess

result = subprocess.run(
    ['aira', '-p', 'Run a code review.', '--output-format', 'json'],
    capture_output=True,
    text=True,
    env={**os.environ, 'AIRA_API_KEY': os.environ['AIRA_API_KEY']},
    check=True,
)
data = json.loads(result.stdout)

از Go

cmd := exec.Command("aira", "-p", "Type-check this package.", "--output-format", "json")
cmd.Env = append(os.Environ(), "AIRA_API_KEY="+token)
out, err := cmd.Output()

خروجی stream

برای گرفتن هر event به‌صورت یک خط JSON روی stdout در حین اجرا، از--output-format stream-json استفاده کن.

aira -p "Review this repository" --output-format stream-json | while read line; do
  echo "event: $line"
done