High-performance asset caching for multi-page applications

These details have been verified by PyPI

Project links

GitHub Statistics

Maintainers

JensRoland

These details have not been verified by PyPI

Project description

Skybolt Python

Python adapter for Skybolt - High-performance asset caching for multi-page applications.

Installation

pip install skybolt

Or with uv:

uv add skybolt

Prerequisites

Install and configure the Vite plugin: npm install @skybolt/vite-plugin
Build your project: npm run build
Ensure render-map.json is generated in your build output

Usage

from skybolt import Skybolt

# Initialize with render map path and cookies
sb = Skybolt("dist/.skybolt/render-map.json", cookies=request.cookies)

<!DOCTYPE html>
<html>
<head>
    {{ sb.css("src/css/critical.css")|safe }}
    {{ sb.launch_script()|safe }}
    {{ sb.css("src/css/main.css")|safe }}
</head>
<body>
    <h1>Hello Skybolt!</h1>
    {{ sb.script("src/js/app.js")|safe }}
</body>
</html>

API

`Skybolt(render_map_path, cookies=None, cdn_url=None)`

Create a new Skybolt instance.

render_map_path - Path to render-map.json generated by Vite plugin
cookies - Cookie dictionary (defaults to None)
cdn_url - Optional CDN URL prefix (e.g., 'https://cdn.example.com')

# Basic usage
sb = Skybolt("dist/.skybolt/render-map.json", cookies=request.cookies)

# With CDN
sb = Skybolt(
    "dist/.skybolt/render-map.json",
    cookies=request.cookies,
    cdn_url="https://cdn.example.com"
)

`css(entry: str) -> str`

Render CSS asset.

First visit: Inlines CSS with caching attributes
Repeat visit: Outputs <link> tag (Service Worker serves from cache)

sb.css("src/css/main.css")

`script(entry: str, module: bool = True) -> str`

Render JavaScript asset.

First visit: Inlines JS with caching attributes
Repeat visit: Outputs <script> tag (Service Worker serves from cache)

# ES module (default)
sb.script("src/js/app.js")

# Classic script
sb.script("src/js/legacy.js", module=False)

`launch_script() -> str`

Render the Skybolt client launcher. Call once in <head> before other assets.

<head>
    {{ sb.launch_script()|safe }}
</head>

`get_asset_url(entry: str) -> str | None`

Get the URL for an asset (for manual use cases).

url = sb.get_asset_url("src/css/main.css")
# "/assets/main-Pw3rT8vL.css"

`get_asset_hash(entry: str) -> str | None`

Get the content hash for an asset.

hash = sb.get_asset_hash("src/css/main.css")
# "Pw3rT8vL"

`preload(entry, as_type, mime_type=None, crossorigin=None, fetchpriority=None) -> str`

Render preload link for critical resources like fonts and images.

# Preload hero image with high priority
sb.preload("images/hero.jpg", as_type="image", fetchpriority="high")

# Preload font
sb.preload("fonts/inter.woff2", as_type="font", mime_type="font/woff2", crossorigin="anonymous")

# Preload a Vite-built asset (resolved from render-map)
sb.preload("src/css/main.css", as_type="style")

Parameters:

entry - Source file path or direct URL
as_type - Resource type ('image', 'font', 'style', 'script', 'fetch')
mime_type - MIME type (e.g., 'font/woff2', 'image/webp')
crossorigin - Crossorigin attribute ('anonymous', 'use-credentials')
fetchpriority - Fetch priority ('high', 'low', 'auto')

Service Worker Setup

The Service Worker must be served from your domain root. Configure your web server:

Nginx:

location = /skybolt-sw.js {
    alias /path/to/dist/skybolt-sw.js;
}

Apache (.htaccess):

RewriteRule ^skybolt-sw\.js$ dist/skybolt-sw.js [L]

Framework Integration

Django

# views.py
from skybolt import Skybolt

def index(request):
    sb = Skybolt("static/.skybolt/render-map.json", cookies=request.COOKIES)
    return render(request, "index.html", {"sb": sb})

<!-- templates/index.html -->
<!DOCTYPE html>
<html>
<head>
    {{ sb.css("src/css/critical.css")|safe }}
    {{ sb.launch_script()|safe }}
    {{ sb.css("src/css/app.css")|safe }}
</head>
<body>
    <!-- content -->
    {{ sb.script("src/js/app.js")|safe }}
</body>
</html>

Flask

from flask import Flask, render_template, request
from skybolt import Skybolt

app = Flask(__name__)

@app.route("/")
def index():
    sb = Skybolt("static/.skybolt/render-map.json", cookies=request.cookies)
    return render_template("index.html", sb=sb)

FastAPI

from fastapi import FastAPI, Request
from fastapi.responses import HTMLResponse
from fastapi.templating import Jinja2Templates
from skybolt import Skybolt

app = FastAPI()
templates = Jinja2Templates(directory="templates")

@app.get("/", response_class=HTMLResponse)
async def index(request: Request):
    sb = Skybolt("static/.skybolt/render-map.json", cookies=request.cookies)
    return templates.TemplateResponse("index.html", {"request": request, "sb": sb})

Requirements

Python 3.10+
Vite with @skybolt/vite-plugin

Publishing

