Add social media handle checker application with Quart framework

- Implement main application logic in app.py
- Create index.html for user interface
- Add requirements.txt for dependencies
- Include .gitignore to exclude __pycache__ directory

.gitignore

@@ -0,0 +1 @@
+__pycache__/

app.py

@@ -0,0 +1,126 @@
+import sys
+import os
+
+sys.path.append(os.path.abspath("../../../"))
+
+import inspect
+from typing import Callable, Literal
+from quart import Quart, send_from_directory
+import requests
+import re
+import asyncio
+from typing import Any, Callable, Coroutine
+from python_utils.get_browser import get_browser_page_async
+import re
+
+app = Quart(__name__)
+
+@app.route('/')
+async def index():
+    """Route handler for the home page"""
+    try:
+        return await send_from_directory('.', 'index.html')
+    except Exception as e:
+        return str(e)
+
+@app.route('/check/<platform>/<username>', methods=['GET'])
+async def check_social_media_handle(platform: str, username: str):
+    match platform.lower():
+        case "instagram":
+            return await async_availability_status(
+                resolve_instagram_username(username))
+        case "linkedin-user":
+            return await async_availability_status(
+                resolve_linkedin_username(username, "in"))
+        case "linkedin-page":
+            return await async_availability_status(
+                resolve_linkedin_username(username, "company"))
+    return { 
+        "message": f'❌ The platform "{platform}" is not supported' 
+    }
+
+def resolve_instagram_username(username: str) -> tuple[str, bool, str] :
+    def get_json_value(page_source, key, value_pattern):
+        pattern = rf'[\'"]?{key}[\'"]?\s*:\s*[\'"]?({value_pattern})[\'"]?'
+        match = re.search(pattern, page_source, flags=re.IGNORECASE)
+        return match.group(1) if match else None
+    def is_valid_instagram_username(username):
+        """
+        Validates an Instagram username based on their username rules:
+        - 1 to 30 characters long
+        - Can contain letters (a-z), numbers (0-9), and periods/underscores
+        - Cannot start or end with a period
+        - Cannot have consecutive periods
+        - Cannot have periods next to underscores
+        """
+        # Regex pattern for Instagram username validation
+        pattern = r'^(?!.*\.\.)(?!.*\._)(?!.*_\.)(?![\.])[a-zA-Z0-9](?!.*\.$)[a-zA-Z0-9._]{0,28}[a-zA-Z0-9]$'
+        return re.match(pattern, username) is not None
+    def resolve() -> bool:
+        restricted_usernames = ["username"]
+        if username.lower() in restricted_usernames:
+            raise Exception(f'"{username}" is not allowed')
+        if not is_valid_instagram_username(username):
+            raise Exception(f'"{username}" is not a valid instagram username')
+        response = requests.get("https://www.instagram.com/")
+        x_ig_app_id = get_json_value(response.text, "X-IG-App-ID", "\d+")
+        user_data_response = requests.get(
+           url=f"https://www.instagram.com/api/v1/users/web_profile_info/?username={username}",
+           headers={
+               "x-ig-app-id": x_ig_app_id,
+           })
+        return (
+            username,
+            user_data_response.ok and user_data_response.json().get('status') == 'ok', 
+            f"https://www.instagram.com/{username}/")
+    return resolve
+
+def resolve_linkedin_username(username: str, company_or_user: Literal["company", "in"]) -> tuple[str, bool, str]:
+    async def resolve() -> tuple[str, bool, str]:
+        # can replace "www." with "de.", ".ke", ".ug", etc
+        # inkedin private user => kamau
+        uri: str = f"https://www.linkedin.com/{company_or_user}/{username}"
+        page, close = await get_browser_page_async()
+        response = None
+        async def capture_response(resp):
+            nonlocal response
+            if uri in resp.url:
+                response = resp
+        page.on("response", capture_response)
+        await page.goto("https://www.linkedin.com/")
+        await page.evaluate(f"""
+            fetch("{uri}", {{ "mode": "no-cors", "credentials": "include" }})
+        """)
+        await close()
+        return (username, response.ok, uri)
+    return resolve
+
+async def async_availability_status(
+        resolve: Callable[[str], Coroutine[Any, Any, bool]], message: str = None):
+    try:
+        username_is_available_uri: tuple[str, bool, str] = await resolve()\
+            if inspect.iscoroutinefunction(resolve) or inspect.isawaitable(resolve)\
+            else await asyncio.to_thread(resolve)
+        username, is_available, uri = username_is_available_uri
+        if is_available == True:
+            return {
+                'available': False,
+                'message': f"{username}: ❌ Taken",
+                'url': uri
+            }
+        if message:
+            return {
+                'available': True,
+                'message': message,
+                'url': uri
+            }
+        else:
+            return {
+                'available': True,
+                'message': f"{username}: ✅ Available",
+                'url': uri
+            }
+    except Exception as e:
+        return {
+            'message': f"❌ {str(e)}"
+        }

index.html

