feat: implement registry system (alias: loader)

[42atomys]

Description

Following the discussion about function loading in #31, this huge refactor implement each method behind multiples registries.

[!WARNING] This pull request are in progress, somes tests must be done before allowing it to be merge and release. Each feedback are welcome !

TODO

• [x] Allow registry to register aliases with function
• [x] Test new package
• [x] Provide detailed documentation for each module and glossary for handler and registry (WIP but available here)

Changes

• Create the Handler and Registry interface
• Define the rules of a registry
• Add a Readme about how to create a registry
• Migrate all existing functions into separated registry
• Backward compatibility function FuncsMap register all registry by default

Fixes #10

Checklist

• [x] I have read the CONTRIBUTING.md document.
• [x] My code follows the code style of this project.
• [x] I have added tests to cover my changes.
• [x] All new and existing tests passed.
• [x] I have updated the documentation accordingly.
• [x] This change requires a change to the documentation on the website.

Additional Information

This update following the discussions #31

[42atomys]

First self feedback: allow registry to register aliases with functions

[42atomys]

Second step :

• test new package
• provide detailled documentation for each module and glossary for handler and registry

[42atomys]

Currently start the last step :

• Write a detailed documentation for each registry, a getting started and explanations for handler and registry, this will be a huge work to import it on Gitbook. The in progress documentation are available here.

🎉 This pull request are done in case of functionalities and tests. This will be merged soon as the documentation are ready too

[42atomys]

Hi @ccoVeille, thanks for your contribution in reviewing this big PR 💜

According to multiple comments on the crypto package, this package was backported from sprig and will be dropped in a few versions due to significant security issues.

I've been focusing on rewriting and enhancing other registries, so I haven't made any changes to this one.

[ccoVeille]

Old code is not funny. Noted

[caarlos0]

it looks really good! I liked the registry idea, and the implementation looks good!

lgtm!

[42atomys]

Thanks @ccoVeille and @caarlos0 for your time and your contribution to reviewing this next step of Sprout 🌱 💜

[codecov[bot]]

Codecov Report

Attention: Patch coverage is 96.87500% with 39 lines in your changes missing coverage. Please review.

Files	Patch %	Lines
registry/backward/functions.go	90.4%	2 Missing and 2 partials :warning:
registry/backward/backward.go	84.6%	2 Missing :warning:
registry/checksum/checksum.go	84.6%	2 Missing :warning:
registry/conversion/conversion.go	90.0%	2 Missing :warning:
registry/encoding/encoding.go	92.0%	2 Missing :warning:
registry/env/env.go	81.8%	2 Missing :warning:
registry/filesystem/filesystem.go	89.4%	2 Missing :warning:
registry/maps/maps.go	91.6%	2 Missing :warning:
registry/numeric/numeric.go	93.1%	2 Missing :warning:
registry/random/random.go	88.8%	2 Missing :warning:
... and 9 more

Files	Coverage Δ
alias.go	100.0% <100.0%> (ø)
error.go	100.0% <100.0%> (ø)
handler.go	100.0% <100.0%> (ø)
internal/helpers/helpers.go	100.0% <100.0%> (ø)
pesticide/rand_test_helpers.go	100.0% <100.0%> (ø)
pesticide/test_helpers.go	100.0% <100.0%> (ø)
registry.go	100.0% <100.0%> (ø)
registry/checksum/functions.go	100.0% <100.0%> (ø)
registry/conversion/functions.go	100.0% <100.0%> (ø)
registry/encoding/functions.go	95.8% <100.0%> (ø)
... and 39 more