Feature: Opt-in 2Captcha integration for Amazon WAF Captcha Challenges

[blytheaw]

Description

PR adds opt-in support for using 2captcha.com to solve Amazon WAF interactive/javascript challenges. Users only need to configure two new optional settings, the name of the service (2captcha) and their api key.

The solution is meant to be expandable to more services, such as Anti-Captcha. I tried implementing Anti-Captcha support as well but ran into issues despite the API being nearly identical. I abandoned that to propose this solution and get feedback.

Fixes #45

Type of Change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• This change requires a schema change
• This change requires a documentation update

Testing Done

I have tested with my own account credentials and have been able to successfully retrieve orders/transactions after bypassing an Amazon WAF captcha challenge. Previously I could never get past this, even with the suggestions in this library's troubleshooting steps.

• tests/unit/test_captcha.py added with unit tests for new functionality
• Tested that if user configures optional service but doesn't have 2captcha-python installed, they receive an error message indicating they need to install the 2captcha python library
• If user doesn't configure optional service, 2captcha-python library is not required (optional dependency lazy loaded)

Checklist

• I have added tests that prove my change works as expected, and make test passes with no new errors or warnings
• I have run make check to ensure no new errors or warnings
• I have updated the docs, if applicable, and run make docs to ensure no new errors or warnings
• I have performed a self-review of my own code
• I have commented my code in particularly hard-to-understand areas

[github-actions]

This PR is stale because it has remained open with no further activity on it. If is is still being actively worked by you, label it as "wip", otherwise it will be closed automatically. Thank you for your contribution!