Client#

Client for the webdav.

exception webdav4.client.BadGatewayError[source]#

Bases: ClientError

Error when bad gateway error is thrown.

Raised when 502 status code is raised by the server.

class webdav4.client.Client(base_url: URLTypes, auth: Optional[AuthTypes] = None, http_client: Optional[HTTPClient] = None, retry: Union[Callable[[Callable[[], _T]], _T], bool] = True, chunk_size: int = 4194304, **client_opts: Any)[source]#

Bases: object

Provides higher level APIs for interacting with Webdav server.

Instantiate client for webdav.

Examples

>>> client = Client("https://webdav.example.org")
>>> client.ls("/")

Parameters:

base_url – base url of the Webdav server
auth –
Auth for the webdav. Auth can be any of the following:
- a tuple of (user, password)
- None if no auth is required.
Refer to Customizing Authentication for more options.
http_client – http client to use instead, useful in mocking (when extending, it is expected to have implemented additional verbs from webdav)
retry – disable or enable retry on client. Can also pass a callable to handle it there. Some well-known errors are handled and retried a few times with the backoff.

All of the following keyword arguments are passed along to the httpx, the http library this client is built on.

Keyword Arguments:

headers – Dict. of HTTP headers to include when sending requests
cookies – Dict. of Cookie items to include when sending requests
verify –
SSL certificates used to verify the identity of requested hosts. Can be any of:
- True (uses default CA bundle),
- a path to an SSL certificate file,
- False (disable verification), or
- a ssl.SSLContext
cert – An SSL certificate used by the requested host to authenticate the client. Either a path to an SSL certificate file, or two-tuple of (certificate file, key file), or a three-tuple of (certificate file, key file, password).
proxies – A dictionary mapping proxy keys to proxy URLs
timeout – The timeout configuration to use when sending requests
limits – The limits configuration to use
max_redirects – The maximum number of redirect responses that should be followed
trust_env – Enables or disables usage of environment variables for configuration

content_language(path: str) → Optional[str][source]#: Returns content language of the resource with the given path.

content_length(path: str) → Optional[int][source]#: Returns content-length of the resource with the given path.

content_type(path: str) → Optional[str][source]#: Returns content type of the resource with the given path.

copy(from_path: str, to_path: str, depth: Union[int, str] = 'infinity', overwrite: bool = False) → None[source]#: Copy resource.

created(path: str) → Optional[datetime][source]#: Returns creationdate of the resource with the given path.

property detected_features: FeatureDetection#: Feature detection for the server.

download_file(from_path: str, to_path: PathLike[AnyStr], chunk_size: Optional[int] = None, callback: Optional[Callable[[int], Any]] = None) → None[source]#: Download file from remote path to local path.

download_fileobj(from_path: str, file_obj: BinaryIO, callback: Optional[Callable[[int], Any]] = None, chunk_size: Optional[int] = None) → None[source]#: Write stream from path to given file object.

etag(path: str) → Optional[str][source]#: Returns etag of the resource with the given path.

exists(path: str) → bool[source]#: Checks whether the resource with the given path exists or not.

get_property(path: str, name: str, namespace: Optional[str] = None) → Any[source]#

Returns appropriate property from the propfind response.

Also supports getting named properties (for now restricted to a single string with the given namespace)

get_props(path: str, name: Optional[str] = None, namespace: Optional[str] = None, data: Optional[str] = None) → DAVProperties[source]#

Returns properties of a resource by doing a propfind request.

Can also selectively request the properties by passing name or data.

info(path: str) → Dict[str, Any][source]#: Returns information about the path itself.

isdir(path: str) → bool[source]#: Checks whether the resource with the given path is a directory.

isfile(path: str) → bool[source]#: Checks whether the resource with the given path is a file.

join_url(path: str, add_trailing_slash: bool = False) → URL[source]#: Join resource path with base url of the webdav server.

ls(path: str, detail: bool = True, allow_listing_resource: bool = True) → List[Union[str, Dict[str, Any]]][source]#

List items in a resource/collection.

Parameters:

path – Path to the resource
detail – If detail=True, additional information is returned in a dictionary
allow_listing_resource – If True and path is a resource (non-collection), ls will return the file entry/details. Otherwise, it will raise an error.

mkdir(path: str) → None[source]#: Create a collection.

modified(path: str) → Optional[datetime][source]#: Returns getlastmodified of the resource with the given path.

move(from_path: str, to_path: str, overwrite: bool = False) → None[source]#: Move resource to a new destination (with or without overwriting).

open(path: str, mode: str = 'r', encoding: Optional[str] = None, chunk_size: Optional[int] = None) → Iterator[Union[TextIO, BinaryIO]][source]#: Returns file-like object to a resource.

options(path: str = '') → Set[str][source]#: Returns features detected in the webdav server.

propfind(path: str, data: Optional[str] = None, headers: Optional[HeaderTypes] = None, follow_redirects: bool = False) → MultiStatusResponse[source]#: Returns properties of the specific resource by propfind request.

remove(path: str) → None[source]#: Remove a resource.

request(method: str, path: str, **kwargs: Any) → HTTPResponse[source]#

Sends request to a server with given method and path.

Also checks for Multistatus response and other http errors.

set_property() → None[source]#: Setting additional property to a resource.

upload_file(from_path: PathLike[AnyStr], to_path: str, overwrite: bool = False, chunk_size: Optional[int] = None, callback: Optional[Callable[[int], Any]] = None) → None[source]#: Upload file from local path to a given remote path.

upload_fileobj(file_obj: BinaryIO, to_path: str, overwrite: bool = False, callback: Optional[Callable[[int], Any]] = None, chunk_size: Optional[int] = None, size: Optional[int] = None) → None[source]#: Upload file from file object to given path.