txt: ## dist_zef-JRaspass-TOML-Thumb.md
  # TOML::Thumb
  
  [![pipeline](https://gitlab.com/JRaspass/toml-thumb/badges/master/pipeline.svg)](https://gitlab.com/JRaspass/toml-thumb/commits/master)
  
  In English folklore, [Tom Thumb](https://en.wikipedia.org/wiki/Tom_Thumb) was a diminutive man. TOML::Thumb is a
  diminutive TOML (de)serializer.
  
  It aims to fully support [TOML v1.0.0](https://toml.io).
  
  **Note until the full test suite passes this module will remain pre 1.0 and
  breaking changes are to be expected.**
  
  ## SYNOPSIS
  
  ```
  use TOML::Thumb;
  
  my %config = 'config.toml'.IO.&from-toml;
  
  spurt 'config.toml', to-toml %config;
  
  ```
  
  ## SUBROUTINES
  
  ### from-toml
  
  ```
  multi sub from-toml(IO  $toml)
  multi sub from-toml(Str $toml)
  
  ```
  
  ### to-toml
  
  ```
  sub to-toml(%hash)
  
  ```
  
  ## PERFORMANCE
  
  Testing the large TOML file from [CPAN Rocks](https://cpan.rocks).
  
  ```
  $ ls -hs dists.toml; wc -l $_
  4.1M dists.toml
  282687 dists.toml
  
  ```
  
  ```
  $ time raku -MTOML::Thumb -e 'from-toml slurp "dists.toml"'
  
  real    0m15.926s
  user    0m15.814s
  sys     0m0.210s
  
  $ time raku -MConfig::TOML -e 'from-toml slurp "dists.toml"'
  
  real    186m51.735s
  user    186m22.130s
  sys     0m11.225s
  
  ```
  
  ```
  $ raku -v
  This is Rakudo version 2020.02 built on MoarVM version 2020.02
  implementing Raku 6.d.
  
  $ lscpu | sed -nr '/Model name/ s/.*: +//p'
  Intel(R) Core(TM) i7-8700 CPU @ 3.20GHz
  
  ```
  
  ## SEE ALSO
  
  * [Config::TOML](https://raku.land/github:atweiden/Config::TOML)
  * [TOML](https://raku.land/zef:tony-o/TOML)
  