Compare commits

..

No commits in common. "main" and "v1.1.0" have entirely different histories.
main ... v1.1.0

8 changed files with 86 additions and 262 deletions

View File

@ -1,28 +0,0 @@
# Nix builder
FROM nixos/nix:latest AS builder
# Copy our source and setup our working dir.
COPY . /tmp/build
WORKDIR /tmp/build
# Build our Nix environment
RUN nix \
--extra-experimental-features "nix-command flakes" \
--option filter-syscalls false \
build
# Copy the Nix store closure into a directory. The Nix store closure is the
# entire set of Nix store values that we need for our build.
RUN mkdir /tmp/nix-store-closure
RUN cp -r $(nix-store -qR result/) /tmp/nix-store-closure
# Final image is based on scratch. We copy a bunch of Nix dependencies
# but they're fully self-contained so we don't need Nix anymore.
FROM scratch
WORKDIR /app
# Copy /nix/store
COPY --from=builder /tmp/nix-store-closure /nix/store
COPY --from=builder /tmp/build/result /app
CMD ["/app/bin/testdata"]

View File

@ -1,15 +0,0 @@
services:
testdata:
image: result/latest
build:
dockerfile: ./Dockerfile
environment:
TESTDATA_HOST: 0.0.0.0
TESTDATA_PORT: 1234
TESTDATA_CONFIG: ./config.json
volumes:
- ./config.json:/app/config.json
- ./db.json:/app/db.json
- ./log.jsonl:/app/log.jsonl

View File

@ -61,17 +61,17 @@
in '' in ''
${ ${
if builtins.elem "pytest" dev && !skipCheck if builtins.elem "pytest" dev && !skipCheck
then "pytest tests" then "pytest src tests"
else "" else ""
} }
${ ${
if builtins.elem "mypy" dev && !skipCheck if builtins.elem "mypy" dev && !skipCheck
then "mypy src" then "mypy src tests"
else "" else ""
} }
${ ${
if builtins.elem "pylint" dev && !skipCheck if builtins.elem "pylint" dev && !skipCheck
then "pylint src" then "pylint src tests"
else "" else ""
} }
''; '';

View File

@ -1,27 +1,27 @@
[project] [project]
name = "testdata" name = "testdata"
version = "1.2.1" version = "1.1.0"
requires-python = "~=3.12, <4" requires-python = "~=3.12, <4"
dependencies = [ dependencies = [
"fastapi~=0.115", "fastapi~=0.115.3",
"uvicorn~=0.32", "uvicorn~=0.32.0",
"pydantic~=2.9", "pydantic~=2.9.2",
] ]
[project.optional-dependencies] [project.optional-dependencies]
dev = [ dev = [
"pytest~=8.3", "pytest~=8.3.4",
"mypy~=1.13", "mypy~=1.13.0",
"pylint~=3.3", "pylint~=3.3.3",
"requests~=2.32", "requests~=2.32.3",
"types-requests~=2.32" "types-requests~=2.32.0"
] ]
[project.scripts] [project.scripts]
testdata = "testdata.main:main" testdata = "testdata.main:main"
[build-system] [build-system]
requires = ["setuptools~=75.1"] requires = ["setuptools~=75.1.1"]
build-backend = "setuptools.build_meta" build-backend = "setuptools.build_meta"
[tool.setuptools.packages.find] [tool.setuptools.packages.find]

View File

@ -132,7 +132,7 @@ def generate_log_config(log_path: str | None = None) -> dict:
'class': logging.handlers.RotatingFileHandler, 'class': logging.handlers.RotatingFileHandler,
'level': 'DEBUG', 'level': 'DEBUG',
'formatter': 'json', 'formatter': 'json',
'filename': log_path, 'filename': 'log.jsonl',
'maxBytes': 1024 * 1024 * 10, # 10 MiB 'maxBytes': 1024 * 1024 * 10, # 10 MiB
'backupCount': 3 'backupCount': 3
}} if log_path is not None else {}), }} if log_path is not None else {}),

26
src/testdata/main.py vendored
View File

