flask-Humanify 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

flask_humanify/features/rate_limiter.py

@@ -0,0 +1,77 @@
+import hashlib
+import time
+from collections import defaultdict, deque
+
+from flask import request, redirect, url_for, render_template
+from flask_humanify.utils import get_client_ip, get_return_url
+
+
+class RateLimiter:
+    """
+    Rate limiter.
+    """
+
+    def __init__(self, app=None, max_requests: int = 2, time_window: int = 10):
+        """
+        Initialize the rate limiter.
+        """
+        self.app = app
+        if app is not None:
+            self.init_app(app)
+        self.max_requests = max_requests
+        self.time_window = time_window
+        self.ip_request_times = defaultdict(deque)
+
+    def init_app(self, app):
+        """
+        Initialize the rate limiter.
+        """
+        self.app = app
+        self.app.before_request(self.before_request)
+
+        @self.app.route(
+            "/humanify/rate_limited",
+            methods=["GET"],
+            endpoint="humanify.rate_limited",
+        )
+        def rate_limited():
+            """
+            Rate limited route.
+            """
+            return (
+                render_template("rate_limited.html").replace(
+                    "RETURN_URL", get_return_url(request)
+                ),
+                429,
+                {"Cache-Control": "public, max-age=15552000"},
+            )
+
+    def before_request(self):
+        """
+        Before request hook.
+        """
+        ip = get_client_ip(request)
+        if request.endpoint == "humanify.rate_limited":
+            return
+        if self.is_rate_limited(ip or "127.0.0.1"):
+            return redirect(
+                url_for("humanify.rate_limited", return_url=request.full_path)
+            )
+
+    def is_rate_limited(self, ip: str) -> bool:
+        """
+        Check if the IP is rate limited.
+        """
+        hashed_ip = hashlib.sha256(ip.encode()).hexdigest()
+
+        current_time = time.time()
+        request_times = self.ip_request_times[hashed_ip]
+
+        while request_times and request_times[0] <= current_time - self.time_window:
+            request_times.popleft()
+
+        if len(request_times) < self.max_requests:
+            request_times.append(current_time)
+            return False
+
+        return True

{flask_Humanify → flask_humanify}/ipset.py

@@ -4,7 +4,10 @@ import socket
 import time
 import threading
 import os
+import importlib.metadata
+import importlib.resources
 import urllib.request
+from pathlib import Path
 from typing import Dict, List, Optional, Tuple
 from datetime import datetime, timedelta
 from netaddr import IPNetwork, IPAddress
@@ -13,20 +16,39 @@ from netaddr import IPNetwork, IPAddress
 logger = logging.getLogger(__name__)
 
 
+try:
+    importlib.metadata.distribution("flask-humanify")
+    BASE_DIR = importlib.resources.files("flask_humanify")
+except importlib.metadata.PackageNotFoundError:
+    BASE_DIR = Path(__file__).parent
+
+DATASET_DIR = BASE_DIR / "datasets"
+if not DATASET_DIR.exists():
+    DATASET_DIR.mkdir(parents=True)
+
+IPSET_DATA_PATH = str(DATASET_DIR / "ipset.json")
+
+
 class IPSetMemoryServer:
     """A singleton memory server that manages IP sets and provides lookup functionality."""
 
     _instance = None
     _lock = threading.Lock()
 
-    def __new__(cls, port: int = 9876, data_path: str = "ipset.json"):
+    def __new__(cls, port: int = 9876, data_path: Optional[str] = None):
+        if data_path is None:
+            data_path = IPSET_DATA_PATH
+
         with cls._lock:
             if cls._instance is None:
                 cls._instance = super(IPSetMemoryServer, cls).__new__(cls)
                 cls._instance.initialized = False
             return cls._instance
 
-    def __init__(self, port: int = 9876, data_path: str = "ipset.json"):
+    def __init__(self, port: int = 9876, data_path: Optional[str] = None):
+        if data_path is None:
+            data_path = IPSET_DATA_PATH
+
         if getattr(self, "initialized", False):
             return
 
