Files
Alex 574f96341e refactor: rename the application package to docsgpt
The backend import package is now docsgpt, the name it will carry on PyPI;
application was far too generic to install into anyone's site-packages.
git mv plus a mechanical rewrite of every import, dotted string and path
reference: 734 Python files, the compose files, Dockerfile, workflows, docs,
setup scripts, devcontainer, k8s manifests, vscode config, pytest and coverage
config, .gitignore. Behaviour is unchanged.

Kept for one release:
- A top-level application package whose meta-path finder resolves
  application.x.y to the already-imported docsgpt.x.y object, so old imports
  and entry points (celery -A application.app.celery,
  uvicorn application.asgi:asgi_app) keep working with a FutureWarning.
- Celery registers every application.* task name as an alias of its
  docsgpt.* task on start-up, so messages queued by the previous release still
  run. The redbeat key prefix moves to redbeat:docsgpt:v2: so schedule entries
  the previous release wrote are left unread instead of firing twice.

The backend image builds from the repository root (docker build -f
docsgpt/Dockerfile .) so it can ship the alias package; a root .dockerignore
allow-lists docsgpt/ and application/ and keeps caches, local data, .env
files, the sample index files and the Dockerfile out. Compose and the image
workflows point at the new context.
2026-09-07 10:20:43 +01:00

219 lines
7.3 KiB
Python

