Registry / devops / brother-ql

brother-ql

JSON →
library0.9.4pypypi✓ verified 84d ago

Python package to talk to Brother QL label printers. Current version 0.9.4, with irregular release cadence.

devops
pip install brother-ql
github ↗homepage ↗
INSTALL
IMPORT
SIG · BROTHER-QL
B
brother-ql
devopspythonv0.9.4
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

brother_ql
✓ import brother_ql
✗ import brother
wrong package name
brother_ql.conversion
✓ from brother_ql import conversion
✗ from brother_ql.conversion import *
function-level imports are safer
brother_ql.models
✓ from brother_ql.models import BrotherQL
✗ from brother_ql import BrotherQL
BrotherQL is in models submodule

Convert a text label to printer instructions (no printer needed).

import brother_ql from brother_ql.conversion import convert label = 'Hello World' instructions = convert(label=label, label_type='62', rotate=False, threshold=70) print(type(instructions))
Debug
Known issues
deprecatedIn version 0.9.0, the `label` argument in `convert()` became keyword-only. Passing label positionally will raise a TypeError.
fix
Use `convert(label='...', ...)` instead of `convert('...', ...)`.
affects: >=0.9.0
gotchaThe `label_type` parameter in `convert()` expects a string like '62' for 62mm tape. Some users mistakenly pass an integer or use wrong format.
fix
Always pass a string, e.g., label_type='62'.
affects: All
gotchaOn some Linux systems, USB access requires udev rules or running as root. Without proper permissions, you get 'usb.core.USBError: [Errno 13] Access denied'.
fix
Add a udev rule: `SUBSYSTEM=="usb", ATTRS{idVendor}=="04f9", ATTRS{idProduct}=="209b", MODE="0666"` (adjust idProduct for your model).
affects: All
Errors
Common errors & fixes
usb.core.USBError: [Errno 13] Access denied (insufficient permissions)
User does not have permission to access USB device.
fix
Install udev rule or run with sudo.
TypeError: convert() takes 0 positional arguments but 1 was given
In brother-ql >=0.9.0, the 'label' argument must be passed as a keyword.
fix
Change `convert('your text')` to `convert(label='your text')`.
Upgrade
Version history
0.9.4latest on PyPI · released Jan 13, 2019
Audit
Dependencies

No dependency data recorded yet.

Agent activity
8 hits · last 30 days
node
8
Resources
githubhttps://github.com/pklaus/brother_ql ↗
homepagehttps://github.com/pklaus/brother_ql ↗
brother-ql — pip install brother-ql · libregistry