.nh
.TH DIRENV-FETCHURL 1 "2019" direnv "User Manuals"
.SH "نام (NAME)"
direnv fetchurl \- دریافت یک URL و ذخیره روی دیسک

.SH "خلاصه دستور (SYNOPSIS)"
\fIdirenv fetchurl\fP <url> [<integrity-hash>]

.SH "توضیحات (DESCRIPTION)"
این دستور نشانی اینترنتی (URL) ارائه‌شده را بر اساس محتوای فایل دریافت‌شده، در یک مکان ثابت روی دیسک بارگیری می‌کند.

.PP
این قابلیت برای رفع وابستگی به \fBcurl\fR یا \fBwget\fR و در عین حال ترویج روشی امن‌تر برای دریافت داده‌ها از اینترنت معرفی شده است. به جای \fBcurl <url> | sh\fR\& از این دستور استفاده کنید.

.PP
این دستور دارای دو حالت عملکردی است:
.IP "  1." 5
تنها نشانی اینترنتی (URL) را ارسال کنید تا هش یکپارچگی آن شناسایی شود.
.IP "  2." 5
نشانی اینترنتی (URL) \fIو\fP هش یکپارچگی را با هم ارسال کنید تا مسیر ذخیره روی دیسک را دریافت کنید.

.PP
از آنجا که مکان ذخیره روی دیسک بر اساس هش است، به عنوان یک حافظه موقت (کش) نیز عمل می‌کند. یکی از نتایج این طراحی این است که نشانی‌های URL باید پایدار بوده و همیشه همان محتوا را برگردانند.

.PP
فایل‌های بارگیری‌شده به عنوان فقط‌خواندنی و قابل‌اجرا علامت‌گذاری می‌شوند تا بتوان از آن برای دریافت و اجرای فایل‌های باینری ایستا نیز استفاده کرد.

.SH "گزینه‌ها (OPTIONS)"
\fB<url>\fR
    یک نشانی اینترنتی (HTTP URL) که در پاسخ به درخواست‌های HTTP GET محتوا بازمی‌گرداند. تغییرمسیرهای ۳۰۱ و سایر موارد دنبال می‌شوند.

.PP
\fB<integrity-hash>\fR
    در صورت ارسال، یکپارچگی محتوای دریافت‌شده در برابر هش داده‌شده اعتبارسنجی می‌شود. کدگذاری هش بر اساس مشخصات SRI کنسرسیوم W3C است (نشانی https://www.w3.org/TR/SRI را ببینید).

.SH "خروجی (OUTPUT)"
دستور \fIdirenv fetchurl\fP بر اساس آرگومان ارائه‌شده، خروجی‌های متفاوتی تولید می‌کند.

.PP
اگر \fBintegrity-hash\fR ارسال شده باشد، در صورت موفقیت‌آمیز بودن دریافت، مسیر مکان ذخیره روی دیسک را چاپ می‌کند.

.PP
اگر تنها \fBurl\fR ارسال شده باشد، مقدار هش را به همراه دستورالعمل‌هایی خوانا برای کاربر چاپ می‌کند. اگر خروجی استاندارد یک tty نباشد، تنها مقدار هش نمایش داده خواهد شد.

.SH "مثال (EXAMPLE)"
.EX
$ ./direnv fetchurl https://releases.nixos.org/nix/nix-2.3.7/install
Found hash: sha256-7Gxl5GzI9juc/U30Igh/pY+p6+gj5Waohfwql3jHIds=

Invoke fetchurl again with the hash as an argument to get the disk location:

  direnv fetchurl "https://releases.nixos.org/nix/nix-2.3.7/install" "sha256-7Gxl5GzI9juc/U30Igh/pY+p6+gj5Waohfwql3jHIds="
  #=> /home/zimbatm/.cache/direnv/cas/sha256-7Gxl5GzI9juc_U30Igh_pY+p6+gj5Waohfwql3jHIds=
.EE

.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
\fBXDG_CACHE_HOME\fP
    این متغیر برای انتخاب مکان ذخیره نشانی‌های اینترنتی دریافت‌شده روی دیسک به صورت \fB$XDG_CACHE_HOME/direnv/cas\fR\& استفاده می‌شود. اگر \fBXDG_CACHE_HOME\fP تنظیم نشده یا خالی باشد، مقدار پیش‌فرض آن \fB$HOME/.cache\fR\& خواهد بود.

.SH "حق نشر (COPYRIGHT)"
مجوز MIT - حق نشر (C) 2019 متعلق به @zimbatm و مشارکت‌کنندگان

.SH "همچنین ببینید (SEE ALSO)"
direnv-stdlib(1)