@@ -281,8 +303,11 @@ class IPSetClient:
             self.socket = None
 
 
-def ensure_server_running(port: int = 9876, data_path: str = "ipset.json") -> None:
+def ensure_server_running(port: int = 9876, data_path: Optional[str] = None) -> None:
     """Ensure that the memory server is running."""
+    if data_path is None:
+        data_path = IPSET_DATA_PATH
+
     server = IPSetMemoryServer(port=port, data_path=data_path)
     server.start()
 

flask_humanify/templates/access_denied.html

@@ -0,0 +1,110 @@
+<!DOCTYPE html>
+<html lang="en">
+    <head>
+        <meta charset="UTF-8">
+        <meta name="viewport" content="width=device-width, initial-scale=1.0">
+        <title>Access Denied</title>
+        <style>
+            body {
+                font-family: system-ui, sans-serif;
+                background: #f2f2f2;
+                color: #181818;
+                margin: 0;
+                line-height: 1.5;
+                text-align: center;
+                display: grid;
+                place-items: center;
+                height: 100vh;
+                padding: 0 20px;
+            }
+            
+            @media (prefers-color-scheme: dark) {
+                body {
+                    background: #121212;
+                    color: #f2f2f2;
+                }
+                
+                .btn {
+                    background: #f2f2f2;
+                    color: #121212;
+                }
+                
+                .fill {
+                    background: rgba(0,0,0,0.15);
+                }
+            }
+            
+            .content {
+                max-width: 600px;
+            }
+
+            .emoji {
+                font-size: 48px;
+                margin-bottom: 10px;
+            }
+            
+            h1 {
+                font-size: 22px;
+                margin: 15px 0;
+            }
+            
+            p {
+                margin: 15px 0;
+                opacity: 0.8;
+            }
+            
+            .btn {
+                display: inline-block;
+                padding: 12px 24px;
+                background: #181818;
+                color: #f2f2f2;
+                border-radius: 6px;
+                text-decoration: none;
+                margin-top: 20px;
+                position: relative;
+                overflow: hidden;
+                pointer-events: none;
+            }
+            
+            .fill {
+                position: absolute;
+                left: 0;
+                top: 0;
+                height: 100%;
+                width: 0;
+                background: rgba(255,255,255,0.15);
+                animation: fillBtn 10s linear forwards;
+            }
+            
+            @keyframes fillBtn {
+                to { width: 100%; }
+            }
+        </style>
+    </head>
+    <body>
+        <div class="content">
+            <div class="emoji">
+                🚨
+            </div>
+            <h1>Sorry, but you can't see the requested page.</h1>
+            <p>Automated scripts are likely attempting to request this page. If you use anonymizing tools like VPNs or proxies, consider disabling them temporarily.</p>
+            <a href="RETURN_URL" id="retry" class="btn">
+                <div class="fill"></div>
+                <span>Try again</span>
+            </a>
+        </div>
+        
+        <noscript>
+            <style>
+                .btn { pointer-events: all !important; }
+                .fill { display: none; }
+            </style>
+        </noscript>
+        
+        <script>
+            setTimeout(function() {
+                document.getElementById('retry').style.pointerEvents = 'all';
+            }, 10000);
+        </script>
+    </body>
+</html>

flask_humanify/templates/oneclick_captcha.html

