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

• Allow registry to register aliases with function
• Test new package
• 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

• I have read the CONTRIBUTING.md document.
• My code follows the code style of this project.
• I have added tests to cover my changes.
• All new and existing tests passed.
• I have updated the documentation accordingly.
• 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]

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 ⚠️
registry/backward/backward.go	84.6%	2 Missing ⚠️
registry/checksum/checksum.go	84.6%	2 Missing ⚠️
registry/conversion/conversion.go	90.0%	2 Missing ⚠️
registry/encoding/encoding.go	92.0%	2 Missing ⚠️
registry/env/env.go	81.8%	2 Missing ⚠️
registry/filesystem/filesystem.go	89.4%	2 Missing ⚠️
registry/maps/maps.go	91.6%	2 Missing ⚠️
registry/numeric/numeric.go	93.1%	2 Missing ⚠️
registry/random/random.go	88.8%	2 Missing ⚠️
... 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