البدء

ثبّت Elide، وأنشئ مشروعًا، ثم شغّله واختبره وابنِه.

التثبيت

على macOS أو Linux أو ⁦WSL:⁩

curl -sSL --tlsv1.2 elide.sh | bash

على Windows (PowerShell):

& ([scriptblock]::Create((irm https://elide.sh/install.ps1)))

عبر npm، على أي منصة:

npm install -g @elide-dev/elide

افتح طرفية جديدة وتحقق من التثبيت:

elide --version

لمعرفة المزيد عن Homebrew والحاويات وقنوات الإصدار ومكوّن Python، راجع التثبيت.

إنشاء مشروع

mkdir hello && cd hello
elide init --plain --skip-defaults --template ktjvm

amends "elide:project.pkl"

name = "Sample Project"

jvm {
  main = "com.example.HelloKt"
}

يعرض elide init --templates القوالب الأخرى: java و web-simple و web-demo و workspace. ومن دون خيارات، يفتح elide init محررًا لمعاملات القالب. ولمشروع Java أو Kotlin قائم، شغّل elide adopt داخله (اعتماد مشروع قائم).

تشغيل ملف

تعمل ملفات المصدر مباشرة، داخل مشروع أو خارجه. لا يحتاج TypeScript إلى خطوة تصريف:

// hello.ts
const name: string = "TypeScript";
console.log(`Hello from ${name}!`);

elide run hello.ts

Hello from TypeScript!

يحتاج Python إلى مكوّن Python (elide setup python):

# hello.py
print("Hello from Python!")

elide python hello.py

Hello from Python!

تعمل ملفات Kotlin و Java بالطريقة نفسها:

// hello.kt
fun main() {
  println("Hello from Kotlin!")
}

elide run hello.kt

Hello from Kotlin!

داخل المشروع، إذا شُغّل elide run من دون ملف فإنه يبني jvm.main ويشغّله، فيطبع Hello Elide!.

السكربتات القابلة للتنفيذ

ابدأ الملف بالسطر #!/usr/bin/env elide واجعله قابلًا للتنفيذ. تصل الوسائط إلى process.argv أو sys.argv:

#!/usr/bin/env elide
const n: number = 42;
console.log(`ts ${n}`, process.argv.slice(2).join(" "));

chmod +x hello.ts
./hello.ts --flag x

ts 42 --flag x

يعمل السطر نفسه مع ملفات .js و .mjs و .py. ويُشغَّل الملف الذي لا امتداد له بوصفه JavaScript.

إضافة تبعية

صرّح بالحزم في elide.pkl:

dependencies {
  maven {
    packages { "com.google.guava:guava:33.4.8-jre" }
  }
  npm {
    packages { "zod@3.25.76" }
  }
}

elide install                         # Maven
elide install --ecosystems=maven,npm  # Maven and npm

تُثبَّت حزم npm في node_modules، ويقرأ npm أيضًا package.json. لا يثبّت elide install حزم pypi. راجع التبعيات.

الاختبار

elide test

com.example.HelloTest
✓ testGreeting() [15ms]

 1 pass
 0 skip
 0 fail
Ran one test across one file. (0.67s)

يشغّل elide test أيضًا ملفات node:test المكتوبة بـ JavaScript و TypeScript؛ راجع الاختبار.

البناء

elide build

توضع المخرجات وحالة البناء في .dev/. يعرض elide build --inspect المهام وخياراتها؛ راجع مهام البناء.

الخطوات التالية

• اللغات: JavaScript و TypeScript، Python، Java و Kotlin، WebAssembly.
• سلسلة الأدوات: البناء والاختبار والتنسيق والتحزيم.
• إعداد المشروع: السكربتات ومساحات العمل وتحديد إصدار Elide.
• خادم التطوير: يقدّم elide dev مجلدًا أو سكربت خادم مع إعادة تحميل الصفحة.
• عينات الكود: أمثلة من ملف واحد مع مخرجاتها المتوقعة.