feat(taps): Implement reference paginators

[edgarrmondragon]

Docs: https://meltano-sdk--732.org.readthedocs.build/en/732

Closes #316

[aaronsteers]

@edgarrmondragon - This is so cool!

My comments are only cosmetic, more about getting this ready for a prod release.

I think it's worth discussing if we should warn (as you have it) or just fail if they are using the legacy approach. And if we fail, would be nice to do so in a unit test (nested in get_standard_tests or similar) rather than at runtime. 😄

[codecov-commenter]

Codecov Report

Merging #732 (0b6b143) into main (e84036b) will increase coverage by 0.58%.
The diff coverage is 98.01%.

@@            Coverage Diff             @@
##             main     #732      +/-   ##
==========================================
+ Coverage   80.68%   81.27%   +0.58%     
==========================================
  Files          35       36       +1     
  Lines        3480     3520      +40     
  Branches      692      706      +14     
==========================================
+ Hits         2808     2861      +53     
+ Misses        499      486      -13     
  Partials      173      173              

Impacted Files	Coverage Δ
singer_sdk/streams/rest.py	82.58% <83.33%> (-0.03%)	⬇️
singer_sdk/pagination.py	100.00% <100.00%> (ø)
singer_sdk/mapper_base.py	55.55% <0.00%> (-2.03%)	⬇️
singer_sdk/mapper.py	84.23% <0.00%> (-0.35%)	⬇️
singer_sdk/sinks/core.py	78.74% <0.00%> (-0.05%)	⬇️
singer_sdk/streams/core.py	81.37% <0.00%> (+0.11%)	⬆️
singer_sdk/sinks/record.py	76.92% <0.00%> (+1.92%)	⬆️
singer_sdk/io_base.py	77.77% <0.00%> (+2.02%)	⬆️
singer_sdk/sinks/batch.py	100.00% <0.00%> (+5.00%)	⬆️

📣 We’re building smart automated test selection to slash your CI/CD build times. Learn more

[aaronsteers]

Nice work, @edgarrmondragon !

Just one small question (nit).

[edgarrmondragon]

I think it's worth discussing if we should warn (as you have it) or just fail if they are using the legacy approach. And if we fail, would be nice to do so in a unit test (nested in get_standard_tests or similar) rather than at runtime. 😄

@aaronsteers I think we could warn that it will fail in the future. Wdyt?