Skip to main content

session_jupyter

Show session geometry in a Jupyter notebook with the session viewer. One function, no paths:

from session_py import Line, Session
from session_jupyter import show

session = Session("net")
session.add_line(Line(0, 0, 0, 1, 0, 0))

show(session, "my_net")

show uploads the session to the viewer's storage (Cloudflare R2, bucket session-viewer-data) as the scene my_net and returns a frame with https://petrasvestartas.github.io/session/?scene=view_my_net.yaml. Run the cell again and the open viewer reloads.

Call What it does
show(session, name) upload, then show the viewer in the notebook
show(session, name, view="top", height=700) choose the opening camera (top, front, iso, …) and the frame height
show(session, name, upload=False) only show the scene already published under that name
publish(session, name) upload and return the viewer address
url(name) the viewer address of a published scene

Install

pip install session-jupyter

Every change to session_jupyter/ on main is released by .github/workflows/session-jupyter-publish.yml. For development inside the session monorepo, beside session_py:

uv pip install -e session_jupyter

Upload rights

Uploading needs the [r2] profile in ~/.aws/credentials, the same one bash/view_put.sh uses. Without it show raises a clear error; upload=False still shows what is published.

A scene name is a public address and the storage keeps no history of the scene file: publishing a name again replaces what that name showed. The geometry itself is stored under its content hash and is never overwritten.

Settings

SESSION_VIEWER, R2_BUCKET, R2_ACCOUNT, R2_ENDPOINT, R2_PUBLIC, R2_PROFILE and R2_NOTIFY environment variables replace the defaults; they match bash/lib/view.sh.

Metadata

Release files for session-jupyter 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for session-jupyter 0.1.0
File Size Uploaded Provenance Actions
session_jupyter-0.1.0.tar.gz 24.6 kB With provenance Details for session_jupyter-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for session-jupyter 0.1.0
File Interpreter ABI Platform Actions
session_jupyter-0.1.0-py3-none-any.whl Python 3 none any Details for session_jupyter-0.1.0-py3-none-any.whl

Total release size: 29.4 kB

Release files / session_jupyter-0.1.0.tar.gz

Download URL session_jupyter-0.1.0.tar.gz
Size 24.6 kB
Tags Source
SHA-256 checksum
How to use checksums
e07813f54e00fb42a0956f5def06b6cc3e8b685b1ecf0af58984c9909fae2b4f
BLAKE2b-256 checksum
How to use checksums
c1e905b1f2bda3070bdd9b42dce1e1a5b2e97b013275c8037ec5c31dd06adc05
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 11, 2026.

Transparency log

Release files / session_jupyter-0.1.0-py3-none-any.whl

Download URL session_jupyter-0.1.0-py3-none-any.whl
Size 4.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d63539bcad74bf8d6679dec98a35aa19ef7baa133bc37e51434ab925d28b58a3
BLAKE2b-256 checksum
How to use checksums
6b897911c503f80ca6fa04215d2c33cdf60d6439aa93e954b7748ede4666641a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 11, 2026.

Transparency log

Security for session-jupyter 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for session_jupyter-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 11, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page