Skip to content

ServerKit is a lightweight, modern server control panel for managing web applications, databases, and services on your VPS or dedicated server. Built with Python/Flask backend and React frontend.

4.7 KB
Raw Blame
"""One door for seeding test data (plan 77 G1/G2).

Every test that needs a user/JWT/application/server/workspace mints it here,
so a schema change lands once instead of being absorbed by dozens of
hand-rolled seed blocks. All makers take ``**overrides`` — pass exactly what
the test cares about and let the defaults absorb everything else.

Usage (tests import these as top-level modules, like subprocess_stub):

    from factories import make_user, headers_for, make_application

    user = make_user(db, 'alice', role='viewer')
    resp = client.get('/api/v1/apps', headers=headers_for(user))
"""
import uuid


def _uid():
    return uuid.uuid4().hex[:8]


def make_user(db, username=None, role='developer', password='x', **overrides):
    """Create + commit a User. Unique username derived when omitted."""
    from app.models import User
    from werkzeug.security import generate_password_hash
    if username is None:
        username = f'u{_uid()}'
    fields = dict(
        email=f'{username}@t.local',
        username=username,
        password_hash=generate_password_hash(password),
        role=role,
        is_active=True,
    )
    fields.update(overrides)
    user = User(**fields)
    db.session.add(user)
    db.session.commit()
    return user


def access_token_for(user, **token_options):
    """Mint through one door, allowing explicit malformed/expired test claims."""
    from flask_jwt_extended import create_access_token
    user_id = getattr(user, 'id', user)
    return create_access_token(identity=user_id, **token_options)


def headers_for(user, **token_options):
    """JWT auth headers for a User row (or a raw user id)."""
    return {'Authorization': f'Bearer {access_token_for(user, **token_options)}'}


def make_workspace(db, name='ws', created_by=None, **overrides):
    """Create + commit a Workspace; seeds an owner user when none is given."""
    from app.models import Workspace
    if created_by is None:
        created_by = make_user(db).id
    fields = dict(name=name, slug=overrides.pop('slug', name), created_by=created_by)
    fields.update(overrides)
    ws = Workspace(**fields)
    db.session.add(ws)
    db.session.commit()
    return ws


def make_application(db, **overrides):
    """Create + commit an Application (docker-shaped defaults, the seed block
    formerly copy-pasted as ``_seed_app`` across suites). Seeds an owning
    admin user when ``user_id`` is not supplied."""
    from app.models import Application
    fields = dict(
        name='web',
        app_type='docker',
        source='manual',
        root_path='/tmp/web',
        compose_file='docker-compose.yml',
        docker_image='nginx:latest',
    )
    fields.update(overrides)
    if 'user_id' not in fields:
        from app.models import User
        fields['user_id'] = make_user(db, role=User.ROLE_ADMIN).id
    row = Application(**fields)
    db.session.add(row)
    db.session.commit()
    return row


def make_server(db, name='box1', **overrides):
    """Create + commit a Server row."""
    from app.models.server import Server
    fields = dict(name=name)
    fields.update(overrides)
    row = Server(**fields)
    db.session.add(row)
    db.session.commit()
    return row


# ---------------------------------------------------------------------------
# Authz one-liners (plan 77 G4) — the per-endpoint 401/403 micro-test shapes,
# promoted from test_raw_infra_authz.py so new endpoint tests are one line.
# ---------------------------------------------------------------------------

def assert_requires_auth(client, method, url, body=None, expected=401):
    """No token -> 401 (or ``expected``). Returns the response."""
    kwargs = {'json': body} if body is not None else {}
    resp = getattr(client, method.lower())(url, **kwargs)
    assert resp.status_code == expected, (
        f'{method.upper()} {url} without auth returned {resp.status_code}, '
        f'expected {expected}')
    return resp


def assert_admin_only(client, personas, method, url, body=None, ok_status=200,
                      non_admin=('owner', 'member', 'viewer', 'foreign')):
    """Every non-admin persona is 403; the admin passes the gate.

    ``personas`` is a scoping_rbac-style namespace of per-persona auth
    headers (see conftest.scoping_rbac).
    """
    kwargs = {'json': body} if body is not None else {}
    for persona in non_admin:
        resp = getattr(client, method.lower())(url, headers=getattr(personas, persona), **kwargs)
        assert resp.status_code == 403, f'{persona} reached {method.upper()} {url}'
    resp = getattr(client, method.lower())(url, headers=personas.admin, **kwargs)
    assert resp.status_code == ok_status, (
        f'admin denied {method.upper()} {url}: {resp.status_code}')
    return resp