@ -1,32 +1,14 @@
import os
import sys import sys
import argparse import argparse
import asyncio import asyncio
import shutil
from .testdata import Testdata from .testdata import Testdata
def parse_args(args: list[str]): def parse_args(args: list[str]):
def formatter(prog): parser = argparse.ArgumentParser()
return argparse.ArgumentDefaultsHelpFormatter(prog, max_help_position=shutil.get_terminal_size().columns) parser.add_argument('-c', '--config', type=argparse.FileType('r'), default='./config.json', help='Path to config file in JSON format.')
parser.add_argument('-l', '--listen', type=str, default='0.0.0.0', help='IP on which to listen.')
parser = argparse.ArgumentParser(formatter_class=formatter) parser.add_argument('-p', '--port', type=int, default='8080', help='Port on which to serve the webserver.')
parser.add_argument(
'-c', '--config', type=argparse.FileType('r'),
default=os.environ['TESTDATA_CONFIG'] if 'TESTDATA_CONFIG' in os.environ else './config.json',
help='Path to config file in JSON format.'
)
parser.add_argument(
'-l', '--listen', type=str,
default=os.environ['TESTDATA_HOST'] if 'TESTDATA_HOST' in os.environ else '0.0.0.0',
help='IP on which to listen.'
)
parser.add_argument(
'-p', '--port', type=int,
default=os.environ['TESTDATA_PORT'] if 'TESTDATA_PORT' in os.environ else 8080,
help='Port on which to serve the webserver.'
)
return parser.parse_args(args) return parser.parse_args(args)

View File