@@ -0,0 +1,192 @@
+<!DOCTYPE html>
+<html lang="en">
+    <head>
+        <meta charset="UTF-8">
+        <meta name="viewport" content="width=device-width, initial-scale=1.0">
+        <title>Verify Human</title>
+        <style>
+            body {
+                font-family: system-ui, sans-serif;
+                background: #f2f2f2;
+                color: #181818;
+                margin: 0;
+                line-height: 1.5;
+                text-align: center;
+                display: grid;
+                place-items: center;
+                height: 100vh;
+                padding: 0 20px;
+            }
+            
+            @media (prefers-color-scheme: dark) {
+                body {
+                    background: #121212;
+                    color: #f2f2f2;
+                }
+                
+                .fill {
+                    background: rgba(0,0,0,0.15);
+                }
+            }
+            
+            .content {
+                max-width: 600px;
+                display: flex;
+                flex-direction: column;
+                align-items: center;
+            }
+
+            .emoji {
+                font-size: 48px;
+                margin-bottom: 10px;
+            }
+            
+            h1 {
+                font-size: 22px;
+                margin: 15px 0;
+            }
+            
+            p {
+                margin: 15px 0;
+                opacity: 0.8;
+            }
+            
+            .preview-container {
+                width: 200px;
+                height: 200px;
+                margin-bottom: 20px;
+            }
+
+            .preview-container img {
+                width: 100%;
+                height: 100%;
+                object-fit: cover;
+                border-radius: 8px;
+                box-shadow: 0 4px 8px rgba(0, 0, 0, 0.1);
+            }
+            
+            .text-container {
+                text-align: center;
+                margin-bottom: 25px;
+            }
+            
+            .error {
+                color: #e53935;
+                margin: 10px 0;
+                font-size: 16px;
+            }
+            
+            .images-row {
+                display: flex;
+                flex-direction: row;
+                justify-content: center;
+                flex-wrap: wrap;
+                gap: 15px;
+                margin-bottom: 25px;
+                width: 100%;
+            }
+            
+            .image-button {
+                background: none;
+                border: none;
+                padding: 0;
+                cursor: pointer;
+                width: 100px;
+                height: 100px;
+                transition: transform 0.2s ease, box-shadow 0.2s ease;
+                border-radius: 8px;
+                overflow: hidden;
+                position: relative;
+            }
+            
+            .image-button:hover {
+                transform: translateY(-3px);
+                box-shadow: 0 5px 15px rgba(0, 0, 0, 0.2);
+            }
+            
+            .image-button img {
+                width: 100%;
+                height: 100%;
+                object-fit: cover;
+            }
+            
+            .audio-challenge-link {
+                display: flex;
+                align-items: center;
+                justify-content: center;
+                margin-top: 15px;
+                color: #4a6ed0;
+                text-decoration: none;
+                font-size: 14px;
+                transition: all 0.2s ease;
+            }
+            
+            .audio-challenge-link:hover {
+                transform: translateY(-2px);
+            }
+            
+            .audio-challenge-link svg {
+                margin-right: 6px;
+                width: 16px;
+                height: 16px;
+                fill: currentColor;
+            }
+            
+            @media (max-width: 600px) {
+                .preview-container {
+                    width: 180px;
+                    height: 180px;
+                }
+                
+                .images-row {
+                    gap: 10px;
+                    justify-content: center;
+                }
+                
+                .image-button {
+                    width: 80px;
+                    height: 80px;
+                }
+            }
+        </style>
+    </head>
+    <body>
+        <div class="content">
+            <div class="preview-container">
+                <img src="{{ preview_image }}" alt="Reference image">
+            </div>
+            
+            <div class="text-container">
+                {% if subject == "smiling dog" %}
+                <p>To verify you're not a bot, select the dog that smiles like shown above.</p>
+                {% else %}
+                <p>To verify you're not a bot, select the image that matches the motif shown above.</p>
+                {% endif %}
+                {% if error %}
+                    <p class="error">{{ error }}</p>
+                {% endif %}
+            </div>
+
+            <div class="images-row">
+                {% for image in images %}
+                <form action="{{ url_for('captchaify.verify') }}" method="POST">
+                    <input type="hidden" name="return_url" value="{{ return_url }}">
+                    <input type="hidden" name="captcha_data" value="{{ captcha_data }}">
+                    <button type="submit" class="image-button" name="{{ loop.index }}" value="1">
+                        <img src="{{ image }}" alt="Selection image {{ loop.index }}">
+                    </button>
+                </form>
+                {% endfor %}
+            </div>
+            
+            {% if audio_challenge_available %}
+                <a class="audio-challenge-link" href="{{ url_for('captchaify.audio_challenge', return_url=return_url) }}">
+                    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20">
+                        <path d="M10 1a1 1 0 0 1 1 1v13.59l1.29-1.29a1 1 0 1 1 1.42 1.42l-3 3a1 1 0 0 1-1.42 0l-3-3a1 1 0 0 1 1.42-1.42L9 15.59V2a1 1 0 0 1 1-1zm2-1a1 1 0 1 1 0 2 5 5 0 0 0-5 5 1 1 0 1 1-2 0 7 7 0 0 1 7-7zm2 3a1 1 0 1 1 0 2 3 3 0 0 0-3 3 1 1 0 1 1-2 0 5 5 0 0 1 5-5z" />
+                    </svg>
+                    Audio challenge
+                </a>
+            {% endif %}
+        </div>
+    </body>
+</html>

