8 Commits

Author SHA1 Message Date
n07070
a2d1779e2b Update worker to get differents printer types 2026-06-03 23:55:04 +02:00
n07070
f841cd5628 Add queue completion method, add Printer discovery and types 2026-06-03 23:54:15 +02:00
n07070
db7e030a1f Remove printer import, remove vendor&device configuration, update
print_queue
2026-06-03 23:53:02 +02:00
n07070
1218d3fbee Remove unused import, add get_queue_completed method 2026-06-03 23:52:23 +02:00
n07070
ef613b3c10 Remove print, add task Typing 2026-06-03 23:51:38 +02:00
n07070
e549cdc64b Remove vendor and device ID from configuration because it's not needed
anymore
2026-06-03 23:51:13 +02:00
n07070
9e4ec6c1a5 Add support for QR code task 2026-06-01 21:40:28 +02:00
n07070
9e77e0980b Change the Printer class to implement multiple printer types 2026-06-01 21:40:13 +02:00
24 changed files with 446 additions and 1034 deletions

View File

@@ -15,7 +15,6 @@ To make this project work, you will need :
- A Thermal Printer : - A Thermal Printer :
- I used *Adafruit's thermal printer* at first, but it broke down. You can get it [here](https://www.adafruit.com/product/597). - I used *Adafruit's thermal printer* at first, but it broke down. You can get it [here](https://www.adafruit.com/product/597).
- I then used an *EPSON TM-T2OIII*. It's expensive, but it's also high quality, and has better CUPS and specific library support. - I then used an *EPSON TM-T2OIII*. It's expensive, but it's also high quality, and has better CUPS and specific library support.
- Sometime after, a friend leant me a *Brother QL-650TD* to add support for this type of printer.
- A Raspberry Pi or any computer with USB or Serial. - A Raspberry Pi or any computer with USB or Serial.
- Some electric wires. - Some electric wires.
- Some knowledge of the command line, - Some knowledge of the command line,
@@ -38,15 +37,13 @@ You can also get some information from [here](https://learn.adafruit.com/mini-th
LittlePrynter itself does not require any other software than the ones installed with it, i.e the ones listed in the `pyproject.toml` file. LittlePrynter itself does not require any other software than the ones installed with it, i.e the ones listed in the `pyproject.toml` file.
The project supports EPSON label printers as well as Brother label printers, and you can try to adapt it for other printers. For example, using `adafruit-thermal`. The version for the EPSON TM-T20III uses a library called `python-escpos`, which doesn't need a CUPS driver or anything else. It's included in the Python dependencies.
For the EPSON TM-T20III, LittlePrynter uses a library called `python-escpos`, which doesn't need a CUPS driver or anything else. It's included in the Python dependencies. For the Brother-QL, we use the `brother-ql` library, which is also included. The project only supports the EPSON printer, but you can try to adapt it for other printers. For example, using `adafruit-thermal`, or `brother-ql`.
### Install & setup the project : ### Install & setup the project :
We use [Poetry](https://python-poetry.org/) to manage the Python environnement and packages. You will need to install it on your computer to install LittlePrynter. Theses commands will copy the software on your computer, go into the directory, then activate a virtual environnement and install all of the project's dependecies.
The following commands will copy the software on your computer, go into the directory, then activate a virtual environnement and install all of the project's dependecies.
``` ```
$ git clone https://git.n07070.xyz/n07070/LittlePrynter $ git clone https://git.n07070.xyz/n07070/LittlePrynter
@@ -72,8 +69,6 @@ $ flask run --cert=adhoc
The `--cert=adhoc` argument will make LittlePrinter accessible in HTTPS with a [self-signed SSL certificate](https://en.wikipedia.org/wiki/Self-signed_certificate). This provides a free and easy way to use HTTPS, but does not provide any trust value. It is, on the other hand, a good way to access the webcam in developpement mode or on a local network, because a HTTPS connexion is required by browsers to access the needed APIs. The `--cert=adhoc` argument will make LittlePrinter accessible in HTTPS with a [self-signed SSL certificate](https://en.wikipedia.org/wiki/Self-signed_certificate). This provides a free and easy way to use HTTPS, but does not provide any trust value. It is, on the other hand, a good way to access the webcam in developpement mode or on a local network, because a HTTPS connexion is required by browsers to access the needed APIs.
You can also use the `run.sh` for this.
This command should start a web server with which you can test your configuration. If you plan on exposing your printer to the Internet, and give it an IP / URL, _please, please, please_, don't run it this way. Look at Flask's documentation and read about running a production server. It's a little more work, but it will prevent your computer/server being hacked in too easily. This command should start a web server with which you can test your configuration. If you plan on exposing your printer to the Internet, and give it an IP / URL, _please, please, please_, don't run it this way. Look at Flask's documentation and read about running a production server. It's a little more work, but it will prevent your computer/server being hacked in too easily.
Voilà ! Voilà !
@@ -86,11 +81,11 @@ Please also say if you had a printer to test your code, and which printer you've
### Code structure ### Code structure
The app is written around the Flask framework. You can start by looking at the code in the `src/` folder, in the `main.py` file. There, you will see that a few classes are initialized. In general, they are two parts to the program : The app is written about the Flask framework. You can start by looking at the code in the `src/` folder, in the `main.py` file. There, you will see that a few classes are initialized. In general, they are two parts to the program :
The Web pages and the API, which are the user-facing parts. This is with what the users will interact, and define how the program is going to be used. The web pages are renderer from the `include/` folder where Jinj2 templates are defined. The Web pages and the API, which are the user-facing parts. This is with what the users will interact, and define how the program is going to be used. The web pages are renderer from the `include/` folder where Jinj2 templates are defined.
The Worker and Printer Queue are the internal parts. When a new thing needs to be printed, usually sent from the Web or API interfaces, a new Task of the type of the document is created, and added to a print queue. Then, a Worker thread looks up the state of the queue every so often and picks jobs to execute on the printers connected to the system. The Worker and Printer Queue are the internal parts. When a new thing needs to be printed, usually sent from the Web or API interfaces, a new Task in the type of the document is created, and added to a print queue. Then, a Worker thread looks up the state of the queue every so often and picks jobs to execute on the printers connected to the system.
The last part of the program is the Raspberry Pi class, that handles to Photomaton mode, which handles button presses, and LED indicator and a flash. The last part of the program is the Raspberry Pi class, that handles to Photomaton mode, which handles button presses, and LED indicator and a flash.
@@ -135,7 +130,7 @@ If you liked this project, feel free to support my work !
- [A link to buy one in Europe](https://rlx.sk/sk/various-boards/1829-mini-thermal-receipt-printer-adafruit-597.html) - [A link to buy one in Europe](https://rlx.sk/sk/various-boards/1829-mini-thermal-receipt-printer-adafruit-597.html)
- [Another link to buy one, direct from factory](https://www.cashinotech.com/csn-a2-58mm-mini-panel-thermal-receipt-printer_p11.html) - [Another link to buy one, direct from factory](https://www.cashinotech.com/csn-a2-58mm-mini-panel-thermal-receipt-printer_p11.html)
- [Diagnostickoeur](https://framagit.org/stickoeur/diagnostickoeur), another printer software mainly around Brother QL printers. - [Diagnostickoeur](https://framagit.org/stickoeur/diagnostickoeur), another printer software mainly around Brother QL printers.
- [FaxTheSystem](https://github.com/hackstub/faxthesystem/tree/main), another printer software, also around an Epson TM printer
## Licence ## Licence

View File

@@ -1,28 +1,11 @@
# Configuration file the LittlePrynter # Configuration file the LittlePrynter
[defaults] [defaults]
signature = "" signature = "Anonymous"
# Printer settings # Printer settings
[printer] [printer]
upload_folder = "src/static/uploads" upload_folder = "src/static/uploads"
# How long do we wait before giving up on waiting for a printer connexion
waiting_time = 5
[printer.epson]
# Configurations for EPSON printers
profile = "TM-T20III"
label_type = 80 # 80 or 58 ( label width in mm )
align_text = "center"
text_max_length = 4096
signature_max_length = 256
[printer.brother]
# Configurations for Brother printers
label_type = "62" # See https://github.com/pklaus/brother_ql#usage for label types
text_max_length = 4096
signature_max_length = 256
# Raspberry Pi Configuration # Raspberry Pi Configuration
[rpi] [rpi]

View File

@@ -5,25 +5,8 @@ signature = "Anonymous"
# Printer settings # Printer settings
[printer] [printer]
# Where do we upload the pictures and such vendor_id = "0x04b8"
upload_folder = "src/static/uploads" device_id = "0x0e28"
# How long do we wait before giving up on waiting for a printer connexion
waiting_time = 5
[printer.epson]
# Configurations for EPSON printers
profile = "TM-T20III"
label_type = 80 # 80 or 58 ( label width in mm )
align_text = "center"
text_max_length = 4096
signature_max_length = 256
[printer.brother]
# Configurations for Brother printers
label_type = 62 # See https://github.com/pklaus/brother_ql#usage for label types
text_max_length = 4096
signature_max_length = 256
# Raspberry Pi Configuration # Raspberry Pi Configuration
[rpi] [rpi]

65
poetry.lock generated
View File

@@ -651,18 +651,6 @@ enabler = ["pytest-enabler (>=3.4)"]
test = ["jaraco.test (>=5.4)", "pytest (>=6,!=8.1.*)", "zipp (>=3.17)"] test = ["jaraco.test (>=5.4)", "pytest (>=6,!=8.1.*)", "zipp (>=3.17)"]
type = ["pytest-mypy (>=1.0.1) ; platform_python_implementation != \"PyPy\""] type = ["pytest-mypy (>=1.0.1) ; platform_python_implementation != \"PyPy\""]
[[package]]
name = "iniconfig"
version = "2.3.1"
description = "brain-dead simple config-ini parsing"
optional = false
python-versions = ">=3.10"
groups = ["main"]
files = [
{file = "iniconfig-2.3.1-py3-none-any.whl", hash = "sha256:9121e2c1fdb355232495be3194c8dfe87ccc2d5dee45947b78e68f499790d7a7"},
{file = "iniconfig-2.3.1.tar.gz", hash = "sha256:67f4b9c50da0dedf52af349e7749a80a9057a5031199791b906c3bb3ae878960"},
]
[[package]] [[package]]
name = "isort" name = "isort"
version = "8.0.1" version = "8.0.1"
@@ -1149,18 +1137,6 @@ files = [
{file = "platformdirs-4.9.6.tar.gz", hash = "sha256:3bfa75b0ad0db84096ae777218481852c0ebc6c727b3168c1b9e0118e458cf0a"}, {file = "platformdirs-4.9.6.tar.gz", hash = "sha256:3bfa75b0ad0db84096ae777218481852c0ebc6c727b3168c1b9e0118e458cf0a"},
] ]
[[package]]
name = "pluggy"
version = "1.7.0"
description = "plugin and hook calling mechanisms for python"
optional = false
python-versions = ">=3.10"
groups = ["main"]
files = [
{file = "pluggy-1.7.0-py3-none-any.whl", hash = "sha256:7dd7b0d8832ba3cb632c306926ded123429211b83641b35dc5c41ad2d34f9bec"},
{file = "pluggy-1.7.0.tar.gz", hash = "sha256:d1eaa46ebb595891b860ab086b4d09c8588af65ebd4361b8e8f4bb8920b90ba8"},
]
[[package]] [[package]]
name = "pycparser" name = "pycparser"
version = "3.0" version = "3.0"
@@ -1225,21 +1201,6 @@ files = [
{file = "pycryptodomex-3.23.0.tar.gz", hash = "sha256:71909758f010c82bc99b0abf4ea12012c98962fbf0583c2164f8b84533c2e4da"}, {file = "pycryptodomex-3.23.0.tar.gz", hash = "sha256:71909758f010c82bc99b0abf4ea12012c98962fbf0583c2164f8b84533c2e4da"},
] ]
[[package]]
name = "pygments"
version = "2.21.0"
description = "Pygments is a syntax highlighting package written in Python."
optional = false
python-versions = ">=3.9"
groups = ["main"]
files = [
{file = "pygments-2.21.0-py3-none-any.whl", hash = "sha256:2363c69b61c4a97c838da3b130dcd6468f4848992b21a82f2a63ec34377137d9"},
{file = "pygments-2.21.0.tar.gz", hash = "sha256:610ca751c9bc2492b38eb9a38a7fbc93edbbb2d7182edaf34e66ae493dee5c8c"},
]
[package.extras]
windows-terminal = ["colorama (>=0.4.6)"]
[[package]] [[package]]
name = "pylint" name = "pylint"
version = "4.0.5" version = "4.0.5"
@@ -1292,28 +1253,6 @@ files = [
[package.extras] [package.extras]
cp2110 = ["hidapi"] cp2110 = ["hidapi"]
[[package]]
name = "pytest"
version = "9.2.0"
description = "pytest: simple powerful testing with Python"
optional = false
python-versions = ">=3.10"
groups = ["main"]
files = [
{file = "pytest-9.2.0-py3-none-any.whl", hash = "sha256:07acdcf88ec174f907dc01af70bf52d49b014bbab03faeeade31c96b18c2e588"},
{file = "pytest-9.2.0.tar.gz", hash = "sha256:97c4f3b1f3c7414aa36465e09b8220f1d03627993bd51b1282e193753c80557b"},
]
[package.dependencies]
colorama = {version = ">=0.4", markers = "sys_platform == \"win32\""}
iniconfig = ">=2"
packaging = ">=24"
pluggy = ">=1.6,<2"
pygments = ">=2.15"
[package.extras]
dev = ["argcomplete", "asynctest ; python_version < \"3.11\"", "attrs (>=23.1)", "coverage (>=7.5)", "hypothesis (>=6.75)", "mock", "numpy (>=1.26)", "pexpect (>=4.9)", "pytest-xdist (>=3.5)", "pyyaml", "requests", "setuptools", "xmlschema"]
[[package]] [[package]]
name = "python-barcode" name = "python-barcode"
version = "0.16.1" version = "0.16.1"
@@ -1943,5 +1882,5 @@ h11 = ">=0.16.0,<1"
[metadata] [metadata]
lock-version = "2.1" lock-version = "2.1"
python-versions = ">=3.13" python-versions = ">=3.14"
content-hash = "7f8ddfbcbf88df2634e01dd4daf62ad54d1b97c279e3c4b478822fb5d4485647" content-hash = "18e1a5c8b085aa639b665279856f9e3c51a734a6a8d1d4dd135ca7e4f67e86ae"

View File

@@ -43,7 +43,6 @@ dependencies = [
"pep8 (>=1.7.1,<2.0.0)", "pep8 (>=1.7.1,<2.0.0)",
"pylint (>=4.0.5,<5.0.0)", "pylint (>=4.0.5,<5.0.0)",
"brother-ql-inventree (>=1.3,<2.0)", "brother-ql-inventree (>=1.3,<2.0)",
"pytest (>=9.2.0,<10.0.0)",
] ]
[tool.poetry] [tool.poetry]

2
run.sh
View File

@@ -1,2 +0,0 @@
eval $(poetry env activate)
export FLASK_DEBUG=True; export FLASK_APP=src/main.py && flask run --cert=adhoc --debug --no-debugger --host 0.0.0.0 --without-threads

View File

@@ -1,8 +1,7 @@
""" """
Welcome to the LittlePrynter's source code. Welcome to the LittlePrynter's source code.
This program expose a web interface, This program expose a web interface, with user authentification,
that makes it possible to print messages from the web. that makes it possible to print messages from the web.
It also exposes a API, making it possible to print and interface It also exposes a API, making it possible to print and interface
with much of the printer's abilities. with much of the printer's abilities.
@@ -11,14 +10,12 @@ Then we build the API around Flask,
Then we build the web interface, using the simple Jinja2 templating. Then we build the web interface, using the simple Jinja2 templating.
We support two modes : We support two modes :
The first is a simple mode, where a computer, connected to a thermal printer, The first is a simple mode, where a computer, connected to a thermal printer,
runs this program and exposes a web interface that makes use of the client's camera runs this program and exposes a web interface that makes use of the client's camera
The seconde is booth mode, where a Raspberry Pi is connected to a thermal printer,
The seconde is booth mode, where a Raspberry Pi is connected to a button and a flash.
a thermal printer, a button and a flash. The web interface exists but may not be used, as the press of the button with take
The web interface exists but it's not needed, as the press of the button a picture and activate the flash while simply informing the web page.
takes a picture and activates the flash while simply informing the web page.
""" """
# Following are the librairies we import, # Following are the librairies we import,
@@ -43,7 +40,6 @@ from raspberry import Raspberry # The Raspberry pi control Class
from web import Web # Wrapper for the web routes and API from web import Web # Wrapper for the web routes and API
from print_queue import PrintQueue from print_queue import PrintQueue
from worker import PrintWorker from worker import PrintWorker
from printers import Printers
# We create the main Flask object # We create the main Flask object
app = Flask(__name__) app = Flask(__name__)
@@ -87,39 +83,39 @@ except PermissionError:
sys.exit(77) sys.exit(77)
# Output the config file # Output the config file
if not os.getenv("FLASK_DEBUG") is None and os.getenv("FLASK_DEBUG") is True: if os.getenv("FLASK_DEBUG"):
pprint.pprint(configuration_file) pprint.pprint(configuration_file)
# We define the app module used by Flask # We define the app module used by Flask
app.secret_key = configuration_file["secrets"]["flask_secret_key"] app.secret_key = configuration_file["secrets"]["flask_secret_key"]
app.config["UPLOAD_FOLDER"] = UPLOAD_FOLDER app.config["UPLOAD_FOLDER"] = UPLOAD_FOLDER
app.config["ALLOWED_EXTENSIONS"] = ALLOWED_EXTENSIONS app.config["ALLOWED_EXTENSIONS"] = ALLOWED_EXTENSIONS
app.config["MAX_CONTENT_LENGTH"] = 10 * 1000 * 1000 # Maximum 10Mb for a file upload app.config["MAX_CONTENT_LENGTH"] = 10 * 1000 * 1000 # Maximum 3Mb for a file upload
app.config["TEMPLATES_AUTO_RELOAD"] = True app.config["TEMPLATES_AUTO_RELOAD"] = True
# Queue creation # Queue creation
print_queue = PrintQueue(app) print_queue = PrintQueue(app)
# Find out if we are running on a Raspberry Pi # Find out if we are running on a Raspberry Pi
rpi = Raspberry(print_queue, app, configuration_file) rpi = Raspberry(
print_queue,
app,
socketio,
configuration_file["rpi"]["button_gpio_port_number"],
configuration_file["rpi"]["indicator_gpio_port_number"],
configuration_file["rpi"]["flash_gpio_port_number"],
configuration_file["rpi"]["flash"],
)
RASPBERRY_PI_CONNECTED = rpi.is_raspberry_pi() RASPBERRY_PI_CONNECTED = rpi.is_raspberry_pi()
# Web & API management # Web & API management
web = Web(app, print_queue) web = Web(app, print_queue)
# Create a pool of printers
try:
# comment: Find all printers connected to the system
printers_pool = Printers(app, configuration_file)
except Exception as e:
app.logger.error("Could not create a pool of printers because %s", str(e))
sys.exit(-1)
# end try
# Start worker thread # Start worker thread
# When created, the worker will try to find printers connected to the system
try: try:
worker = PrintWorker(app, print_queue, printers_pool=printers_pool) worker = PrintWorker(app, print_queue, socketio)
worker.start() worker.start()
except Exception as e: except Exception as e:
app.logger.error("Could not start the worker because %s ", str(e)) app.logger.error("Could not start the worker because %s ", str(e))
@@ -130,10 +126,6 @@ limiter = Limiter(
get_remote_address, app=app, default_limits=["1500 per day", "500 per hour"] get_remote_address, app=app, default_limits=["1500 per day", "500 per hour"]
) )
app.logger.info("🖶 Welcome to LittlePrynter !")
# General routes # General routes
@app.route("/") @app.route("/")
@limiter.limit("1/second", override_defaults=False) @limiter.limit("1/second", override_defaults=False)
@@ -173,19 +165,9 @@ def web_print_sms():
"No signature found for this print, using default signature : %s ", str(e) "No signature found for this print, using default signature : %s ", str(e)
) )
sign = configuration_file["defaults"]["signature"] sign = configuration_file["defaults"]["signature"]
try:
do_cut = bool(request.form["cut"])
except werkzeug.exceptions.BadRequestKeyError:
do_cut = False
try: try:
# Clamp value between 1 and web.print_sms(txt, sign)
many = max(1, min(int(request.form["many"]), 20))
except werkzeug.exceptions.BadRequestKeyError:
many = 1
try:
web.print_sms(txt, sign, do_cut, many)
except RuntimeError as e: except RuntimeError as e:
app.logger.error("Whoops, we could not print an SMS because : %s ", str(e)) app.logger.error("Whoops, we could not print an SMS because : %s ", str(e))
flash("Whoops, we could not print an SMS because :" + str(e), "error") flash("Whoops, we could not print an SMS because :" + str(e), "error")
@@ -210,9 +192,6 @@ def web_print_img():
"No signature found for this print, using default signature : %s", str(e) "No signature found for this print, using default signature : %s", str(e)
) )
sign = configuration_file["defaults"]["signature"] sign = configuration_file["defaults"]["signature"]
except werkzeug.exceptions.RequestEntityTooLarge as e:
flash("Whoops, image is too big: " + str(e), "error")
return redirect(url_for("index"))
# check if the post request has the file part # check if the post request has the file part
if "img" not in request.files: if "img" not in request.files:
@@ -229,25 +208,9 @@ def web_print_img():
flash("Submitted file has no filename !", "error") flash("Submitted file has no filename !", "error")
return redirect(url_for("index")) return redirect(url_for("index"))
try:
do_cut = bool(request.form["cut"])
except werkzeug.exceptions.BadRequestKeyError:
do_cut = False
try:
process_image = bool(request.form["process"])
except werkzeug.exceptions.BadRequestKeyError:
process_image = False
try:
# Clamp value between 1 and
many = max(1, min(int(request.form["many"]), 20))
except werkzeug.exceptions.BadRequestKeyError:
many = 1
try: try:
app.logger.debug("Sending the image to the printer.") app.logger.debug("Sending the image to the printer.")
web.print_image(file, sign, do_cut, process_image, many) web.print_image(file, sign)
except RuntimeError as e: except RuntimeError as e:
app.logger.error("The image could not be printed because : %s ", str(e)) app.logger.error("The image could not be printed because : %s ", str(e))
flash("The image could not be printed because : " + str(e), "error") flash("The image could not be printed because : " + str(e), "error")
@@ -292,21 +255,9 @@ def api_print_sms():
"No signature found for this print, using default signature. : %s", str(e) "No signature found for this print, using default signature. : %s", str(e)
) )
sign = configuration_file["defaults"]["signature"] sign = configuration_file["defaults"]["signature"]
try:
do_cut = bool(request.form["cut"])
except werkzeug.exceptions.BadRequestKeyError:
do_cut = False
try:
# Clamp value between 1 and
many = max(1, min(int(request.form["many"]), 20))
except werkzeug.exceptions.BadRequestKeyError:
many = 1
try: try:
# comment: We try to print the SMS # comment: We try to print the SMS
web.print_sms(txt, sign, do_cut, many) web.print_sms(txt, sign)
except RuntimeError as e: except RuntimeError as e:
return str(e), 500 return str(e), 500
# end try # end try
@@ -339,25 +290,9 @@ def api_print_image():
app.logger.error("Submitted file has no filename !") app.logger.error("Submitted file has no filename !")
return "Submitted file has no filename !", 400 return "Submitted file has no filename !", 400
try:
do_cut = bool(request.form["cut"])
except werkzeug.exceptions.BadRequestKeyError:
do_cut = False
try:
process_image = bool(request.form["process"])
except werkzeug.exceptions.BadRequestKeyError:
process_image = False
try:
# Clamp value between 1 and
many = max(1, min(int(request.form["many"]), 20))
except werkzeug.exceptions.BadRequestKeyError:
many = 1
try: try:
app.logger.debug("Sending the image to the printer.") app.logger.debug("Sending the image to the printer.")
web.print_image(file, sign, do_cut, process_image, many) web.print_image(file, sign)
except RuntimeError as e: except RuntimeError as e:
return str(e), 500 return str(e), 500
@@ -366,7 +301,6 @@ def api_print_image():
# TODO: This might not depend on the Raspberry Pi # TODO: This might not depend on the Raspberry Pi
@app.route("/api/camera/picture", methods=["GET"]) @app.route("/api/camera/picture", methods=["GET"])
@limiter.limit("6/minute", override_defaults=False)
def camera_picture(): def camera_picture():
"""Returns a picture taken by the camera on a raspberry pi""" """Returns a picture taken by the camera on a raspberry pi"""
if RASPBERRY_PI_CONNECTED: if RASPBERRY_PI_CONNECTED:
@@ -379,28 +313,22 @@ def camera_picture():
@app.route("/api/queue", methods=["GET"]) @app.route("/api/queue", methods=["GET"])
@limiter.limit("6/minute", override_defaults=False)
def api_queue_status(): def api_queue_status():
"""API endpoint for entire queue""" """API endpoint for entire queue"""
return jsonify(web.get_queue_state()) return jsonify(web.get_queue_state())
@app.route("/api/queue/completed", methods=["GET"]) @app.route("/api/queue/completed", methods=["GET"])
@limiter.limit("6/minute", override_defaults=False)
def api_queue_completed(): def api_queue_completed():
"""API endpoint that returns the finished tasks""" """API endpoint that returns the finished tasks"""
return jsonify(web.get_queue_completed()) return jsonify(web.get_queue_completed())
@app.route("/api/worker", methods=["GET"]) @app.route("/api/worker", methods=["GET"])
@limiter.limit("6/minute", override_defaults=False)
def api_worker_state(): def api_worker_state():
"""API endpoint to get the worker state""" """API endpoint to get the worker state"""
return jsonify(worker.current_state()) return jsonify(worker.current_state())
@app.route("/api/worker/start") @app.route("/api/worker/start")
@limiter.limit("6/minute", override_defaults=False)
def api_worker_start(): def api_worker_start():
""" """
Enable to worker. This starts to process the print queue. Enable to worker. This starts to process the print queue.
@@ -410,7 +338,6 @@ def api_worker_start():
@app.route("/api/worker/stop") @app.route("/api/worker/stop")
@limiter.limit("6/minute", override_defaults=False)
def api_worker_stop(): def api_worker_stop():
""" """
Stops the print queue. This stops the processing of the print queue. Stops the print queue. This stops the processing of the print queue.
@@ -419,13 +346,6 @@ def api_worker_stop():
return jsonify(worker.current_state()) return jsonify(worker.current_state())
@app.route("/api/printers")
@limiter.limit("6/minute", override_defaults=False)
def api_printers_info():
"""Returns the current state of every printers"""
return jsonify(printers_pool.printers_info())
## Authentification ## Authentification
@@ -483,4 +403,4 @@ def camera_status():
if __name__ == "__main__": if __name__ == "__main__":
app.run(use_reloader=False, host="0.0.0.0", ssl_context="adhoc") app.run(debug=True, use_reloader=False, host="0.0.0.0", ssl_context="adhoc")

