1
mirror of https://gitlab.com/jessieh/qrprinter.git synced 2024-12-03 11:01:45 +00:00
LuaJIT library facilitating easy encoding and printing of strings as QR codes
Go to file
2021-12-11 20:39:46 -05:00
bin Move Fennel binary 2021-10-07 15:58:40 -04:00
rockspec Add .rockspec for 1.0-1 2021-10-07 15:59:35 -04:00
src Fix segfault when encoding 0-length string 2021-12-11 20:39:46 -05:00
.gitignore Update .gitignore 2021-10-07 16:18:19 -04:00
LICENSE Initial commit 2021-10-07 01:55:46 -04:00
Makefile Update clean recipe in Makefile 2021-10-07 16:19:25 -04:00
README.md Update README.md 2021-10-07 16:18:33 -04:00

qrprinter

A wrapper for libqrencode that provides an easy way of encoding and printing strings as QR codes from Lua.

Written in Fennel.

Installation

Install dependencies:

# Debian/Ubuntu:
apt install libqrencode-dev

# Alpine:
apk add gcompat libqrencode-dev

Install with luarocks:

luarocks install qrprinter

For a list of available versions, see the luarocks module page.

Example Usage

Documentation

Encoding

qrprinter.encode_string

qrprinter.encode_string( string )

Encodes string into a table representing a QR code.
Returns a two-dimensional sequential table of true/false values representing black/white QR modules.

Printing

All print functions accept an optional table options that may contain two keys:

  • invert: If non-nil, the output colors will be inverted
  • padding: Number of blanks cells to print around the QR code (default 2)

qrprinter.print_qr

qrprinter.print_qr( qr, [options] )

Print qr to stdout using ANSI escape sequences.
Alias of qrprinter.print_qr_ansi.

qrprinter.print_qr_ascii

qrprinter.print_qr_ascii( qr, [options] )

Print qr to stdout using ASCII characters.

qrprinter.print_qr_ansi

qrprinter.print_qr_ansi( qr, [options] )

Print qr to stdout using ANSI escape sequences.

qrprinter.print_qr_utf8

qrprinter.print_qr_utf8( qr, [options] )

Print qr to stdout using UTF8 block elements.