from unittest.mock import Mock, patch
import pytest
@pytest.mark.unit
class TestHandleAuth:
def test_returns_local_when_no_auth_type(self):
from docsgpt.auth import handle_auth
mock_request = Mock()
with patch("docsgpt.auth.settings") as mock_settings:
mock_settings.AUTH_TYPE = "none"
result = handle_auth(mock_request)
assert result == {"sub": "local"}
def test_returns_none_when_no_jwt_header(self):
from docsgpt.auth import handle_auth
mock_request = Mock()
mock_request.headers.get.return_value = None
with patch("docsgpt.auth.settings") as mock_settings:
mock_settings.AUTH_TYPE = "simple_jwt"
result = handle_auth(mock_request)
assert result is None
def test_decodes_valid_jwt(self):
from docsgpt.auth import handle_auth
mock_request = Mock()
mock_request.headers.get.return_value = "Bearer valid_token"
with patch("docsgpt.auth.settings") as mock_settings, patch(
"docsgpt.auth.jwt"
) as mock_jwt:
mock_settings.AUTH_TYPE = "simple_jwt"
mock_settings.JWT_SECRET_KEY = "secret"
mock_jwt.decode.return_value = {"sub": "user123"}
result = handle_auth(mock_request)
assert result == {"sub": "user123"}
mock_jwt.decode.assert_called_once_with(
"valid_token",
"secret",
algorithms=["HS256"],
options={"verify_exp": False, "require_exp": False},
)
def test_returns_error_on_invalid_jwt(self):
from docsgpt.auth import handle_auth
mock_request = Mock()
mock_request.headers.get.return_value = "Bearer bad_token"
with patch("docsgpt.auth.settings") as mock_settings, patch(
"docsgpt.auth.jwt"
) as mock_jwt:
mock_settings.AUTH_TYPE = "session_jwt"
mock_settings.JWT_SECRET_KEY = "secret"
mock_jwt.decode.side_effect = Exception("Invalid token")
result = handle_auth(mock_request)
assert result["error"] == "invalid_token"
def test_strips_bearer_prefix(self):
from docsgpt.auth import handle_auth
mock_request = Mock()
mock_request.headers.get.return_value = "Bearer my_token"
with patch("docsgpt.auth.settings") as mock_settings, patch(
"docsgpt.auth.jwt"
) as mock_jwt:
mock_settings.AUTH_TYPE = "simple_jwt"
mock_settings.JWT_SECRET_KEY = "secret"
mock_jwt.decode.return_value = {"sub": "user1"}
handle_auth(mock_request)
mock_jwt.decode.assert_called_once()
assert mock_jwt.decode.call_args[0][0] == "my_token"
@pytest.mark.unit
class TestHandleAuthOidc:
"""AUTH_TYPE=oidc: same local HS256 session tokens, but exp is verified."""
def test_returns_none_when_no_jwt_header(self):
from docsgpt.auth import handle_auth
mock_request = Mock()
mock_request.headers.get.return_value = None
with patch("docsgpt.auth.settings") as mock_settings:
mock_settings.AUTH_TYPE = "oidc"
result = handle_auth(mock_request)
assert result is None
def test_decodes_valid_jwt_with_exp_verification(self):
from docsgpt.auth import handle_auth
mock_request = Mock()
mock_request.headers.get.return_value = "Bearer valid_token"
with patch("docsgpt.auth.settings") as mock_settings, patch(
"docsgpt.auth.jwt"
) as mock_jwt:
mock_settings.AUTH_TYPE = "oidc"
mock_settings.JWT_SECRET_KEY = "secret"
mock_jwt.decode.return_value = {"sub": "user123", "email": "u@example.com"}
result = handle_auth(mock_request)
assert result == {"sub": "user123", "email": "u@example.com"}
mock_jwt.decode.assert_called_once_with(
"valid_token",
"secret",
algorithms=["HS256"],
options={"verify_exp": True, "require_exp": True},
)
def test_expired_token_returns_token_expired(self):
from jose.exceptions import ExpiredSignatureError
from docsgpt.auth import handle_auth
mock_request = Mock()
mock_request.headers.get.return_value = "Bearer stale_token"
with patch("docsgpt.auth.settings") as mock_settings, patch(
"docsgpt.auth.jwt"
) as mock_jwt:
mock_settings.AUTH_TYPE = "oidc"
mock_settings.JWT_SECRET_KEY = "secret"
mock_jwt.decode.side_effect = ExpiredSignatureError("expired")
result = handle_auth(mock_request)
assert result["error"] == "token_expired"
def test_invalid_token_returns_invalid_token(self):
from docsgpt.auth import handle_auth
mock_request = Mock()
mock_request.headers.get.return_value = "Bearer bad_token"
with patch("docsgpt.auth.settings") as mock_settings, patch(
"docsgpt.auth.jwt"
) as mock_jwt:
mock_settings.AUTH_TYPE = "oidc"
mock_settings.JWT_SECRET_KEY = "secret"
mock_jwt.decode.side_effect = Exception("bad")
result = handle_auth(mock_request)
assert result["error"] == "invalid_token"
def test_token_without_exp_rejected_under_oidc(self):
# Under oidc, exp is REQUIRED: an exp-less HS256 token signed with the
# shared secret (e.g. a legacy simple_jwt/session_jwt token) must not
# authenticate, or it would be valid forever and unrevocable.
from jose import jwt as real_jwt
from docsgpt.auth import handle_auth
token = real_jwt.encode({"sub": "helper_user"}, "secret", algorithm="HS256")
mock_request = Mock()
mock_request.headers.get.return_value = f"Bearer {token}"
with patch("docsgpt.auth.settings") as mock_settings:
mock_settings.AUTH_TYPE = "oidc"
mock_settings.JWT_SECRET_KEY = "secret"
result = handle_auth(mock_request)
assert result["error"] == "invalid_token"
def test_expired_token_real_jose(self):
import time
from jose import jwt as real_jwt
from docsgpt.auth import handle_auth
token = real_jwt.encode(
{"sub": "helper_user", "exp": int(time.time()) - 3600},
"secret",
algorithm="HS256",
)
mock_request = Mock()
mock_request.headers.get.return_value = f"Bearer {token}"
with patch("docsgpt.auth.settings") as mock_settings:
mock_settings.AUTH_TYPE = "oidc"
mock_settings.JWT_SECRET_KEY = "secret"
result = handle_auth(mock_request)
assert result["error"] == "token_expired"
def test_simple_jwt_still_skips_exp_verification(self):
import time
from jose import jwt as real_jwt
from docsgpt.auth import handle_auth
token = real_jwt.encode(
{"sub": "local", "exp": int(time.time()) - 3600},
"secret",
algorithm="HS256",
)
mock_request = Mock()
mock_request.headers.get.return_value = f"Bearer {token}"
with patch("docsgpt.auth.settings") as mock_settings:
mock_settings.AUTH_TYPE = "simple_jwt"
mock_settings.JWT_SECRET_KEY = "secret"
result = handle_auth(mock_request)
assert result["sub"] == "local"