witness-fracture/.venv/lib/python3.12/site-packages/internetarchive/auth.py
2025-06-23 17:55:02 -05:00

71 lines
2.6 KiB
Python

#
# The internetarchive module is a Python/CLI interface to Archive.org.
#
# Copyright (C) 2012-2024 Internet Archive
#
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU Affero General Public License as
# published by the Free Software Foundation, either version 3 of the
# License, or (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU Affero General Public License for more details.
#
# You should have received a copy of the GNU Affero General Public License
# along with this program. If not, see <http://www.gnu.org/licenses/>.
"""
internetarchive.auth
~~~~~~~~~~~~~~~~~~~~
This module contains the Archive.org authentication handlers for Requests.
:copyright: (C) 2012-2024 by Internet Archive.
:license: AGPL 3, see LICENSE for more details.
"""
from __future__ import annotations
from requests.auth import AuthBase
from internetarchive.exceptions import AuthenticationError
class S3Auth(AuthBase):
"""Attaches S3 Basic Authentication to the given Request object."""
def __init__(self, access_key: str | None = None, secret_key: str | None = None):
self.access_key = access_key
self.secret_key = secret_key
def __call__(self, r):
if not self.access_key:
if self.secret_key:
raise AuthenticationError('No access_key set!'
' Have you run `ia configure`?')
if not self.secret_key:
if self.access_key:
raise AuthenticationError('No secret_key set!'
' Have you run `ia configure`?')
else:
raise AuthenticationError('No access_key or secret_key set!'
' Have you run `ia configure`?')
auth_str = f'LOW {self.access_key}:{self.secret_key}'
r.headers['Authorization'] = auth_str
return r
class S3PostAuth(AuthBase):
"""Attaches S3 Basic Authentication to the given Request object."""
def __init__(self, access_key: str | None = None, secret_key: str | None = None):
self.access_key = access_key
self.secret_key = secret_key
def __call__(self, r):
auth_str = f'&access={self.access_key}&secret={self.secret_key}'
if not r.body:
r.body = ''
r.body += auth_str
r.headers['content-type'] = 'application/x-www-form-urlencoded'
return r