This package does not have an OSI-approved license. It just has one indicated in the elm.json because otherwise Elm will not let this compile.
This package is actually licensed under NPL (Nonviolent Public License) v7.
You can read more about the NPL license family here.
Convert to and from different bases of positive numbers.
Supports the following int conversions:
- base16
- base32
- base32 (RFC 4648)
- base36
- base58
- base62
- base64
- base64 (URL-safe)
Convert from decimal Ints:
> Base.fromInt b16 44000
"abe0" : String
Convert from non-decimal number strings:
> Base.toInt b36 "jeff"
Ok 905163
Convert between non-decimal number strings in one function:
> Base.convert b16 b58 "8f0ce9"
Ok "q3r8"
Get nice error messages that aren't strings in English, so you can localise failures in any language:
> Base.toInt b16 ""
Err EmptyString
> Base.toInt b16 "owo"
Err (BadChars [(0,'o'),(1,'w'),(2,'o')])
Make your own base system for conversion:
> plastic = Base.make "plastic" CaseAgnostic
> Base.fromInt plastic 4400
"liiit" : String
- This is only designed for use with positive integers such as ID numbers for content.
- This doesn't support
BigInt.
When it comes to looking for a way to shorten URL IDs by using a higher base of numbers, I was quite interested in base58.
The issue with base58 is that it was created for Bitcoin, a neo-feudalist project that wastes immense amounts of electricity and is frequently used as a currency among nazis and white supremacists.
So to avoid having to associate with Bitcoin, I made my own under a license that bitcoin enthusiasts are unlikely to want to deal with, and I threw in others as well because I can and thought it would be fun.
Use the same functions for any base type the package supports. Convert between bases without having to chain multiple functions.
I also noticed that similar packages returned errors in English strings, which makes localising errors very difficult, so this returns types instead.