Popularity
4.0
Growing
Activity
0.8
-
7
3
1

Programming language: Crystal
Tags: Converters    
Latest version: v0.1.2

base62.cr alternatives and similar shards

Based on the "Converters" category

Do you think we are missing an alternative of base62.cr or a related project?

Add another 'Converters' Shard

README

Base62.cr Build Status Releases License

Crystal shard for Base62 encoding/decoding. It's especially useful for converting data into shortened strings suitable for URL shortening and/or obfuscating auto-incrementing resource ids from being exposed through RESTful APIs.

What is Base62 encoding?

Base62 encoding converts numbers to ASCII strings (0-9, a-z and A-Z) and vice versa, which typically results in comparatively short strings. Such identifiers also tend to be more readily identifiable by humans.

Installation

Add this to your application's shard.yml:

dependencies:
  base62:
    github: Sija/base62.cr

Usage

require "base62"

Base62.encode(999)  # => "G7"
Base62.decode("G7") # => 999

This uses the default ASCII character set for encoding/decoding.

It's also possible to define a custom character set instead:

charset = "~9876543210ABCDEFGHIJKLMNOPQRSTU$#@%!abcdefghijklmnopqrstuvw-="

Base62.encode(999, charset)  # => "F3"
Base62.decode("F3", charset) # => 999

Note that charset typically expects the respective string to contain exactly 62 unique character. In fact, it's also possible to use characters sets with more than 62 characters in order to achieve shorter identifiers for large numbers.

Contributing

  1. Fork it (https://github.com/Sija/base62.cr/fork)
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

Contributors

  • @Sija Sijawusz Pur Rahnama - creator, maintainer


*Note that all licence references and agreements mentioned in the base62.cr README section above are relevant to that project's source code only.