Source code for multistorageclient.signers.base

 1# SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
 2# SPDX-License-Identifier: Apache-2.0
 3#
 4# Licensed under the Apache License, Version 2.0 (the "License");
 5# you may not use this file except in compliance with the License.
 6# You may obtain a copy of the License at
 7#
 8# http://www.apache.org/licenses/LICENSE-2.0
 9#
10# Unless required by applicable law or agreed to in writing, software
11# distributed under the License is distributed on an "AS IS" BASIS,
12# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13# See the License for the specific language governing permissions and
14# limitations under the License.
15
16from __future__ import annotations
17
18from abc import ABC, abstractmethod
19
20

[docs]
21class URLSigner(ABC):
22    """Pluggable backend for generating pre-signed URLs."""
23

[docs]
24    @abstractmethod
25    def generate_presigned_url(self, path: str, *, method: str = "GET") -> str:
26        """
27        Generate a pre-signed URL for the given object path.
28
29        :param path: The object path (full path including bucket/container).
30        :param method: HTTP method the URL should authorise (e.g. ``"GET"``, ``"PUT"``).
31        :return: A pre-signed URL string.
32        """
33        ...