نام (NAME)

wcurl - پوسته ساده و سبک برای دانلود فایلها با curl

خلاصه دستور (SYNOPSIS)

wcurl <URL>...

wcurl [--curl-options <CURL_OPTIONS>]... [--dry-run] [--no-decode-filename] [-o|-O|--output <PATH>] [--] <URL>...

wcurl [--curl-options=<CURL_OPTIONS>]... [--dry-run] [--no-decode-filename] [--output=<PATH>] [--] <URL>...

wcurl -V|--version

wcurl -h|--help

توضیحات (DESCRIPTION)

wcurl یک پوسته ساده برای curl است که به شما امکان می‌دهد بدون نیاز به حفظ کردن پارامترها، فایل‌ها را با استفاده از curl دانلود کنید.

اجرای wcurl همراه با فهرستی از نشانی‌های اینترنتی (URL) که قصد دانلود آن‌ها را دارید، باعث می‌شود wcurl مقادیر پیش‌فرض مناسب و معقولی را انتخاب کند.

اگر به تنظیمات پیچیده‌تری نیاز دارید، می‌توانید هر یک از پارامترهای پشتیبانی‌شده توسط curl را از طریق گزینه --curl-options مشخص کنید. توجه داشته باشید که اگر مورد کاربرد شما با این ابزار پوشش داده نمی‌شود، احتمالاً بهتر است مستقیماً از curl استفاده نمایید.

به‌طور پیش‌فرض، wcurl اقدامات زیر را انجام می‌دهد:

* نویسه‌های فاصله خالی را در URLها با استفاده از Percent-encode کدگذاری می‌کند؛

* چندین URL را به‌صورت موازی دانلود می‌کند

اگر نسخه curl نصب‌شده 7.66.0 یا بالاتر باشد (--parallel)؛

* در مجموع از ۵ اتصال موازی به یک مقصد مشترک (پروتکل + نام میزبان + شماره پورت) استفاده می‌کند

اگر نسخه curl نصب‌شده 8.16.0 یا بالاتر باشد (--parallel-max-host)؛

* تغییر مسیرها (Redirects) را دنبال می‌کند؛

* به‌طور خودکار نامی را برای فایل خروجی انتخاب می‌کند؛

* از بازنویسی (Overwrite) فایل‌ها جلوگیری می‌کند

اگر نسخه curl نصب‌شده 7.83.0 یا بالاتر باشد (--no-clobber)؛

* عملیات بارگیری مجدد در صورت خطا (Retries) را انجام می‌دهد؛

* مهر زمانی (Timestamp) فایل دانلودشده را

در صورت در دسترس بودن، به مقداری که سرور ارائه داده تنظیم می‌کند؛

* پروتکل https را به‌طور پیش‌فرض در نظر می‌گیرد

اگر URL فاقد هرگونه طرح‌واره (Scheme) باشد؛

* تحلیل‌گر تطبیق الگو (Globbing) را در curl غیرفعال می‌کند

تا با نویسه‌های {} و [] در URLها به‌صورت ویژه برخورد نشود؛

* نام فایل به‌دست‌آمده را Percent-decode می‌کند؛

* از 'index.html' به‌عنوان نام فایل پیش‌فرض استفاده می‌کند

اگر نامی در URL وجود نداشته باشد.

گزینهها (OPTIONS)

--curl-options, --curl-options=<CURL_OPTIONS>...

گزینه‌های اضافی را برای ارسال به curl هنگام فراخوانی مشخص می‌کند. این گزینه می‌تواند بیش از یک‌بار تعیین شود.

-o, -O, --output, --output=<PATH>

استفاده از مسیر خروجی ارائه‌شده به‌جای استخراج آن از نشانی اینترنتی (URL). اگر چندین URL ارائه شده باشد، فایل‌های حاصل نام مشترکی خواهند داشت که یک عدد به انتهای آن‌ها اضافه می‌شود (curl >= 7.83.0). اگر این گزینه چندین‌بار مشخص شود، فقط آخرین مقدار در نظر گرفته خواهد شد.

--no-decode-filename

نام فایل خروجی را با استفاده از درصدزدایی (Percent-decode) رمزگشایی نکن، حتی اگر کدگذاری درصدی در نشانی اینترنتی توسط خود wcurl انجام شده باشد؛ مانند زمانی که نشانی اینترنتی حاوی فاصله خالی بوده است.

--dry-run

دستور curl را عملاً اجرا نکن، بلکه دستوری را که قرار بود فراخوانی شود چاپ کن.

-V, --version

چاپ اطلاعات نسخه برنامه.

-h, --help

چاپ پیام راهنما.

گزینه‌های CURL (CURL_OPTIONS)

هر گزینه‌ای که توسط curl پشتیبانی می‌شود را می‌توان در اینجا تنظیم کرد. این گزینه‌ها مستقیماً توسط wcurl پردازش نمی‌شوند؛ بلکه به فراخوانی نهایی curl منتقل می‌گردند.

نشانی اینترنتی (URL)

نشانی اینترنتی (URL) که باید دانلود شود. هر چیزی که پارامتر نباشد، یک URL در نظر گرفته می‌شود. فاصله‌های خالی کدگذاری درصدی (Percent-encode) می‌شوند و نشانی به curl فرستاده می‌شود که سپس پردازش و تحلیل آن را انجام می‌دهد. این مورد می‌تواند بیش از یک‌بار مشخص شود.

مثال‌ها (EXAMPLES)

دانلود یک فایل منفرد:

wcurl example.com/filename.txt

دانلود دو فایل به‌صورت موازی:

wcurl example.com/filename1.txt example.com/filename2.txt

دانلود یک فایل با ارسال فلگ‌های --progress-bar و --http2 به curl:

wcurl --curl-options="--progress-bar --http2" example.com/filename.txt

ادامه دانلود یک فایل متوقف‌شده (Resume). گزینه‌های موردنیاز برای ادامه دانلود (--clobber --continue-at -) باید آخرین گزینه‌های مشخص‌شده در --curl-options باشند. توجه داشته باشید که تنها راه برای ادامه دانلود فایل‌های متوقف‌شده این است که به wcurl اجازه بازنویسی فایل مقصد داده شود:

wcurl --curl-options="--clobber --continue-at -" example.com/filename.txt

دانلود چندین فایل بدون محدودیت در تعداد اتصالات هم‌زمان به هر میزبان (محدودیت پیش‌فرض ۵ است):

wcurl --curl-options="--parallel-max-host 0"; example.com/filename1.txt example.com/filename2.txt

نویسندگان (AUTHORS)

Samuel Henrique <samueloph@debian.org>
Sergio Durigan Junior <sergiodj@debian.org>
و بسیاری از مشارکت‌کنندگان، فایل AUTHORS را ببینید.

گزارش باگ‌ها (REPORTING BUGS)

اگر با هرگونه مشکلی در wcurl مواجه شدید که در curl با آن روبرو نمی‌شوید، یک گزارش اشکال در گیت‌هاب ارسال کنید: https://github.com/curl/wcurl

حق نشر (COPYRIGHT)

wcurl تحت مجوز curl منتشر شده است.

همچنین ببینید (SEE ALSO)

curl(1), trurl(1)