This package is maintained in the Skybolt monorepo and automatically synced to skybolt-python.

To publish a new version, run one command from the packages/python directory:

./scripts/release.sh patch   # 3.1.0 → 3.1.1
./scripts/release.sh minor   # 3.1.0 → 3.2.0
./scripts/release.sh major   # 3.1.0 → 4.0.0

This automatically:

Bumps the version in VERSION, pyproject.toml, and source files
Commits and pushes to the monorepo
Sync workflow pushes changes to the split repo
tag-version.yml in the split repo creates the v* tag
publish.yml builds and publishes to PyPI using trusted publishing (OIDC)

License

MIT

Project details

These details have been verified by PyPI

Project links

GitHub Statistics

Maintainers

JensRoland

These details have not been verified by PyPI

Release history Release notifications | RSS feed

3.4.0

Dec 1, 2025

3.3.0

Nov 30, 2025

This version

3.2.0

Nov 27, 2025

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

skybolt-3.2.0.tar.gz (5.8 kB view details)

Uploaded Nov 27, 2025 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

skybolt-3.2.0-py3-none-any.whl (7.1 kB view details)

Uploaded Nov 27, 2025 Python 3

File details

Details for the file skybolt-3.2.0.tar.gz.

File metadata

Download URL: skybolt-3.2.0.tar.gz
Upload date: Nov 27, 2025
Size: 5.8 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for skybolt-3.2.0.tar.gz
Algorithm	Hash digest
SHA256	`3e8dbff10b92c7212de496e0ccc15c38305b704fc58ba099d118ce9aa85daed1`
MD5	`7cfd75176e2b4fd87c25a3b2a73a8d65`
BLAKE2b-256	`b37a971c001b636a09f8d509e253f96deeb99b14af59bc0659ae13770d43ff10`

See more details on using hashes here.

Provenance

The following attestation bundles were made for skybolt-3.2.0.tar.gz:

Publisher: tag-and-publish.yml on JensRoland/skybolt-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: skybolt-3.2.0.tar.gz
- Subject digest: 3e8dbff10b92c7212de496e0ccc15c38305b704fc58ba099d118ce9aa85daed1
- Sigstore transparency entry: 729604437
- Sigstore integration time: Nov 27, 2025
Source repository:
- Permalink: JensRoland/skybolt-python@d178446831f92b6bc30903df0d365f240c483a74
- Branch / Tag: refs/heads/main
- Owner: https://github.com/JensRoland
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: tag-and-publish.yml@d178446831f92b6bc30903df0d365f240c483a74
- Trigger Event: push

File details

Details for the file skybolt-3.2.0-py3-none-any.whl.

File metadata

Download URL: skybolt-3.2.0-py3-none-any.whl
Upload date: Nov 27, 2025
Size: 7.1 kB
Tags: Python 3
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for skybolt-3.2.0-py3-none-any.whl
Algorithm	Hash digest
SHA256	`d28d3406e3a3c4b76ffd1b7cc7456c4dcc92093c5df8d5154e93736f4379698d`
MD5	`3b26a17fc16513c0594325d9066eb501`
BLAKE2b-256	`df2103ff5665a917fa77e9fd4e4f0a77ab61e9dd8929571fbea70cc1af50dde0`

See more details on using hashes here.

Provenance

The following attestation bundles were made for skybolt-3.2.0-py3-none-any.whl:

Publisher: tag-and-publish.yml on JensRoland/skybolt-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: skybolt-3.2.0-py3-none-any.whl
- Subject digest: d28d3406e3a3c4b76ffd1b7cc7456c4dcc92093c5df8d5154e93736f4379698d
- Sigstore transparency entry: 729604439
- Sigstore integration time: Nov 27, 2025
Source repository:
- Permalink: JensRoland/skybolt-python@d178446831f92b6bc30903df0d365f240c483a74
- Branch / Tag: refs/heads/main
- Owner: https://github.com/JensRoland
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: tag-and-publish.yml@d178446831f92b6bc30903df0d365f240c483a74
- Trigger Event: push

skybolt 3.2.0

Navigation

Verified details

Project links

GitHub Statistics

Maintainers

Unverified details

Meta

Classifiers

Project description

Skybolt Python

Installation

Prerequisites

Usage

API

Skybolt(render_map_path, cookies=None, cdn_url=None)

css(entry: str) -> str

script(entry: str, module: bool = True) -> str

launch_script() -> str

get_asset_url(entry: str) -> str | None

get_asset_hash(entry: str) -> str | None

preload(entry, as_type, mime_type=None, crossorigin=None, fetchpriority=None) -> str

Service Worker Setup

Framework Integration

Django

Flask

FastAPI

Requirements

Publishing

License

Project details

Verified details

Project links

GitHub Statistics

Maintainers

Unverified details

Meta

Classifiers

Release history Release notifications | RSS feed

Download files

Source Distribution

Built Distribution

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

`Skybolt(render_map_path, cookies=None, cdn_url=None)`

`css(entry: str) -> str`

`script(entry: str, module: bool = True) -> str`

`launch_script() -> str`

`get_asset_url(entry: str) -> str | None`

`get_asset_hash(entry: str) -> str | None`

`preload(entry, as_type, mime_type=None, crossorigin=None, fetchpriority=None) -> str`