Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ The current Fullbleed release is [MIT licensed](https://github.com/fullbleed-eng

## What do I need to install?

Python 3.10–3.14 and a Fullbleed wheel for your platform. The core has no required third-party Python runtime dependencies. See [installation](getting-started/installation.md) for the published platform list.
Standard-GIL CPython 3.10–3.15 and a Fullbleed wheel for your platform. The core has no required third-party Python runtime dependencies. See [installation](getting-started/installation.md) for the published platform list and Python 3.15 qualification.

## Can I use my existing HTML and CSS?

Expand Down
34 changes: 21 additions & 13 deletions docs/getting-started/installation.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
---
title: Install Fullbleed for Python
description: Install Fullbleed on Python 3.10–3.14 for Windows, macOS, or Linux using a prebuilt wheel.
description: Install Fullbleed on Python 3.10–3.15 for Windows, macOS, or Linux using a prebuilt wheel.
---
# Install Fullbleed for Python

Fullbleed supports Python 3.10–3.14. Published wheels cover Windows, macOS, and Linux, including the architectures listed below.
Current stable Fullbleed supports standard-GIL CPython 3.10–3.15. Published wheels cover Windows, macOS, and Linux, including the architectures listed below.

```bash
python -m pip install fullbleed
Expand Down Expand Up @@ -45,19 +45,27 @@ python -m pip install fullbleed

The stable-ABI wheels cover supported CPython versions. For an unsupported target, a source build requires Rust; [source build instructions](https://github.com/fullbleed-engine/fullbleed-official#install) are in the engine repository.

## Python 3.15 preview
<span id="python-315-preview"></span>

The separate [Python Preview checks](https://github.com/fullbleed-engine/fullbleed-official/actions/runs/37720487567)
exercise CPython **3.15.0rc3**, with the standard GIL, on Windows x64 and Linux
x64. They install the same abi3 wheel tested on Python 3.10, run the installed
API and CLI checks, and compare generated PDFs and previews byte for byte.
The [coverage note](https://github.com/fullbleed-engine/fullbleed-official/blob/master/docs/python-compatibility.md)
explains the retained evidence and the explicit skip for an unavailable legacy
subinterpreter API.
## Python 3.15 final

Python 3.10–3.14 remains the supported stable range. These preview checks do not
establish compatibility with Python 3.15 final, free-threaded builds, or macOS
on this preview.
The public stable **Fullbleed 2.5.34** wheel is checked on **CPython 3.15.0 final**
on Windows x64, Linux x64, and Intel and Apple-silicon Macs. Use the ordinary
installation command above.

Each platform's job verifies the PyPI wheel and matching release source, runs
the complete Python suite and isolated API/CLI checks, and compares generated
PDFs and previews byte for byte with the same wheel on Python 3.10. The Linux
job also checks installation in the official `python:3.15-slim` container with
networking disabled.

The [coverage note and retained evidence](https://github.com/fullbleed-engine/fullbleed-official/blob/master/docs/python-compatibility.md)
describe the exact checks and the explicit skip for an unavailable legacy
subinterpreter API. This qualification covers standard-GIL builds; free-threaded
builds and subinterpreters remain outside its scope.

The [earlier rc3 checks](https://github.com/fullbleed-engine/fullbleed-official/actions/runs/37720487567)
remain available as historical evidence.

## Run in Docker

Expand Down
2 changes: 1 addition & 1 deletion docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -127,7 +127,7 @@ Pick your application stack. Generate a PDF locally or download one from the bro

=== "Python"

Use Python 3.10–3.14. The wheel includes the engine, CLI, and fonts.
Use standard-GIL CPython 3.10–3.15. The wheel includes the engine, CLI, and fonts.

```bash
python -m pip install fullbleed
Expand Down
Loading