Implement Trends API

[PattaFeuFeu]

Description

Implements the Trends API methods to

• View trending tags
• View trending statuses
• View trending links

Note

The TrendsLink returned by getTrendingLinks is an almost 1:1 copy of PreviewCard, except with nullability and null defaults instead of empty Strings, and with the additional (reused) History type.
I didn’t know how better to implement it without adding dependencies on other classes that could hurt us down the way, so I rather duplicated what we had instead.

Closes #297

Type of Change

• New feature
• Documentation

Breaking Changes

• None

How Has This Been Tested?

I’ve added new unit tests for both the happy path where we then parse the examples given in the documentation, as well as for the unhappy path for our client-side input validation for the limit parameter.

Mandatory Checklist

• I ran gradle check and there were no errors reported
• I have performed a self-review of my code
• I have added tests that prove my fix is effective or that my feature works
• All tests pass locally with my changes
• I have added KDoc documentation to all public methods

Optional Things To Check

The items below are some more things to check before asking other people to review your code.

• In case you worked on a new feature: Did you also implement the reactive endpoint (bigbone-rx)?
• In case you added new *Methods classes: Did you also reference it in the MastodonClient main class?
• Did you also update the documentation in the /docs folder (e.g. API Coverage page)?

[codecov]

Codecov Report

Merging #360 (77c561c) into master (c6d650e) will increase coverage by 0.12%.
The diff coverage is 53.48%.

Additional details and impacted files

@@             Coverage Diff              @@
##             master     #360      +/-   ##
============================================
+ Coverage     48.08%   48.20%   +0.12%     
- Complexity      496      522      +26     
============================================
  Files           137      140       +3     
  Lines          3704     3790      +86     
  Branches        243      246       +3     
============================================
+ Hits           1781     1827      +46     
- Misses         1733     1769      +36     
- Partials        190      194       +4     

Files	Coverage Δ
...e/src/main/kotlin/social/bigbone/MastodonClient.kt	43.75% <100.00%> (+0.18%)	⬆️
...n/kotlin/social/bigbone/api/entity/data/History.kt	44.44% <ø> (ø)
...n/kotlin/social/bigbone/api/method/TrendMethods.kt	90.62% <90.62%> (ø)
...ain/kotlin/social/bigbone/api/entity/TrendsLink.kt	48.48% <48.48%> (ø)
...rc/main/kotlin/social/bigbone/rx/RxTrendMethods.kt	0.00% <0.00%> (ø)

[bocops]

Looks good, and works well in practice after some testing on my instance.

I've left one comment regarding our client-side checking of the limit parameter. These checks could be removed while we discuss in #293, but I could also live with this going through for the time being. :)