Spaces:
Runtime error
Runtime error
""" | |
A Simple server used to show altair graphics from a prompt or script. | |
This is adapted from the mpld3 package; see | |
https://github.com/mpld3/mpld3/blob/master/mpld3/_server.py | |
""" | |
import sys | |
import threading | |
import webbrowser | |
import socket | |
from http import server | |
from io import BytesIO as IO | |
import itertools | |
import random | |
JUPYTER_WARNING = """ | |
Note: if you're in the Jupyter notebook, Chart.serve() is not the best | |
way to view plots. Consider using Chart.display(). | |
You must interrupt the kernel to cancel this command. | |
""" | |
# Mock server used for testing | |
class MockRequest: | |
def makefile(self, *args, **kwargs): | |
return IO(b"GET /") | |
def sendall(self, response): | |
pass | |
class MockServer: | |
def __init__(self, ip_port, Handler): | |
Handler(MockRequest(), ip_port[0], self) | |
def serve_forever(self): | |
pass | |
def server_close(self): | |
pass | |
def generate_handler(html, files=None): | |
if files is None: | |
files = {} | |
class MyHandler(server.BaseHTTPRequestHandler): | |
def do_GET(self): | |
"""Respond to a GET request.""" | |
if self.path == "/": | |
self.send_response(200) | |
self.send_header("Content-type", "text/html") | |
self.end_headers() | |
self.wfile.write(html.encode()) | |
elif self.path in files: | |
content_type, content = files[self.path] | |
self.send_response(200) | |
self.send_header("Content-type", content_type) | |
self.end_headers() | |
self.wfile.write(content.encode()) | |
else: | |
self.send_error(404) | |
return MyHandler | |
def find_open_port(ip, port, n=50): | |
"""Find an open port near the specified port""" | |
ports = itertools.chain( | |
(port + i for i in range(n)), (port + random.randint(-2 * n, 2 * n)) | |
) | |
for port in ports: | |
s = socket.socket(socket.AF_INET, socket.SOCK_STREAM) | |
result = s.connect_ex((ip, port)) | |
s.close() | |
if result != 0: | |
return port | |
raise ValueError("no open ports found") | |
def serve( | |
html, | |
ip="127.0.0.1", | |
port=8888, | |
n_retries=50, | |
files=None, | |
jupyter_warning=True, | |
open_browser=True, | |
http_server=None, | |
): | |
"""Start a server serving the given HTML, and (optionally) open a browser | |
Parameters | |
---------- | |
html : string | |
HTML to serve | |
ip : string (default = '127.0.0.1') | |
ip address at which the HTML will be served. | |
port : int (default = 8888) | |
the port at which to serve the HTML | |
n_retries : int (default = 50) | |
the number of nearby ports to search if the specified port is in use. | |
files : dictionary (optional) | |
dictionary of extra content to serve | |
jupyter_warning : bool (optional) | |
if True (default), then print a warning if this is used within Jupyter | |
open_browser : bool (optional) | |
if True (default), then open a web browser to the given HTML | |
http_server : class (optional) | |
optionally specify an HTTPServer class to use for showing the | |
figure. The default is Python's basic HTTPServer. | |
""" | |
port = find_open_port(ip, port, n_retries) | |
Handler = generate_handler(html, files) | |
if http_server is None: | |
srvr = server.HTTPServer((ip, port), Handler) | |
else: | |
srvr = http_server((ip, port), Handler) | |
if jupyter_warning: | |
try: | |
__IPYTHON__ # noqa | |
except NameError: | |
pass | |
else: | |
print(JUPYTER_WARNING) | |
# Start the server | |
print("Serving to http://{}:{}/ [Ctrl-C to exit]".format(ip, port)) | |
sys.stdout.flush() | |
if open_browser: | |
# Use a thread to open a web browser pointing to the server | |
def b(): | |
return webbrowser.open("http://{}:{}".format(ip, port)) | |
threading.Thread(target=b).start() | |
try: | |
srvr.serve_forever() | |
except (KeyboardInterrupt, SystemExit): | |
print("\nstopping Server...") | |
srvr.server_close() | |