VersionObject

class docushare.VersionObject(docushare, hdl, title, filename, version_number)

Represents one Version object in DocuShare.

Parameters

docushare (DocuShare) – The DocuShare site that this object belongs to.
hdl (Handle) – The DocuShare handle that represents this object. The type must be HandleType.Version.
title (str) – Title of this version.
filename (str) – File name of this version.
version_number (int) – Version number of this version.

Attributes Summary

`docushare`	The DocuShare site that this object belongs to.
`download_url`	URL to download this document.
`filename`	File name of this document.
`handle`	The DocuShare handle that represents this object.
`title`	Title of this document.
`version_number`	version number (a sequential number)

Methods Summary

download([path, size_for_progress_report])

Download this document from the DocuShare site to the local storage.

Attributes Documentation

docushare

The DocuShare site that this object belongs to.

download_url

URL to download this document.

filename

File name of this document.

handle

The DocuShare handle that represents this object.

title

Title of this document.

version_number

version number (a sequential number)

Methods Documentation

download(path=None, size_for_progress_report=1000000)

Download this document from the DocuShare site to the local storage.

Parameters

path (path-like object or None) – If it is None, this method downloads the document as a file in the current directory and the file name is determined as suggested by the DocuShare site. If it is a directory path, the document is downloaded as a file in the given directory and the file name is determined as suggested by the DocuShare site. If the given path is not a directory or does not exist, the document is downloaded as a file to the given path.
size_for_progress_report (int) – This method shows a progress bar using tqdm <https://tqdm.github.io/> if the file size is more than the specified size in bytes.

Returns

Path to the downloaded file.

Return type

path-like object