Text mark

[mwaskom]

A new mark that shows text at x/y locations, with various other properties:

(
    so.Plot(glue, "Average", "Model", text="Average")
    .add(so.Bar())
    .add(so.Text(halign="right", color="w"))
)

Current properties:

Init signature:
so.Text(
    artist_kws: 'dict' = <factory>,
    text: 'MappableString' = <''>,
    color: 'MappableColor' = <'k'>,
    alpha: 'MappableFloat' = <1>,
    fontsize: 'MappableFloat' = <rc:font.size>,
    halign: 'MappableString' = <'center'>,
    valign: 'MappableString' = <'center_baseline'>,
    offset: 'MappableFloat' = <4>,
) -> None

Note: this is somewhat limited in usefulness at the moment due to #3053; it's not possible to annotate using the result of a statistical transform. But that needs an upstream solution, I think.

To do:

• Docstring w/ examples
• Documentation of new properties
• Unit tests
• Decide on whether we'll have a formatting property (no, at least for now)
• Allow marks to not have a legend artist

[codecov]

Codecov Report

Merging #3051 (36a2091) into master (ad11bdc) will increase coverage by 0.06%.
The diff coverage is 100.00%.

❗ Current head 36a2091 differs from pull request most recent head 3ea116e. Consider uploading reports for the commit 3ea116e to get more accurate results

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #3051      +/-   ##
==========================================
+ Coverage   98.30%   98.36%   +0.06%     
==========================================
  Files          69       72       +3     
  Lines       23281    23453     +172     
==========================================
+ Hits        22886    23070     +184     
+ Misses        395      383      -12     

Impacted Files	Coverage Δ
seaborn/_core/plot.py	99.18% <100.00%> (+<0.01%)	⬆️
seaborn/_core/properties.py	99.19% <100.00%> (+0.04%)	⬆️
seaborn/_marks/base.py	98.40% <100.00%> (+0.01%)	⬆️
seaborn/_marks/text.py	100.00% <100.00%> (ø)
seaborn/objects.py	100.00% <100.00%> (+100.00%)	⬆️
tests/_core/test_plot.py	98.63% <100.00%> (+<0.01%)	⬆️
tests/_marks/test_text.py	100.00% <100.00%> (ø)
tests/test_objects.py	100.00% <100.00%> (ø)