flask_humanify/templates/rate_limited.html

@@ -0,0 +1,110 @@
+<!DOCTYPE html>
+<html lang="en">
+    <head>
+        <meta charset="UTF-8">
+        <meta name="viewport" content="width=device-width, initial-scale=1.0">
+        <title>Rate Limited</title>
+        <style>
+            body {
+                font-family: system-ui, sans-serif;
+                background: #f2f2f2;
+                color: #181818;
+                margin: 0;
+                line-height: 1.5;
+                text-align: center;
+                display: grid;
+                place-items: center;
+                height: 100vh;
+                padding: 0 20px;
+            }
+            
+            @media (prefers-color-scheme: dark) {
+                body {
+                    background: #121212;
+                    color: #f2f2f2;
+                }
+                
+                .btn {
+                    background: #f2f2f2;
+                    color: #121212;
+                }
+                
+                .fill {
+                    background: rgba(0,0,0,0.15);
+                }
+            }
+            
+            .content {
+                max-width: 600px;
+            }
+
+            .emoji {
+                font-size: 48px;
+                margin-bottom: 10px;
+            }
+            
+            h1 {
+                font-size: 22px;
+                margin: 15px 0;
+            }
+            
+            p {
+                margin: 15px 0;
+                opacity: 0.8;
+            }
+            
+            .btn {
+                display: inline-block;
+                padding: 12px 24px;
+                background: #181818;
+                color: #f2f2f2;
+                border-radius: 6px;
+                text-decoration: none;
+                margin-top: 20px;
+                position: relative;
+                overflow: hidden;
+                pointer-events: none;
+            }
+            
+            .fill {
+                position: absolute;
+                left: 0;
+                top: 0;
+                height: 100%;
+                width: 0;
+                background: rgba(255,255,255,0.15);
+                animation: fillBtn 10s linear forwards;
+            }
+            
+            @keyframes fillBtn {
+                to { width: 100%; }
+            }
+        </style>
+    </head>
+    <body>
+        <div class="content">
+            <div class="emoji">
+                🫖
+            </div>
+            <h1>Have some Tea</h1>
+            <p>It appears that you are sending an excessive number of requests to this website. Please reduce the frequency of your requests.</p>
+            <a href="RETURN_URL" id="retry" class="btn">
+                <div class="fill"></div>
+                <span>Try again</span>
+            </a>
+        </div>
+        
+        <noscript>
+            <style>
+                .btn { pointer-events: all !important; }
+                .fill { display: none; }
+            </style>
+        </noscript>
+        
+        <script>
+            setTimeout(function() {
+                document.getElementById('retry').style.pointerEvents = 'all';
+            }, 10000);
+        </script>
+    </body>
+</html>