@ -1,16 +1,10 @@
import os import os
import json import json
import asyncio import asyncio
import inspect
import functools
import random
import importlib.metadata
from datetime import datetime
import uvicorn
from typing_extensions import Annotated from typing_extensions import Annotated
from fastapi import FastAPI, Request, Security, status, HTTPException import uvicorn
from fastapi.security import APIKeyHeader, APIKeyQuery from fastapi import FastAPI, Request, status, HTTPException
from fastapi.responses import StreamingResponse from fastapi.responses import StreamingResponse
from pydantic import BaseModel, ConfigDict, Field, BeforeValidator, ValidationError from pydantic import BaseModel, ConfigDict, Field, BeforeValidator, ValidationError
@ -55,158 +49,77 @@ class Testdata:
_config: Config _config: Config
_api: FastAPI _api: FastAPI
_state: dict _state: dict[str, int]
_logger: logger.Logger _logger: logger.Logger
def __init__(self, config: Config): def __init__(self, config: Config):
self._config = config self._config = config
self._api = FastAPI(docs_url=None, redoc_url=None)
self._logger = logger.getLogger('testdata') self._logger = logger.getLogger('testdata')
self._api = self._setup_api()
# Store internal state # Store internal state
self._state = { self._state = {'data-used': 0}
'version': importlib.metadata.version('testdata'), # For future compatibility
'data-used': {f'{(today := datetime.today()).year}-{today.month:02}': 0} # math each months data usage
}
def _setup_api(self) -> FastAPI:
api = FastAPI(docs_url='/', redoc_url=None)
# Security
def get_api_key(
api_key_query: str = Security(APIKeyQuery(name="api_key", auto_error=False)),
api_key_header: str = Security(APIKeyHeader(name="x-api-key", auto_error=False))
) -> str:
# https://joshdimella.com/blog/adding-api-key-auth-to-fast-api
if api_key_query in self._config.authorized_keys:
return api_key_query
if api_key_header in self._config.authorized_keys:
return api_key_header
raise HTTPException(
status_code=status.HTTP_401_UNAUTHORIZED,
detail='Invalid or missing API Key'
)
# A wrapper to set the function signature to accept the api key dependency
def secure(func):
# Get old signature
positional_only, positional_or_keyword, variadic_positional, keyword_only, variadic_keyword = [], [], [], [], []
for value in inspect.signature(func).parameters.values():
if value.kind == inspect.Parameter.POSITIONAL_ONLY:
positional_only.append(value)
elif value.kind == inspect.Parameter.POSITIONAL_OR_KEYWORD:
positional_or_keyword.append(value)
elif value.kind == inspect.Parameter.VAR_POSITIONAL:
variadic_positional.append(value)
elif value.kind == inspect.Parameter.KEYWORD_ONLY:
keyword_only.append(value)
elif value.kind == inspect.Parameter.VAR_KEYWORD:
variadic_keyword.append(value)
# Avoid passing an unrecognized keyword
if inspect.iscoroutinefunction(func):
async def wrapper(*args, **kwargs):
if len(variadic_keyword) == 0:
if 'api_key' in kwargs:
del kwargs['api_key']
return await func(*args, **kwargs)
else:
def wrapper(*args, **kwargs):
if len(variadic_keyword) == 0:
if 'api_key' in kwargs:
del kwargs['api_key']
return func(*args, **kwargs)
# Override signature
wrapper.__signature__ = inspect.signature(func).replace(
parameters=(
*positional_only,
*positional_or_keyword,
*variadic_positional,
*keyword_only,
inspect.Parameter('api_key', inspect.Parameter.POSITIONAL_OR_KEYWORD, default=Security(get_api_key)),
*variadic_keyword
)
)
return functools.wraps(func)(wrapper)
# Routes
api.get('/zeros')(secure(self._zeros))
return api
async def _zeros(self, size: int | str, request: Request, filename: str = 'zeros.bin') -> StreamingResponse:
try:
extra = {'id': f'{random.randint(0, 2 ** 32 - 1):08X}'}
self._logger.debug(
'Initiated request.',
extra=extra | {
'ip': request.client.host if request.client is not None else None,
'query-params': dict(request.query_params),
'headers': dict(request.headers)
}
)
@self._api.get('/zeros')
async def zeros(api_key: str, size: int | str, request: Request) -> StreamingResponse:
try: try:
size = convert_to_bytes(size) extra = {'api_key': api_key, 'ip': request.client.host if request.client is not None else None, 'size': size}
except ValueError as err: self._logger.debug('Initiated request.', extra=extra)
self._logger.warning('Invalid format for size.', extra=extra)
raise HTTPException(
status_code=status.HTTP_400_BAD_REQUEST,
detail='Invalid format for size.'
) from err
if size < 0: if api_key not in config.authorized_keys:
raise MinSizePerRequestError raise HTTPException(
if self._config.max_size < size: status_code=status.HTTP_401_UNAUTHORIZED,
raise MaxSizePerRequestError detail='Invalid API Key.'
)
try:
size = convert_to_bytes(size)
except ValueError as err:
self._logger.warning('Invalid format for size.', extra=extra)
raise HTTPException(
status_code=status.HTTP_400_BAD_REQUEST,
detail='Invalid format for size.'
) from err
# update internal state if size < 0:
current_date = f'{(today := datetime.today()).year}-{today.month:02}' raise MinSizePerRequestError
if current_date not in self._state['data-used']: if config.max_size < size:
self._state['data-used'][current_date] = 0 raise MaxSizePerRequestError
if self._config.max_data < self._state['data-used'][current_date] + size:
raise HTTPException( # update internal state
status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, if config.max_data < self._state['data-used'] + size:
detail='Service not available.' raise HTTPException(
status_code=status.HTTP_500_INTERNAL_SERVER_ERROR,
detail='Service not available.'
)
self._state['data-used'] += size
self._logger.debug('Successfully processed request.', extra=extra)
return StreamingResponse(
status_code=status.HTTP_200_OK,
content=generate_data(size, config.buffer_size),
media_type='application/octet-stream',
headers={
'Content-Length': str(size)
}
) )
self._state['data-used'][current_date] += size
self._logger.debug('Successfully processed request.', extra=extra) except MinSizePerRequestError as err:
return StreamingResponse( self._logger.warning('Size if negative.', extra=extra)
status_code=status.HTTP_200_OK, raise HTTPException(
content=generate_data(size, self._config.buffer_size), status_code=status.HTTP_416_REQUESTED_RANGE_NOT_SATISFIABLE,
media_type='application/octet-stream', detail='Size has to be non-negative.'
headers={ ) from err
'Content-Length': str(size), except MaxSizePerRequestError as err:
'Content-Disposition': f'attachment; filename="{filename}"' self._logger.warning('Exceeded max size per request.', extra=extra)
} raise HTTPException(
) status_code=status.HTTP_416_REQUESTED_RANGE_NOT_SATISFIABLE,
detail=f'Exceeded max size per request of {config.max_size} Bytes.'
except MinSizePerRequestError as err: ) from err
self._logger.warning('Size if negative.', extra=extra) except Exception as err:
raise HTTPException( self._logger.exception(err)
status_code=status.HTTP_416_REQUESTED_RANGE_NOT_SATISFIABLE, raise err
detail='Size has to be non-negative.'
) from err
except MaxSizePerRequestError as err:
self._logger.warning('Exceeded max size per request.', extra=extra)
raise HTTPException(
status_code=status.HTTP_416_REQUESTED_RANGE_NOT_SATISFIABLE,
detail=f'Exceeded max size per request of {self._config.max_size} Bytes.'
) from err
except Exception as err:
self._logger.exception(err)
raise err
async def _update_state(self) -> None:
assert self._config.database is not None
async def _update_state(self):
mode = 'r+' if os.path.exists(self._config.database) else 'w+' mode = 'r+' if os.path.exists(self._config.database) else 'w+'
with open(self._config.database, mode, encoding='utf-8') as file: with open(self._config.database, mode, encoding='utf-8') as file:
@ -217,7 +130,7 @@ class Testdata:
while True: while True:
file.seek(0) file.seek(0)
json.dump(self._state, file, indent=2) json.dump(self._state, file)
file.truncate() file.truncate()
await asyncio.sleep(self._config.database_update_interval) await asyncio.sleep(self._config.database_update_interval)
@ -229,7 +142,7 @@ class Testdata:
self._logger = logger.getLogger('testdata') self._logger = logger.getLogger('testdata')
self._logger.info('Server started.') self._logger.info('Server started.')
coroutines = [uvicorn.Server(uvicorn.Config(self._api, host, port)).serve()] coroutines = [asyncio.create_task(uvicorn.Server(uvicorn.Config(self._api, host, port)).serve())]
if self._config.database is not None: if self._config.database is not None:
coroutines.append(self._update_state()) coroutines.append(self._update_state())

