aboutsummaryrefslogtreecommitdiff
# -------------------------------------------------------------------------
# Copyright (c) Microsoft Corporation. All rights reserved.
# Licensed under the MIT License. See License.txt in the project root for
# license information.
# --------------------------------------------------------------------------

from typing import (
    Any, Dict, Optional, Tuple, Union,
    TYPE_CHECKING
)
from urllib.parse import quote, unquote, urlparse

from ._deserialize import deserialize_permission_key
from ._generated.models import SharePermission
from ._parser import _parse_snapshot
from ._shared.base_client import parse_query

if TYPE_CHECKING:
    from urllib.parse import ParseResult


def _parse_url(account_url: str, share_name: str) -> "ParseResult":
    try:
        if not account_url.lower().startswith('http'):
            account_url = "https://" + account_url
    except AttributeError as exc:
        raise ValueError("Account URL must be a string.") from exc
    parsed_url = urlparse(account_url.rstrip('/'))
    if not share_name:
        raise ValueError("Please specify a share name.")
    if not parsed_url.netloc:
        raise ValueError(f"Invalid URL: {account_url}")
    return parsed_url


def _format_url(scheme: str, hostname: str, share_name: Union[str, bytes], query_str: str) -> str:
    if isinstance(share_name, str):
        share_name = share_name.encode('UTF-8')
    return f"{scheme}://{hostname}/{quote(share_name)}{query_str}"


def _from_share_url(share_url: str, snapshot: Optional[Union[str, Dict[str, Any]]]) -> Tuple[str, str, Optional[str]]:
    try:
        if not share_url.lower().startswith('http'):
            share_url = "https://" + share_url
    except AttributeError as exc:
        raise ValueError("Share URL must be a string.") from exc
    parsed_url = urlparse(share_url.rstrip('/'))
    if not (parsed_url.path and parsed_url.netloc):
        raise ValueError(f"Invalid URL: {share_url}")

    share_path = parsed_url.path.lstrip('/').split('/')
    account_path = ""
    if len(share_path) > 1:
        account_path = "/" + "/".join(share_path[:-1])
    account_url = f"{parsed_url.scheme}://{parsed_url.netloc.rstrip('/')}{account_path}?{parsed_url.query}"

    share_name = unquote(share_path[-1])
    path_snapshot, _ = parse_query(parsed_url.query)
    path_snapshot = _parse_snapshot(snapshot, path_snapshot)

    if not share_name:
        raise ValueError("Invalid URL. Please provide a URL with a valid share name")

    return account_url, share_name, path_snapshot


def _create_permission_for_share_options(file_permission: str, **kwargs: Any) -> Dict[str, Any]:
    options = {
        'share_permission': SharePermission(permission=file_permission),
        'cls': deserialize_permission_key,
        'timeout': kwargs.pop('timeout', None),
    }
    options.update(kwargs)
    return options