# Copyright (c) Microsoft Corporation. # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. import pathlib from pathlib import Path from typing import TYPE_CHECKING, Optional, Union from playwright._impl._artifact import Artifact if TYPE_CHECKING: # pragma: no cover from playwright._impl._page import Page class Download: def __init__( self, page: "Page", url: str, suggested_filename: str, artifact: Artifact ) -> None: self._page = page self._loop = page._loop self._dispatcher_fiber = page._dispatcher_fiber self._url = url self._suggested_filename = suggested_filename self._artifact = artifact def __repr__(self) -> str: return f"" @property def page(self) -> "Page": return self._page @property def url(self) -> str: return self._url @property def suggested_filename(self) -> str: return self._suggested_filename async def delete(self) -> None: await self._artifact.delete() async def failure(self) -> Optional[str]: return await self._artifact.failure() async def path(self) -> pathlib.Path: return await self._artifact.path_after_finished() async def save_as(self, path: Union[str, Path]) -> None: await self._artifact.save_as(path) async def cancel(self) -> None: return await self._artifact.cancel()