puid

# Changelog

## v2.0.0 (2022-06-30)

### Added

- ASCII encoding optimization
    - Use cross-product character pairs to encode larger bit chunks
    - Encode remaining bits via single character strategy
- Unicode and/or ASCII-Uncode mix encoding optimization
    - Encode bits via single character strategy
- Optimize bit filtering in selection of random indexes
    - Minimize bit shifting for out-of-range index slices
- Store unused source entropy bits between `puid` generation calls per `Puid` module
- Speed and efficiency are independent of pre-defined vs custom characters, including Unicode
- Simplify module creation API
    - `chars` option can be a pre-defined atom, a string or a charlist
- Pre-defined :symbol characters
- Add chi square tests of random ID character histograms
- CHANGELOG

### Changes
- Remove `CryptoRand` dependency
    - Functionality superceded by new, in-project optimizations
- Update timing tests
- README

### Breaking Changes

- Reverse argument order for `Puid.Entropy` helper functions
    - Allows idiomatic Elixir use. Note these functions are rarely used directly.

### Removed 

- Deprecated functions
    - `Puid.Entropy.bits_for_length/2`
    - `Puid.Entropy.bits_for_length!/2`
- `charset` option for pre-defined characters
    - Use the `chars` option instead
- Pre-defined `printable_ascii`
    - Replaced by `safe_ascii` (no backslash, backtick, single-quote or double-quote)

## v1.1.2 (2021-09-15)

### Added

- Resolve Elixir 1.11 compilation warnings

### Changes
- Project file structure

### Fixes
- Correct `Error.reason()` in function specs 


## v1.1.1 (2020-01-15)

### Deprecated

  - `Puid.Entropy.bits_for_length/2`
  - `Puid.Entropy.bits_for_length!/2`


## v1.1.0 (2020-01-14)

### Added

- Refactor
    - `Puid.Entropy.bits_for_length/2` -> `Puid.Entropy.bits_for_len/2`
    - `Puid.Entropy.bits_for_length!/2` -> `Puid.Entropy.bits_for_len!/2`

### Changes

- Timing tests
- README


## v1.0.0 (2019-05-02)

Initial release