net_dl.download

Contains the Download class

Classes

Download

The download task object.

Module Contents

class net_dl.download.Download(url=None, destdir=getcwd(), destname=None, request_headers=None, chunk_size=None, progress_queue=None, remove_on_error=True, resume=None, timeout=config.HTTP_TIMEOUT, callback=None, callback_args=list(), callback_kwargs=dict())

The download task object.

It contains the source URL, the destination folder, and other needed attributes.

Variables:
  • url – the source URL to download from

  • destdir – the local destination folder

  • resume – attempt to resume an incomplete download

get()

The typical way to start the download task.

Whether the URL is downloaded as a file or it’s content is printed to stdout depends on the value of ‘Content-Type’ in the URL’s response headers.

get_content()

Explicitly download the URL’s content, regardless of ‘Content-Type’.

get_text()

Explicitly download the URL’s text content.

This method is automatically used if Content-Type is “text-like”.

get_file(file_mode='wb')

Explicitly download the URL as a file.

This method is automatically used if Content-Type is “application-like”; progress bar is shown.

Variables:

file_mode – write mode for downloaded file. ‘ab’ is used to continue a partial download