qrbill 1.1.0

Python库，用于生成瑞士QR-bill

从2020年开始，瑞士支付单据将逐步转换为QR-bill格式。规范可以在https://www.paymentstandards.ch/找到

该库旨在生成正确格式的QR-bill作为SVG文件，可以从命令行输入或使用QRBill类。

安装

您可以使用以下命令轻松安装此库

$ pip install qrbill

命令行使用示例

最小化

$ qrbill --account "CH5800791123000889012" --creditor-name "John Doe"
  --creditor-postalcode 2501 --creditor-city "Biel"

更完整

$ qrbill --account "CH44 3199 9123 0008 8901 2" --reference-number "210000000003139471430009017"
--creditor-name "Robert Schneider AG" --creditor-street "Rue du Lac 1268"
--creditor-postalcode "2501" --creditor-city "Biel"
--additional-information "Bill No. 3139 for garden work and disposal of cuttings."
--debtor-name "Pia Rutschmann" --debtor-street "Marktgasse 28" --debtor-postalcode "9400"
--debtor-city "Rorschach" --language "de"

使用方法

$ qrbill -h

如果未指定–output SVG文件路径，SVG文件将使用账户名称和当前日期/时间命名，并写入当前目录。

请注意，如果您不喜欢某些地址的读数部分自动换行，您可以在债权人或债务人的名称、行1、行2或街道中用换行序列替换空格，以强制在打印的地址中换行。（例如：–creditor-street “Rue des Quatorze Contours du Cheminndu Creux du Van”）二维码账单中编码的数据不会包含换行字符。它将被常规空格替换。

Python使用示例

>>> from qrbill import QRBill
>>> my_bill = QRBill(
        account='CH5800791123000889012',
        creditor={
            'name': 'Jane', 'pcode': '1000', 'city': 'Lausanne', 'country': 'CH',
        },
        amount='22.45',
    )
>>> my_bill.as_svg('/tmp/my_bill.svg')

输出PDF或位图

如果您想生成结果的账单的PDF版本，我们建议使用svglib <https://pypi.ac.cn/project/svglib/>库。它可以用svg2pdf脚本在命令行上使用，或直接从Python使用

>>> import tempfile
>>> from qrbill import QRBill
>>> from svglib.svglib import svg2rlg
>>> from reportlab.graphics import renderPDF

>>> my_bill = QRBill(
        account='CH5800791123000889012',
        creditor={
            'name': 'Jane', 'pcode': '1000', 'city': 'Lausanne', 'country': 'CH',
        },
        amount='22.45',
    )
>>> with tempfile.TemporaryFile(encoding='utf-8', mode='r+') as temp:
>>>     my_bill.as_svg(temp)
>>>     temp.seek(0)
>>>     drawing = svg2rlg(temp)
>>> renderPDF.drawToFile(drawing, "file.pdf")

或生成位图图像输出

>>> from reportlab.graphics import renderPM
>>> dpi = 300
>>> drawing.scale(dpi/72, dpi/72)
>>> renderPM.drawToFile(drawing, "file.png", fmt='PNG', dpi=dpi)

运行测试

您可以通过以下方式运行测试

$ python tests/test_qrbill.py

或

$ python setup.py test

赞助商

变更日志