feat(printing): filament label printing foundation by akira69 · Pull Request #846 · Donkie/Spoolman

akira69 · 2026-02-12T00:51:18Z

Summary

filament label printing foundation

Provides a means to print labels for Filaments, not just spools. This is useful for labeling test coupons/filament color swatches that are not spool connected.

Note, further, earlier additional functionality that used to be inside this PR is moved to other PRs to limit scope and simplify review.

Code Quality Compliance ✅

Per https://github.com/Donkie/Spoolman/wiki/Contribute#style

ESLint (frontend) ✓
Prettier (frontend) ✓
Ruff (backend) ✓
Pre-commit hooks validated ✓

Included

Filament label printing entry points from filament list/show
Dedicated filament printing page + selection modal
Filament QR-code printing dialog and filament-specific print preset plumbing (print_presets_filament)
Spool presets remain on print_presets in this PR
Shared print dialog wiring for filament printing
Filament selector performance fix for large datasets (server pagination in selector table)
Clarified print page headers to show context (filament vs spool)
Filament pre-print selection UX now mirrors the same general selection-step pattern used by the spool-side selection UX PR (feat(printing/ui): Spool Print selection page UX Improvement #869):
- backend-backed ?search= param across the full filament dataset (vendor name, name, material, article number, ID)
- viewport-fill table height
- visible pagination controls
- bulk selection tied to visible rows
Changelog entry for printing updates

Latest Fixes

The filament selector now uses a single debounced ?search= API call for full-dataset search, consistent with the spool selector pattern in feat(printing/ui): Spool Print selection page UX Improvement #869. Searching for a vendor or material is no longer limited to the currently visible page.
The filament API endpoint now exposes a unified search query parameter (matching the spool API), backed by the existing _build_search_filters() helper.
Filament QR print dialogs now handle older or manually edited base_url settings without crashing when that value was stored as a plain string.

Code Quality Improvements 🔧

Performance Optimizations Applied:

Added useCallback memoization to selectUnselectFiltered, handleSelectItem, handlePageChange, and handlePageSizeChange callbacks in filamentSelectModal.tsx
Prevents unnecessary re-renders of child components (Table pagination, checkboxes, buttons)
Stable function references now persist across renders, improving React.memo effectiveness for downstream components

Backend Refactoring:

Extracted search filter logic from filament.find() to dedicated _build_search_filters() helper function
Reduced cyclomatic complexity and improves code maintainability
Dedicated helper clarifies search term parsing logic (exact match vs fuzzy matching)
Added unified ?search= query parameter to the filament list API endpoint

React Immutability Fixes Applied:

Replaced prop mutations with spread copies in qrCodePrintingDialog.tsx (×5 sites), filamentQrCodePrintingDialog.tsx (×3 sites), spoolQrCodePrintingDialog.tsx (×3 sites)
Pattern: curPreset.field = value; updateCurrentPreset(curPreset) → updateCurrentPreset({ ...curPreset, field: value })
Nested-object sites use double-spread: { ...curPreset, subObj: { ...curPreset.subObj, key: value } }

Selection Performance Fix (spoolSelectModal):

Replaced O(n) selectedItems.includes(id) calls (once per row per render) with O(1) selectedSet.has(id) via useMemo(() => new Set(selectedItems), [selectedItems])

Scope Boundary

Feature requests addressed:
- Filament label printing foundation (parity with spool label printing flow)
- Filament print entry points from filament list/show pages
Feature request links:
- Tracking PR: feat(printing): filament label printing foundation #846
- Related label workflow context: Improve label layout #74
Deliberately excluded from this PR:
- Separate export flows/pages (filament/spool labels export UX): #869
- AML ZIP/template export follow-ups: #860
- General search/index/performance/table UX improvements: #861, #862
- Cross spool/filament preset sharing; preset storage remains intentionally separate in this PR
- Export flows (AML/PNG/ZIP), filename templates, and broader print/export selector UX (moved to follow-up PRs)

Database Impact

None (this PR does not introduce schema/index/data migrations).

Relationship / Merge Notes

This PR is the filament printing foundation base.
#860 is stacked on top of #846.
#857 is stacked on top of #860.
#872 is stacked on top of #857.
#869 remains intentionally independent and improves the spool-side pre-print selection UX.
#846 and #869 now use parallel selection-step UX patterns, both using a single debounced ?search= API call for full-dataset search.
Until both are merged, any shared selection UX changes must be mirrored/rebased deliberately between the two branches.
#869 does not replace this PR; it brings spool selection UX up to the same general level as the filament-side selection flow here.
#846 does not depend on #862.

Compatibility pre-patch (d65860a) for combined-branch merges:

onPrint made optional (was required) — allows feat(export): add separate AML/PNG label export flows and improvements #860 callers to conditionally render only an Export button
onExport? callback + conditional Export Labels button added — mirrors SpoolSelectModal pattern from feat(export): add separate AML/PNG label export flows and improvements #860
initialSelectedIds? added — enables URL-parameter pre-selection used by feat(export): add separate AML/PNG label export flows and improvements #860's routing
printing.qrcode.exportButton locale key added

Test Checklist

Verified locally on March 27, 2026 via Playwright against the PR app at http://localhost:9846.

akira69 · 2026-02-13T20:29:30Z

@Donkie , at all interested in implementing these features? do you have the time to consider it? Or did you find any other maintainers to consider it? Thanks for any feedback.

Donkie · 2026-02-13T21:14:30Z

Thanks for the contribution! I will take a look within a couple of days hopefully.

AIT-OLPE · 2026-02-14T11:22:15Z

This feature would be great as many has requested the filament QR code generation. +1 from me

From upstream Donkie/Spoolman PR Donkie#846

- Remove unused sqlalchemy imports from migrations - Move AsyncSession to TYPE_CHECKING block - Use removeprefix() instead of ternary - Rename loop variable to avoid overwrite warning - Fix extra blank lines in env.py

akira69 · 2026-03-02T16:43:30Z

OK! after much wrangling, is now cleanly separated from other PRs and implementing features in ways that work with other later PRs. Ready to go!

---> after some futher optimization/improvements (including better commented code) March 13, ready again for review and merge!

- Extract _build_search_filters() helper to reduce McCabe complexity - Reduces find() complexity from 13 → ~8 (under 10 limit) - Reduces branch count from 13 → acceptable levels - Resolves Ruff linting errors C901 + PLR0912 - Pure refactoring: behavior unchanged - Also fixes Prettier formatting on filamentSelectModal and qrCodePrintingDialog

- Wrap selectUnselectFiltered, handleSelectItem callbacks in useCallback - Wrap handlePageChange, handlePageSizeChange, applySearchFilter in useCallback - Reduces unnecessary re-renders of child components (pagination, checkboxes, buttons) - Stable function references now persist across renders

…ack PR773) - Fetch extra field definitions once at endpoint entry instead of per-request - Eliminates redundant database calls for extra field validation - Applies feedback from PR 773: 'get_extra_fields only needs to be run max at once per call' - Affected endpoints: create/update for filament, spool, and vendor resources - Reduces API layer complexity and improves performance

