sharkeyes-lib 1.0.0__py3-none-any.whl

sharkeyes_lib/__init__.py

@@ -0,0 +1,4 @@
+from .sharkeyes import configure, verify
+
+# Явно указываем, что доступно для импорта извне
+__all__ = ['configure', 'verify']

sharkeyes_lib/sharkeyes.py

@@ -0,0 +1,69 @@
+import logging
+
+logger = logging.getLogger(__name__)
+
+_API_KEY: str = ""
+_URL: str = "https://api.sharkeyes.dev/api/v2/server-verify"
+_TIMEOUT: float = 5.0
+
+
+def configure(api_key: str, url: str = None, timeout: float = None):
+    global _API_KEY, _URL, _TIMEOUT
+    _API_KEY = api_key
+    if url:
+        _URL = url
+    if timeout:
+        _TIMEOUT = timeout
+
+
+
+def _extract_ip(request):
+    if hasattr(request, 'META'):
+        x_ff = request.META.get('HTTP_X_FORWARDED_FOR')
+        if x_ff:
+            return x_ff.split(',')[0].strip()
+        return request.META.get('REMOTE_ADDR')
+    if hasattr(request, 'headers'):
+        x_ff = request.headers.get('x-forwarded-for')
+        if x_ff:
+            return x_ff.split(',')[0].strip()
+        if hasattr(request, 'client') and request.client:
+            return request.client.host
+    return "127.0.0.1"
+    
+
+def verify(token: str, request_obj) -> tuple:
+
+    if not _API_KEY:
+        raise RuntimeError("First, call sharkeyes.configure(api_key='...')")
+    user_ip = _extract_ip(request_obj)
+    if not token or not token.strip():
+        return False, "Enable JavaScript."
+
+    try:
+        import httpx
+
+        resp = httpx.post(
+            _URL,
+            json={
+                "verification_token": token.strip(),
+                "user_ip": user_ip
+            },
+            headers={"X-Api-Key": _API_KEY},
+            timeout=_TIMEOUT,
+        )
+
+        if resp.status_code != 200:
+            return False, f"Verification error (Status: {resp.status_code})"
+            
+        data = resp.json()
+
+        if data.get("is_bot") is False:
+            return True, None
+            
+        return False, data.get("reason", "Verification failed.")
+
+
+    except Exception as e:
+        logger.error("[SharkEyes] %s", e)
+        return False, "Technical error during verification."

sharkeyes_lib-1.0.0.dist-info/METADATA

@@ -0,0 +1,11 @@
+Metadata-Version: 2.4
+Name: sharkeyes-lib
+Version: 1.0.0
+Summary: Python client for SharkEyes bot-detection API
+License: MIT
+Project-URL: Homepage, https://github.com/SharkEyes-Dev/SharkEyes-Lib
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.23.0
+Dynamic: license-file

sharkeyes_lib-1.0.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+sharkeyes_lib/__init__.py,sha256=xl4J526vFgMHBxyglscES1qAcu80dPOYnlhWdK5OhAE,164
+sharkeyes_lib/sharkeyes.py,sha256=AGzi0ymnHXbH2Emp83s2okeDKiJa4AxufRJrT2TVyF4,1852
+sharkeyes_lib-1.0.0.dist-info/licenses/LICENSE,sha256=96xsptTwowYiQvLJ8osq7ImNe5jE8qgTDH3BFiSX9y0,1070
+sharkeyes_lib-1.0.0.dist-info/METADATA,sha256=eY2Z4Og_QtbVaoGQKsh3m3A2BGm5gNWGX9vWmWOIGNo,331
+sharkeyes_lib-1.0.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+sharkeyes_lib-1.0.0.dist-info/top_level.txt,sha256=nomE9QpKNSrECjnqKPq6Bx04UB2KjJKHDIXVDgtnS-M,14
+sharkeyes_lib-1.0.0.dist-info/RECORD,,

sharkeyes_lib-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

sharkeyes_lib-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SharkEyes-Dev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

sharkeyes_lib-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+sharkeyes_lib