View File

@ -53,17 +53,6 @@ def _server(request) -> Generator[str, None, None]:
break break
@pytest.mark.parametrize('_server', [({
'keys': ['one', 'two', 'three'],
'max-size': '100',
'max-data': 1234,
'buffer-size': '12MiB',
})], indirect=['_server'])
def test_invalid_api_key(_server):
response = requests.get(f'{PROTOCOL}://{HOST}:{PORT}/zeros?api_key=four&size=100', timeout=TIMEOUT)
assert response.status_code == 401
@pytest.mark.parametrize('_server', [({ @pytest.mark.parametrize('_server', [({
'keys': ['one', 'two', 'three'], 'keys': ['one', 'two', 'three'],
'max-size': '100', 'max-size': '100',
@ -96,16 +85,13 @@ def test_request_size_upper_bound(_server):
@pytest.mark.parametrize('_server', [({ @pytest.mark.parametrize('_server', [({
'keys': ['one', 'two', 'three'], 'keys': ['one', 'two', 'three'],
'max-size': '100KB', 'max-size': '100',
'max-data': '100KB', 'max-data': 1234,
'buffer-size': '12MiB', 'buffer-size': '12MiB',
})], indirect=['_server']) })], indirect=['_server'])
def test_request_max_data_used(_server): def test_invalid_api_key(_server):
response = requests.get(f'{PROTOCOL}://{HOST}:{PORT}/zeros?api_key=one&size=100KB', timeout=TIMEOUT) response = requests.get(f'{PROTOCOL}://{HOST}:{PORT}/zeros?api_key=four&size=100', timeout=TIMEOUT)
assert response.status_code == 200 assert response.status_code == 401
response = requests.get(f'{PROTOCOL}://{HOST}:{PORT}/zeros?api_key=one&size=1', timeout=TIMEOUT)
assert response.status_code == 500
@pytest.mark.parametrize('_server', [({ @pytest.mark.parametrize('_server', [({
@ -116,29 +102,15 @@ def test_request_max_data_used(_server):
'database-update-interval': 0.1 'database-update-interval': 0.1
})], indirect=['_server']) })], indirect=['_server'])
def test_check_database_update(_server): def test_check_database_update(_server):
import importlib.metadata
from datetime import datetime
database = _server database = _server
with open(database, 'r', encoding='utf-8') as file: with open(database, 'r', encoding='utf-8') as file:
file.seek(0) file.seek(0)
today = datetime.today() assert json.load(file) == {'data-used': 0}
assert json.load(file) == {
'version': importlib.metadata.version('testdata'),
'data-used': {
f'{today.year}-{today.month:02}': 0
}
}
response = requests.get(f'{PROTOCOL}://{HOST}:{PORT}/zeros?api_key=one&size=100', timeout=TIMEOUT) response = requests.get(f'{PROTOCOL}://{HOST}:{PORT}/zeros?api_key=one&size=100', timeout=TIMEOUT)
assert response.status_code == 200 assert response.status_code == 200
time.sleep(0.1) time.sleep(0.1)
file.seek(0) file.seek(0)
assert json.load(file) == { assert json.load(file) == {'data-used': 100}
'version': importlib.metadata.version('testdata'),
'data-used': {
f'{today.year}-{today.month:02}': 100
}
}