Fix metrics examples, add average precision metric

[amrit110]

PR Type ([Feature | Fix | Documentation | Test])

Feature, Documentation

Short Description

• Add Average Precision (also known as AUPRC) support for the binary case to metrics package
• Fix examples section in docstrings of evaluate package
• Add doctest to pre-commit and hence to the test suite to check if docstring examples are working correctly

Tests Added

• tests/cyclops/evaluate/metrics/test_average_precision.py

[codecov]

Codecov Report

Merging #522 (de3cf07) into main (49b7fd8) will increase coverage by 0.06%.
The diff coverage is 69.64%.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #522      +/-   ##
==========================================
+ Coverage   64.80%   64.86%   +0.06%     
==========================================
  Files          93       95       +2     
  Lines        9231     9270      +39     
==========================================
+ Hits         5982     6013      +31     
- Misses       3249     3257       +8     

Files	Coverage Δ
cyclops/evaluate/metrics/accuracy.py	97.91% <ø> (ø)
cyclops/evaluate/metrics/auroc.py	92.15% <ø> (ø)
.../evaluate/metrics/experimental/confusion_matrix.py	98.83% <100.00%> (ø)
.../metrics/experimental/distributed_backends/base.py	88.46% <100.00%> (ø)
...etrics/experimental/distributed_backends/mpi4py.py	36.73% <100.00%> (ø)
...etrics/experimental/functional/confusion_matrix.py	89.47% <100.00%> (ø)
cyclops/evaluate/metrics/experimental/metric.py	82.92% <100.00%> (ø)
cyclops/evaluate/metrics/experimental/utils/ops.py	70.31% <100.00%> (ø)
...clops/evaluate/metrics/experimental/utils/types.py	85.71% <ø> (ø)
.../evaluate/metrics/experimental/utils/validation.py	84.44% <100.00%> (ø)
... and 19 more

[fcogidi]

Looks good.

doctest is quite helpful.