View File

@@ -76,15 +76,7 @@ class PrintQueue:
"""Return current queue state""" """Return current queue state"""
with self._lock: with self._lock:
self.app.logger.debug("Return current queue state") self.app.logger.debug("Return current queue state")
return [ return [{"task_id": t.task_id, "status": t.status, "type": str(t.task_type) } for t in self._queue]
{
"task_id": t.task_id,
"status": t.status,
"type": str(t.task_type),
"content": str(t.get_print_data()),
}
for t in self._queue
]
def get_queue_completed(self): def get_queue_completed(self):
"""Return completed queue elements""" """Return completed queue elements"""

View File

@@ -1,47 +1,39 @@
""" """
This class manages connexion to a Printer This class manages connexion to a Printer
""" """
from time import sleep
import os.path import os.path
import os
from abc import ABC, abstractmethod from abc import ABC, abstractmethod
from dataclasses import dataclass from dataclasses import dataclass
import time
from enum import Enum from enum import Enum
import uuid import uuid
import threading
from pathlib import Path
from uuid import uuid4
import usb.core import usb.core
from PIL import Image, ImageEnhance, ImageDraw, ImageFont import threading
from PIL import Image, ImageEnhance
import numpy as np import numpy as np
# Importing the modules needed for each supported printer Type # Importing the modules needed for each supported printer Type
import escpos.printer import escpos.printer
from brother_ql.models import ModelsManager from brother_ql.models import ModelsManager
from brother_ql.backends import backend_factory, guess_backend from brother_ql.backends import backend_factory
from brother_ql import labels
from brother_ql.raster import BrotherQLRaster from brother_ql.raster import BrotherQLRaster
from brother_ql.conversion import convert from brother_ql.conversion import convert
from brother_ql.backends.helpers import send from brother_ql.backends.helpers import send
from brother_ql import create_label
class PrinterType(Enum): class PrinterType(Enum):
""" """
What are the capacities of a Printer ? What are the capacities of a Printer ?
""" """
EPSON = "epson" EPSON = "epson"
BROTHER = "brother" BROTHER = "brother"
# For Brother-QL Printers # For Brother-QL Printers
@dataclass @dataclass
class PrinterInfo: class PrinterInfo:
"""
Brother-QL printer information
"""
identifier: str identifier: str
backend: str backend: str
protocol: str protocol: str
@@ -62,7 +54,6 @@ class PrinterInfo:
def __setitem__(self, key, value): def __setitem__(self, key, value):
setattr(self, key, value) setattr(self, key, value)
class Printer(ABC): class Printer(ABC):
""" """
If it outputs printed paper and speaks like a printer, then it must be a printer. If it outputs printed paper and speaks like a printer, then it must be a printer.
@@ -79,7 +70,6 @@ class Printer(ABC):
self.ready = False self.ready = False
self.printer_type = printer_type self.printer_type = printer_type
self._lock = threading.Lock() self._lock = threading.Lock()
self.used = False
@abstractmethod @abstractmethod
def _has_paper(self) -> bool: def _has_paper(self) -> bool:
@@ -93,21 +83,13 @@ class Printer(ABC):
def print_task(self, task_type, data)-> None: def print_task(self, task_type, data)-> None:
"""Takes a PrintTask and executes it""" """Takes a PrintTask and executes it"""
def use_printer(self) -> None:
"""Marks the printer as being used"""
self.used = True
def free_printer(self) -> None:
"""Marks the printer as being not used, it's available."""
self.used = False
class EscPosPrinter(Printer): class EscPosPrinter(Printer):
""" """
Create a new ESC/POS based printer. Create a new ESC/POS based printer.
""" """
def __init__(self, app, vendor_id, device_id, configuration_file): def __init__(self, app, vendor_id, device_id):
""" """
Create a connexion to a ESC/POS Printer via USB, Create a connexion to a ESC/POS Printer via USB,
Making sure the printer is alive, Making sure the printer is alive,
@@ -119,23 +101,20 @@ class EscPosPrinter(Printer):
self.usb_args = {} self.usb_args = {}
self.usb_args["idVendor"] = self.vendor_id self.usb_args["idVendor"] = self.vendor_id
self.usb_args["idProduct"] = self.device_id self.usb_args["idProduct"] = self.device_id
self.configuration_file = configuration_file
try: try:
# This also calls open(), which we need to close() # This also calls open(), which we need to close()
# or else the device will appear as busy. # or else the device will appear as busy.
p = escpos.printer.Usb( p = escpos.printer.Usb(
self.vendor_id, self.device_id, 0, profile=configuration_file["profile"] self.vendor_id, self.device_id, 0, profile="TM-P80"
) )
except escpos.exceptions.DeviceNotFoundError as e: except escpos.exceptions.DeviceNotFoundError as e:
self.app.logger.error( self.app.logger.error(
"The USB device is not plugged in : %s", "The USB device is not plugged in : %s",
str(e), str(e),
) )
raise e
except Exception as e: except Exception as e:
self.app.logger.error("Printer could not be connected : %s ", str(e)) self.app.logger.error("Printer could not be connected : %s ", str(e))
raise e
try: try:
if p.is_online(): if p.is_online():
@@ -143,21 +122,9 @@ class EscPosPrinter(Printer):
except Exception as e: except Exception as e:
raise e raise e
self.printer_info = PrinterInfo(
identifier=configuration_file["profile"],
backend="pyusb",
model=configuration_file["profile"],
protocol="ESC/POS",
vendor_id=self.vendor_id,
product_id=self.device_id,
serial_number="",
label_type=self.configuration_file["label_type"],
)
# Setting up the printing options. # Setting up the printing options.
# TODO : Expose this to the web interface
p.set( p.set(
align=self.configuration_file["align_text"], align="center",
font="a", font="a",
bold=False, bold=False,
underline=0, underline=0,
@@ -205,6 +172,7 @@ class EscPosPrinter(Printer):
return True return True
def _print_txt(self, msg, signature="", bold=False): def _print_txt(self, msg, signature="", bold=False):
if not isinstance(msg, str): if not isinstance(msg, str):
self.app.logger.error( self.app.logger.error(
"It is not possible to print a " + str(type(msg)) + ", only strings." "It is not possible to print a " + str(type(msg)) + ", only strings."
@@ -216,25 +184,24 @@ class EscPosPrinter(Printer):
clean_signature = str(signature) clean_signature = str(signature)
# Make checks on the size of the message being printed # Make checks on the size of the message being printed
if len(clean_msg) > int(self.configuration_file["text_max_length"]): if len(clean_msg) > 4096:
self.app.logger.warning( self.app.logger.warning(
"Could not print message of this length: " + str(len(clean_msg)) "Could not print message of this length: " + str(len(clean_msg))
) )
raise RuntimeError( raise RuntimeError(
"Could not print message of this length :" "Could not print message of this length :"
+ str(len(clean_msg)) + str(len(clean_msg))
+ ", needs to be below %s caracters long.", + ", needs to be below 4096 caracters long."
str(self.configuration_file["text_max_length"]),
) )
if len(signature) > int(self.configuration_file["signature_max_length"]):
if len(signature) > 256:
self.app.logger.warning( self.app.logger.warning(
"Could not print signature of this length: " + str(len(clean_signature)) "Could not print signature of this length: " + str(len(clean_signature))
) )
raise RuntimeError( raise RuntimeError(
"Could not print signature of this length :" "Could not print signature of this length :"
+ str(len(clean_signature)) + str(len(clean_signature))
+ ", needs to be below %s caracters long.", + ", needs to be below 256 caracters long."
str(self.configuration_file["signature_max_length"]),
) )
# Do the actual printing # Do the actual printing
@@ -245,7 +212,6 @@ class EscPosPrinter(Printer):
self.printer.textln(clean_msg) self.printer.textln(clean_msg)
if clean_signature: if clean_signature:
self.printer.textln(clean_signature) self.printer.textln(clean_signature)
self.printer.textln()
self.printer.close() self.printer.close()
except Exception as e: except Exception as e:
self.app.logger.error("Unable to print because : " + str(e)) self.app.logger.error("Unable to print because : " + str(e))
@@ -254,20 +220,19 @@ class EscPosPrinter(Printer):
) from e ) from e
self.app.logger.info("Printed text") self.app.logger.info("Printed text")
self.ready = True return True
def _print_img(self, path, signature="", center=True, process=False): def _print_img(self, path, signature="", center=True, process=False):
clean_signature = str(signature) clean_signature = str(signature)
if len(signature) > int(self.configuration_file["signature_max_length"]): if len(signature) > 256:
self.app.logger.warning( self.app.logger.warning(
"Could not print signature of this length: " + str(len(clean_signature)) "Could not print signature of this length: " + str(len(clean_signature))
) )
raise RuntimeError( raise ValueError(
"Could not print signature of this length :" "Could not print signature of this length :"
+ str(len(clean_signature)) + str(len(clean_signature))
+ ", needs to be below %s caracters long.", + ", needs to be below 256 caracters long."
str(self.configuration_file["signature_max_length"]),
) )
if not os.path.isfile(str(path)): if not os.path.isfile(str(path)):
@@ -283,42 +248,42 @@ class EscPosPrinter(Printer):
if process: if process:
try: try:
self.app.logger.debug("Proccessing the image") self.app.logger.debug("Proccessing the image")
processed_path = _process_image(self, path) path = _process_image(self, path)
except RuntimeError as e: except RuntimeError as e:
self.app.logger.error( self.app.logger.error(
"Error while processing the image, aborting print : %s", str(e) "Error while processing the image, aborting print : %s", str(e)
) )
raise e raise e
else: else:
processed_path = path
self.app.logger.warning("Not proccessing the image") self.app.logger.warning("Not proccessing the image")
try: try:
self.printer.open(self.usb_args) self.printer.open(self.usb_args)
self.printer.image(processed_path, center=center) self.printer.image(path, center=center)
self.printer.textln(signature) self.printer.textln(signature)
self.printer.close() self.printer.close()
self.app.logger.debug("Printed an image : " + str(processed_path)) self.app.logger.debug("Printed an image : " + str(path))
except Exception as e: except Exception as e:
self.app.logger.error(str(e)) self.app.logger.error(str(e))
raise RuntimeError("Could not print the picture") from e raise RuntimeError("Could not print the picture") from e
# finally: finally:
# try: try:
# os.remove(path) os.remove(path)
# os.remove(processed_path) except OSError as e:
# self.app.logger.debug("Removed image : " + str(processed_path)) raise e
# self.app.logger.debug("Removed image : " + str(path))
# except OSError as e: self.app.logger.debug("Removed image : " + str(path))
# raise e
try: try:
self.printer.close() self.printer.close()
except Exception as e: except Exception as e:
self.app.logger.error("Could not close the printer connexion %s", str(e)) self.app.logger.error(
"Could not close the printer connexion %s", str(e)
)
raise RuntimeError("Could not close the printer connexion. ") from e raise RuntimeError("Could not close the printer connexion. ") from e
self.app.logger.info("Printed a picture") self.app.logger.info("Printed a picture")
self.ready = True return True
def _qr(self, content): def _qr(self, content):
try: try:
@@ -332,7 +297,6 @@ class EscPosPrinter(Printer):
raise e raise e
self.app.logger.info("Printed a QR") self.app.logger.info("Printed a QR")
self.ready = True
def _cut(self): def _cut(self):
try: try:
@@ -345,79 +309,52 @@ class EscPosPrinter(Printer):
raise e raise e
self.app.logger.info("Did a cut") self.app.logger.info("Did a cut")
self.ready = True return True
def _state(self) -> bool: def _state(self):
has_paper = self._has_paper() return self.printer.is_online() and self.ready and self._has_paper()
is_ready = self.ready
self.app.logger.debug("Has paper : %s ", has_paper)
self.app.logger.debug("Ready : %s ", is_ready)
return is_ready and has_paper # and is_online
def print_task(self, task_type, data): def print_task(self, task_type, data):
"""Execute actual print based on task type""" """Execute actual print based on task type"""
with self._lock: with self._lock:
self.app.logger.debug("Acquired lock to start print") if self._state:
self._state = False
i_m_ready = self._state()
while not i_m_ready:
self.app.logger.debug(
"Waiting for the printer to become ready, current state %s ",
str(i_m_ready),
)
i_m_ready = self._state()
time.sleep(0.3)
self.app.logger.debug("Checked state to start printing : %s", self._state())
self.ready = False
try:
self.app.logger.debug("Checking task type")
match (task_type.value): match (task_type.value):
case "text": case "text":
self._print_txt(data["txt"], signature=data["sign"]) self._print_txt(data["txt"], signature=data["sign"])
self.ready = True self._state = True
case "image": case "image":
self._print_img( self._print_img(
data["img"], signature=data["sign"], process=data["process"] data["img"], signature=data["sign"], process=data["process"]
) )
self.ready = True self._state = True
case "cut": case "cut":
self._cut() self._cut()
self.ready = True self._state = True
case "qr": case "qr":
self._qr(data["txt"]) self._qr(data["txt"])
self.ready = True self._state = True
case _: case _:
raise RuntimeError("This task type is not supported") raise RuntimeError("This task type is not supported")
except Exception as e: else:
self.app.logger.debug("Exception occured while printing %s", str(e)) raise RuntimeError("The printer is not ready to print yet !")
self.ready = True
raise RuntimeError from e
class BrotherPrinter(Printer): class BrotherPrinter(Printer):
""" """
Manages connexion and capabilities of a BrotherQL Printer Manages connexion and capabilities of a BrotherQL Printer
""" """
def __init__(self, app, vendor_id, device_id, configuration_file): def __init__(self, app, vendor_id, device_id):
super().__init__(app, vendor_id="",device_id="", printer_type=PrinterType.BROTHER)
super().__init__(app, vendor_id, device_id, printer_type=PrinterType.BROTHER)
self.printer = None self.printer = None
self.usb_args = {} self.usb_args = {}
self.usb_args["idVendor"] = self.vendor_id self.usb_args["idVendor"] = self.device_id
self.usb_args["idProduct"] = self.device_id self.usb_args["idProduct"] = self.vendor_id
self.model_manager = ModelsManager() self.model_manager = ModelsManager()
# Code taken from https://github.com/5shekel/printit/blob/master/printer_utils.py # Code taken from https://github.com/5shekel/printit/blob/master/printer_utils.py
self.app.logger.debug("Creating backend for Brother")
backend = backend_factory("pyusb") backend = backend_factory("pyusb")
available_devices = backend["list_available_devices"]() available_devices = backend["list_available_devices"]()
for printer in available_devices: for printer in available_devices:
@@ -426,29 +363,22 @@ class BrotherPrinter(Printer):
parts = identifier.split("/") parts = identifier.split("/")
if len(parts) < 4: if len(parts) < 4:
self.app.logger.warning( self.app.logger.warning(f"Skipping device with invalid identifier format: {identifier}")
f"Skipping device with invalid identifier format: {identifier}"
)
continue continue
protocol = parts[0] protocol = parts[0]
# device_info = parts[2] device_info = parts[2]
serial_number = parts[3] serial_number = parts[3]
try: try:
product_id_int = int(self.device_id, 16)
for m in self.model_manager.iter_elements(): for m in self.model_manager.iter_elements():
if m.product_id == self.device_id: if m.product_id == product_id_int:
model = m.identifier model = m.identifier
break break
self.app.logger.debug(f"Matched printer model: {model}") self.app.logger.debug(f"Matched printer model: {model}")
except ValueError as ve: except ValueError:
self.app.logger.warning("Invalid product ID format:" + str(ve)) self.app.logger.warning(f"Invalid product ID format: {product_id}")
raise ve
except Exception as e:
self.app.logger.error("Error while finding a model ? : " + str(e))
raise e
self.printer_info = PrinterInfo( self.printer_info = PrinterInfo(
identifier=identifier, identifier=identifier,
@@ -458,330 +388,164 @@ class BrotherPrinter(Printer):
vendor_id=vendor_id, vendor_id=vendor_id,
product_id=self.device_id, product_id=self.device_id,
serial_number=serial_number, serial_number=serial_number,
label_type=configuration_file[
"label_type"
], # TODO: Implement automatic label type detection : https://framagit.org/stickoeur/diagnostickoeur/-/blob/no-masters/printit.py?ref_type=heads#L239
) )
self.app.logger.debug("Created a Brother printer !")
self.ready = True self.ready = True
def _has_paper(self): def _has_paper(self):
raise NotImplementedError("This printer model does not support this.") raise NotImplementedError("This printer model does not support this.")
def _state(self): def _state(self):
return self.ready return self.ready
def _print_txt(self, msg, signature="", bold=False): def _print_img(self,data):
"""Print text after converting it to an image"""
self._print_img(text_to_image(msg))
self._print_img(text_to_image(signature))
def _print_img(
self,
data,
signature="",
process=False,
):
""" """
Print a raster image via a Brother QL printer Print a raster image via a Brother QL printer
""" """
self.app.logger.debug("Printing an image %s via Brother printer", data) self.ready = False
if process: label_type = "102"
rotate = 0
dither = False
try: try:
self.app.logger.debug("Proccessing the image") # Prepare the image for printing
processed_path = _process_image(self, data) qlr = BrotherQLRaster(self.printer_info["model"])
except RuntimeError as e:
self.app.logger.error(
"Error while processing the image, aborting print : %s", str(e)
)
raise e
else:
processed_path = data
self.app.logger.warning("Not proccessing the image")
try:
selected_backend = guess_backend(self.printer_info.identifier)
BACKEND_CLASS = backend_factory(selected_backend)["backend_class"]
BACKEND_STRING_DESCR = self.printer_info.identifier
except Exception as e:
self.app.logger.error(
"Couldn't guess the backend to use from the printer string descriptor"
)
raise e
try:
im = Image.open(processed_path)
qlr = BrotherQLRaster(self.printer_info.model)
# create_label(qlr, im, self.printer_info.label_type, cut=False, dither=True)
# noinspection PyCallingNonCallable
# be = BACKEND_CLASS(BACKEND_STRING_DESCR)
# be.write(qlr.data)
# be.dispose()
# del be
instructions = convert( instructions = convert(
qlr=qlr, qlr=qlr,
images=[im], images=[data["img"]],
label=self.printer_info.label_type, label=label_type,
dither=True, rotate=rotate,
compress=False, threshold=70,
dither=dither,
compress=True,
red=False,
dpi_600=False, dpi_600=False,
cut=False, hq=False,
cut=True,
) )
success = send( # Debug logging
if FLASK_DEBUG:
self.app.logger.debug(f"""
Print parameters:
- Label type: {label_type}
- Rotate: {rotate}
- Dither: {dither}
- Model: {self.printer_info['model']}
- Backend: {self.printer_info['backend']}
- Identifier: {self.printer_info['identifier']}
""")
# Try to print using Python API
# send() = status = {
# 'instructions_sent': True, # The instructions were sent to the printer.
# 'outcome': 'unknown', # String description of the outcome of the sending operation like: 'unknown', 'sent', 'printed', 'error'
# 'printer_state': None, # If the selected backend supports reading back the printer state, this key will contain it.
# 'did_print': False, # If True, a print was produced. It defaults to False if the outcome is uncertain (due to a backend without read-back capability).
# 'ready_for_next_job': False, # If True, the printer is ready to receive the next instructions. It defaults to False if the state is unknown.
# }
status = send(
instructions=instructions, instructions=instructions,
printer_identifier=BACKEND_STRING_DESCR, printer_identifier= self.printer_info["identifier"],
backend_identifier="pyusb", backend_identifier="pyusb"
blocking=False,
) )
self.app.logger.debug(str(success)) if not status["did_print"] or status["outcome"] == "error" or status["outcome"] == "unknown":
self.app.logger.debug("Printed image") raise RuntimeError("Failed to print using Python API")
time.sleep(2)
if status["printer_state"]:
self.ready = bool(status["printer_state"])
else:
self.ready = True
except usb.core.USBError as e: except usb.core.USBError as e:
if "timeout error" in str(e): # Treat timeout errors as successful since they often occur after print completion
self.app.logger.error("USB Timeout Error %s", str(e)) if e.errno == 110: # Operation timed out
except Exception as e: self.app.logger.debug("USB timeout occurred - this is normal and the print likely completed")
raise e self.app.logger.debug("Print completed (timeout is normal)")
# finally: self.ready = True
# try:
# os.remove(processed_path)
# self.app.logger.debug("Removed image : " + str(processed_path))
# except OSError as e:
# raise e
if signature != "": error_msg = f"USBError encountered: {e}"
self.app.logger.debug("Printing signature for the image %s", data) self.app.logger.debug(error_msg)
try: raise RuntimeError from e
signature_file = text_to_image(signature)
im = Image.open(signature_file)
qlr = BrotherQLRaster(self.printer_info.model)
# create_label(
# qlr, im, self.printer_info.label_type, cut=False, dither=True
# )
# noinspection PyCallingNonCallable
# be = BACKEND_CLASS(BACKEND_STRING_DESCR)
# be.write(qlr.data)
# be.dispose()
# del be
instructions = convert(
qlr=qlr,
images=[signature_file],
label=self.printer_info.label_type,
dither=True,
compress=False,
dpi_600=False,
cut=False,
)
success = send(
instructions=instructions,
printer_identifier=BACKEND_STRING_DESCR,
backend_identifier="pyusb",
blocking=False,
)
self.app.logger.debug(str(success))
self.app.logger.debug("Printed signature")
time.sleep(2)
except Exception as e: except Exception as e:
raise e error_msg = f"Unexpected error during printing: {str(e)}"
finally: self.app.logger.debug(error_msg)
try: raise RuntimeError from e
# os.remove(signature_file)
self.app.logger.debug("Removed image : " + str(signature_file))
except OSError as e:
raise e
def _cut(self):
self.app.logger.debug("Cutting via Brother Printer")
try:
selected_backend = guess_backend(self.printer_info.identifier)
BACKEND_CLASS = backend_factory(selected_backend)["backend_class"]
BACKEND_STRING_DESCR = self.printer_info.identifier
except Exception as e:
self.app.logger.error(
"Couldn't guess the backend to use from the printer string descriptor"
)
raise e
data = "src/static/images/1x1.png"
try:
im = Image.open(data)
qlr = BrotherQLRaster(self.printer_info.model)
create_label(
qlr, im, self.printer_info.label_type, threshold=70, cut=True, rotate=0
)
# noinspection PyCallingNonCallable
be = BACKEND_CLASS(BACKEND_STRING_DESCR)
be.write(qlr.data)
be.dispose()
del be
self.app.logger.debug("Finished cutting via Brother Printer")
except Exception as e:
raise e
def _qr(self):
# This should not be reached by a print on a BrotherQL
raise NotImplementedError()
def print_task(self, task_type, data): def print_task(self, task_type, data):
"""Execute actual print based on task type""" """Execute actual print based on task type"""
with self._lock: with self._lock:
self.app.logger.debug("Acquired lock to start print") if self._state:
i_m_ready = self._state() self._state = False
while not i_m_ready:
self.app.logger.debug(
"Waiting for the printer to become ready, current state %s ",
str(i_m_ready),
)
i_m_ready = self._state()
time.sleep(0.3)
self.app.logger.debug("Checked state to start printing : %s", self._state())
self.ready = False
try:
match (task_type.value): match (task_type.value):
case "image": case "image":
self._print_img(data["img"], signature=data["sign"]) self._print_img(data["img"])
self.ready = True self._state = True
case "cut": case "cut":
self._cut() # The cut happens by default on Brother QL printers.
self.ready = True self._state = True
case "text":
self._print_txt(data["txt"], signature=data["sign"])
self.ready = True
case _: case _:
raise RuntimeError("This task type is not supported") raise RuntimeError("This task type is not supported")
except Exception as e:
raise e
def _process_image(self, path, max_width=575, max_height=1000):
brightness_threshold = 100
contrast_factor = 2.0
with Image.open(path) as img:
# Preserve aspect ratio while fitting within the maximum dimensions.
img.thumbnail(
(max_width, max_height),
Image.Resampling.LANCZOS,
)
grayscale = img.convert("L")
avg_brightness = np.asarray(grayscale, dtype=np.float32).mean()
self.app.logger.debug("Average brightness of the image: %.2f", avg_brightness)
if avg_brightness < brightness_threshold:
brightness_factor = min(
max(
1 + (brightness_threshold - avg_brightness) / brightness_threshold,
1.1,
),
2.5,
)
self.app.logger.debug(
"Image is dark; increasing brightness by %.2f",
brightness_factor,
)
grayscale = ImageEnhance.Brightness(grayscale).enhance(brightness_factor)
contrast = float(np.asarray(grayscale, dtype=np.float32).std())
self.app.logger.debug("Grayscale standard deviation: %.2f", contrast)
# Save the enhanced result.
processed = ImageEnhance.Contrast(grayscale).enhance(contrast_factor)
jpeg_path = os.path.splitext(path)[0] + "_processed.jpg"
processed.save(jpeg_path, format="JPEG", quality=95, optimize=True)
self.app.logger.debug("Processed and saved image: %s", jpeg_path)
return jpeg_path
def text_to_image(
text,
width=400,
font_path="src/static/font/MonospaceTypewriter.ttf",
font_size=24,
padding=10,
line_spacing=4,
background="white",
fill="black",
output_dir="src/static/uploads",
):
"""Converts a string to an image"""
font = ImageFont.truetype(font_path, font_size)
# Measure and wrap text by pixel width.
measure_img = Image.new("RGB", (1, 1))
draw = ImageDraw.Draw(measure_img)
max_text_width = width - 2 * padding
if max_text_width <= 0:
raise ValueError("width must be greater than twice the padding")
lines = []
for paragraph in text.splitlines() or [""]:
words = paragraph.split()
if not words:
lines.append("")
continue
line = ""
for word in words:
candidate = f"{line} {word}".strip()
if draw.textbbox((0, 0), candidate, font=font)[2] <= max_text_width:
line = candidate
continue
if line:
lines.append(line)
# Split a word that is wider than the available width.
line = ""
piece = ""
for char in word:
if (
piece
and draw.textbbox((0, 0), piece + char, font=font)[2]
> max_text_width
):
lines.append(piece)
piece = char
else: else:
piece += char raise RuntimeError("The printer is not ready to print yet !")
line = piece
if line: # These values are by default for now
lines.append(line)
if not lines: # raise NotImplementedError("This printer type is not implemented yet")
lines = [""]
ascent, descent = font.getmetrics() def _process_image(self, path):
line_height = ascent + descent brightness_factor = 1.5 # Used only if image is too dark
height = 2 * padding + len(lines) * line_height + (len(lines) - 1) * line_spacing brightness_threshold = 100 # Brightness threshold (0–255)
contrast_factor = 0.6 # Less than 1.0 = lower contrast
max_width = 575
max_height = 1000
image = Image.new("RGB", (width, height), background) with Image.open(path) as original_img:
draw = ImageDraw.Draw(image) # Convert to RGB if needed (JPEG doesn't support alpha)
if original_img.mode in ("RGBA", "P"):
self.app.logger.debug("Converting the image to RGB from RGBA")
original_img = original_img.convert("RGB")
y = padding # Resize while maintaining aspect ratio
for line in lines: original_img.thumbnail((max_width, max_height), Image.Resampling.LANCZOS)
draw.text((padding, y), line, font=font, fill=fill) self.app.logger.debug("Resized the image")
y += line_height + line_spacing
upload_dir = Path(output_dir) # # Convert to grayscale for dithering
upload_dir.mkdir(parents=True, exist_ok=True) # dithered_img = original_img.convert("L").convert("1")
# Dithering using default method (Floyd–Steinberg)
# self.app.logger.debug("Dithered the image")
image_path = upload_dir / f"{uuid4().hex}.png" # Compute brightness of original image (grayscale average)
image.save(image_path, format="PNG") grayscale = original_img.convert("L")
avg_brightness = np.array(grayscale).mean()
self.app.logger.debug(
"Average brightness of the image : " + str(avg_brightness)
)
return str(image_path) # Dynamically compute brightness factor if too dark
if avg_brightness < brightness_threshold:
brightness_factor = (
1 + (brightness_threshold - avg_brightness) / brightness_threshold
)
brightness_factor = min(
max(brightness_factor, 1.1), 2.5
) # Clamp between 1.1 and 2.5
self.app.logger.debug(
f"Image too dark, increasing brightness by a factor of {brightness_factor:.2f}"
)
enhancer = ImageEnhance.Brightness(original_img)
original_img = enhancer.enhance(brightness_factor)
# # Reduce contrast
# contrast_enhancer = ImageEnhance.Contrast(original_img)
# original_img = contrast_enhancer.enhance(contrast_factor)
# Convert to JPEG and save
jpeg_path = os.path.splitext(path)[0] + "_processed.jpg"
original_img.save(jpeg_path, format="JPEG", quality=95, optimize=True)
self.app.logger.debug("Processed and saved image.")
return jpeg_path

View File

@@ -1,31 +1,23 @@
""" """
A collection of Printers. A collection of Printers.
It has methods to discover printers, and provides an interface for It has methods to discover printers, and provides an interface for the methods expected from printers.
the methods expected from printers.
""" """
from collections.abc import Mapping, Set
from collections.abc import Set
import time
import threading
import usb.core import usb.core
import usb.util import usb.util
from printer import Printer, EscPosPrinter, BrotherPrinter from printer import Printer, EscPosPrinter, BrotherPrinter, PrinterType
class Printers():
class Printers:
""" """
Finds and creates a set of Printer that can be used by the Workers to print. Finds and creates a set of Printer that can be used by the Workers to print.
""" """
def __init__(self, app):
def __init__(self, app, configuration_file):
""" """
Discovers printers connected to the computer Discover printers connected to the computer and return a Collection of Printer()
""" """
self.app = app self.app = app
self.configuration_file = configuration_file self.printers = self._discover_printers()
self.printers = list(self._discover_printers())
self._lock = threading.Lock()
def _discover_printers(self) -> Set[Printer]: def _discover_printers(self) -> Set[Printer]:
""" """
@@ -43,32 +35,11 @@ class Printers:
printers = set() printers = set()
waiting_time_for_printer = self.configuration_file["printer"]["waiting_time"]
while True:
# Find all connected USB devices # Find all connected USB devices
# the find() fnc returns a generator devices = usb.core.find(find_all=True,custom_match=_FindClass(7))
devices = list( if not devices:
usb.core.find(find_all=True, custom_match=_FindClass(self.app, 7)) self.app.logger.warning("No USB devices of class 7 ( printers ) found or pyusb could not access the bus.")
) raise RuntimeError("No USB devices of class 7 ( printers ) found or pyusb could not access the bus.")
if devices:
break
if waiting_time_for_printer <= 0:
self.app.logger.warning(
"No USB devices of class 7 ( printers ) found or pyusb could not access the bus."
)
raise RuntimeError(
"No USB devices of class 7 ( printers ) found or pyusb could not access the bus."
)
self.app.logger.warning(
"No printers found; waiting for a printer to connect..."
)
time.sleep(1)
waiting_time_for_printer -= 1
for dev in devices: for dev in devices:
# Attempt to get the manufacturer and product strings # Attempt to get the manufacturer and product strings
@@ -81,135 +52,80 @@ class Printers:
product = usb.util.get_string(dev, dev.iProduct) product = usb.util.get_string(dev, dev.iProduct)
except Exception: except Exception:
product = "Unknown" product = "Unknown"
self.app.logger.debug("Looking at %s %s (%s:%s)", manufacturer, product, hex(dev.idVendor), hex(dev.idProduct))
self.app.logger.debug( if manufacturer == "EPSON":
"Looking at %s %s (%s:%s)",
manufacturer,
product,
hex(dev.idVendor),
hex(dev.idProduct),
)
match (manufacturer):
case "EPSON":
try: try:
# We create a new EscPosPrinter() # We create a new EscPosPrinter()
self.app.logger.debug("Trying to create a new EPSON printer") self.app.logger.debug("Trying to creat a new EPSON printer")
prid = dev.idProduct prid = dev.idProduct
vendir = dev.idVendor vendir = dev.idVendor
escpos_printer = EscPosPrinter( escpos_printer = EscPosPrinter(self.app, vendor_id=vendir, device_id=prid)
self.app,
vendir,
prid,
self.configuration_file["printer"]["epson"],
)
except Exception as e: except Exception as e:
raise e raise e
# If the object creation is successfull, we add it to the list of Printers # If the object creation is successfull, we add it to the list of Printers
printers.add(escpos_printer) printers.add(escpos_printer)
self.app.logger.debug("Found a %s printer", manufacturer) self.app.logger.debug("Found a %s printer" % manufacturer )
case "Brother":
# We already found the type of printer,
# we don't need an extra comparaison.
continue
# or a Brother Printer
if manufacturer == "Brother":
try: try:
# We create a new BrotherPrinter() # We create a new BrotherPrinter()
self.app.logger.debug("Trying to create a new BROTHER printer") self.app.logger.debug("Trying to creat a new BROTHER printer")
prid = dev.idProduct
brother_printer = BrotherPrinter( vendir = dev.idVendor
self.app, brother_printer = BrotherPrinter(self.app, vendor_id=vendir,device_id=prid)
dev.idVendor,
dev.idProduct,
self.configuration_file["printer"]["brother"],
)
except Exception as e: except Exception as e:
self.app.logger.error( self.app.logger.error("Could not create a %s printer class with %s:%s" % product, dev.idVendor, dev.idProduct)
"Could not create a %s printer class with %s:%s",
product,
dev.idVendor,
dev.idProduct,
)
raise e raise e
# If the object creation is successfull, we add it to the list of Printers # If the object creation is successfull, we add it to the list of Printers
printers.add(brother_printer) printers.add(brother_printer)
self.app.logger.debug("Found a %s printer", manufacturer) self.app.logger.debug("Found a %s printer" % manufacturer )
case _:
self.app.logger.debug(
"Found a printer of unknown manufacturer : %s", manufacturer
)
# end match
self.app.logger.debug("Found %s printers", len(printers))
if len(printers) < 1:
self.app.logger.warning(
"Not printers found ! Please plug in a Printer and restart the program."
)
raise RuntimeError("No printers found")
self.app.logger.debug("Found %s printers" % len(printers))
return printers return printers
def acquire_available_printer(self, start_index=0): def any(self) -> Printer:
"""Atomically acquire and return an available printer, or None.""" """
printers = self.printers Return a dict key: UUID, value: Printer, with any connected printer.
if not printers: """
self.app.logger.error("No printers available for acquisition") if len(self.printers) > 0:
return None
with self._lock:
# So don't always look at the first printer available if need be
# this allows for a round-robin lookup
for offset in range(len(printers)):
index = (start_index + offset) % len(printers)
printer = printers[index]
if not printer.used:
printer.use_printer()
return index, printer
return None
def printers_info(self):
"""Return the current list of printers"""
printers_info_list = []
for i in self.printers: for i in self.printers:
printers_info_list.append( return i
[ else:
i.printer_type.name, raise RuntimeError("No printers available")
"Used: " + str(i.used),
"Ready: " + str(i.ready),
i.printer_info,
]
)
return printers_info_list def get_printer(self, printer_type):
class _FindClass:
"""
Use by usb.core to modify the way USB devices are found
Taken from pyUSB documentation on Github
""" """
Return a specific printer
def __init__(self, app, class_): printer_type -- a printer type
"""
return NotImplementedError()
class _FindClass():
def __init__(self, class_):
self._class = class_ self._class = class_
self.app = app
def __call__(self, device): def __call__(self, device):
# first, let's check the device # first, let's check the device
self.app.logger.debug(
"Found a USB device of class %s", str(device.bDeviceClass)
)
if device.bDeviceClass == self._class: if device.bDeviceClass == self._class:
return True return True
# ok, transverse all devices to find an # ok, transverse all devices to find an
# interface that matches our class # interface that matches our class
for configuration in device: for cfg in device:
# Every device can have one or more configuration, # find_descriptor: what's it?
interface = usb.util.find_descriptor( intf = usb.util.find_descriptor(
configuration, bInterfaceClass=self._class cfg,
bInterfaceClass=self._class
) )
# each config can have several interfaces if intf is not None:
if interface is not None:
return True return True
return False return False

View File

@@ -10,12 +10,12 @@ import io # To check if we are on a Raspberry Pi
import subprocess import subprocess
import os import os
from time import sleep, gmtime, strftime from time import sleep, gmtime, strftime
from flask_socketio import SocketIO
from gpiozero import Button, LED, DigitalOutputDevice from gpiozero import Button, LED, DigitalOutputDevice
from PIL import Image from PIL import Image
from task import TextTask, ImageTask, CutTask from task import TextTask, ImageTask, CutTask
class Raspberry():
class Raspberry:
""" """
This class will manage three things : This class will manage three things :
- Connecting to a USB webcam - Connecting to a USB webcam
@@ -23,17 +23,29 @@ class Raspberry:
- Activating a flash ( or light ) - Activating a flash ( or light )
- Flash an indicator light - Flash an indicator light
# pylint: disable=too-many-instance-attributes
# dede
""" """
def __init__(self, print_queue, app, configuration_file): def __init__(
self,
print_queue,
app,
socketio,
button_gpio_port_number,
indicator_gpio_port_number,
flash_gpio_port_number,
is_flash_present,
):
self.print_queue = print_queue self.print_queue = print_queue
self.socketio = socketio
self.app = app self.app = app
self.configuration_file = configuration_file
self.flash_gpio = flash_gpio_port_number
self.is_flash_present = is_flash_present
self.button_gpio = button_gpio_port_number
self.led_gpio = indicator_gpio_port_number
self.image_path = self.app.config["UPLOAD_FOLDER"] + "/image.jpg" self.image_path = self.app.config["UPLOAD_FOLDER"] + "/image.jpg"
def is_raspberry_pi(self): def is_raspberry_pi(self, raise_on_errors=False):
""" """
Checking if we are on a Raspberry Pi by checking Checking if we are on a Raspberry Pi by checking
information on the /proc/cpuinfo file information on the /proc/cpuinfo file
@@ -60,11 +72,8 @@ class Raspberry:
return False return False
if not found: if not found:
self.app.logger.warning( self.app.logger.error(
"Couldn't get sufficient hardware information from /proc/cpuinfo" "Couldn't get sufficient hardware information from /proc/cpuinfo, Unable to determine if we are on a Raspberry Pi."
)
self.app.logger.warning(
"Unable to determine if we are on a Raspberry Pi."
) )
return False return False
except IOError: except IOError:
@@ -74,41 +83,28 @@ class Raspberry:
self.app.logger.debug("It seems we are on a Raspberry Pi") self.app.logger.debug("It seems we are on a Raspberry Pi")
try: try:
self._initialise_gpio() self.initialise_gpio()
except Exception as e: except Exception as e:
self.app.logger.debug("Could not init GPIO : " + str(e)) self.app.logger.debug("Could not init GPIO : " + str(e))
raise e raise e
return True return True
def _initialise_gpio(self): def initialise_gpio(self):
"""
Set GPIO ports from configuration and activate them
to show the user it's working.
"""
self.app.logger.debug("Initializing GPIO") self.app.logger.debug("Initializing GPIO")
self.led = LED(self.configuration_file["rpi"]["indicator_gpio_port_number"]) self.led = LED(self.led_gpio)
self.app.logger.debug("Activated indicator LED") self.app.logger.debug("Activated indicator LED")
self.indicator_countdown(iters=3) self.indicator_countdown(iters=3)
self.button = Button( self.button = Button(self.button_gpio, pull_up=True, bounce_time=0.1)
self.configuration_file["rpi"]["button_gpio_port_number"],
pull_up=True,
bounce_time=0.1,
)
self.button.when_pressed = self.on_button_pressed self.button.when_pressed = self.on_button_pressed
self.app.logger.debug("Activated button") self.app.logger.debug("Activated button")
# The "flash" is a relay-controlled device ( light bulb for example ) # The "flash" is a relay-controlled device ( light bulb for example )
self.flash = DigitalOutputDevice( self.flash = DigitalOutputDevice(self.flash_gpio)
self.configuration_file["rpi"]["flash_gpio_port_number"]
)
self.flash_toggle() self.flash_toggle()
self.app.logger.debug("Activated flash") self.app.logger.debug("Activated flash")
def indicator_countdown(self, iters=10, multi=10): def indicator_countdown(self, iters=10, multi=10):
"""
Activates the LED faster and faster to show a countdown
"""
for i in range(iters, 0, -1): for i in range(iters, 0, -1):
self.led.on() self.led.on()
sleep(i / multi) sleep(i / multi)
@@ -116,10 +112,7 @@ class Raspberry:
sleep(i / multi) sleep(i / multi)
def indicator_led(self, timing=0.2, l=5): def indicator_led(self, timing=0.2, l=5):
""" for i in range(l):
Turns on the indicator LED for a certain period of time
"""
for _ in range(l):
self.app.logger.debug("LED turned on") self.app.logger.debug("LED turned on")
self.led.on() self.led.on()
sleep(timing) sleep(timing)
@@ -128,9 +121,6 @@ class Raspberry:
sleep(timing) sleep(timing)
def flash_toggle(self): def flash_toggle(self):
"""
Flashes the flash
"""
self.app.logger.debug("Flash turned on") self.app.logger.debug("Flash turned on")
self.flash.on() self.flash.on()
sleep(0.3) sleep(0.3)
@@ -138,9 +128,6 @@ class Raspberry:
self.app.logger.debug("Flash turned off") self.app.logger.debug("Flash turned off")
def take_picture(self): def take_picture(self):
"""
Takes a picture via the USB webcam
"""
# Validate if the image path is valid # Validate if the image path is valid
if not os.path.isdir(os.path.dirname(self.image_path)): if not os.path.isdir(os.path.dirname(self.image_path)):
self.app.logger.error( self.app.logger.error(
@@ -186,9 +173,6 @@ class Raspberry:
position="bottom_right", position="bottom_right",
margin=10, margin=10,
): ):
"""
Takes an image and overlays it with a another picture.
"""
try: try:
image = Image.open(image_path).convert("RGBA") image = Image.open(image_path).convert("RGBA")
logo = Image.open(logo_path).convert("RGBA") logo = Image.open(logo_path).convert("RGBA")
@@ -215,9 +199,7 @@ class Raspberry:
y = image.height - logo.height - margin y = image.height - logo.height - margin
else: else:
raise ValueError( raise ValueError(
"Invalid position." "Invalid position. Choose from 'bottom_right', 'top_left', 'top_right', or 'bottom_left'."
+ "Choose from 'bottom_right', 'top_left', "
+ " 'top_right', or 'bottom_left'."
) )
# Composite the logo onto the image # Composite the logo onto the image
@@ -235,9 +217,6 @@ class Raspberry:
return True return True
def crop_to_square(self, image_path, output_path=None): def crop_to_square(self, image_path, output_path=None):
"""
Crop an image so that it becomes a square
"""
try: try:
image = Image.open(image_path) image = Image.open(image_path)
width, height = image.size width, height = image.size
@@ -265,10 +244,6 @@ class Raspberry:
return True return True
def on_button_pressed(self): def on_button_pressed(self):
"""
When a button press is detected, a picture is taken from the webcam
and added to the print queue.
"""
self.app.logger.debug("Button has been pressed") self.app.logger.debug("Button has been pressed")
self.led.on() self.led.on()
self.app.logger.debug("Counting down") self.app.logger.debug("Counting down")
@@ -289,9 +264,7 @@ class Raspberry:
self.led.on() self.led.on()
self.crop_to_square(self.image_path) self.crop_to_square(self.image_path)
self.print_queue.enqueue(ImageTask(self.image_path,signature="",process=True)) self.print_queue.enqueue(ImageTask(self.image_path,signature="",process=True))
self.print_queue.enqueue( self.print_queue.enqueue(TextTask(content="Imprimé par LittlePrynter", signature=""))
TextTask(content="Imprimé par LittlePrynter", signature="")
)
time = strftime("%Y-%m-%d %H:%M", gmtime()) time = strftime("%Y-%m-%d %H:%M", gmtime())
self.print_queue.enqueue(TextTask(content=time, signature="")) self.print_queue.enqueue(TextTask(content=time, signature=""))
self.print_queue.enqueue(CutTask()) self.print_queue.enqueue(CutTask())

Binary file not shown.

Before

Width:  |  Height:  |  Size: 153 B

Binary file not shown.

Before

Width:  |  Height:  |  Size: 8.2 KiB

View File

@@ -14,7 +14,6 @@ to print at the same time.
We can also delay and store printing tasks until a printer becomes We can also delay and store printing tasks until a printer becomes
available if none is online. available if none is online.
""" """
from abc import ABC, abstractmethod from abc import ABC, abstractmethod
## See https://docs.python.org/3/library/abc.html to learn more about this ## See https://docs.python.org/3/library/abc.html to learn more about this
@@ -28,7 +27,6 @@ class TaskType(Enum):
""" """
The different tasks supported by the printers The different tasks supported by the printers
""" """
TEXT = "text" TEXT = "text"
IMAGE = "image" IMAGE = "image"
CUT = "cut" CUT = "cut"
@@ -49,6 +47,7 @@ class PrintTask(ABC):
def get_print_data(self): def get_print_data(self):
"""Return data formatted for printer""" """Return data formatted for printer"""
def _generate_id(self): def _generate_id(self):
# Generate unique task ID # Generate unique task ID
return str(uuid.uuid4()) return str(uuid.uuid4())
@@ -67,10 +66,8 @@ class TextTask(PrintTask):
def get_print_data(self): def get_print_data(self):
return {"txt": self.content, "sign": self.signature} return {"txt": self.content, "sign": self.signature}
class QRTask(TextTask): class QRTask(TextTask):
"""This task prints a QR-Code, the signature is ignore and is always the content itself""" """This task prints a QR-Code, the signature is ignore and is always the content itself"""
def __init__(self, content): def __init__(self, content):
super().__init__(content, signature="") super().__init__(content, signature="")
self.content = content self.content = content
@@ -79,7 +76,6 @@ class QRTask(TextTask):
def get_print_data(self): def get_print_data(self):
return {"txt": self.content, "sign": self.signature} return {"txt": self.content, "sign": self.signature}
class ImageTask(PrintTask): class ImageTask(PrintTask):
""" """
This tasks represents a image content ( in the form of it's path ), and it's signature. This tasks represents a image content ( in the form of it's path ), and it's signature.

View File

@@ -5,6 +5,6 @@
<title>LittlePrynter API</title> <title>LittlePrynter API</title>
</head> </head>
<body> <body>
Welcome to the printing software's API. Please see the index page to get started. "Welcome to the printing software's API. Please see the index page to get started.
</body> </body>
</html> </html>

View File

@@ -53,7 +53,7 @@
<hr> <hr>
<footer class="row"> <footer class="row">
<p class=" text-center">Little Prynter is built by <a href="https://n07070.xyz/about-me/">n07070</a> because it's fun :) | <a href="/api">API interface</a> | <a href="https://git.n07070.xyz/n07070/littleprynter">Source code - AGPLv3</a></p> <p class=" text-center">Little Prynter is built by <a href="https://n07070.xyz/about-me/">n07070</a> because it's fun :) | <a href="https://git.n07070.xyz/n07070/littleprynter">Source code - AGPLv3</a></p>
</footer> </footer>
</body> </body>
<script src="https://cdn.socket.io/4.0.0/socket.io.min.js"></script> <script src="https://cdn.socket.io/4.0.0/socket.io.min.js"></script>

View File

@@ -0,0 +1,5 @@
<hr>
<footer>Little Prynter is built by <a href="https://n07070.xyz/about-me/">n07070</a> because it's fun :) | <a href="https://git.n07070.xyz/n07070/littleprynter/src/branch/epson-tm-t20iii">Source code - AGPLv3</a></footer>
</div>
</body>
</html>

View File

@@ -6,23 +6,9 @@
<h3 class="card-header">Print a short message</h3> <h3 class="card-header">Print a short message</h3>
<div class="card-body"> <div class="card-body">
<form class="form-group" action="/web/print/sms" method="post"> <form class="form-group" action="/web/print/sms" method="post">
<textarea class="form-control" type="text" name="txt" placeholder="4096 caractères maximum " maxlength="4096"></textarea> <input class="form-control" type="text" name="txt" placeholder="200 chars or less " maxlength="200" required><br>
<br> <input class="form-control" type="text" name="signature" placeholder="Signature or pseudo" maxlength="200"><br>
<input class="form-control" type="text" name="signature" placeholder="Signature ou pseudo" maxlength="200"><br>
<div class="input-group">
<span class="input-group-text">Combien ?</span>
<input type="number" aria-label="how-many" class="form-control" name="many" max="20" min="1" value="1">
<input class="btn btn-primary float-right" type="submit" value="Imprimer" name="imprimer"> <input class="btn btn-primary float-right" type="submit" value="Imprimer" name="imprimer">
</div>
<br>
<div class="form-check">
<input class="form-check-input" type="checkbox" value="True" id="flexCheckDefault" name="cut" checked>
<label class="form-check-label" for="flexCheckDefault">
Couper après impression ?
</label>
</div>
</form> </form>
</div> </div>
</div> </div>
@@ -34,26 +20,8 @@
<div class="card-body"> <div class="card-body">
<form enctype="multipart/form-data" class="form-group" action="/web/print/img" method="post"> <form enctype="multipart/form-data" class="form-group" action="/web/print/img" method="post">
<input class="form-control" type="file" name="img" required><br> <input class="form-control" type="file" name="img" required><br>
<input class="form-control" type="text" name="signature" placeholder="Signature ou pseudo" maxlength="200"><br> <input class="form-control" type="text" name="signature" placeholder="Signature or pseudo" maxlength="200"><br>
<div class="input-group">
<span class="input-group-text">Combien ?</span>
<input type="number" aria-label="how-many" class="form-control" name="many" max="20" min="1" value="1">
<input class="btn btn-primary float-right" type="submit" value="Imprimer" name="imprimer"> <input class="btn btn-primary float-right" type="submit" value="Imprimer" name="imprimer">
</div>
<br>
<div class="form-check .form-check-inline">
<input class="form-check-input" type="checkbox" value="True" id="flexCheckDefault" name="cut" checked>
<label class="form-check-label" for="flexCheckDefault">
Couper après impression ?
</label>
</div>
<div class="form-check .form-check-inline">
<input class="form-check-input" type="checkbox" value="True" id="flexCheckDefault" name="process">
<label class="form-check-label" for="flexCheckDefault">
Traiter l'image ?
</label>
</div>
</form> </form>
</div> </div>
</div> </div>

0
src/templates/login.html Normal file
View File

View File

@@ -0,0 +1,30 @@
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Log in</title>
<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
<link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/css/bootstrap.min.css" integrity="sha384-MCw98/SFnGE8fJT3GXwEOngsV7Zt27NXFoaoApmYm81iuXoPkFOJwJ8ERdknLPMO" crossorigin="anonymous">
<link rel="stylesheet" href="{{ url_for('static',filename='css/style.css') }}">
</head>
<body class="container">
<div class="col-md-6 offset-md-3">
<h1>Login</h1>
{% with messages = get_flashed_messages(with_categories=true) %}
{% if messages %}
{% for category, message in messages %}
<div class="alert alert-{{ category }}" role="alert">{{ message }}</div>
{% endfor %}
{% endif %}
{% endwith %}
<form action="/login" method="post">
<div class="form-group">
<input type="text" name="username" class="form-control" placeholder="Pseudo">
<input type="password" name="password" class="form-control" placeholder="Password">
<button type="submit" class="btn btn-primary">Submit</button>
</div>
</form>
</div>
</body>
</html>

0
src/templates/print.html Normal file
View File

View File

@@ -1,13 +1,10 @@
"""
Manage all of the inputs from a web source
"""
import os import os
from flask import flash
from werkzeug.utils import secure_filename from werkzeug.utils import secure_filename
from task import TextTask, ImageTask, CutTask from task import TextTask, ImageTask, CutTask
class Web: class Web(object):
"""Web is the class that gets all of the information from web calls """Web is the class that gets all of the information from web calls
( API and Web page ) and provides checks before sending stuff to printing""" ( API and Web page ) and provides checks before sending stuff to printing"""
@@ -16,7 +13,7 @@ class Web:
self.print_queue = print_queue self.print_queue = print_queue
self.app = app self.app = app
def print_sms(self, texte, sign: str, do_cut: bool, many: int = 1) -> bool: def print_sms(self, texte, sign: str) -> bool:
""" """
Get text and a signature, prints the text and cuts after that. Get text and a signature, prints the text and cuts after that.
""" """
@@ -28,22 +25,15 @@ class Web:
# !! there is no garantee !! that both the SMS task and the Cut task # !! there is no garantee !! that both the SMS task and the Cut task
# are added back to back, another task could be # are added back to back, another task could be
# inserted between the two. # inserted between the two.
for i in range(many):
sms = self.print_queue.enqueue(TextTask(content=texte, signature=sign)) sms = self.print_queue.enqueue(TextTask(content=texte, signature=sign))
self.app.logger.info("Added a SMS task at position %s", sms)
if do_cut:
cut = self.print_queue.enqueue(CutTask()) cut = self.print_queue.enqueue(CutTask())
self.app.logger.info("Added a CUT task at position %s", cut)
except Exception as e: except Exception as e:
self.app.logger.error(e) self.app.logger.error(e)
raise RuntimeError("Could not add SMS to queue, " + str(e)) from e raise RuntimeError("Could not add SMS to queue, " + str(e)) from e
self.app.logger.info("Added two new tasks at position %s and %s", sms, cut)
return True return True
def print_image( def print_image(self, image, sign: str) -> bool:
self, image, sign: str, do_cut: bool, process_image: bool, many: int = 1
) -> bool:
""" """
Get an image and a signature, prints the image and cuts after that. Get an image and a signature, prints the image and cuts after that.
""" """
@@ -51,12 +41,11 @@ class Web:
file_uploaded = self.upload_file(image) file_uploaded = self.upload_file(image)
except Exception as e: except Exception as e:
self.app.logger.error(e) self.app.logger.error(e)
raise RuntimeError("Could not upload file : " + str(e)) from e raise RuntimeError("Could not upload file") from e
if file_uploaded: if file_uploaded:
self.app.logger.debug("File has been uploaded, printing...") self.app.logger.debug("File has been uploaded, printing...")
try: try:
for i in range(many):
img = self.print_queue.enqueue( img = self.print_queue.enqueue(
ImageTask( ImageTask(
os.path.join( os.path.join(
@@ -64,32 +53,28 @@ class Web:
secure_filename(image.filename), secure_filename(image.filename),
), ),
signature=sign, signature=sign,
process=process_image, process=True,
) )
) )
self.app.logger.info("Added a IMG task at position %s", img)
if do_cut:
cut = self.print_queue.enqueue(CutTask()) cut = self.print_queue.enqueue(CutTask())
self.app.logger.info("Added a CUT task at position %s", cut)
except Exception as e: except Exception as e:
raise RuntimeError("Could not add IMG to queue" + str(e)) from e raise RuntimeError("Could not add IMG to queue" + str(e)) from e
self.app.logger.info("Added two new tasks at position %s and %s", img, cut)
return True return True
# def login(self, username: str, password: str) -> bool: def login(self, username: str, password: str) -> bool:
# """Not implemented""" """Not implemented"""
# return return
# def logout(self, username: str, password: str) -> bool: def logout(self, username: str, password: str) -> bool:
# """Not implemented""" """Not implemented"""
# return return
def allowed_file(self, filename) -> bool: def allowed_file(self, filename) -> bool:
""" self.app.logger.debug("Is the filename allowed ?")
Check if the file extension is allowed
"""
self.app.logger.debug("Checking if the file extension is allowed")
return ( return (
"." in filename "." in filename
and filename.rsplit(".", 1)[1].lower() and filename.rsplit(".", 1)[1].lower()
@@ -97,11 +82,8 @@ class Web:
) )
def upload_file(self, image) -> bool: def upload_file(self, image) -> bool:
"""
Save the file after executing checks on it
"""
self.app.logger.debug("Validating file") self.app.logger.debug("Validating file")
if not image is None or not image == "": if image:
if self.allowed_file(image.filename): if self.allowed_file(image.filename):
filename = secure_filename(image.filename) filename = secure_filename(image.filename)
self.app.logger.debug("File valid") self.app.logger.debug("File valid")
@@ -109,9 +91,7 @@ class Web:
image.save(os.path.join(self.app.config["UPLOAD_FOLDER"], filename)) image.save(os.path.join(self.app.config["UPLOAD_FOLDER"], filename))
except OSError as e: except OSError as e:
self.app.logger.error("Could not save file %s", e) self.app.logger.error("Could not save file %s", e)
raise RuntimeError( return False
"An OS error occured while uploading this file : " + str(e)
) from e
self.app.logger.debug( self.app.logger.debug(
"File saved to " "File saved to "
@@ -119,8 +99,16 @@ class Web:
) )
return True return True
self.app.logger.error("Could not save file because the filename is forbidden") self.app.logger.error(
raise RuntimeError("This file type is forbidden.") "Could not save file because the filename is forbidden"
)
return False
else:
self.app.logger.error(
"Could not save file, it seems to be null ? : " + str(filename)
)
return False
def get_queue_state(self): def get_queue_state(self):
"""Return current queue state""" """Return current queue state"""

View File

@@ -1,67 +1,37 @@
""" # This is the main printing thread
This is the main printing thread. A worker thread consums Tasks from # As explained in the task file, this is where we command
a PrintQueue, while trying to find available printers. # printing to happen.
"""
import threading import threading
import time import time
import traceback from printers import Printers
class PrintWorker(threading.Thread): class PrintWorker(threading.Thread):
""" def __init__(self, app, print_queue, socketio=None):
A thread used to consume Tasks added to a Print Queue.
On initialisation, the worker will try to find Printers,
and on each print, if the choosen Printer becomes unavailable, it
will choose an available Printer from a list of Printers.
If a print fails, it's not retried, but will be added to a list of completed
tasks. TODO : Change that
"""
def __init__(self, app, print_queue, printers_pool, printer_index=0):
super().__init__(daemon=True) super().__init__(daemon=True)
self.app = app self.app = app
self.print_queue = print_queue self.print_queue = print_queue
self.printer = None self.printer = None
self._lock = threading.Lock() self._lock = threading.Lock()
self.socketio = socketio # Optional
self.running = True self.running = True
self.state = "idle" # idle, printing, dead, drinking-a-beer self.state = "idle" # idle, printing, dead, drinking-a-beer
# All workers share the same pool of printers.
self.printers = printers_pool
self.printers_obj = self.printers.printers
# If we create several workers, we can assign an index
# so that we lookup the nth printer for the nth worker
self._printer_index = printer_index
self.app.logger.debug("Worker initialized.")
self.app.logger.debug("Printers connected:")
for printer in self.printers_obj:
self.app.logger.debug("Printer type: %s", printer.printer_type)
self.app.logger.debug("Printer state: %s", printer.ready)
self.app.logger.debug("Ho great, I'm alive... I'm ready to work another day...") self.app.logger.debug("Ho great, I'm alive... I'm ready to work another day...")
def _acquire_available_printer(self): try:
result = self.printers.acquire_available_printer( self.printers = Printers(self.app)
start_index=self._printer_index self.printers_obj = self.printers.printers
) self.printers = iter(self.printers.printers)
if result is None: except RuntimeError as e:
return None self.app.logger.warning("Could not get any Printers")
raise e
index, printer = result
# In case we need to lookup another printer, we don't
# look at the same printer in the printer list
self._printer_index = (index + 1) % len(self.printers_obj)
return printer
def run(self): def run(self):
"""Background thread that processes queue items""" """Background thread that processes queue items"""
self.app.logger.debug("Worker %s started working.", threading.get_ident()) self.app.logger.debug("Worker %s started working.", threading.get_ident())
self.app.logger.debug("Current threads : %s", threading.active_count()) self.app.logger.debug("Current threads : %s" % threading.active_count())
self.app.logger.debug("Threads actives : %s ", threading.enumerate()) self.app.logger.debug("Threads actives : %s " % threading.enumerate())
while True: while True:
@@ -70,33 +40,18 @@ class PrintWorker(threading.Thread):
time.sleep(0.2) time.sleep(0.2)
continue continue
# If we have no available printer, we look at the list printers # If we have no available printer, we look at the list printers we know about, and try to find one that is available.
# we know about, and try to find one that is available.
# When we find a printer, we acquire it # When we find a printer, we acquire it
# When we are finished with a printer, we release it to the world. # When we are finished with a printer, we release it to the world.
while not self.printer or not self.printer.ready:
# If we do not have a printer, we try to find one
while self.running and self.printer is None:
self.app.logger.debug(
"Trying to find a available printer for the worker."
)
self.printer = self._acquire_available_printer()
self.app.logger.debug(
"The worker got a %s printer and it's %s",
self.printer.printer_type,
"Ready" if self.printer.ready else "Not ready",
)
if self.printer is None:
time.sleep(1)
self.printer.use_printer()
# If the printer is not ready, we wait for it to become ready.
while not self.printer.ready:
self.app.debug("Waiting for our printer to become ready...")
time.sleep(1) time.sleep(1)
try:
self.app.logger.debug("Changing printers")
self.printer = next(self.printers)
self.app.logger.debug("The worker got a %s printer and it's %s", self.printer.printer_type, "Ready" if self.printer.ready else "Not ready")
except Exception as e:
self.app.logger.error(str(e))
self.printer = None
if self.state != "idle": if self.state != "idle":
self.app.logger("We are not idle, waiting...") self.app.logger("We are not idle, waiting...")
@@ -111,7 +66,6 @@ class PrintWorker(threading.Thread):
except Exception as e: except Exception as e:
self.app.logger.error("Could not get a new task ! %s ", str(e)) self.app.logger.error("Could not get a new task ! %s ", str(e))
self.state = "idle" self.state = "idle"
self.printer.free_printer()
raise RuntimeError( raise RuntimeError(
"We could not get a new task because " + str(e) "We could not get a new task because " + str(e)
) from e ) from e
@@ -119,10 +73,9 @@ class PrintWorker(threading.Thread):
if task: if task:
try: try:
self.app.logger.info("Got a new task") self.app.logger.info("Got a new task")
self.app.logger.debug( self.app.logger.debug("Got task %s", task.task_id)
"Got task %s %s", task.task_type, task.task_id
)
task.status = "processing" task.status = "processing"
self._emit_status(task.task_id, "processing")
print_data = task.get_print_data() print_data = task.get_print_data()
@@ -131,39 +84,49 @@ class PrintWorker(threading.Thread):
except RuntimeError as e: except RuntimeError as e:
self.state = "idle" self.state = "idle"
self.app.logger.error("Could not print : %s", str(e)) self.app.logger.error("Could not print : %s", str(e))
self.app.logger.error(traceback.format_exc()) raise e
self.printer.free_printer()
task.status = "completed" task.status = "completed"
self.print_queue.mark_completed(task.task_id, "completed") self.print_queue.mark_completed(task.task_id, "completed")
self.app.logger.debug( self._emit_status(task.task_id, "completed")
"Finished printing task %s ", task.task_id self.app.logger.debug("Finished printing task %s " % task.task_id)
)
self.state = "idle" self.state = "idle"
except RuntimeError as e: except RuntimeError as e:
task.status = "failed" task.status = "failed"
self.state = "idle" self.state = "idle"
self.print_queue.mark_completed(task.task_id, "failed") self.print_queue.mark_completed(task.task_id, "failed")
self.app.logger.error( self._emit_status(task.task_id, "failed", error=str(e))
"Could not print task %s because %s ", task.task_id, str(e) self.app.logger.error("Could not print task %s because %s " % task.task_id, str(e))
)
else: else:
# When they are no new tasks to handle, we put the thread to sleep. # When they are no new tasks to handle, we put the thread to sleep.
self.state = "idle" self.state = "idle"
time.sleep(0.1) time.sleep(0.1)
def _emit_status(self, task_id, status, error=None):
"""Emit status update via Socket.IO if available"""
if not self.socketio:
return
room = f"task_{task_id}"
data = {
"task_id": task_id,
"status": status,
"position": None, # Task no longer in queue
}
if error:
data["error"] = error
self.socketio.emit("task_status", data, room=room)
def stop_worker(self): def stop_worker(self):
""" """
Give the worker a break Give the worker a break
""" """
self.app.logger.debug("Giving the worker a break") self.app.logger.debug("Giving the worker a break")
self.state = "drinking-a-beer" self.state = "drinking-a-beer"
# Free the printer during the worker break
# so it can be used by someone else
self.printer.free_printer()
self.printer = None
self.running = False self.running = False
def start_worker(self): def start_worker(self):