Newman CLI
اجرای Collectionهای Postman از خط فرمان با Newman CLI
آخرین بهروزرسانی: 1405-04-15Newman یک ابزار خط فرمان برای اجرای Postman Collectionهاست. با Newman میتوانید Collectionها و تستهای آنها را بدون باز کردن برنامه Postman اجرا کنید؛ مثلا در ترمینال، اسکریپتهای build یا pipelineهای CI/CD. نکته مهم: Newman با فرمت Collection v3 که در Postman نسخه ۱۲ و نسخههای جدیدتر، بهخصوص در Native Git workflows استفاده میشود، سازگار...
نصب و اجرای Newman
آخرین بهروزرسانی: 1405-04-15Newman بر پایه Node.js ساخته شده است. برای استفاده از آن، ابتدا Node.js را نصب کنید و بعد Newman را اضافه کنید. پس از نصب، میتوانید Collectionهای Postman را به صورت فایل JSON یا با URL از خط فرمان اجرا کنید. نصب Newman قبل از نصب Newman، مطمئن شوید Node.js نسخه ۱۶ یا جدیدتر روی...
مرجع دستورهای Newman
آخرین بهروزرسانی: 1405-04-15با گزینههای خط فرمان Newman میتوانید اجرای Collection را دقیقتر کنترل کنید؛ از انتخاب فایلهای environment و global گرفته تا timeout، SSL، reporterها و کد خروجی مناسب برای CI/CD. گزینهها بعد از مسیر فایل یا URL Collection در دستور newman run قرار میگیرند: newman run my-collection.json [options] برای دیدن فهرست گزینههای موجود، این دستور را...
آپلود فایلهای داده تست با Newman
آخرین بهروزرسانی: 1405-04-15Newman از آپلود فایل پشتیبانی میکند؛ بنابراین میتوانید هنگام اجرای Collection، دادههای تست مثل form-data یا فایل binary را همراه درخواست API ارسال کنید. برای اینکه آپلود فایل درست کار کند، فایل باید در همان working directory قرار داشته باشد که فایل JSON Collection را از آن اجرا میکنید. همچنین نام فایل باید در ویژگی...
گزارش اجرای Collection با reporterهای داخلی Newman
آخرین بهروزرسانی: 1405-04-15Newman چند reporter داخلی دارد که برای تولید گزارش از اجرای Collection استفاده میشوند. این گزارشها کمک میکنند خروجی اجرا را در ترمینال ببینید، برای CI ذخیره کنید، یا نتیجه تستها را در فرمتهای قابل پردازش نگه دارید. Reporterهای داخلی Newman CLI: گزارش را در ترمینال نمایش میدهد. JSON: گزارش را به صورت فایل JSON...
استفاده از reporterهای خارجی و سفارشی در Newman
آخرین بهروزرسانی: 1405-04-15در Newman میتوانید برای اجرای Collectionها گزارشهای اختصاصی بسازید. اگر reporterهای داخلی نیاز شما را پوشش نمیدهند، میتوانید از reporterهای خارجی آماده استفاده کنید یا reporter سفارشی خودتان را بنویسید؛ مثلا برای ثبت response body وقتی یک request یا test شکست میخورد. ساخت reporter سفارشی Reporter سفارشی یک ماژول Node.js است که نام package آن...
اجرای Newman با Docker در macOS، Ubuntu و Windows
آخرین بهروزرسانی: 1405-04-15Docker بستری برای ساخت و اجرای برنامهها در محیط container است. با image رسمی Newman میتوانید Collectionهای Postman را داخل یک container اجرا کنید. در این حالت همچنان میتوانید از گزینههای خط فرمان Newman استفاده کنید و حتی فایلهای Collection محلی را هم اجرا کنید. استفاده از Newman با Docker در macOS و Ubuntu مطمئن...
اجرای Collectionهای Postman در محیط CI با Newman
آخرین بهروزرسانی: 1405-04-15میتوانید از Newman و Postman API برای اجرای Collectionهای Postman در محیط continuous integration یا CI استفاده کنید. ایده اصلی ساده است: در محیط CI ابتدا Node.js و Newman را نصب میکنید، سپس Newman با کمک Postman API، Collection شما را دریافت و اجرا میکند. پیشنیازها یک سیستم CI داشته باشید که بتواند دستورهای shell...
یکپارچهسازی تستهای Postman با Travis CI و Newman
آخرین بهروزرسانی: 1405-04-15CI/CD روشی است که در آن تغییرات کد به صورت منظم در یک repository مشترک ثبت میشود و بعد از هر commit، فرایند خودکار build و test اجرا میشود. با Newman میتوانید تستهای Postman را هم به این pipeline اضافه کنید تا هر push به GitHub باعث اجرای خودکار تستهای API شود. اجرای تستهای Postman...
یکپارچهسازی تستهای Postman با Jenkins و Newman
آخرین بهروزرسانی: 1405-04-15Jenkins یک automation server متنباز است که میتواند به عنوان سرور CI یا مرکز CD استفاده شود. با Newman میتوانید Collectionهای Postman و تستهای API آنها را از داخل Jenkins اجرا کنید و حتی زمانبندی اجرای آنها را مشخص کنید. این راهنما از Jenkins محلی استفاده میکند، اما در محیط واقعی معمولا Jenkins روی یک...
مهاجرت اسکریپتها از Newman به Postman CLI
آخرین بهروزرسانی: 1405-04-15میتوانید اسکریپتهای Newman خود را به دستورهای Postman CLI منتقل کنید. Postman CLI ابزار پیشنهادی Postman برای اجرای Collectionها و کار با قابلیتهای Postman در سیستم محلی و pipelineهای CI/CD است. نکته مهم: Newman با قابلیتهای معرفیشده در Postman v12، از جمله Native Git workflows و فرمت Collection v3، سازگار نیست. Collectionهایی که در Local...