- Add ?search= query param to filament API endpoint (mirrors spool API) - Simplify filamentSelectModal from 4-field parallel fetch loop to single debounced ?search= call – consistent with spoolSelectModal pattern - Remove getAPIURL import, allSearchResults state, isSearching state, localSearchTerm, and multi-field fetch loop (~50 LOC removed)

- onPrint made optional (was required) - Added optional onExport callback + Export Labels button (conditional) - Added optional initialSelectedIds for URL-parameter pre-selection - Initialize selectedItems state from initialSelectedIds ?? [] - Added printing.qrcode.exportButton locale key

…n checks - qrCodePrintingDialog: 5 sites (nested printSettings + 4 scalar fields) - filamentQrCodePrintingDialog: 3 sites (labelSettings, name triple-spread, template) - spoolQrCodePrintingDialog: 3 sites (same pattern as filament dialog) - spoolSelectModal: add useMemo Set for O(1) isAllFilteredSelected checks

NPutting · 2026-03-27T15:14:32Z

@akira69 Is this just waiting on Donkie to approve?

akira69 · 2026-03-30T12:33:24Z

@akira69 Is this just waiting on Donkie to approve?

Pretty much, I've just recently did some more testing and tweaked accordingly, but confirmation/review/test from anyone else is appreciated

AIT-OLPE · 2026-03-30T12:56:11Z

Would you mind creating a release on your repo so we can test/use it until it gets merged into Spoolman?
I would love to try it out.

akira69 · 2026-03-30T15:56:13Z

Would you mind creating a release on your repo so we can test/use it until it gets merged into Spoolman? I would love to try it out.

@AIT-OLPE : done:
https://github.com/akira69/Spoolman_Labels/releases/tag/v0.9.0-filament-labels
--> though note I didn't test this specifically - hope it works, no reason it shouldn't
i'll try to make some releases for the other PRs too.

AIT-OLPE · 2026-03-31T09:06:16Z

Thanks, I built the docker image and started it which works, however I can't seem to find the button to print filament labels at all. Do I need to enable it somewhere? Ive tried both with my production database and a new test database same issue.

akira69 · 2026-03-31T10:12:39Z

Thanks, I built the docker image and started it which works, however I can't seem to find the button to print filament labels at all. Do I need to enable it somewhere? Ive tried both with my production database and a new test database same issue.

I must have made a mistake in what I selected to release.
@AIT-OLPE
and yep, confirmed
fixed in this new release. the commit count matches PR846 upstream and there is 0 diff. I did build the PR846. I don't have the time right now to directly build this release, but will try that when I get time.
https://github.com/akira69/Spoolman_Labels/releases/tag/v0.9.1-pr846-exact

jpapiez added a commit to OlyForge3D/Spoolman that referenced this pull request Feb 14, 2026

