From f9aa890fb8ba8f7ee46841cfac3271caef9f8639 Mon Sep 17 00:00:00 2001
From: Kovid Goyal <kovid@kovidgoyal.net>
Date: Wed, 18 Mar 2026 14:38:39 +0530
Subject: [PATCH] Start work on new web scraper framework

---
 src/calibre/web/automate/__init__.py |   0
 src/calibre/web/automate/worker.py   | 148 +++++++++++++++++++++++++++
 2 files changed, 148 insertions(+)
 create mode 100644 src/calibre/web/automate/__init__.py
 create mode 100644 src/calibre/web/automate/worker.py

diff --git a/src/calibre/web/automate/__init__.py b/src/calibre/web/automate/__init__.py
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/src/calibre/web/automate/worker.py b/src/calibre/web/automate/worker.py
new file mode 100644
index 0000000000..43bc6583a7
--- /dev/null
+++ b/src/calibre/web/automate/worker.py
@@ -0,0 +1,148 @@
+#!/usr/bin/env python
+# License: GPLv3 Copyright: 2026, Kovid Goyal <kovid at kovidgoyal.net>
+
+
+import asyncio
+import errno
+import json
+import secrets
+import string
+import sys
+from collections.abc import Awaitable, Callable
+from functools import partial
+from typing import Any
+
+from calibre.constants import islinux, iswindows
+from calibre.ptempfile import base_dir
+
+WIN_ERROR_ALREADY_EXISTS = 183
+WIN_ERROR_PIPE_BUSY = 231
+Handler = Callable[[Any], Awaitable[Any]]
+
+
+def get_random_socket_path(name: str) -> str:
+    random_suffix = ''.join(secrets.choice(string.ascii_lowercase + string.digits) for _ in range(8))
+    name = f'{name}-{random_suffix}'
+
+    if iswindows:
+        # Named Pipe for Windows
+        return rf'\\.\pipe\{name}'
+    if islinux:
+        # Abstract Unix Socket for Linux (starts with null byte)
+        return f'\x00{name}'
+    # Standard Unix Domain Socket for macOS/BSD
+    return f'/{base_dir()}/{name}.sock'
+
+
+class SingleObjectProtocol(asyncio.Protocol):
+
+    def __init__(self, handler_callback: Handler):
+        self.handler = handler_callback
+        self.transport = None
+        self._buffer = bytearray()
+
+    def connection_made(self, transport):
+        self.transport = transport
+
+    def data_received(self, data):
+        self._buffer.extend(data)
+
+    def eof_received(self):
+        # Client finished writing. Process what we have.
+        self.task = asyncio.create_task(self._process_and_respond())
+        return False  # Returning False closes the transport
+
+    async def _process_and_respond(self):
+        try:
+            data = json.loads(self._buffer)
+            self._buffer.clear()
+            response = await self.handler(data)
+            payload = {'response': response}
+        except Exception as e:
+            import traceback
+            payload = {'exception': str(e), 'traceback': traceback.format_exc()}
+        finally:
+            self.transport.write(json.dumps(payload))
+            self.transport.close()
+
+
+async def echo(x):
+    return x
+
+
+async def start_server(
+    handle_client: Handler = echo,
+    name: str = 'calibre-aweb'
+) -> tuple[str, asyncio.Server]:
+    '''Tries to start the server, retrying on name collisions.'''
+    loop = asyncio.get_running_loop()
+    protocol_factory = partial(SingleObjectProtocol, handle_client)
+    while True:
+        path = get_random_socket_path()
+        try:
+            if iswindows:
+                server = await loop.start_serving_pipe(protocol_factory, path)
+            else:
+                server = await asyncio.start_unix_server(protocol_factory, path=path)
+            return path, server
+        except OSError as e:
+            if iswindows:
+                exists = e.winerror in (WIN_ERROR_ALREADY_EXISTS, WIN_ERROR_PIPE_BUSY)
+            else:
+                exists = e.errno in (errno.EADDRINUSE, errno.EEXIST)
+            if not exists:
+                raise
+
+
+async def no_setup() -> None:
+    pass
+
+
+async def handler_with_setup(
+    x: Any, handler: Handler, setup: Callable[[], Awaitable[None]], setup_done: asyncio.Event, setup_lock: asyncio.Lock
+) -> Any:
+    if not setup_done.is_set():
+        async with setup_lock:
+            if not setup_done.is_set():
+                await setup()
+                setup_done.set()
+    await setup_done.wait()
+    return await handler(x)
+
+
+async def watch_stdin():
+    '''Abort mechanism: waits for stdin to close (EOF).'''
+    reader = asyncio.StreamReader()
+    protocol = asyncio.StreamReaderProtocol(reader)
+    await asyncio.get_running_loop().connect_read_pipe(lambda: protocol, sys.stdin)
+    await reader.read()
+
+
+async def async_main(
+    # async handler that is called to handle each connection
+    handler: Handler = echo,
+    # global setup called exactly once when first connection arrives
+    delayed_setup: Callable[[], Awaitable[None]] = no_setup,
+    # called after server is shutdown
+    finalizer: Callable[[], None] = lambda: None,
+) -> None:
+    setup_done = asyncio.Event()
+    setup_lock = asyncio.Lock()
+    wh = partial(handler_with_setup, handler=handler, setup=delayed_setup, setup_done=setup_done, setup_lock=setup_lock)
+    abort_task = asyncio.create_task(watch_stdin())
+    try:
+        server, path = await start_server(wh)
+        print(json.dumps(path), end='')
+        sys.stdout.flush()
+        sys.stdout.close()
+        try:
+            await asyncio.wait((server.serve_forever(), abort_task), return_when=asyncio.FIRST_COMPLETED)
+        finally:
+            server.close()
+            await server.wait_closed()
+    finally:
+        finalizer()
+
+
+def main(*a, **kw) -> None:
+    asyncio.run(async_main(*a, **kw))