build: migrate to PEP 621-compatible pyproject.toml and restructure project

- Replaced setup.py and setup.cfg with pyproject.toml for a modern build system. Updated project structure to align with the src directory convention. Adjusted imports, examples, and documentation for the updated layout and dependency changes.

Author: alperensert

.editorconfig

@@ -0,0 +1,6 @@
+# .editorconfig
+root = true
+
+[*]
+end_of_line = lf
+insert_final_newline = true

README.md

@@ -33,7 +33,7 @@ Usage examples
 #### ImageToText
 
 ```python
-from capmonster_python import ImageToTextTask
+from src.capmonster_python import ImageToTextTask
 
 capmonster = ImageToTextTask("API_KEY")
 task_id = capmonster.create_task(image_path="img.png")
@@ -44,7 +44,7 @@ print(result.get("text"))
 #### Recaptcha v2
 
 ```python
-from capmonster_python import RecaptchaV2Task
+from src.capmonster_python import RecaptchaV2Task
 
 capmonster = RecaptchaV2Task("API_KEY")
 task_id = capmonster.create_task("website_url", "website_key")
@@ -55,7 +55,7 @@ print(result.get("gRecaptchaResponse"))
 #### Recaptcha v2 enterprise
 
 ```python
-from capmonster_python import RecaptchaV2EnterpriseTask
+from src.capmonster_python import RecaptchaV2EnterpriseTask
 
 capmonster = RecaptchaV2EnterpriseTask("API_KEY")
 task_id = capmonster.create_task("website_url", "website_key", {"s": "payload value"}, "api_domain")
@@ -66,7 +66,7 @@ print(result.get("gRecaptchaResponse"))
 #### GeeTest
 
 ```python
-from capmonster_python import GeeTestTask
+from src.capmonster_python import GeeTestTask
 
 capmonster = GeeTestTask("API_KEY")
 task_id = capmonster.create_task("website_url", "gt", "challenge")
