مهاجرت اسکریپتها از Newman به Postman CLI
مدت زمان مطالعه: : 1 دقیقه
میتوانید اسکریپتهای Newman خود را به دستورهای Postman CLI منتقل کنید. Postman CLI ابزار پیشنهادی Postman برای اجرای Collectionها و کار با قابلیتهای Postman در سیستم محلی و pipelineهای CI/CD است.
نکته مهم: Newman با قابلیتهای معرفیشده در Postman v12، از جمله Native Git workflows و فرمت Collection v3، سازگار نیست. Collectionهایی که در Local View نسخههای جدید Postman ساخته یا بهروزرسانی میشوند، از فرمت v3 استفاده میکنند و Newman نمیتواند آنها را اجرا کند. برای ادامه اجرای Collectionها و استفاده از این قابلیتها، باید به Postman CLI مهاجرت کنید.
محدودیتهای Newman #
- پشتیبانی از قابلیتها: Postman CLI فقط اجرای Collection را محدود نمیکند و از قابلیتهایی مثل Collection، monitor، mock server، flow و موارد دیگر پشتیبانی میکند. Newman فقط برای اجرای Collectionها طراحی شده است.
- Native Git workflows: Postman CLI از Native Git پشتیبانی میکند و امکان کار محلی روی APIها و push کردن تغییرات به cloud Postman را فراهم میکند. Newman این قابلیت را ندارد.
- فرمت Collection: Postman CLI از همه فرمتهای Collection، از جمله v3 YAML مورد نیاز Native Git در Postman v12 و نسخههای جدیدتر، پشتیبانی میکند. Newman فقط فرمت v2.۱ JSON را پشتیبانی میکند.
مهاجرت از Newman به Postman CLI #
برای مهاجرت، دستورهای Newman فعلی را با دستورهای معادل Postman CLI جایگزین کنید. برای اجرای Collectionها از دستور postman collection run استفاده میشود که از نظر ساختار و گزینهها به Newman شباهت زیادی دارد.
اگر Collectionهای موجود را در repository نگه میدارید، از دستور postman collection migrate برای تبدیل آنها به فرمت v3 استفاده کنید تا با Native Git workflows سازگار شوند.
بعد از اتصال پروژه Git به workspace، Collectionهایی که در Local View ساخته میشوند به صورت خودکار در فرمت v3 ذخیره میشوند.
نگاشت دستورهای Newman به Postman CLI #
| کار | دستور Newman | دستور Postman CLI |
|---|---|---|
| اجرای Collection | newman run <collection> |
postman collection run <collection> |
| اجرا با environment | newman run <collection> -e <environment> |
postman collection run <collection> -e <environment> |
| اجرا با globals | newman run <collection> -g <globals> |
postman collection run <collection> -g <globals> |
| مشخص کردن reporterها | newman run <collection> -r cli,json |
postman collection run <collection> -r cli,json |
در عمل، بیشتر مهاجرتها با جایگزین کردن prefix دستورها شروع میشوند، اما برای پروژههایی که از Native Git یا Collection v3 استفاده میکنند، مرحله تبدیل Collectionها هم مهم است.
منبع آموزشی: Postman Docs، بازنویسی و سادهسازیشده برای کاربران فارسیزبان.
