Andrew/api factor

[ayjayt]

• Add new API functions kaleido.start_sync_server() and kaleido.stop_sync_server() to start and stop global Kaleido server
• Modify kaleido.calc_fig_sync(), kaleido.write_fig_sync(), and kaleido.write_fig_from_object_sync() to use the global server if running
• Various typing improvements

The principal change here is in:
src/py/kaleido/_sync_server.py

However there was type work done and some error messages improved elsewhere to silence the type checker.

[ayjayt]

kaleido.start_sync_server() # take same arguments as kaleido.Kaleido

start = time.perf_counter() # hora inicio

for i in range(10):
    go.Figure(data=[go.Scatter(y=[1, 3, 2])]).write_image(f"slow_test_{i}.jpg")

print(f"Duration: {time.perf_counter() - start}") # calcular duración

kaleido.stop_sync_server()

[emilykl]

Under what circumstances would this RuntimeError be reached?

(not directly relevant to this PR, just curious)

[ayjayt]

/path/to/my/new_file.jpg <-- will show up in the else. But we expect they've created everything up until new_file.jpg, we'll create that though.

[emilykl]

not-released

I mean... everything added in a PR is not-released, until we release it. 🙃

[ayjayt]

yeah, i think i meant not-documented

[emilykl]

Suggested change

	"start_kaleido_sync_server",
	"stop_kaleido_sync_server",
	"start_sync_server",
	"stop_sync_server",

[ayjayt]

is my ruff broken? i feel like thats a ruff catch

[emilykl]

🚀