منصوبے کے بارے میں

Alchemy خود کو "Infrastructure-as-Effects" قرار دیتا ہے: کلاؤڈ انفراسٹرکچر اور ایپلیکیشن لاجک ایک ہی، ٹائپ سیف Effect پروگرام کے طور پر لکھے جاتے ہیں۔ انفراسٹرکچر کنفیگریشن کو رن ٹائم کوڈ سے الگ کرنے کے بجائے، ریسورسز، Workers/Lambdas، IAM پالیسیاں اور SDK کالز ایک ہی پروگرام میں رہتی ہیں، نہ کوئی YAML اور نہ کوئی دوسرا رن ٹائم۔ README کے اہم نکات: - ایک پروگرام، ایک زبان: ریسورسز، فنکشنز، IAM اور SDKs ایک ہی Effect پروگرام شیئر کرتے ہیں۔ - گلو کوڈ کے بجائے بائنڈنگز: S3.GetObject(bucket) جیسی کال کہا جاتا ہے کہ ایک ہی لائن میں IAM پالیسی، ماحول متغیر اور ٹائپ شدہ SDK کال کو جوڑ دیتی ہے۔ مثال میں Cloudflare.R2.ReadWriteBucket(Bucket) دکھایا گیا ہے جو ڈیپلائے ٹائم اور رن ٹائم دونوں پر ایک بائنڈنگ، env var اور ٹائپ شدہ کلائنٹ کو جوڑتا ہے۔ - ٹائپ سسٹم میں غلطیاں: کلاؤڈ API کی ناکامیاں ٹیگ شدہ Effect غلطیوں کے طور پر پیش کی جاتی ہیں جنہیں دانستہ طور پر ہینڈل کیا جا سکتا ہے۔ - آج پرووائیڈر کوریج: AWS (S3, SQS, DynamoDB, Kinesis, Lambda, EC2) اور Cloudflare (Workers, R2, D1, Durable Objects, Containers)۔ - تمام مراحل میں ایک ہی کوڈ: لوکل ڈیولپمنٹ، پلان/ڈیپلائے، اسموک ٹیسٹ اور CI کو ایک ہی ذہنی ماڈل شیئر کرتے ہوئے پیش کیا گیا ہے۔ انسٹالیشن `bun add alchemy@latest effect@rc` کے طور پر دکھائی گئی ہے۔ ایک روٹ GitHub Action `main` سے `prod` ڈیپلائے کر سکتا ہے، PR پیش نظاروں کو `staging-{number}` کے طور پر ڈیپلائے کر سکتا ہے، اور PR بند ہونے پر پیش نظاروں کو تباہ کر سکتا ہے؛ ورک فلو کو action چلنے سے پہلے alchemy CLI انسٹال کرنا ہوگا۔ README AI کوڈنگ ایجنٹس کے لیے ایک پرامپٹ بھی فراہم کرتا ہے جو llms.txt دستاویزی انڈیکس حاصل کرتا ہے، اور ٹیوٹوریل، مثالوں اور Discord کے لنکس دیتا ہے۔ پروجیکٹ بتاتا ہے کہ یہ الفا میں ہے اور توڑ پھوڑ والی تبدیلیوں کی توقع رکھنی چاہیے۔ یہ Apache 2.0 کے تحت لائسنس یافتہ ہے، تھرڈ پارٹی لائسنسز الگ سے دستاویزی ہیں۔