Înapoi la portofoliu
ToolClient real

PDF Auto-Print

Utilitar desktop Python care verifică periodic un endpoint, descarcă documente PDF, păstrează local istoricul și starea lor și le trimite automat sau manual către imprimante Windows prin SumatraPDF.

PDF Auto-Print

Stack principal

Python
PyQt5
Requests
SQLite
pywin32SumatraPDF CLIWindows Print SpoolerPyInstaller

Provocarea

Provocarea a fost eliminarea unui pas operațional repetitiv: detectarea documentelor noi, descărcarea lor, evitarea reprintării intenționate a aceluiași URL și trimiterea lor către o imprimantă Windows, păstrând în același timp control manual și trasabilitate locală asupra documentelor procesate.

Soluția

Soluția combină un UI desktop PyQt5 cu polling pe timer, Requests pentru integrarea HTTP, SQLite pentru jurnalul persistent al documentelor și pywin32 + SumatraPDF pentru integrarea cu imprimantele Windows. Un URL unic și statusul printed separă documentele noi de cele deja procesate, iar eșecurile de print rămân în starea neprintată pentru o reîncercare ulterioară. UI-ul permite intervenție manuală, selecție, căutare, reprintare, ștergere și acces la coada imprimantei.

Complexitate notabilă

PDF Auto-Print este o aplicație desktop pentru un flux operațional în care documentele PDF publicate de un endpoint trebuie preluate și tipărite pe un PC Windows fără verificare manuală repetitivă. Interfața PyQt5 centralizează adresa endpointului, intervalul de verificare, imprimanta selectată și folderul local de descărcare, iar aceste setări sunt persistate într-un fișier JSON.

Fluxul automat pornește un QTimer cu interval configurabil între 10 și 3600 de secunde. La fiecare ciclu, aplicația face un request POST către endpoint, tratează răspunsul ca listă JSON de URL-uri, descarcă documentele în folderul configurat și înregistrează fiecare URL în SQLite. Tabela locală păstrează URL-ul unic, calea fișierului, momentul descărcării, statusul de print și momentul imprimării.

Imprimarea este realizată secvențial prin SumatraPDF în mod command-line, folosind -print-to pentru imprimanta aleasă și setarea fit. Lista imprimantelor este citită din Windows prin pywin32, incluzând imprimante locale și conexiuni, iar aplicația poate deschide direct coada sistemului pentru imprimanta curentă.

Idempotency-ul este parțial și explicit la nivel de stare: URL-ul are constrângere UNIQUE, inserarea folosește INSERT OR IGNORE, iar numai rândurile cu printed=0 intră în fluxul automat de print. Dacă imprimarea eșuează, rândul rămâne neprintat și va fi încercat din nou la un ciclu ulterior. Nu există însă un job queue separat, backoff, limită de retry sau contor de încercări, iar PDF-urile sunt descărcate din nou înainte de deduplicarea din bază.

Pe lângă automatizare, UI-ul oferă un flux manual: listarea documentelor disponibile la endpoint, descărcarea și imprimarea lor cu progres vizibil, căutare după numele fișierului, selectarea rândurilor, reprintarea documentelor neprintate, schimbarea manuală a statusului, copiere din tabel și ștergerea sincronizată a fișierului local și a înregistrării din SQLite.

La pornire, aplicația reconciliază baza locală cu discul și elimină intrările ale căror fișiere nu mai există. Opțional, poate crea sau elimina un shortcut în folderul Windows Startup, astfel încât utilitarul să pornească odată cu sesiunea utilizatorului. Repository-ul include și un spec PyInstaller pentru build windowed, plus un endpoint PHP minimal folosit pentru testarea listării de PDF-uri.

Snapshotul analizat este funcțional ca utilitar desktop local, dar nu este hardenat ca agent enterprise. Endpointul configurat în repository folosește HTTP, nu există autentificare sau semnare a răspunsului, requests nu setează timeout, tipul și dimensiunea fișierelor descărcate nu sunt validate, iar page_size și orientation există în config fără să fie aplicate la comanda de print. De asemenea, două URL-uri diferite cu același nume de fișier pot indica aceeași cale locală.

Rezultate cheie

  • Aplicație desktop Windows cu configurare pentru endpoint, interval de polling, imprimantă și folder local
  • Flux automat endpoint → download PDF → persistare SQLite → imprimare silențioasă
  • Persistență locală pentru URL, cale, momentul descărcării, statusul de print și momentul imprimării
  • Deduplicarea documentelor procesate prin URL unic și selectarea automată doar a rândurilor neprintate
  • Reîncercare implicită a imprimărilor eșuate prin păstrarea statusului printed=0
  • Enumerarea imprimantelor Windows locale și conectate și deschiderea cozii imprimantei selectate
  • Flux manual pentru listarea documentelor, descărcare, print și progres
  • Istoric tabelar cu căutare, status editabil, selecție și operații de reprintare sau ștergere
  • Reconcilierea bazei SQLite cu fișierele existente pe disc la pornire și refresh
  • Pornire opțională odată cu Windows prin shortcut în Startup
  • Configurație PyInstaller pentru distribuirea aplicației fără fereastră de consolă

Proiecte asemănătoare

Vrei ceva similar?

Începe cu wizard-ul de estimare — răspunzi la câteva întrebări și primești un range de preț + timeline realist.