session-adapters 0.2.0__tar.gz → 0.4.0__tar.gz

session_adapters-0.4.0/.env

@@ -0,0 +1 @@
+TASK_X_REMOTE_TASKFILES=1

session_adapters-0.4.0/.github/dependabot.yml

@@ -0,0 +1,28 @@
+# Copyright 2026 Terradue
+#
+# 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.
+
+version: 2
+
+updates:
+- package-ecosystem: "pip"
+  directory: "/"
+  schedule:
+    interval: "daily"
+  open-pull-requests-limit: 10
+  commit-message:
+    prefix: "build"
+  labels:
+  - "dependencies"
+  allow:
+  - dependency-type: "direct"

{session_adapters-0.2.0 → session_adapters-0.4.0}/.gitignore

@@ -1,2 +1,3 @@
+.task
 .venv
 __pycache__

session_adapters-0.4.0/CHANGELOG.md

@@ -0,0 +1,64 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+
+### Changed
+
+### Deprecated
+
+### Removed
+
+### Fixed
+
+### Security
+
+## [0.4.0] - 2026-07-15
+
+### Added
+
+- Add `BearerAuthHTTPAdapter` to attach a bearer token to HTTP requests.
+
+## [0.3.0] - 2026-04-14
+
+### Changed
+
+- Replace `python-magic` MIME detection with the Python standard library's
+  `mimetypes` module, removing the external `libmagic` runtime dependency.
+
+### Fixed
+
+- Fix file response MIME detection in environments where `libmagic` is not
+  available or does not work.
+
+## [0.2.0] - 2026-03-23
+
+### Changed
+
+- Create an OCI client for each request and log out after the request completes.
+- Retry OCI operations anonymously when the authenticated login or handshake is
+  rejected.
+
+## [0.1.0] - 2026-03-06
+
+### Added
+
+- Add `requests` transport adapters for local files, Amazon S3 objects, and OCI
+  registry artifacts.
+- Support `GET`, `HEAD`, `PUT`, and `DELETE` operations across the adapters.
+- Support S3 range, object version, delimiter, and maximum-key query options.
+- Support OCI tag and digest references, optional registry authentication, and
+  configurable registry hostnames.
+- Support Python 3.10 through 3.14, including CPython and PyPy.
+
+[unreleased]: https://github.com/Terradue/session-adapters/compare/v0.4.0...HEAD
+[0.4.0]: https://github.com/Terradue/session-adapters/compare/v0.3.0...v0.4.0
+[0.3.0]: https://github.com/Terradue/session-adapters/compare/v0.2.0...v0.3.0
+[0.2.0]: https://github.com/Terradue/session-adapters/compare/v0.1.0...v0.2.0
+[0.1.0]: https://github.com/Terradue/session-adapters/releases/tag/v0.1.0