Merge PR Donkie#846: Add Filament Label Printing and AML Export

25652a3

From upstream Donkie/Spoolman PR Donkie#846

daften mentioned this pull request Feb 23, 2026

Add filtering and sorting for custom fields #773

Open

akira69 force-pushed the feat/filament-aml-printing branch from f2e6da9 to e1ab3be Compare February 24, 2026 04:42

akira69 changed the title ~~feat: filament labels + export/print flows + AML~~ feat(printing): filament label printing foundation Feb 24, 2026

akira69 marked this pull request as draft February 24, 2026 04:48

feat(printing): add filament label printing foundation

1861cbb

akira69 force-pushed the feat/filament-aml-printing branch from e1ab3be to 2c8a20f Compare February 24, 2026 05:17

docs: add changelog entry for printing updates

9e4cf60

akira69 force-pushed the feat/filament-aml-printing branch from 2c8a20f to 9e4cf60 Compare February 24, 2026 05:24

This was referenced Feb 24, 2026

feat(export): add separate AML/PNG label export flows and improvements #860

Open

feat(printing/ui): Spool Print selection page UX Improvement #869

Open

akira69 added 2 commits February 25, 2026 17:07

perf(printing): paginate filament selector and clarify print page titles

dcfc8e7

i18n(printing): use explicit filament/spool print page titles

b9432d0

akira69 marked this pull request as ready for review February 26, 2026 01:02

akira69 marked this pull request as draft February 26, 2026 16:47

akira69 marked this pull request as ready for review February 26, 2026 17:12

akira69 closed this Mar 2, 2026

akira69 reopened this Mar 2, 2026

akira69 marked this pull request as draft March 2, 2026 15:33

akira69 marked this pull request as ready for review March 3, 2026 03:55

This was referenced Mar 5, 2026

feat(printing): add template tag modifiers and syntax help #876

Open

Create Filament Swatch Card #420

Open

feat(vendors/logos): add GitHub logo-pack sync workflow (no bundled assets) #872

Open

akira69 force-pushed the feat/filament-aml-printing branch from 0e67ff2 to 750a946 Compare March 10, 2026 06:14

This was referenced Mar 11, 2026

Need export labels to SVG-file format and PDF (or HTML) #730

Closed

[Review Stack] #860 on #846 akira69/Spoolman_Labels#5

Open

[Review Stack] #857 on #860 akira69/Spoolman_Labels#6

Open

[Review Stack] #872 on #857 akira69/Spoolman_Labels#7

Open

akira69 marked this pull request as draft March 14, 2026 05:00

akira69 marked this pull request as ready for review March 14, 2026 18:06

akira69 force-pushed the feat/filament-aml-printing branch from 16ca9a4 to 8420604 Compare March 16, 2026 19:54

akira69 added 3 commits March 16, 2026 21:33

akira69 force-pushed the feat/filament-aml-printing branch from e2388ac to 85fd256 Compare March 17, 2026 13:15

akira69 added 2 commits March 17, 2026 17:01

fix(printing): harden legacy base_url parsing

4dd7808

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat(printing): filament label printing foundation#846

feat(printing): filament label printing foundation#846
akira69 wants to merge 11 commits intoDonkie:masterfrom
akira69:feat/filament-aml-printing

akira69 commented Feb 12, 2026 •

edited

Loading

Uh oh!

akira69 commented Feb 13, 2026

Uh oh!

Donkie commented Feb 13, 2026

Uh oh!

AIT-OLPE commented Feb 14, 2026

Uh oh!

akira69 commented Mar 2, 2026 •

edited

Loading

Uh oh!

NPutting commented Mar 27, 2026

Uh oh!

akira69 commented Mar 30, 2026

Uh oh!

AIT-OLPE commented Mar 30, 2026

Uh oh!

akira69 commented Mar 30, 2026 •

edited

Loading

Uh oh!

AIT-OLPE commented Mar 31, 2026

Uh oh!

akira69 commented Mar 31, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Uh oh!

Conversation

akira69 commented Feb 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Code Quality Compliance ✅

Included

Latest Fixes

Code Quality Improvements 🔧

Related

Scope Boundary

Database Impact

Relationship / Merge Notes

Test Checklist

Uh oh!

akira69 commented Feb 13, 2026

Uh oh!

Donkie commented Feb 13, 2026

Uh oh!

AIT-OLPE commented Feb 14, 2026

Uh oh!

akira69 commented Mar 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

NPutting commented Mar 27, 2026

Uh oh!

akira69 commented Mar 30, 2026

Uh oh!

AIT-OLPE commented Mar 30, 2026

Uh oh!

akira69 commented Mar 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

AIT-OLPE commented Mar 31, 2026

Uh oh!

akira69 commented Mar 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

akira69 commented Feb 12, 2026 •

edited

Loading

akira69 commented Mar 2, 2026 •

edited

Loading

akira69 commented Mar 30, 2026 •

edited

Loading

akira69 commented Mar 31, 2026 •

edited

Loading