Add multicombinations to Oscar

[mjrodgers]

The UI directly mirrors that of combinations, the only difference being that we get combinations with repetitions allowed.

At the moment I still need to add some tests and include documentation in the Oscar manual. But we see a nice speedup compared to the version in Experimental/LieAlgebras (which to be fair was never claiming to be optimized at all).

julia> @b collect(Oscar.multicombinations(20,7))
17.005 ms (657803 allocs: 75.279 MiB)

julia> @b collect(Oscar.LieAlgebras.multicombinations(20,7))
260.422 ms (1317337 allocs: 515.105 MiB, 31.65% gc time, without a warmup)

[lgoettgens]

Could you also please remove the implementation in Experimental/LieAlgebras and redirect all call-sites to this new implementation?

[fingolfin]

Great!

[fingolfin]

This should be hooked up into the manual, too!

We can of course merge this now and do that in a follow-up PR, but ideally that should come soon so we don't forget about it.

[codecov]

Codecov Report

❌ Patch coverage is 92.85714% with 2 lines in your changes missing coverage. Please review.
✅ Project coverage is 84.19%. Comparing base (24341a3) to head (be6453b).
⚠️ Report is 19 commits behind head on master.

Files with missing lines	Patch %	Lines
...rics/EnumerativeCombinatorics/multicombinations.jl	92.30%	2 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #5477      +/-   ##
==========================================
+ Coverage   84.05%   84.19%   +0.13%     
==========================================
  Files         730      731       +1     
  Lines       99233   101201    +1968     
==========================================
+ Hits        83412    85206    +1794     
- Misses      15821    15995     +174     

Files with missing lines	Coverage Δ
experimental/LieAlgebras/src/Combinatorics.jl	100.00% <ø> (ø)
experimental/LieAlgebras/src/LieAlgebraModule.jl	90.23% <100.00%> (ø)
...xperimental/LieAlgebras/test/Combinatorics-test.jl	92.30% <ø> (+0.64%)	⬆️
...rc/Combinatorics/EnumerativeCombinatorics/types.jl	100.00% <100.00%> (ø)
...rics/EnumerativeCombinatorics/multicombinations.jl	92.30% <92.30%> (ø)

... and 18 files with indirect coverage changes

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.