{flask_humanify-0.1.0.dist-info → flask_humanify-0.1.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flask-Humanify
-Version: 0.1.0
+Version: 0.1.2
 Summary: Protect against bots and DDoS attacks
 Author-email: TN3W <tn3w@protonmail.com>
 License-Expression: Apache-2.0
@@ -55,15 +55,17 @@ if __name__ == "__main__":
     app.run()
 ```
 
+## Usage
+
 ### Installation
 Install the package with pip:
 ```bash
-pip install flask-Humanify
+pip install flask-humanify --upgrade
 ```
 
 Import the extension:
 ```python
-from flask_Humanify import Humanify
+from flask_humanify import Humanify
 ```
 
 Add the extension to your Flask app:

flask_humanify-0.1.2.dist-info/RECORD

@@ -0,0 +1,14 @@
+flask_humanify/__init__.py,sha256=L67JR_FDgC9iNnBrnRchNPZe_z7tXbwV_xJ4NEQKGFw,269
+flask_humanify/humanify.py,sha256=JJeTcJlMte6zj2QRlat2876iJzFg40YNoMEX5kWepiU,3772
+flask_humanify/ipset.py,sha256=ZZZRtgtddkZr2q1zuI6803hJQ8OodVHNdyZvZGqpmMI,10866
+flask_humanify/utils.py,sha256=CJ4FPhNJ75FuWcAn_ZuZkqRa9HR3jVvYOu9NZaN4L1o,2461
+flask_humanify/datasets/ipset.json,sha256=YNPqwI109lYkfvZeOPsoDH_dKJxOCs0G2nvx_s2mvqU,30601191
+flask_humanify/features/rate_limiter.py,sha256=kl3l1SHtDOPzOb1TLZizIRp-mJo5d30uW62ocmBm_fM,2175
+flask_humanify/templates/access_denied.html,sha256=Y7EzM53LRBMJBniczTWYvinHuPPFQVKrqvCmKaqLHak,3165
+flask_humanify/templates/oneclick_captcha.html,sha256=CnK4qTOdjIrlnFB8lytuK8pEcpj1dL5uYzj0ZNBkx-E,6241
+flask_humanify/templates/rate_limited.html,sha256=LSS1-c9F3YLxXF-jiyyNN6vIMoIAdmd6ObO1PDcjIxI,3110
+flask_humanify-0.1.2.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+flask_humanify-0.1.2.dist-info/METADATA,sha256=9oxqmwHRjGz9RVxSwxuZWdXcjYdPtaC2j17rOkOWVyE,2787
+flask_humanify-0.1.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+flask_humanify-0.1.2.dist-info/top_level.txt,sha256=9-c6uhxwCpPE3BJYge1Y9Z_bYmWitI0fY5RgqMiFWr0,15
+flask_humanify-0.1.2.dist-info/RECORD,,

flask_humanify-0.1.2.dist-info/top_level.txt

@@ -0,0 +1 @@
+flask_humanify

flask_humanify-0.1.0.dist-info/RECORD

@@ -1,9 +0,0 @@
-flask_Humanify/__init__.py,sha256=me3NQI32tVcx5iTq5hpCJ4JOG4wdlj9x8Lnx-Y2Rhvk,269
-flask_Humanify/humanify.py,sha256=JJeTcJlMte6zj2QRlat2876iJzFg40YNoMEX5kWepiU,3772
-flask_Humanify/ipset.py,sha256=LK2OrqwccSrikofGrdSEzgOx17i-HsPYsR9gHJyPDhQ,10219
-flask_Humanify/utils.py,sha256=CJ4FPhNJ75FuWcAn_ZuZkqRa9HR3jVvYOu9NZaN4L1o,2461
-flask_humanify-0.1.0.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-flask_humanify-0.1.0.dist-info/METADATA,sha256=oIDLoHKKyylisbMBTwAaPVnwBVffeWzEZjoxpbUxNYU,2767
-flask_humanify-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-flask_humanify-0.1.0.dist-info/top_level.txt,sha256=XcJXzmBdGt7o2wY93Yhc0Epzeb2nORaZ8-fLsbwOYQ8,15
-flask_humanify-0.1.0.dist-info/RECORD,,

flask_humanify-0.1.0.dist-info/top_level.txt

@@ -1 +0,0 @@
-flask_Humanify