k1lib.serve module

This module is for quickly serving Python functions in an interactive website, so that you can build interfaces for your experiments real quick. Let’s say you have a function in the file “a.py”:

def endpoint(a:int=3, b:float=4, c:bool=True) -> float:
   if c: return a + b
   else: return a * b

You want to be able to expose a nice interactive interface so that you can present to everyone, or to be used in other systems, then you can do something like this:

cbs = k1.Callbacks()
cbs.add(serve.FromPythonFile("a.py"))
cbs.add(serve.BuildPythonFile(port=5138))
cbs.add(serve.StartServer())
cbs.add(serve.GenerateHtml(htmlFile="index.html"))

serve.serve(cbs)

This will start up a local server at the specified port (this case 5138), and dumps a index.html file in the current folder. Opening it up will give you this interface:

That’s pretty much it. You can add in your own callbacks, to enable further integration with your systems. You can also customize the given callbacks more.

An example of all supported data types and interfaces:

def endpoint(a:int=3, b:float=5.2, c:str="short string", d:serve.text(True)="paragraph",
             e:bool=True, f:range(3, 21)=6, g:serve.slider(1, 2)=1.2,
             h:PIL.Image.Image=someImg, i:bytes=someBinaryData,
             j:["opt 1", "opt 2"]="opt 1") -> float:
   pass

And how they’re displayed:

• int, float, str, serve.text(True): text box. Could be multiline for text case

• bool: checkbox

• range(3, 21): discrete slider

• serve.slider(1, 2): continuous slider

• PIL.Image.Image`: file upload. If return value is this then will just display the image directly

• bytes: file upload

• ["opt 1", "opt 2"]: dropdown menu

See a few demo examples at https://mlexps.com/ (at the very bottom of the page)

class k1lib.serve.main.FromNotebook(fileName, tagName='serve')

Bases: Callback

__init__(fileName, tagName='serve')

Grabs source code from a Jupyter notebook. Will grab cells with the comment like # serve in the first line.

Parameters

tagName – tag name on the first line of the cell to pull out from

fetchSource()

class k1lib.serve.main.FromPythonFile(fileName)

Bases: Callback

__init__(fileName)

Grabs source code from a python file.

fetchSource()

class k1lib.serve.main.BuildPythonFile(port=None)

Bases: Callback

__init__(port=None)

Builds the output Python file, ready to be served on localhost.

Parameters

port – which port to run on localhost. If not given, then a port will be picked at random, and will be available at cbs.l['port']

buildPythonFile()

class k1lib.serve.main.BuildDashFile

Bases: BuildPythonFile

__init__()

Builds the output Python file for a Dash app, ready to be served on localhost

class k1lib.serve.main.StartServer(initTime=10)

Bases: Callback

__init__(initTime=10)

Starts the server, verify that it starts okay and dumps meta information (including function signatures) to cbs.l

Parameters

initTime – time to wait in seconds until the server is online before declaring it’s unsuccessful

startServer()

class k1lib.serve.main.GenerateHtml(serverPrefix=None, htmlFile=None, title='Interactive demo')

Bases: Callback

__init__(serverPrefix=None, htmlFile=None, title='Interactive demo')

Generates a html file that communicates with the server.

Parameters

• serverPrefix – prefix of server for back and forth requests, like “https://example.com/proj1”. If empty, tries to grab cbs.l["serverPrefix"], which you can deposit from your own callback. If that’s not available then it will fallback to localhost:port

• htmlFile – path of the target html file. If not specified then a temporary file will be created and made available in cbs.l["htmlFile"]

• title – title of html page

generateHtml()

k1lib.serve.main.commonCbs()

Grabs common callbacks, including BuildPythonFile and StartServer

k1lib.serve.main.serve(cbs)

Runs the serving pipeline.

class k1lib.serve.main.text(multiline: bool = True, password: bool = False)

Bases: baseType

__init__(multiline: bool = True, password: bool = False)

Represents text, either on single or multiple lines. If password is true, then will set multiline to false automatically, and creates a text box that blurs out the contents

class k1lib.serve.main.slider(start: float, stop: float, intervals: int = 100)

Bases: baseType

__init__(start: float, stop: float, intervals: int = 100)

Represents a slider from start to stop with a bunch of intervals in the middle. If defValue is not specified, uses the middle point between start and stop

class k1lib.serve.main.html

Bases: baseType

k1lib.serve.main.analyze(f)

k1lib.serve.main.webToPy(o: str, klass: baseType)

k1lib.serve.main.pyToWeb(o, klass: baseType) → str