A Lua library which provides base2(bitfield), base16(hex), base32(crockford/rfc), base64(rfc/url), base85(z85) decoding and encoding.
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

README.adoc

basexx

travis

A Lua library for base2, base16, base32, base64, base85 decoding and encoding of data strings.

API

For every supported format has basexx a from and to function.

The from functions have two parameters:

  • str which represent the encoded string that should be decoded

  • ignore is an optional set of characters that should be ignored in the string, see the from_bit and from_hex examples

The from functions return a string if the string can be decoded, otherwise nil and an error message.

The to functions have just one parameter:

  • str the data string that should be encoded

The to_z85 function can return nil and an error message, all other functions return allways the encoded string.

from_bit / to_bit

Converts a byte string to a bitfield string.

  • 0, O and o maps to the same value

  • 1, I, i, L and l maps to the same value

basexx.to_bit( "ACDC" ) --> 01000001010000110100010001000011
basexx.from_bit( "01000001010000110100010001000011" ) --> ACDC
basexx.from_bit( "o1ooooo1o1oooo11" ) --> AC
basexx.from_bit( "Oioooooi Oiooooii\n", " \n" ) --> AC

from_hex / to_hex

Converts a byte string to a uppercase hex data string.

basexx.to_hex( "Hello world!" ) --> 48656C6C6F20776F726C6421
basexx.from_hex( "4865-6C6C 6F20-776F 726C-6421", "- " ) --> Hello world!
basexx.from_hex( "48656c6c6f20776f726c6421" ) --> Hello world!

from_base32 / to_base32

Converts a byte string to a base32(_rfc3548) uppercase data string.

  • It’s case insensitive

basexx.to_base32( "chunky bacon!" ) --> MNUHK3TLPEQGEYLDN5XCC===
basexx.from_base32( "MNUHK3TLPEQGEYLDN5XCC===" ) --> chunky bacon!

from_crockford / to_crockford

Converts a byte string to a base32(crockford) uppercase data string. The optional check value is not implemented.

  • It’s case insensitive

  • 1, I, i, L and l maps to the same value

  • 0, O and o maps to the same value

string.lower( basexx.to_crockford( "Hello World" ) ) --> 91jprv3f41bpywkccg
basexx.from_crockford( "axqqeb10d5t20wk5c5p6ry90exqq4tvk44" ) --> Wow, it really works!

from_base64 / to_base64

Converts a byte string to a base64 data string.

basexx.to_base64( "Man") --> TWFu
basexx.from_base64( "TWFu" ) --> Man

from_url64 / to_url64

Same as above, but uses a URL Safe base64 alphabet and no padding.

from_z85 / to_z85

Converts a byte string to a base85(ZeroMQ) data string. to_z85 expects only a binary string that length is divisible by 4 with no remainder, and from_z85 expects only printable a string that length is divisible by 5 with no remainder.

basexx.to_z85( "1234" ) --> f!$Kw
basexx.from_z85( "f!$Kw" ) --> 1234

Installation

To install the version 0.4.0 of basexx use LuaRocks with the following line.

luarocks install basexx

If you want to use the current development version, clone this repository and use LuaRocks with the following command.

luarocks make dist/basexx-scm-0.rockspec