@@ -0,0 +1,141 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <title>Social Media Handle Checker | ToKnow.ai</title>
+    <link href="https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css" rel="stylesheet">
+    <style>
+        .platform-logo {
+            width: 30px;
+            height: 30px;
+            margin-right: 10px;
+        }
+    </style>
+</head>
+
+<body class="bg-light">
+    <div class="container mt-5">
+        <h1 class="text-center mb-4">Social Media Handle Checker</h1>
+
+        <p class="text-center text-body-secondary">
+            <a target="_blank" href="https://toknow.ai/posts/social-media-handle-checker"
+                class="text-decoration-none text-reset">
+                <b><u>ToKnow</u></b>.ai
+            </a>
+        </p>
+
+        <div class="row justify-content-center">
+            <div class="col-lg-6 col-md-8">
+                <form id="search-form" class="mb-3 mt-4">
+                    <div class="input-group">
+                        <input type="text" id="social-handle" class="form-control" placeholder="Enter username"
+                            aria-label="Username" required />
+                        <button class="btn btn-primary" type="submit">Check</button>
+                    </div>
+                </form>
+            </div>
+        </div>
+
+        <div class="row justify-content-center">
+            <div class="col-lg-6 col-md-8" id="platform-container">
+            </div>
+        </div>
+
+        <p class="text-center mt-4 text-body-secondary text-lowercase">
+            <a target="_blank" href="https://toknow.ai/posts/social-media-handle-checker" class="text-decoration-none">
+                <i>get help or get more details</i>
+            </a>
+            <img class="rounded mx-auto d-block"
+                src="https://api.visitorbadge.io/api/visitors?path=https://toknow.ai/posts/social-media-handle-checker" />
+        </p>
+    </div>
+
+    <script>
+        const platformContainer = document.querySelector("#platform-container")
+        const platforms = [
+            {
+                id: "instagram",
+                name: "Instagram",
+                img: "https://cdn.jsdelivr.net/npm/simple-icons@v6/icons/instagram.svg"
+            },
+            {
+                id: "x",
+                name: "X (formerly Twitter)",
+                img: "https://cdn.jsdelivr.net/npm/simple-icons@v6/icons/twitter.svg"
+            },
+            {
+                id: "linkedin-user",
+                name: "LinkedIn User",
+                img: "https://cdn.jsdelivr.net/npm/simple-icons@v6/icons/linkedin.svg"
+            },
+            {
+                id: "linkedin-page",
+                name: "LinkedIn Company",
+                img: "https://cdn.jsdelivr.net/npm/simple-icons@v6/icons/linkedin.svg"
+            }
+        ];
+
+        for (const platform of platforms) {
+            platformContainer.innerHTML +=
+                `<div class="card mb-2" data-platform="${platform.id}">
+                    <div class="card-body d-flex align-items-center">
+                        <img src="${platform.img}" alt="${platform.name}" class="platform-logo">
+                        <span class="me-auto">${platform.name}</span>
+                        <div class="spinner-border text-primary d-none me-2"></div>
+                        <span class="status"></span>
+                    </div>
+                </div>`
+        }
+
+        document.getElementById('search-form').addEventListener('submit', function (e) {
+            e.preventDefault();
+            const username = document.getElementById('social-handle').value;
+            if ((username || '').trim().length == 0) {
+                return;
+            }
+
+            if (platforms.length == 0) {
+                alert("Not working right now, please try again later...")
+                return;
+            }
+
+            // Simulate API calls
+            platforms.forEach(platform => {
+                const card = document.querySelector(`[data-platform="${platform.id}"]`);
+                const statusSpan = card.querySelector('.status');
+                const spinner = card.querySelector('.spinner-border');
+
+                card.classList.remove('bg-success-subtle', 'bg-danger-subtle', 'bg-warning-subtle');
+                spinner.classList.remove('d-none');
+                statusSpan.textContent = ' checking...';
+
+                fetch(`/check/${platform.id}/${username}`)
+                    .then(response => response.json())
+                    .then(({ available, message, url }) => {
+                        spinner.classList.add('d-none');
+                        if (available === true) {
+                            card.classList.add('bg-success-subtle');
+                            statusSpan.textContent = message;
+                            statusSpan.innerHTML += ` (<a href="${url}" target="_blank">view</a>)`;
+                        } else if (available === false) {
+                            card.classList.add('bg-danger-subtle');
+                            statusSpan.textContent = message;
+                            statusSpan.innerHTML += ` (<a href="${url}" target="_blank">view</a>)`;
+                        } else {
+                            card.classList.add('bg-warning-subtle');
+                            statusSpan.textContent = message || 'Unable to check';
+                        }
+                    })
+                    .catch(error => {
+                        spinner.classList.add('d-none');
+                        card.classList.add('bg-warning-subtle');
+                        statusSpan.textContent = `Error checking availability`;
+                    });
+            });
+        });
+    </script>
+</body>
+
+</html>

requirements.txt

@@ -0,0 +1,3 @@
+gunicorn==22.0.0
+Quart==0.19.9
+requests==2.32.3