grski

Są święta, zatem w grafiku grskiego pojawiło się nieco więcej czasu, co pozwoliło mi na dokończenie małego projekciku.
Tak powstała brena - generator faktur z poziomu CLI.

Od lat jestem na b2b, korzystałem z różnych programów do wystawiania faktur, większość z nich jest fajna i całkiem przyjemna, ale mają minusy typu potrzeba zakładania konta, zbieranie moich danych i faktur, które kto wie jak przechowują, co z nimi robią (foliowa czapeczka here) i tak dalej. Do tego wszystko trzeba wyklikiwać w przeglądarce a ja bardziej terminalowy chłopak jestem.

Zatem mając wolny dzień przysiadłem i tak oto w kilka godzin zrodziło się to, co dziś wam prezentuję. Całe 221 linijek kodu w Pythonie.
Jak to działa?

1. definiujemy plik brena.toml według wskazań z dokumentacji - tam znajdują się nasze faktury, informacje o firmie/kontrahentach
2. instalujemy paczkę pip install brena
3. w katalogu gdzie mamy zdefiniowany plik brena.toml wpisuje brena, żeby wygenerować wszystkie faktury, lub brena InvoiceCode1 invcoide2 żeby wygenerować tylko faktury o określonym numerze

Jest też opcja druga dla tych, którzy nie mają najnowszego pythona lub nie chcą instalować ciężkich zależności weasyprinta, bo potrafi z nim być czasem problem, alternatywa w postaci dockera. Tutaj droga wygląda tak:

1. definiujemy plik brena.toml
2. docker run -v `readlink -f .`:/app/ grski/brena
   lub jeśli nie mamy readlinka:
3. docker run -v /home/grski/directorywherebrenatomlis/:/app/ grski/brena
   ewentualnie:
   1.docker run -v /home/grski/directorywherebrenatomlis/:/app/ grski/brena sh -c "python -m brena somecode1 somecode2"

I gotowe.
Brena bazuje na
toml, weasyprint i jinja2.

TOMLa używam do konfiguracji. Dlaczego nie yaml albo coś innego? Tak po prostu. Obsługę innych konfiguracji dodam kiedy indziej, być może.
jinja wzbogaca nasz html template dokonując odpowiednich podstawień.
weasyprint renderuje template html do pdf.

Do CLI użyłem typer piękna libka, podobna do fastapi i bazująca na typehintingu <3

Jako formater wiadomo - jedyny prawilny black, do porządkowania importów isort, tu i ówdzie przyda się też
flake8 no i autoflake a no i bandit żeby skanować potencjalne głupie gafy security.

Do tego bumpversion, żeby releasowanie było przyjemniejsze i bardziej automatyczne.

Na sam koniec poetry <- zarządzanie zależnościami jak i publikowanie paczek.

Całość spiąłem sobie w github action, żeby mieć automatyczny deploy paczki na pypi i sprawdzanie formatowania i takich tam pierdółek.
Testów brak póki co.

Brena wspiera obecnie wystawianie faktur po polsku, angielsku jak i dwujęzycznych.
Wkrótcę dodam automatyczne generowanie przeliczeń dla faktur w walutach obcych wg kursu nbp.

W przyszłości będę chciał potencjalnie wyciągnąć weasyprinta z zależności, może zrobić z tego jakiś serwisik api albo coś, dodać przechowywanie zaszyfrowanej faktury w chmurze, taaakie różne duperele. Póki co jest to bardzo szybki i prosty PoC zrobiony dla mojej wygody.

W załączniku dodałem przykład wygenerowanej faktury.