httpbinx 1.10.0__tar.gz → 1.10.2__tar.gz

{httpbinx-1.10.0 → httpbinx-1.10.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: httpbinx
-Version: 1.10.0
+Version: 1.10.2
 Summary: HTTP Request & Response Service, written in Python + FastAPI.
 Author-Email: Leo <imleowoo@outlook.com>
 Maintainer-Email: Leo <imleowoo@outlook.com>
@@ -38,23 +38,18 @@ Project-URL: Homepage, https://github.com/imleowoo/httpbinx
 Project-URL: Repository, https://github.com/imleowoo/httpbinx
 Requires-Python: >=3.10
 Requires-Dist: fastapi
+Requires-Dist: pydantic
 Requires-Dist: uvicorn
 Requires-Dist: starlette
 Requires-Dist: jinja2
 Requires-Dist: brotli
 Requires-Dist: python-multipart
-Provides-Extra: test
-Requires-Dist: httpx; extra == "test"
-Requires-Dist: pytest-cov; extra == "test"
-Requires-Dist: pytest-mock; extra == "test"
-Requires-Dist: pytest-xdist; extra == "test"
-Requires-Dist: pytest; extra == "test"
 Description-Content-Type: text/markdown
 
 ![![cover](httpbinx/static/images/httpbinx_cover.png)](https://raw.githubusercontent.com/imleowoo/httpbinx/main/httpbinx/static/images/httpbinx_cover.png)
 
 [![thanks](https://img.shields.io/badge/thanks-httpbin-green)](https://github.com/postmanlabs/httpbin)
-![python](https://img.shields.io/badge/python-3.9%20%7C%203.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue)
+![python](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue)
 
 # httpbinx
 
@@ -66,7 +61,7 @@ HTTP Request & Response Service, written in Python + FastAPI.
 
 ## Reference Project
 
-A  [Kenneth Reitz](http://kennethreitz.org/bitcoin) Project. See https://github.com/postmanlabs/httpbin
+A [Kenneth Reitz](http://kennethreitz.org/bitcoin) Project. See https://github.com/postmanlabs/httpbin
 
 ## Quick Start
 

{httpbinx-1.10.0 → httpbinx-1.10.2}/README.md

@@ -1,7 +1,7 @@
 ![![cover](httpbinx/static/images/httpbinx_cover.png)](https://raw.githubusercontent.com/imleowoo/httpbinx/main/httpbinx/static/images/httpbinx_cover.png)
 
 [![thanks](https://img.shields.io/badge/thanks-httpbin-green)](https://github.com/postmanlabs/httpbin)
-![python](https://img.shields.io/badge/python-3.9%20%7C%203.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue)
+![python](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue)
 
 # httpbinx
 
@@ -13,7 +13,7 @@ HTTP Request & Response Service, written in Python + FastAPI.
 
 ## Reference Project
 
-A  [Kenneth Reitz](http://kennethreitz.org/bitcoin) Project. See https://github.com/postmanlabs/httpbin
+A [Kenneth Reitz](http://kennethreitz.org/bitcoin) Project. See https://github.com/postmanlabs/httpbin
 
 ## Quick Start
 

{httpbinx-1.10.0 → httpbinx-1.10.2}/httpbinx/__init__.py

@@ -2,6 +2,6 @@
 
 from .main import app
 
-__version__ = '1.10.0'
+__version__ = '1.10.2'
 
 app.version = __version__

httpbinx-1.10.2/httpbinx/cli.py

@@ -0,0 +1,58 @@
+"""httpbinx CLI."""
+
+import argparse
+import platform
+import sys
+
+import fastapi
+
+import httpbinx
+
+
+def info(_args):
+    """Show httpbinx and environment information."""
+    print(f'httpbinx: {httpbinx.__version__}')
+    print(f'fastapi: {fastapi.__version__}')
+    print(f'python: {sys.version}')
+    print(f'platform: {platform.platform()}')
+    print(f'python executable: {sys.executable}')
+
+
+def version(_args):
+    """Show httpbinx version."""
+    print(httpbinx.__version__)
+
+
+def server(_args):
+    """Start the httpbinx server."""
+    import uvicorn
+
+    uvicorn.run('httpbinx.main:app', host=_args.host, port=_args.port)
+
+
+def execute():
+    """Execute the CLI."""
+    parser = argparse.ArgumentParser(prog='httpbinx', description='httpbinx is a fastapi server for testing.')
+    parser.add_argument('--version', action='version', version='%(prog)s 1.0')
+    subparsers = parser.add_subparsers(dest='command')
+    # version
+    parser_version = subparsers.add_parser('version', help='show version')
+    parser_version.set_defaults(func=version)
+    # info
+    parser_info = subparsers.add_parser('info', help='show info')
+    parser_info.set_defaults(func=info)
+    # server
+    parser_server = subparsers.add_parser('server', help='start server')
+    parser_server.set_defaults(func=server)
+    parser_server.add_argument('--host', type=str, help='host', default='0.0.0.0')
+    parser_server.add_argument('--port', type=int, help='port', default=80)
+
+    parse_args = parser.parse_args()
+    if hasattr(parse_args, 'func'):
+        parse_args.func(parse_args)
+    else:
+        parser.print_help()
+
+
+if __name__ == '__main__':
+    execute()

{httpbinx-1.10.0 → httpbinx-1.10.2}/httpbinx/constants.py

@@ -1,12 +1,6 @@
 REDIRECT_LOCATION = '/redirect/1'
 
-ACCEPTED_MEDIA_TYPES = [
-    'image/webp',
-    'image/svg+xml',
-    'image/jpeg',
-    'image/png',
-    'image/*'
-]
+ACCEPTED_MEDIA_TYPES = ['image/webp', 'image/svg+xml', 'image/jpeg', 'image/png', 'image/*']
 
 ENV_COOKIES = (
     '_gauges_unique',

{httpbinx-1.10.0 → httpbinx-1.10.2}/httpbinx/helpers.py

@@ -8,12 +8,11 @@ from starlette.requests import Request
 from starlette.responses import Response
 from starlette.templating import Jinja2Templates
 
-from httpbinx.constants import (ACCEPTED_MEDIA_TYPES, ASCII_ART,
-                                REDIRECT_LOCATION)
+from httpbinx.constants import ACCEPTED_MEDIA_TYPES, ASCII_ART, REDIRECT_LOCATION
 from httpbinx.schemas import RequestAttrs, RequestInfo
 
 # init Jinja2
-_templates = Jinja2Templates(directory='templates')
+_templates = Jinja2Templates(directory=str(Path(__file__).parent / 'templates'))
 # image path
 _images_path = Path(__file__).parent / 'static' / 'images'
 # bomb files path
@@ -62,25 +61,19 @@ def status_code_response(code: int) -> Response:
         status.HTTP_304_NOT_MODIFIED: dict(data=''),
         status.HTTP_305_USE_PROXY: redirect,
         status.HTTP_307_TEMPORARY_REDIRECT: redirect,
-        status.HTTP_401_UNAUTHORIZED: dict(
-            headers={'WWW-Authenticate': 'Basic realm="Fake Realm"'}
-        ),
+        status.HTTP_401_UNAUTHORIZED: dict(headers={'WWW-Authenticate': 'Basic realm="Fake Realm"'}),
         status.HTTP_402_PAYMENT_REQUIRED: dict(
-            data='Fuck you, pay me!',
-            headers={'x-more-info': 'https://vimeo.com/22053820'}
+            data='Fuck you, pay me!', headers={'x-more-info': 'https://vimeo.com/22053820'}
         ),
         status.HTTP_406_NOT_ACCEPTABLE: dict(
-            data=json.dumps({
-                'message': 'Client did not request a supported media type.',
-                'accept': ACCEPTED_MEDIA_TYPES
-            }),
-            headers={'Content-Type': 'application/json'}),
-        status.HTTP_407_PROXY_AUTHENTICATION_REQUIRED: dict(
-            headers={'Proxy-Authenticate': 'Basic realm="Fake Realm"'}
+            data=json.dumps(
+                {'message': 'Client did not request a supported media type.', 'accept': ACCEPTED_MEDIA_TYPES}
+            ),
+            headers={'Content-Type': 'application/json'},
         ),
+        status.HTTP_407_PROXY_AUTHENTICATION_REQUIRED: dict(headers={'Proxy-Authenticate': 'Basic realm="Fake Realm"'}),
         status.HTTP_418_IM_A_TEAPOT: dict(  # I'm a teapot!
-            data=ASCII_ART,
-            headers={'x-more-info': 'https://datatracker.ietf.org/doc/html/rfc2324'}
+            data=ASCII_ART, headers={'x-more-info': 'https://datatracker.ietf.org/doc/html/rfc2324'}
         ),
     }
 

{httpbinx-1.10.0 → httpbinx-1.10.2}/httpbinx/main.py

@@ -9,28 +9,22 @@ from httpbinx.routers import router
 
 app = FastAPI(
     title='httpbinx',
-    description='HTTP Request & Response Service, '
-                'written in Python + FastAPI.',
+    description='HTTP Request & Response Service, written in Python + FastAPI.',
     docs_url='/',  # swagger docs page url
     swagger_ui_parameters={'docExpansion': 'none'},
-    openapi_tags=get_tags_metadata()
+    openapi_tags=get_tags_metadata(),
 )
 
 app.add_middleware(
-    CORSMiddleware,
+    CORSMiddleware,  # type: ignore
     allow_origins=['*'],
     allow_credentials=True,
     allow_methods=['*'],
     allow_headers=['*'],
-
 )
 
 # mount static files
 static_dir = Path(__file__).parent / 'static'
-app.mount(
-    '/static',
-    StaticFiles(directory=static_dir),
-    name='static'
-)
+app.mount('/static', StaticFiles(directory=static_dir), name='static')
 
 app.include_router(router=router)

{httpbinx-1.10.0 → httpbinx-1.10.2}/httpbinx/meta.py

@@ -2,6 +2,7 @@
 This module defines the metadata for API tags used in the FastAPI application.
 These tags are used to organize and categorize different endpoints in the API documentation.
 """
+
 from functools import lru_cache
 from typing import List
 
@@ -9,11 +10,15 @@ from pydantic import BaseModel, Field
 
 
 class Tag(BaseModel):
+    """API tag with name and description."""
+
     name: str = Field(..., description='The name of the tag')
     description: str = Field(..., description='A brief description of the tag')
 
 
 class TagsMetadata(BaseModel):
+    """Container for a list of API tags."""
+
     tags: List[Tag] = Field(..., description='List of API tags')
 
 

{httpbinx-1.10.0 → httpbinx-1.10.2}/httpbinx/routers/__init__.py

@@ -1,29 +1,28 @@
-# -*- coding: utf-8 -*-
-
 __all__ = ['router']
 
 from fastapi import APIRouter
 from starlette import status
 from starlette.responses import RedirectResponse
 
-from httpbinx.routers import (anything, auth, cookies, dynamicdata,
-                              httpmethods, images, redirects, responseformats,
-                              statuscodes)
+from httpbinx.routers import (
+    anything,
+    auth,
+    cookies,
+    dynamicdata,
+    httpmethods,
+    images,
+    redirects,
+    responseformats,
+    statuscodes,
+)
 from httpbinx.routers.inspection import request_inspection, response_inspection
 
 router = APIRouter()
 
 
-@router.get(
-    '/favicon.ico',
-    summary='Returns a favicon.ico.',
-    include_in_schema=False
-)
+@router.get('/favicon.ico', summary='Returns a favicon.ico.', include_in_schema=False)
 async def favicon():
-    return RedirectResponse(
-        url='/static/favicon.png',
-        status_code=status.HTTP_301_MOVED_PERMANENTLY
-    )
+    return RedirectResponse(url='/static/favicon.png', status_code=status.HTTP_301_MOVED_PERMANENTLY)
 
 
 router.include_router(httpmethods.router)

{httpbinx-1.10.0 → httpbinx-1.10.2}/httpbinx/routers/anything.py

@@ -13,6 +13,7 @@ router = APIRouter(tags=['Anything'])
 
 class BombTypes(str, Enum):
     """The allowed bomb file compression types are: brotli and gzip."""
+
     brotli = 'brotli'
     gzip = 'gzip'
 
@@ -25,7 +26,7 @@ bombs_path: Path = get_bomb_file_path()
     response_model=RequestInfo,
     summary='Returns anything passed in request data.',
     response_description='Anything passed in request',
-    methods=['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'TRACE']
+    methods=['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'TRACE'],
 )
 async def anything(request: Request):
     return await to_request_info(request)
@@ -36,16 +37,16 @@ async def anything(request: Request):
     response_class=FileResponse,
     summary='Returns a bomb file.',
     description='**It may cause your client to crash! '
-                'References [I use Zip Bombs to Protect my Server](https://idiallo.com/blog/zipbomb-protection)**',
-    response_description='Return a bomb for compressed files.'
+    'References [I use Zip Bombs to Protect my Server](https://idiallo.com/blog/zipbomb-protection)**',
+    response_description='Return a bomb for compressed files.',
 )
 async def bomb_file(
-        *,
-        file: BombTypes = Path(
-            ...,
-            title='Compression types',
-            description='The allowed bomb file compression types',
-        )
+    *,
+    file: BombTypes = Path(
+        ...,
+        title='Compression types',
+        description='The allowed bomb file compression types',
+    ),
 ):
     if file == BombTypes.gzip:
         # dd if=/dev/zero bs=1M count=1000 | gzip -c > bomb-1GB.gz

{httpbinx-1.10.0 → httpbinx-1.10.2}/httpbinx/routers/auth.py

@@ -1,22 +1,20 @@
-# -*- coding: utf-8 -*-
 """Auth"""
+
 from fastapi import APIRouter, HTTPException
 from fastapi.security import HTTPBasic, HTTPBasicCredentials
 
-router = APIRouter(tags=['Auth'],)
+router = APIRouter(
+    tags=['Auth'],
+)
 security = HTTPBasic()
 
 
 @router.get(
     '/basic-auth/{user}/{password}',
     summary='Prompts the user for authorization using HTTP Basic Auth.',
-    response_description='TODO'
+    response_description='TODO',
 )
-async def basic_auth(
-        user: str,
-        password: str,
-        credentials: HTTPBasicCredentials = security
-):
+async def basic_auth(user: str, password: str, credentials: HTTPBasicCredentials = security):
     if not (credentials and credentials.username == user and credentials.password == password):
         raise HTTPException(status_code=401)
 

{httpbinx-1.10.0 → httpbinx-1.10.2}/httpbinx/routers/cookies.py

@@ -1,5 +1,5 @@
-# -*- coding: utf-8 -*-
 """Cookies"""
+
 from fastapi import APIRouter, Path, Query
 from starlette.requests import Request
 from starlette.responses import JSONResponse, RedirectResponse
@@ -14,16 +14,11 @@ router = APIRouter(tags=['Cookies'])
     summary='Returns cookie data.',
     response_description='Set cookies.',
     response_class=JSONResponse,
-
 )
 async def cookies(
-        *,
-        show_env: bool = Query(
-            default=False,
-            title='Show Environment variable?',
-            include_in_schema=False
-        ),
-        request: Request
+    *,
+    show_env: bool = Query(default=False, title='Show Environment variable?', include_in_schema=False),
+    request: Request,
 ):
     resp = JSONResponse(content={'cookies': request.cookies})
     if not show_env:
@@ -34,10 +29,9 @@ async def cookies(
 
 @router.get(
     '/cookies/set',
-    summary='Sets cookie(s) as provided by the query string '
-            'and redirects to cookie list.',
+    summary='Sets cookie(s) as provided by the query string and redirects to cookie list.',
     response_description='Redirect to cookie list',
-    response_class=RedirectResponse
+    response_class=RedirectResponse,
 )
 async def set_cookies(request: Request):
     params = request.query_params.items()
@@ -55,10 +49,10 @@ async def set_cookies(request: Request):
     response_class=RedirectResponse,
 )
 async def set_cookie(
-        *,
-        name: str = Path(..., description='Cookie Name'),
-        value: str = Path(..., description='Cookie Value'),
-        request: Request
+    *,
+    name: str = Path(..., description='Cookie Name'),
+    value: str = Path(..., description='Cookie Value'),
+    request: Request,
 ):
     resp = RedirectResponse(request.url_for(cookies.__name__))
     # TODO secure=True
@@ -68,10 +62,9 @@ async def set_cookie(
 
 @router.get(
     '/cookies/delete',
-    summary='Deletes cookie(s) as provided by the query string '
-            'and redirects to cookie list.',
+    summary='Deletes cookie(s) as provided by the query string and redirects to cookie list.',
     response_description='Redirect to cookie list',
-    response_class=RedirectResponse
+    response_class=RedirectResponse,
 )
 async def delete_cookies(request: Request):
     keys = request.query_params.keys()

{httpbinx-1.10.0 → httpbinx-1.10.2}/httpbinx/routers/dynamicdata.py

@@ -1,5 +1,5 @@
-# -*- coding: utf-8 -*-
 """Dynamic Data"""
+
 import asyncio
 import base64
 import binascii
@@ -10,8 +10,7 @@ from fastapi import APIRouter, Path, Query
 from fastapi.responses import PlainTextResponse
 from starlette import status
 from starlette.requests import Request
-from starlette.responses import (HTMLResponse, JSONResponse, Response,
-                                 StreamingResponse)
+from starlette.responses import HTMLResponse, JSONResponse, Response, StreamingResponse
 
 from httpbinx.constants import AWESOME_BASE64ENCODED
 from httpbinx.helpers import to_request_info
@@ -22,6 +21,7 @@ router = APIRouter(tags=['Dynamic data'])
 
 class OctetStreamResponse(Response):
     """set response headers Content-Type: application/octet-stream"""
+
     media_type = 'application/octet-stream'
 
 
@@ -32,16 +32,12 @@ class OctetStreamResponse(Response):
     response_description='Decoded base64 content.',
 )
 async def decode_base64(
-        value: str = Path(
-            ...,
-            title='base64-encoded string',
-            # examples=[AWESOME_BASE64ENCODED],
-            openapi_examples={
-                'awesome': {
-                    'summary': 'A awesome base64 string',
-                    'value': AWESOME_BASE64ENCODED
-                }}
-        )
+    value: str = Path(
+        ...,
+        title='base64-encoded string',
+        # examples=[AWESOME_BASE64ENCODED],
+        openapi_examples={'awesome': {'summary': 'A awesome base64 string', 'value': AWESOME_BASE64ENCODED}},
+    ),
 ):
     encoded: bytes = value.encode('utf-8')
     try:
@@ -49,8 +45,7 @@ async def decode_base64(
         return PlainTextResponse(content=decoded)
     except binascii.Error as err:
         return PlainTextResponse(
-            content=f'Incorrect Base64 data: {value}, err_msg: {err}',
-            status_code=status.HTTP_400_BAD_REQUEST
+            content=f'Incorrect Base64 data: {value}, err_msg: {err}', status_code=status.HTTP_400_BAD_REQUEST
         )
 
 
@@ -58,15 +53,11 @@ async def decode_base64(
     '/bytes/{n}',
     response_class=OctetStreamResponse,
     summary='Returns n random bytes generated with given seed',
-    response_description='A delayed response.'
+    response_description='A delayed response.',
 )
 async def random_bytes(
-        n: int = Path(..., title='binary file size', gt=0, lt=100 * 1024),  # set 100KB limit
-        seed: int = Query(
-            None,
-            title='random seed',
-            description='Initialize the random number generator'
-        )
+    n: int = Path(..., title='binary file size', gt=0, lt=100 * 1024),  # set 100KB limit
+    seed: int = Query(None, title='random seed', description='Initialize the random number generator'),
 ):
     if seed is not None:
         random.seed(seed)
@@ -81,13 +72,9 @@ async def random_bytes(
     methods=['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'TRACE'],
     response_model=RequestInfo,
     summary='Returns a delayed response (max of 10 seconds).',
-    response_description='A delayed response.'
+    response_description='A delayed response.',
 )
-async def delay_response(
-        *,
-        delay: float = Path(..., ge=0, le=10, description='delay seconds'),
-        request: Request
-):
+async def delay_response(*, delay: float = Path(..., ge=0, le=10, description='delay seconds'), request: Request):
     await asyncio.sleep(delay)
     return await to_request_info(request)
 
@@ -96,25 +83,18 @@ async def delay_response(
     '/drip',
     response_class=StreamingResponse,
     summary='Drips data over a duration after an optional initial delay.',
-    response_description='A dripped response.'
+    response_description='A dripped response.',
 )
 async def drip(
-        duration: float = Query(
-            default=2,
-            description='The amount of time (in seconds) over which to drip each byte'
-        ),
-        numbytes: int = Query(
-            default=10, gt=0, lt=10 * 1024 * 1024,  # set 10MB limit
-            description='The number of bytes to respond with',
-        ),
-        code: int = Query(
-            default=200, title='response code',
-            description='The response code that will be returned'
-        ),
-        delay: float = Query(
-            default=2, ge=0,
-            description='The amount of time (in seconds) to delay before responding'
-        ),
+    duration: float = Query(default=2, description='The amount of time (in seconds) over which to drip each byte'),
+    numbytes: int = Query(
+        default=10,
+        gt=0,
+        lt=10 * 1024 * 1024,  # set 10MB limit
+        description='The number of bytes to respond with',
+    ),
+    code: int = Query(default=200, title='response code', description='The response code that will be returned'),
+    delay: float = Query(default=2, ge=0, description='The amount of time (in seconds) to delay before responding'),
 ):
     await asyncio.sleep(delay)
     # Number of seconds to pause during each data generation
@@ -125,26 +105,24 @@ async def drip(
             yield b'*'
             await asyncio.sleep(pause)
 
-    return StreamingResponse(
-        content=generate_content(),
-        media_type='application/octet-stream',
-        status_code=code
-    )
+    return StreamingResponse(content=generate_content(), media_type='application/octet-stream', status_code=code)
 
 
 @router.get(
     '/links/{n}/{offset}',
     summary='Generate a page containing n links to other pages which do the same.',
     response_class=HTMLResponse,
-    response_description='HTML links.'
+    response_description='HTML links.',
 )
 async def link_page(
-        *,
-        n: int = Path(
-            ..., ge=1, le=200,  # limit to between 1 and 200 links
-            description='Number of links'
-        ),
-        offset: int = Path(..., ge=0),
+    *,
+    n: int = Path(
+        ...,
+        ge=1,
+        le=200,  # limit to between 1 and 200 links
+        description='Number of links',
+    ),
+    offset: int = Path(..., ge=0),
 ):
     html = """
     <!DOCTYPE html>
@@ -161,7 +139,7 @@ async def link_page(
         else:
             body += link.format(
                 href=f'/links/{n}/{i}',  # TODO how to use router.url_path_for?
-                text=i
+                text=i,
             )
     return HTMLResponse(content=html.format(body=body))
 
@@ -170,13 +148,10 @@ async def link_page(
     '/range/{numbytes}',
     summary='Streams n random bytes generated with given seed, at given chunk size per packet.',
     response_class=StreamingResponse,
-    response_description='Streaming Bytes'
+    response_description='Streaming Bytes',
 )
 async def range_request(
-        numbytes: int = Path(
-            ..., ge=1, le=100 * 1024,
-            description='number of bytes must be in the range (0, 102400]'
-        )
+    numbytes: int = Path(..., ge=1, le=100 * 1024, description='number of bytes must be in the range (0, 102400]'),
 ):
     raise NotImplementedError
 
@@ -185,15 +160,17 @@ async def range_request(
     '/stream-bytes/{n}',
     summary='Streams n random bytes generated with given seed, at given chunk size per packet.',
     response_class=StreamingResponse,
-    response_description='Streaming Bytes'
+    response_description='Streaming Bytes',
 )
 async def stream_random_bytes(
-        n: int = Path(
-            ..., ge=1, le=100 * 1024,  # set 100KB limit
-            description='Streams n random bytes generated'
-        ),
-        seed: int = Query(default=None, ge=0),
-        chunk_size: int = Query(default=10 * 1024, ge=1, le=10 * 1024)
+    n: int = Path(
+        ...,
+        ge=1,
+        le=100 * 1024,  # set 100KB limit
+        description='Streams n random bytes generated',
+    ),
+    seed: int = Query(default=None, ge=0),
+    chunk_size: int = Query(default=10 * 1024, ge=1, le=10 * 1024),
 ):
     if seed is not None:
         random.seed(seed)
@@ -211,12 +188,7 @@ async def stream_random_bytes(
     return StreamingResponse(content=generate_bytes(), media_type='application/octet-stream')
 
 
-@router.get(
-    '/uuid',
-    response_class=JSONResponse,
-    summary='Return a UUID4.',
-    response_description='A UUID4.'
-)
+@router.get('/uuid', response_class=JSONResponse, summary='Return a UUID4.', response_description='A UUID4.')
 async def get_uuid4():
     out = {'uuid': str(uuid.uuid4())}
     return JSONResponse(content=out)