@@ -79,7 +79,7 @@ print(result.get("validate"))
 #### Report incorrect captchas
 
 ```python
-from capmonster_python import RecaptchaV2Task
+from src.capmonster_python import RecaptchaV2Task
 
 capmonster = RecaptchaV2Task("API_KEY")
 task_id = capmonster.create_task("website_url", "website_key")

examples/funcaptcha_request.py

@@ -1,6 +1,8 @@
-import requests
 import re
-from capmonster_python import FuncaptchaTask
+
+import requests
+
+from src.capmonster_python import FuncaptchaTask
 
 
 class FuncaptchaRequest:
@@ -35,6 +37,7 @@ def submit_form(self):
 
 if __name__ == "__main__":
     from os import environ
+
     client_key = environ["API_KEY"]
     example_request = FuncaptchaRequest(client_key)
     assert example_request.expected in example_request.submit_form()

examples/funcaptcha_selenium.py

@@ -1,11 +1,13 @@
 import re
+from time import sleep
+
 from selenium import webdriver
-from selenium.webdriver.firefox.options import Options
 from selenium.webdriver.common.by import By
+from selenium.webdriver.firefox.options import Options
 from selenium.webdriver.firefox.service import Service
 from webdriver_manager.firefox import GeckoDriverManager
-from capmonster_python import FuncaptchaTask
-from time import sleep
+
+from src.capmonster_python import FuncaptchaTask
 
 
 class FuncaptchaSelenium:
@@ -45,6 +47,7 @@ def submit_form(self):
 
 if __name__ == "__main__":
     from os import environ
+
     client_key = environ["API_KEY"]
     headless = environ["HEADLESS"]
     environ["WDM_LOG_LEVEL"] = "0"

examples/hcaptcha_request.py

@@ -1,6 +1,7 @@
 import requests
 from bs4 import BeautifulSoup
-from capmonster_python import HCaptchaTask
+
+from src.capmonster_python import HCaptchaTask
 
 
 class HCaptchaRequest:
@@ -35,6 +36,7 @@ def submit_form(self):
 
 if __name__ == "__main__":
     from os import environ
+
     client_key = environ["API_KEY"]
     example_request = HCaptchaRequest(client_key)
     assert example_request.expected in example_request.submit_form()

examples/hcaptcha_selenium.py

@@ -1,10 +1,12 @@
+from time import sleep
+
 from selenium import webdriver
-from selenium.webdriver.firefox.options import Options
 from selenium.webdriver.common.by import By
+from selenium.webdriver.firefox.options import Options
 from selenium.webdriver.firefox.service import Service
 from webdriver_manager.firefox import GeckoDriverManager
-from capmonster_python import HCaptchaTask
-from time import sleep
+
+from src.capmonster_python import HCaptchaTask
 
 
 class HCaptchaSelenium:
@@ -43,6 +45,7 @@ def submit_form(self):
 
 if __name__ == "__main__":
     from os import environ
+
     client_key = environ["API_KEY"]
     headless = environ["HEADLESS"]
     environ["WDM_LOG_LEVEL"] = "0"

examples/imagetotext.py

@@ -1,4 +1,4 @@
-from capmonster_python import ImageToTextTask
+from src.capmonster_python import ImageToTextTask
 
 
 class TextNumericExample:
@@ -26,6 +26,7 @@ def solve_numeric(self):
 
 if __name__ == "__main__":
     from os import environ
+
     client_key = environ["API_KEY"]
     example_text_numeric = TextNumericExample(client_key)
     assert example_text_numeric.expected_1 in example_text_numeric.solve_text()

examples/recaptchav2_request.py

@@ -1,13 +1,15 @@
 import requests
 from bs4 import BeautifulSoup
-from capmonster_python import RecaptchaV2Task
+
+from src.capmonster_python import RecaptchaV2Task
 
 
 class RecaptchaRequest:
     def __init__(self, _client_key: str):
         self.captcha = RecaptchaV2Task(_client_key)
         self.s = requests.Session()
-        self.s.headers = {"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:91.0) Gecko/20100101 Firefox/91.0"}
+        self.s.headers = {
+            "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:91.0) Gecko/20100101 Firefox/91.0"}
         self.website_url = "https://google.com/recaptcha/api2/demo"
         self.expected = "Verification Success... Hooray!"
 
@@ -33,6 +35,7 @@ def submit_form(self):
 
 if __name__ == "__main__":
     from os import environ
+
     client_key = environ["API_KEY"]
     example_request = RecaptchaRequest(client_key)
     assert example_request.expected in example_request.submit_form()

examples/recaptchav2_selenium.py

@@ -1,10 +1,12 @@
+from time import sleep
+
 from selenium import webdriver
 from selenium.webdriver.common.by import By
 from selenium.webdriver.firefox.options import Options
 from selenium.webdriver.firefox.service import Service
 from webdriver_manager.firefox import GeckoDriverManager
-from capmonster_python import RecaptchaV2Task
-from time import sleep
+
+from src.capmonster_python import RecaptchaV2Task
 
 
 class RecaptchaV2Selenium:
@@ -41,6 +43,7 @@ def submit_form(self):
 
 if __name__ == "__main__":
     from os import environ
+
     client_key = environ["API_KEY"]
     headless = environ["HEADLESS"]
     environ["WDM_LOG_LEVEL"] = "0"

examples/turnstile_request.py

@@ -1,22 +1,26 @@
-import requests
 from re import search
+
+import requests
 from bs4 import BeautifulSoup
-from capmonster_python import TurnstileTask
+
+from src.capmonster_python import TurnstileTask
 
 
 class TurnstileRequest:
     def __init__(self, _client_key: str):
         self.captcha = TurnstileTask(_client_key)
         self.s = requests.Session()
-        self.s.headers = {"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:91.0) Gecko/20100101 Firefox/91.0"}
+        self.s.headers = {
+            "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:91.0) Gecko/20100101 Firefox/91.0"}
         self.website_url = "http://tsmanaged.zlsupport.com"
         self.expected = 'Success!'
 
     def _form_html(self):
         return self.s.get(self.website_url).text
 
     def _site_token(self):
-        site_key = search(r"sitekey: '(.+?)'", BeautifulSoup(self._form_html(), "html.parser").find_all("script")[1].text).group(1)
+        site_key = search(r"sitekey: '(.+?)'",
+                          BeautifulSoup(self._form_html(), "html.parser").find_all("script")[1].text).group(1)
         print("# Site key found: {}".format(site_key))
         task_id = self.captcha.create_task(website_url=self.website_url, website_key=site_key)
         print("# Task created successfully")
@@ -31,14 +35,14 @@ def submit_form(self):
             'password': 'test',
             'token': result,
         }
-        response = self.s.post(self.website_url+'/send', data=data, headers=self.s.headers, verify=False)
+        response = self.s.post(self.website_url + '/send', data=data, headers=self.s.headers, verify=False)
         return BeautifulSoup(response.text, "html.parser").title.string
 
 
 if __name__ == "__main__":
     from os import environ
+
     client_key = environ["API_KEY"]
     example_request = TurnstileRequest(client_key)
     assert example_request.expected in example_request.submit_form()
     print("# Submit succeed, test is OK")
-