jhn_stdlib (γ)

A few thought experiments solidified as code.

• Introduction
• Features/Modules
• Build
• Install
• Contribute - Read if you're planning to submit patches

Introduction

This library consists mainly of code that arose out of my curiosity, either about Erlang and coding in general or concerning a pericular protocol or technique. So there is little of cohesion in purposes between the different library modules. But having published these I will continue to support these since the road to enlightenment is one without terminus.

Features/Modules

• String Processing Functions for binary encoded strings
  • blist -- drop in replacement for the lists module in stdlib
  • bstring -- drop in replacement for the string module in stdlib
  • mustache -- Mustache template rendering
• Protocols
  • Encoding/decoding JSON/Erlang -- json rfc4627, rfc7159
  • Encoding/decoding stream JSON/Erlang -- jstream rfc7159
  • Encoding/decoding/evaluation JSON Pointer/Erlang -- json rfc6901
  • Validation JSON schema -- json draft-zyp-json-schema-04, draft-fge-json-schema-validation-00
  • MessagePack -- msgpack MessagePack/Erlang
  • Bencoding -- bencoding
  • Encoding/decoding Syslog/Erlang -- syslog rfc5424, rfc5427, rfc6012
  • Consistent Hashing -- jhn_chash J. Lamping, Eric Veach
• Standards
  • Encoding/decoding URI/Erlang -- uri rfc3986
  • Encoding/decoding IP addresses/Erlang -- ip_addr rfc4291, rfc5952, rfc4632
  • Generating/encoding/decoding Timestamps Posix/Erlang -- timestamp rfc3339
• Clients
  • A simple HTTP client -- shttpc rfc7230, rfc7231, rfc7538, rfc5789, rfc2818
  • Server/client for Syslog -- syslog rfc5425, rfc5426, rfc6587
• Pull oriented data source abstraction
  • lazy -- abstracts different data sources as uniform lazy data
• Data structures
  • Bloom filters -- bloom
  • Property lists -- plist
  • Prefix trees -- p_tree
  • Binary(UTF-8) Prefix trees -- pb_tree
  • Range trees -- r_tree
  • T-trees -- t_tree
• Algorithms
  • Levenshtein distance -- levenshtein

Build

jhn_stdlib requires rebar to build, but provides make support to download and install rebar. To build jhn_stdlib, go to the jhn_stdlib directory and type:

make

To make sure jhn_stdlib works on your platform, run the tests:

make test

Two things might seem alarming when running the tests:

1. Warnings emitted by cover
2. En exception printed by SASL

Both are expected due to the way Erlang currently prints errors. The important line you should look for is All XX tests passed, if that appears all is correct.

Install

If you want to install your own built version of jhn_stdlib add the ebin directory to your Erlang code path or move the jhn_stdlib folder into your release folder and make sure that folder is in your ERL_LIBS environment variable.

Contribute

Should you find yourself using jhn_stdlib and have issues, comments or feedback please [create an issue here on GitHub.] 2

Patches are greatly appreciated, but since these libraries reflect my learning process and I have rather peculiar notions of code hygiene I may do extensive rewrites that does not in any way diminish the appreciation I feel or indeed [express.] 3

For a much nicer history, please write good commit messages. I know I really should.