|
| 1 | +#!/usr/bin/env python3 |
| 2 | +"""Static file server for the project WITH HTTP Range support. |
| 3 | +
|
| 4 | +`python -m http.server` ignores the `Range` header and returns the whole file (200), |
| 5 | +which means HTML5 <video> cannot SEEK — clicking the scrub bar or jumping to a segment |
| 6 | +does nothing. This server answers Range requests with `206 Partial Content`, so video |
| 7 | +seeking works. Use it (instead of `python -m http.server`) to run the segment browser: |
| 8 | +
|
| 9 | + python3 tools/serve.py # serves the project root on http://localhost:8000 |
| 10 | + python3 tools/serve.py 8100 # ...on a different port |
| 11 | + # then open http://localhost:8000/analysis/web/index.html |
| 12 | +
|
| 13 | +Pure standard library; no third-party dependencies. |
| 14 | +""" |
| 15 | +from __future__ import annotations |
| 16 | + |
| 17 | +import functools |
| 18 | +import os |
| 19 | +import re |
| 20 | +import sys |
| 21 | +from http.server import SimpleHTTPRequestHandler, ThreadingHTTPServer |
| 22 | + |
| 23 | +ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) |
| 24 | + |
| 25 | + |
| 26 | +class RangeHandler(SimpleHTTPRequestHandler): |
| 27 | + """SimpleHTTPRequestHandler + byte-range (206) support for seekable media.""" |
| 28 | + |
| 29 | + def send_head(self): |
| 30 | + self._range = None |
| 31 | + path = self.translate_path(self.path) |
| 32 | + if os.path.isdir(path): |
| 33 | + return super().send_head() # directory listing / index.html redirect |
| 34 | + try: |
| 35 | + f = open(path, "rb") |
| 36 | + except OSError: |
| 37 | + self.send_error(404, "File not found") |
| 38 | + return None |
| 39 | + try: |
| 40 | + fs = os.fstat(f.fileno()) |
| 41 | + size = fs.st_size |
| 42 | + ctype = self.guess_type(path) |
| 43 | + rng = self.headers.get("Range") |
| 44 | + if not rng: |
| 45 | + self.send_response(200) |
| 46 | + self.send_header("Content-Type", ctype) |
| 47 | + self.send_header("Content-Length", str(size)) |
| 48 | + self.send_header("Accept-Ranges", "bytes") |
| 49 | + self.send_header("Last-Modified", self.date_time_string(fs.st_mtime)) |
| 50 | + self.end_headers() |
| 51 | + return f |
| 52 | + m = re.match(r"bytes=(\d*)-(\d*)\s*$", rng) |
| 53 | + if not m: |
| 54 | + self.send_error(400, "Invalid Range header") |
| 55 | + f.close() |
| 56 | + return None |
| 57 | + g_start, g_end = m.group(1), m.group(2) |
| 58 | + if g_start == "": # suffix range: last N bytes |
| 59 | + n = int(g_end or 0) |
| 60 | + start, end = max(0, size - n), size - 1 |
| 61 | + else: |
| 62 | + start = int(g_start) |
| 63 | + end = int(g_end) if g_end else size - 1 |
| 64 | + end = min(end, size - 1) |
| 65 | + if start > end or start >= size: |
| 66 | + self.send_response(416) # Range Not Satisfiable |
| 67 | + self.send_header("Content-Range", f"bytes */{size}") |
| 68 | + self.end_headers() |
| 69 | + f.close() |
| 70 | + return None |
| 71 | + self.send_response(206) |
| 72 | + self.send_header("Content-Type", ctype) |
| 73 | + self.send_header("Accept-Ranges", "bytes") |
| 74 | + self.send_header("Content-Range", f"bytes {start}-{end}/{size}") |
| 75 | + self.send_header("Content-Length", str(end - start + 1)) |
| 76 | + self.send_header("Last-Modified", self.date_time_string(fs.st_mtime)) |
| 77 | + self.end_headers() |
| 78 | + f.seek(start) |
| 79 | + self._range = (start, end) |
| 80 | + return f |
| 81 | + except Exception: |
| 82 | + f.close() |
| 83 | + raise |
| 84 | + |
| 85 | + def copyfile(self, source, outputfile): |
| 86 | + rng = getattr(self, "_range", None) |
| 87 | + if rng is None: |
| 88 | + return super().copyfile(source, outputfile) |
| 89 | + start, end = rng |
| 90 | + remaining = end - start + 1 |
| 91 | + while remaining > 0: |
| 92 | + chunk = source.read(min(64 * 1024, remaining)) |
| 93 | + if not chunk: |
| 94 | + break |
| 95 | + try: |
| 96 | + outputfile.write(chunk) |
| 97 | + except (BrokenPipeError, ConnectionResetError): |
| 98 | + break # client seeked away / closed — fine |
| 99 | + remaining -= len(chunk) |
| 100 | + |
| 101 | + |
| 102 | +def main(): |
| 103 | + port = int(sys.argv[1]) if len(sys.argv) > 1 else 8000 |
| 104 | + handler = functools.partial(RangeHandler, directory=ROOT) |
| 105 | + with ThreadingHTTPServer(("", port), handler) as httpd: |
| 106 | + print(f"Serving {ROOT}\n http://localhost:{port}/analysis/web/index.html\n" |
| 107 | + f"(Range requests enabled — video seeking works. Ctrl+C to stop.)") |
| 108 | + try: |
| 109 | + httpd.serve_forever() |
| 110 | + except KeyboardInterrupt: |
| 111 | + print("\nstopped.") |
| 112 | + |
| 113 | + |
| 114 | +if __name__ == "__main__": |
| 115 | + main() |
0 commit comments