Add support for HTTP Range header in SimpleHTTPServer

Author: lyc8503

Lib/http/server.py

@@ -97,6 +97,7 @@
 import mimetypes
 import os
 import posixpath
+import re
 import select
 import shutil
 import socket # For gethostbyaddr()
@@ -682,7 +683,7 @@ def do_GET(self):
         f = self.send_head()
         if f:
             try:
-                self.copyfile(f, self.wfile)
+                self.copyfile(f, self.wfile, range=self.range)
             finally:
                 f.close()
 
@@ -705,6 +706,7 @@ def send_head(self):
         """
         path = self.translate_path(self.path)
         f = None
+        self.range = self.get_range()
         if os.path.isdir(path):
             parts = urllib.parse.urlsplit(self.path)
             if not parts.path.endswith('/'):
@@ -769,9 +771,26 @@ def send_head(self):
                             f.close()
                             return None
 
-            self.send_response(HTTPStatus.OK)
+            if self.range:
+                start, end = self.range
+                if start >= fs.st_size:
+                    # 416 REQUESTED_RANGE_NOT_SATISFIABLE means that none of the range values overlap the extent of the resource
+                    f.close()
+                    self.send_error(HTTPStatus.REQUESTED_RANGE_NOT_SATISFIABLE)
+                    return None
+                if end is None or end >= fs.st_size:
+                    end = fs.st_size - 1
+                self.send_response(HTTPStatus.PARTIAL_CONTENT)
+                self.send_header("Content-Range", "bytes %s-%s/%s" % (start, end, fs.st_size))
+                self.send_header("Content-Length", str(end-start+1))
+
+                # Update range to be sent to be used later in copyfile
+                self.range = (start, end)
+            else:
+                self.send_response(HTTPStatus.OK)
+                self.send_header("Accept-Ranges", "bytes")
+                self.send_header("Content-Length", str(fs[6]))
             self.send_header("Content-type", ctype)
-            self.send_header("Content-Length", str(fs[6]))
             self.send_header("Last-Modified",
                 self.date_time_string(fs.st_mtime))
             self.end_headers()
@@ -868,21 +887,37 @@ def translate_path(self, path):
             path += '/'
         return path
 
-    def copyfile(self, source, outputfile):
-        """Copy all data between two file objects.
+    def copyfile(self, source, outputfile, range=None):
+        """Copy all data between two file objects if range is None.
+        Otherwise, copy data between two file objects based on the
+        inclusive range (start, end).
 
         The SOURCE argument is a file object open for reading
-        (or anything with a read() method) and the DESTINATION
-        argument is a file object open for writing (or
-        anything with a write() method).
+        (or anything with read() and seek() method) and the
+        DESTINATION argument is a file object open for writing
+        (or anything with a write() method).
 
         The only reason for overriding this would be to change
         the block size or perhaps to replace newlines by CRLF
         -- note however that this the default server uses this
         to copy binary data as well.
 
         """
-        shutil.copyfileobj(source, outputfile)
+        if range is None:
+            shutil.copyfileobj(source, outputfile)
+        else:
+            start, end = range
+            length = end - start + 1
+            source.seek(start)
+            while True:
+                if length <= 0:
+                    break
+                buf = source.read(min(length, shutil.COPY_BUFSIZE))
+                if not buf:
+                    break
+                length -= len(buf)
+                outputfile.write(buf)
+
 
     def guess_type(self, path):
         """Guess the type of a file.
@@ -909,6 +944,24 @@ def guess_type(self, path):
             return guess
         return 'application/octet-stream'
 
+    def get_range(self):
+        """Return a tuple of (start, end) representing the range header in
+        the HTTP request. If the range header is missing or not resolvable,
+        None is returned. This only supports single part ranges.
+
+        """
+        range_header = self.headers.get('range')
+        if not range_header:
+            return None
+        m = re.match(r'bytes=(\d+)-(\d*)$', range_header)
+        if not m:
+            return None
+        start = m.group(1)
+        if not m.group(2):
+            return int(start), None
+        end = m.group(2)
+        return int(start), int(end)
+
 
 # Utilities for CGIHTTPRequestHandler
 

Lib/test/test_httpservers.py

@@ -539,6 +539,27 @@ def test_get(self):
             finally:
                 os.chmod(self.tempdir, 0o755)
 
+    def test_range_get(self):
+        response = self.request(self.base_url + '/test')
+        self.assertEqual(response.getheader('accept-ranges'), 'bytes')
+        self.check_status_and_reason(response, HTTPStatus.OK, data=self.data)
+
+        response = self.request(self.base_url + '/test', headers={'Range': 'bytes=3-12'})
+        self.assertEqual(response.getheader('content-range'), 'bytes 3-12/30')
+        self.assertEqual(response.getheader('content-length'), '10')
+        self.check_status_and_reason(response, HTTPStatus.PARTIAL_CONTENT, data=self.data[3:13])
+
+        response = self.request(self.base_url + '/test', headers={'Range': 'bytes=3-'})
+        self.assertEqual(response.getheader('content-range'), 'bytes 3-29/30')
+        self.assertEqual(response.getheader('content-length'), '27')
+        self.check_status_and_reason(response, HTTPStatus.PARTIAL_CONTENT, data=self.data[3:])
+
+        response = self.request(self.base_url + '/test', headers={'Range': 'bytes=100-200'})
+        self.check_status_and_reason(response, HTTPStatus.REQUESTED_RANGE_NOT_SATISFIABLE)
+
+        response = self.request(self.base_url + '/test', headers={'Range': 'bytes=wrong format'})
+        self.check_status_and_reason(response, HTTPStatus.OK, data=self.data)
+
     def test_head(self):
         response = self.request(
             self.base_url + '/test', method='HEAD')

Misc/NEWS.d/next/Library/2024-05-12-00-15-44.gh-issue-86809._5vdGa.rst

@@ -0,0 +1 @@
+Add support for HTTP Range header in ``SimpleHTTPServer``