{session_adapters-0.2.0 → session_adapters-0.4.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: session-adapters
-Version: 0.2.0
-Summary: Requests transport adapters for file://, s3://, and oci:// URLs.
+Version: 0.4.0
+Summary: Requests transport adapters for bearer-authenticated `http(s)://`, `file://`, `s3://`, and `oci://` URLs.
 Project-URL: Documentation, https://github.com/Terradue/session-adapters#README.md
 Project-URL: Issues, https://github.com/Terradue/session-adapters/issues
 Project-URL: Source, https://github.com/Terradue/session-adapters
@@ -22,7 +22,6 @@ Requires-Dist: boto3
 Requires-Dist: loguru
 Requires-Dist: oras
 Requires-Dist: pydantic
-Requires-Dist: python-magic
 Description-Content-Type: text/markdown
 
 # session-adapters
@@ -30,12 +29,15 @@ Description-Content-Type: text/markdown
 [![PyPI - Version](https://img.shields.io/pypi/v/session-adapters.svg)](https://pypi.org/project/session-adapters)
 [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/session-adapters.svg)](https://pypi.org/project/session-adapters)
 
-Requests transport adapters for `file://`, `s3://`, and `oci://` URLs.
+Requests transport adapters for bearer-authenticated `http(s)://`, `file://`,
+`s3://`, and `oci://` URLs.
 
 ## Why This Project
 
-`session-adapters` lets you use a standard `requests.Session` with non-HTTP backends:
+`session-adapters` lets you use a standard `requests.Session` with authenticated
+HTTP requests and non-HTTP backends:
 
+- `http://` and `https://` with bearer token authentication
 - `file://` for local filesystem artifacts
 - `s3://` for AWS S3 objects and prefix listings
 - `oci://` for OCI registry artifacts (via ORAS client)
@@ -53,15 +55,21 @@ pip install session-adapters
 ```python
 import requests
 
+from session_adapters.bearer_auth_http_adapter import BearerAuthHTTPAdapter
 from session_adapters.file_adapter import FileAdapter
-from session_adapters.s3_adapter import S3Adapter
 from session_adapters.oci_adapter import OCIAdapter
+from session_adapters.s3_adapter import S3Adapter
 
 session = requests.Session()
+session.mount("https://", BearerAuthHTTPAdapter("my-token"))
 session.mount("file://", FileAdapter())
 session.mount("s3://", S3Adapter())
 session.mount("oci://", OCIAdapter())
 
+# Bearer-authenticated HTTPS request
+resp = session.get("https://api.example.com/resource")
+print(resp.status_code)
+
 # Local file
 resp = session.get("file:///tmp/example.txt")
 print(resp.status_code)
@@ -77,6 +85,13 @@ print(resp.status_code)
 
 ## Adapter Notes
 
+### Bearer Auth HTTP Adapter
+
+- Adds an `Authorization: Bearer <token>` header to every request it handles
+- Replaces an existing `Authorization` header
+- Can be mounted on a specific URL prefix to limit where the token is sent
+- Mount separate adapters for `http://` and `https://` if both schemes are needed
+
 ### File Adapter
 
 - Supports `GET`, `HEAD`, `PUT`, `DELETE`

{session_adapters-0.2.0 → session_adapters-0.4.0}/README.md

@@ -3,12 +3,15 @@
 [![PyPI - Version](https://img.shields.io/pypi/v/session-adapters.svg)](https://pypi.org/project/session-adapters)
 [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/session-adapters.svg)](https://pypi.org/project/session-adapters)
 
-Requests transport adapters for `file://`, `s3://`, and `oci://` URLs.
+Requests transport adapters for bearer-authenticated `http(s)://`, `file://`,
+`s3://`, and `oci://` URLs.
 
 ## Why This Project
 
-`session-adapters` lets you use a standard `requests.Session` with non-HTTP backends:
+`session-adapters` lets you use a standard `requests.Session` with authenticated
+HTTP requests and non-HTTP backends:
 
+- `http://` and `https://` with bearer token authentication
 - `file://` for local filesystem artifacts
 - `s3://` for AWS S3 objects and prefix listings
 - `oci://` for OCI registry artifacts (via ORAS client)
@@ -26,15 +29,21 @@ pip install session-adapters
 ```python
 import requests
 
+from session_adapters.bearer_auth_http_adapter import BearerAuthHTTPAdapter
 from session_adapters.file_adapter import FileAdapter
-from session_adapters.s3_adapter import S3Adapter
 from session_adapters.oci_adapter import OCIAdapter
+from session_adapters.s3_adapter import S3Adapter
 
 session = requests.Session()
+session.mount("https://", BearerAuthHTTPAdapter("my-token"))
 session.mount("file://", FileAdapter())
 session.mount("s3://", S3Adapter())
 session.mount("oci://", OCIAdapter())
 
+# Bearer-authenticated HTTPS request
+resp = session.get("https://api.example.com/resource")
+print(resp.status_code)
+
 # Local file
 resp = session.get("file:///tmp/example.txt")
 print(resp.status_code)
@@ -50,6 +59,13 @@ print(resp.status_code)
 
 ## Adapter Notes
 
+### Bearer Auth HTTP Adapter
+
+- Adds an `Authorization: Bearer <token>` header to every request it handles
+- Replaces an existing `Authorization` header
+- Can be mounted on a specific URL prefix to limit where the token is sent
+- Mount separate adapters for `http://` and `https://` if both schemes are needed
+
 ### File Adapter
 
 - Supports `GET`, `HEAD`, `PUT`, `DELETE`

{session_adapters-0.2.0 → session_adapters-0.4.0}/Taskfile.yaml

@@ -14,19 +14,14 @@
 
 version: '3'
 
-tasks:
-
-  test:
-    desc: Run tests
-    cmds:
-    - hatch run test:test-show-setup
+includes:
+  quality: https://raw.githubusercontent.com/Terradue/taskfile-utils/refs/heads/main/quality.yaml
 
-  check:
-    desc: Run code quality checks
-    cmds:
-    - hatch run dev:check
+tasks:
 
-  lint:
-    desc: Run linters
+  default:
     cmds:
-    - hatch run dev:lint
+    - task: quality:test
+    - task: quality:check
+    - task: quality:lint
+    

{session_adapters-0.2.0 → session_adapters-0.4.0}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "hatchling.build"
 [project]
 name = "session-adapters"
 dynamic = ["version"]
-description = "Requests transport adapters for file://, s3://, and oci:// URLs."
+description = "Requests transport adapters for bearer-authenticated `http(s)://`, `file://`, `s3://`, and `oci://` URLs."
 readme = "README.md"
 requires-python = ">=3.10"
 license = "MIT"
@@ -30,7 +30,6 @@ dependencies = [
   "loguru",
   "oras",
   "pydantic",
-  "python-magic",
 ]
 
 [project.urls]

{session_adapters-0.2.0 → session_adapters-0.4.0}/src/session_adapters/__about__.py

@@ -12,4 +12,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-__version__ = "0.2.0"
+__version__ = "0.4.0"

{session_adapters-0.2.0 → session_adapters-0.4.0}/src/session_adapters/base.py

@@ -20,7 +20,6 @@ from session_adapters.http_conts import (
 )
 from abc import abstractmethod
 from http import HTTPStatus
-from magic import Magic
 from pathlib import Path
 from requests import PreparedRequest, Response
 from typing import Any, Dict, final, Generic, TypeVar, Union
@@ -36,8 +35,6 @@ __DATE_HEADER_FORMAT__ = "%a, %d %b %Y %H:%M:%S GMT"
 
 AdapterRequest = TypeVar("AdapterRequest")
 
-magic = Magic(mime=True, uncompress=True)
-
 # Ensure YAML extensions are known by the stdlib
 mimetypes.add_type(ContentType.YAML.value, ".yaml")
 mimetypes.add_type(ContentType.YAML.value, ".yml")
@@ -80,13 +77,12 @@ class ExtendedResponse(Response):
         self.send_status(HTTPStatus.OK)
         self.send_date_header(HTTPHeader.LAST_MODIFIED, mod_time)
 
-        mime = magic.from_file(path)
-        if not mime or ContentType.PLAIN == ContentType(mime):
-            guess_mime = mimetypes.guess_type(path)
-            if guess_mime:
-                mime = guess_mime[0]
+        guess_mime = mimetypes.guess_type(path)
 
-        self.send_header(HTTPHeader.CONTENT_TYPE, mime)
+        for mime in guess_mime:
+            if mime:
+                self.send_header(HTTPHeader.CONTENT_TYPE, mime)
+                break
 
     @final
     def send_error(self, http_status: HTTPStatus, error: Any):

session_adapters-0.4.0/src/session_adapters/bearer_auth_http_adapter.py

@@ -0,0 +1,31 @@
+# Copyright 2026 Terradue
+#
+# 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.
+
+from requests import PreparedRequest, Response
+from requests.adapters import HTTPAdapter
+
+
+class BearerAuthHTTPAdapter(HTTPAdapter):
+    def __init__(self, token: str, *args, **kwargs) -> None:
+        super().__init__(*args, **kwargs)
+        self.token = token
+
+    def send(
+        self,
+        request: PreparedRequest,
+        *args,
+        **kwargs,
+    ) -> Response:
+        request.headers["Authorization"] = f"Bearer {self.token}"
+        return super().send(request, *args, **kwargs)

session_adapters-0.4.0/tests/__init__.py

@@ -0,0 +1,13 @@
+# Copyright 2026 Terradue
+#
+# 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.

{session_adapters-0.2.0 → session_adapters-0.4.0}/tests/conftest.py

@@ -1,3 +1,16 @@
+# Copyright 2026 Terradue
+#
+# 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 sys
 import types
 

{session_adapters-0.2.0 → session_adapters-0.4.0}/tests/test_base_adapter.py

@@ -1,3 +1,16 @@
+# Copyright 2026 Terradue
+#
+# 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.
 from http import HTTPStatus
 
 from requests import PreparedRequest, Request

session_adapters-0.4.0/tests/test_bearer_auth_http_adapter.py

@@ -0,0 +1,36 @@
+# Copyright 2026 Terradue
+#
+# 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.
+from unittest.mock import patch
+
+from requests import Request, Response
+from requests.adapters import HTTPAdapter
+
+from session_adapters.bearer_auth_http_adapter import BearerAuthHTTPAdapter
+
+
+def test_send_sets_bearer_authorization_header_and_delegates():
+    adapter = BearerAuthHTTPAdapter("test-token")
+    request = Request(
+        "GET",
+        "https://example.com/resource",
+        headers={"Authorization": "Basic old-credentials"},
+    ).prepare()
+    expected_response = Response()
+
+    with patch.object(HTTPAdapter, "send", return_value=expected_response) as send:
+        response = adapter.send(request, timeout=10)
+
+    assert request.headers["Authorization"] == "Bearer test-token"
+    send.assert_called_once_with(request, timeout=10)
+    assert response is expected_response

{session_adapters-0.2.0 → session_adapters-0.4.0}/tests/test_file_adapter.py

@@ -1,3 +1,16 @@
+# Copyright 2026 Terradue
+#
+# 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.
 from http import HTTPStatus
 
 from requests import Request

{session_adapters-0.2.0 → session_adapters-0.4.0}/tests/test_oci_adapter.py

@@ -1,3 +1,17 @@
+# Copyright 2026 Terradue
+#
+# 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.
+
 from http import HTTPStatus
 
 from requests import Request

{session_adapters-0.2.0 → session_adapters-0.4.0}/tests/test_s3_adapter.py

@@ -1,3 +1,17 @@
+# Copyright 2026 Terradue
+#
+# 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 json
 from http import HTTPStatus
 

session_adapters-0.2.0/tests/__init__.py

@@ -1,3 +0,0 @@
-# SPDX-FileCopyrightText: 2026-present stripodi <simone.tripodi@terradue.com>
-#
-# SPDX-License-Identifier: MIT