download_file

astropy.utils.data.download_file(remote_url, cache=False, show_progress=True, timeout=None, sources=None, pkgname='astropy', http_headers=None, ssl_context=None, allow_insecure=False)

URLをダウンロードし、キャッシュ結果を選択することができます。

URL内容を含むファイルのファイル名を返します。もし…。 cache=True また，そのファイルがキャッシュに存在する場合はファイル名のみを返し，そのファイルをダウンロードしなければならない場合はキャッシュに追加する.もし…。 cache="update" 常にダウンロードしてキャッシュに追加します。

キャッシュは実際にはURLをファイルにマッピングする辞書であり，デフォルトではファイルはそのキーであるURLの内容を含むが，実際にはミラーリングからこれらのコンテンツを取得することができる(使用する). sources )またはローカルファイルシステムからの導入(使用) import_file_to_cache あるいは…。 import_download_cache )である。いずれにしても、各ファイルは、特定のURLを表すコンテンツとみなされ、このURLを使用してそれらを検索するか、または他の方法で操作すべきである。

キャッシュディレクトリ内のファイルは、そのURLの暗号化ハッシュに基づいて命名される(現在MD 5であるため、ハッカーは衝突を引き起こす可能性がある)。これらのファイルの修正時間は、通常、Internetから最後にダウンロードされた時間を表す。

パラメータ

remote_url応力.応力

ダウンロードするファイルのURL

cacheBoolまたは“update”、オプション

リモートURLの内容をキャッシュするかどうか.“update”の場合は、新しいバージョンがないようにリモートURLを常にダウンロードし、その結果をキャッシュに格納します。

show_progressブル値、オプション

ダウンロード中にプログレスバーが表示されているかどうか(デフォルト値は True )である。この設定にかかわらず、プログレスバーは端末に出力されたときにのみ表示される。

timeout浮動、オプション

遠隔要求のタイムアウト時間(秒単位)(デフォルトで配置可能であると考えられる. astropy.utils.data.Conf.remote_timeout ）。

sources文字列リスト、オプション

そこからファイルのURLリスト(提供すれば)の取得を試みる.その結果，元のURLに格納される.元のURLは not これは、このリストにない限り、試みてください；これは、現在知られているアクセス不可能なマスターサーバが長時間待つことを防止するためである。もし空のリストが伝達されていれば download_file Internetへの接続は試みない，すなわち，ファイルがキャッシュにないとKeyErrorを引き起こす.

Pkgname ： str オプションです。文字列、オプション

ダウンロードキャッシュのためのパケット名を特定する.これを使って pkgname='astropy' デフォルトキャッシュ位置は ~/.astropy/cache それがそうです。

http_headersDICTやNONE

着信するHTTPリクエストヘッダ urlopen if needed. (These headers are ignored if the protocol for the name_or_obj/sources エントリはリモートHTTP URLではありません。)デフォルトの場合(なし)、ヘッダは User-Agent: some_value そして Accept: */* どこですか some_value 以下の人員で設置されています astropy.utils.data.conf.default_http_user_agent それがそうです。

ssl_contextDICT、オプション

伝達するキーワードパラメータ ssl.create_default_context HTTPSまたはTLS+FTPソースからダウンロードした場合。これは、ルートCA証明書を提供する代替経路のために使用することができる。また、鍵があれば 'certfile' 任意に 'keyfile' そして 'password' 全てが含まれています ssl.SSLContext.load_cert_chain それがそうです。これは、それを必要とするサーバに対してSSL/TLSクライアント証明書認証を実行するために使用することができる。

allow_insecureブル値、オプション

サーバ証明書の検証に失敗しても，TLS/SSL接続によるファイルのダウンロードが許可される.設定すると True the potentially insecure download is allowed to proceed, but an AstropyWarning is issued. If you are frequently getting certificate verification warnings, consider installing or upgrading certifi パケットは、一般的なルートCAに頻繁に更新される証明書(すなわち、Webブラウザによって使用される証明書と同様の証明書のセット)を提供する。インストールされていれば、Astropyは自動的にそれを使用します。

返品

local_path応力.応力

ファイルがダウンロードされたローカルパスに戻ります。

賃上げをする

urllib.error.URLError

リモートファイルを取得するたびに問題が発生する.

KeyError

キャッシュからファイルが要求されたが失われ、Internetからファイルを取得するソースが提供されていない場合。

注意事項

この関数はファイル名を返すため，別のプロセスが実行される可能性がある. clear_download_cache 実際にファイルを開く前に、利用可能なファイルを指しないファイル名が残ります。