اجرای Collectionهای Postman از خط فرمان با Newman CLI

Newman یک ابزار خط فرمان برای اجرای Postman Collectionهاست. با Newman می‌توانید Collectionها و تست‌های آن‌ها را بدون باز کردن برنامه Postman اجرا کنید؛ مثلا در ترمینال، اسکریپت‌های build یا pipelineهای CI/CD.

نکته مهم: Newman با فرمت Collection v3 که در Postman نسخه ۱۲ و نسخه‌های جدیدتر، به‌خصوص در Native Git workflows استفاده می‌شود، سازگار نیست. اگر در حال ساخت جریان CI/CD جدید هستید، معمولا Postman CLI انتخاب مناسب‌تری است. اگر از قبل workflowهای Newman دارید، می‌توانید آن‌ها را به Postman CLI مهاجرت دهید.

شروع کار با Newman #

برای شروع، ابتدا Node.js و سپس Newman را نصب کنید. بعد از نصب، می‌توانید فایل JSON یک Collection یا URL آن را به Newman بدهید و اجرا را از خط فرمان انجام دهید.

گزینه‌های اجرای Newman #

Newman گزینه‌های زیادی برای کنترل اجرای Collection دارد؛ مثل انتخاب environment، تعیین timeout، افزودن داده‌های تکرار، تنظیم reporterها و کنترل کد خروجی برای CI/CD.

آپلود فایل در Newman #

Newman از upload فایل هم پشتیبانی می‌کند. این قابلیت زمانی کاربرد دارد که درخواست‌های شما form-data دارند و باید از فایل‌هایی مثل فایل متنی برای پر کردن فیلدها استفاده کنید.

گزارش اجرای Collection #

Reporterها خروجی اجرای Collection را برای نیازهای مختلف آماده می‌کنند. برای نمونه، می‌توانید خروجی JSON یا JUnit بگیرید، یا هنگام شکست تست‌ها اطلاعات بیشتری از response body ثبت کنید.

Newman در CI/CD #

یکی از کاربردهای اصلی Newman اجرای خودکار Collectionها بعد از push کد یا در build pipeline است. در این حالت، نتیجه تست‌ها می‌تواند باعث موفق یا ناموفق شدن build شود.

مهاجرت به Postman CLI #

اگر قصد دارید از Postman CLI استفاده کنید، می‌توانید workflowهای Newman را با دستورهای معادل به‌روزرسانی کنید و Collectionها را به فرمت YAML نسخه ۳ منتقل کنید.

منبع آموزشی: Postman Docs، بازنویسی و ساده‌سازی‌شده برای کاربران فارسی‌زبان.