Add Admin::Accounts methods

[PattaFeuFeu]

Description

This PR implements the methods available via the Admin::Accounts endpoints. Despite the branch saying part-1, this actually implements all of them. After having started, I no longer even checked which ones were part of the ticket.

Warning

I have not implemented the v1 variant as it’s due for removal next year anyway.

Note

Mastodon API documentation examples still contain ip as an object instead of a String. I have decided to implement AdminAccount by how it’s defined in the Admin::Account documentation instead.

Closes #323, closes #324.

Type of Change

• New feature
• Documentation

Breaking Changes

• None.

How Has This Been Tested?

New unit tests for all methods added including their optional parameter variants

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 checks

• 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

Attention: 128 lines in your changes are missing coverage. Please review.

Comparison is base (6960044) 50.01% compared to head (c6e765d) 49.84%.

Additional details and impacted files

@@             Coverage Diff              @@
##             master     #404      +/-   ##
============================================
- Coverage     50.01%   49.84%   -0.17%     
- Complexity      620      661      +41     
============================================
  Files           155      162       +7     
  Lines          4243     4484     +241     
  Branches        269      284      +15     
============================================
+ Hits           2122     2235     +113     
- Misses         1885     1996     +111     
- Partials        236      253      +17     

Files	Coverage Δ
...e/src/main/kotlin/social/bigbone/MastodonClient.kt	35.29% <100.00%> (+0.16%)	⬆️
...igbone/src/main/kotlin/social/bigbone/api/Range.kt	100.00% <100.00%> (ø)
...n/social/bigbone/api/entity/admin/AccountOrigin.kt	100.00% <100.00%> (ø)
...n/social/bigbone/api/entity/admin/AccountStatus.kt	100.00% <100.00%> (ø)
...l/bigbone/api/entity/admin/ActionAgainstAccount.kt	100.00% <100.00%> (ø)
.../src/main/kotlin/social/bigbone/api/entity/Role.kt	97.50% <97.50%> (ø)
...in/social/bigbone/api/entity/admin/AdminAccount.kt	39.58% <39.58%> (ø)
...al/bigbone/api/method/admin/AdminAccountMethods.kt	55.71% <55.71%> (ø)
...n/social/bigbone/rx/admin/RxAdminAccountMethods.kt	0.00% <0.00%> (ø)

[bocops]

Code looks good, I'm fine with everything you highlighted via comment.

I'm a bit short on time, so I didn't check the new assets in detail, but assume that those were just copied from available examples and are OK.

Would it be possible to refactor the apiName definition in the enums somehow, so that we don't have to repeat them that often? Doesn't need to happen in this PR, of course, but if at all possible, a new issue could be opened for that.

[PattaFeuFeu]

@bocops Thanks! If Role is alright with you in the current state, I can use the definition of this PR and use it in #411 as well 😊

I’ll create an issue regarding apiName to check. Might be possible to have an extension function that only works on enum classes tagged with Serializable.

[PattaFeuFeu]

@bocops Created: #412