docs: add images directory creation in deployment workflow script

Author: thalissonvs

.github/workflows/deploy-docs.yml

@@ -29,6 +29,7 @@ jobs:
       - name: Prepare final site
         run: |
           mkdir -p site/docs
+          mkdir -p site/images
           cp -r temp_docs/* site/docs/
           cp -r docs/landing/* site/
           cp -r docs/images/* site/images/

CHANGELOG.md

@@ -1,3 +1,15 @@
+## 2.6.0 (2025-08-10)
+
+### Feat
+
+- add DownloadTimeout exception for file download timeouts
+- add context manager for handling file downloads in Tab class
+
+### Refactor
+
+- add type checking for connection handler in mixin class
+- add type overloads for event callback in Browser class
+
 ## 2.5.0 (2025-08-07)
 
 ### Feat

README.md

@@ -17,7 +17,7 @@
 
 
 <p align="center">
-  📖 <a href="https://autoscrape-labs.github.io/pydoll/">Documentation</a> •
+  📖 <a href="https://pydoll.tech/">Documentation</a> •
   🚀 <a href="#-getting-started">Getting Started</a> •
   ⚡ <a href="#-advanced-features">Advanced Features</a> •
   🤝 <a href="#-contributing">Contributing</a> •
@@ -209,7 +209,7 @@ options.browser_preferences = {
 
 This level of control was previously only available to Chrome extension developers - now it's in your automation toolkit!
 
-Check the [documentation](https://autoscrape-labs.github.io/pydoll/features/#custom-browser-preferences/) for more details.
+Check the [documentation](https://pydoll.tech/docs/features/#custom-browser-preferences/) for more details.
 
 ### New `get_parent_element()` method
 Retrieve the parent of any WebElement, making it easier to navigate the DOM structure:
@@ -520,7 +520,7 @@ options.add_argument('--disable-dev-shm-usage')
 
 ## 📚 Documentation
 
-For complete documentation, detailed examples and deep dives into all Pydoll functionalities, visit our [official documentation](https://autoscrape-labs.github.io/pydoll/).
+For complete documentation, detailed examples and deep dives into all Pydoll functionalities, visit our [official documentation](https://pydoll.tech/).
 
 The documentation includes:
 - **Getting Started Guide** - Step-by-step tutorials

cz.yaml

@@ -2,4 +2,4 @@
 commitizen:
   name: cz_conventional_commits
   tag_format: $version
-  version: 2.5.0
+  version: 2.6.0

docs/landing/index.html

@@ -52,7 +52,7 @@
             },
             "sameAs": [
               "https://github.com/autoscrape-labs/pydoll",
-              "https://pypi.org/project/pydoll-python/",
+              "https://pypi.org/project/pydoll-python/"
             ]
           },
           {
@@ -90,7 +90,7 @@
             "publisher": { "@id": "https://pydoll.tech/#org" },
             "offers": {
               "@type": "Offer",
-              "price": "0",
+              "price": 0,
               "priceCurrency": "USD"
             },
             "codeRepository": "https://github.com/autoscrape-labs/pydoll",
@@ -186,16 +186,33 @@
             <img src="https://pydoll.tech/images/E2ECED-cinza-azulado.png" alt="Pydoll" class="h-8 w-auto" />
 
           </a>
-          <nav class="flex items-center gap-2 sm:gap-3">
+          <!-- Desktop nav -->
+          <nav class="hidden items-center gap-2 sm:flex sm:gap-3">
             <a href="https://pydoll.tech/docs/" target="_blank" rel="noopener" class="px-3 py-2 text-sm font-medium text-slate-200 hover:text-white">Docs</a>
             <a href="#install" class="px-3 py-2 text-sm font-medium text-slate-200 hover:text-white">Install</a>
             <a href="#faq" class="px-3 py-2 text-sm font-medium text-slate-200 hover:text-white">FAQ</a>
             <a href="https://github.com/sponsors/thalissonvs" target="_blank" rel="noopener" class="px-3 py-2 text-sm font-medium text-slate-200 hover:text-white">Sponsor</a>
-            <a href="https://github.com/autoscrape-labs/pydoll" target="_blank" rel="noopener" aria-label="Star on GitHub" class="inline-flex items-center gap-2 rounded-md bg-yellow-400 px-3 py-2 text-sm font-semibold text-slate-900 shadow hover:bg-yellow-300">
+            <a href="https://github.com/autoscrape-labs/pydoll" target="_blank" rel="noopener" aria-label="Star on GitHub" class="inline-flex items-center gap-2 rounded-md bg-brand-500 px-3 py-2 text-sm font-semibold text-white shadow hover:bg-brand-400">
               ⭐ Star
-              <span id="starCount" class="hidden rounded bg-slate-900/10 px-2 py-0.5 text-slate-900/80 sm:inline-block">...</span>
+              <span id="starCount" class="hidden rounded bg-white/10 px-2 py-0.5 text-white/80 sm:inline-block">...</span>
             </a>
           </nav>
+          <!-- Mobile toggle -->
+          <button id="mobileMenuButton" aria-controls="mobileMenu" aria-expanded="false" class="inline-flex items-center justify-center rounded-md p-2 text-slate-200 hover:text-white hover:bg-white/5 focus:outline-none focus:ring-2 focus:ring-brand-500 sm:hidden" type="button">
+            <span class="sr-only">Open main menu</span>
+            <svg id="iconMenu" xmlns="http://www.w3.org/2000/svg" class="h-6 w-6" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><line x1="3" y1="6" x2="21" y2="6"/><line x1="3" y1="12" x2="21" y2="12"/><line x1="3" y1="18" x2="21" y2="18"/></svg>
+            <svg id="iconClose" xmlns="http://www.w3.org/2000/svg" class="hidden h-6 w-6" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><line x1="18" y1="6" x2="6" y2="18"/><line x1="6" y1="6" x2="18" y2="18"/></svg>
+          </button>
+        </div>
+        <!-- Mobile menu panel -->
+        <div id="mobileMenu" class="hidden sm:hidden">
+          <div class="space-y-1 border-t border-white/10 py-3">
+            <a href="https://pydoll.tech/docs/" target="_blank" rel="noopener" class="block rounded-md px-3 py-2 text-sm font-medium text-slate-200 hover:bg-white/5">Docs</a>
+            <a href="#install" class="block rounded-md px-3 py-2 text-sm font-medium text-slate-200 hover:bg-white/5">Install</a>
+            <a href="#faq" class="block rounded-md px-3 py-2 text-sm font-medium text-slate-200 hover:bg-white/5">FAQ</a>
+            <a href="https://github.com/sponsors/thalissonvs" target="_blank" rel="noopener" class="block rounded-md px-3 py-2 text-sm font-medium text-slate-200 hover:bg-white/5">Sponsor</a>
+            <a href="https://github.com/autoscrape-labs/pydoll" target="_blank" rel="noopener" class="mt-2 inline-flex w-full items-center justify-center gap-2 rounded-md bg-brand-500 px-3 py-2 text-sm font-semibold text-white shadow hover:bg-brand-400">⭐ Star</a>
+          </div>
         </div>
       </div>
     </header>
@@ -303,22 +320,22 @@ <h3 class="flex items-center gap-2 text-lg font-semibold">
     </section>
 
     <!-- Install CTA -->
-    <section id="install">
+    <section id="install" class="overflow-x-hidden">
       <div class="mx-auto max-w-7xl px-4 py-14 sm:px-6 lg:px-8">
-        <div class="grid items-center gap-8 lg:grid-cols-2">
-          <div>
+        <div class="grid grid-cols-1 items-center gap-8 lg:grid-cols-2">
+          <div class="min-w-0">
             <h2 class="text-2xl font-bold tracking-tight">Install and get started in seconds</h2>
             <p class="mt-3 text-slate-300">No complex setup. Install, import and automate.</p>
-            <div class="mt-6 rounded-lg border border-white/10 bg-slate-950 p-4">
-              <div class="flex items-center justify-between">
-                <code id="installCmd" class="text-sm">pip install pydoll-python</code>
-                <button id="copyBtn" class="rounded-md bg-slate-800 px-3 py-1.5 text-xs font-semibold text-slate-100 hover:bg-slate-700">Copy</button>
+            <div class="mt-6 rounded-lg border border-white/10 bg-slate-950 p-3 sm:p-4">
+              <div class="flex items-center gap-3 flex-wrap sm:flex-nowrap">
+                <code id="installCmd" class="text-sm block max-w-full whitespace-nowrap overflow-x-auto">pip install pydoll-python</code>
+                <button id="copyBtn" class="shrink-0 rounded-md bg-slate-800 px-3 py-1.5 text-xs font-semibold text-slate-100 hover:bg-slate-700">Copy</button>
               </div>
             </div>
             <!-- Quick code example -->
             <div class="mt-6">
               <p class="mb-2 text-sm text-slate-300">Quick example:</p>
-              <pre class="language-python overflow-x-auto rounded-lg border border-white/10 bg-slate-950 p-4 text-[12px] leading-relaxed"><code class="language-python">import asyncio
+              <pre class="language-python overflow-x-auto max-w-full rounded-lg border border-white/10 bg-slate-950 p-4 text-[12px] leading-relaxed"><code class="language-python">import asyncio
 from pydoll.browser.chromium import Chrome
 
 async def main():
@@ -336,7 +353,7 @@ <h2 class="text-2xl font-bold tracking-tight">Install and get started in seconds
               <a href="https://github.com/sponsors/thalissonvs" target="_blank" rel="noopener" class="inline-flex items-center justify-center gap-2 rounded-md border border-white/10 px-4 py-2 text-sm font-semibold text-white/90 hover:bg-white/5">Support the project</a>
             </div>
           </div>
-          <div class="relative overflow-hidden rounded-xl border border-white/10 bg-slate-950 shadow-xl">
+          <div class="relative min-w-0 w-full overflow-hidden rounded-xl border border-white/10 bg-slate-950 shadow-xl">
             <div class="flex items-center gap-2 border-b border-white/10 bg-slate-900/80 px-3 py-2">
               <span class="h-2.5 w-2.5 rounded-full bg-red-400/70"></span>
               <span class="h-2.5 w-2.5 rounded-full bg-yellow-400/70"></span>
@@ -548,7 +565,7 @@ <h4 class="text-lg font-semibold">Enjoying Pydoll?</h4>
           <p class="mt-1 text-sm text-slate-200/90">Star it, contribute to the repo or sponsor the development.</p>
           </div>
           <div class="flex flex-wrap gap-2">
-            <a href="https://github.com/autoscrape-labs/pydoll" target="_blank" rel="noopener" class="inline-flex items-center gap-2 rounded-md bg-yellow-400 px-3 py-2 text-sm font-semibold text-slate-900 hover:bg-yellow-300">⭐ Star</a>
+            <a href="https://github.com/autoscrape-labs/pydoll" target="_blank" rel="noopener" class="inline-flex items-center gap-2 rounded-md bg-brand-500 px-3 py-2 text-sm font-semibold text-white hover:bg-brand-400">⭐ Star</a>
             <a href="https://github.com/autoscrape-labs/pydoll/blob/main/CONTRIBUTING.md" target="_blank" rel="noopener" class="inline-flex items-center gap-2 rounded-md border border-white/10 px-3 py-2 text-sm font-semibold text-white/90 hover:bg-white/5">👩‍💻 Contribute</a>
             <a href="https://github.com/sponsors/thalissonvs" target="_blank" rel="noopener" class="inline-flex items-center gap-2 rounded-md bg-brand-500 px-3 py-2 text-sm font-semibold text-white hover:bg-brand-400">💖 Sponsor</a>
           </div>

docs/landing/script.js

@@ -160,6 +160,32 @@
   bindCopy('copyRequestsBtn', 'codeRequests')
   bindCopy('copyPrefsBtn', 'codePrefs')
 
+  // Mobile menu toggle
+  const mobileMenuButton = document.getElementById('mobileMenuButton')
+  const mobileMenu = document.getElementById('mobileMenu')
+  const iconMenu = document.getElementById('iconMenu')
+  const iconClose = document.getElementById('iconClose')
+  if (mobileMenuButton && mobileMenu && iconMenu && iconClose) {
+    const setExpanded = (expanded) => {
+      mobileMenuButton.setAttribute('aria-expanded', String(expanded))
+      mobileMenu.classList.toggle('hidden', !expanded)
+      iconMenu.classList.toggle('hidden', expanded)
+      iconClose.classList.toggle('hidden', !expanded)
+    }
+    mobileMenuButton.addEventListener('click', () => {
+      const isOpen = mobileMenuButton.getAttribute('aria-expanded') === 'true'
+      setExpanded(!isOpen)
+    })
+    // Close on escape and when clicking links
+    document.addEventListener('keydown', (e) => {
+      if (e.key === 'Escape') setExpanded(false)
+    })
+    mobileMenu.addEventListener('click', (e) => {
+      const target = e.target
+      if (target instanceof HTMLElement && target.tagName === 'A') setExpanded(false)
+    })
+  }
+
   // (CTA final não requer JS adicional)
 })()
 

pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "pydoll-python"
-version = "2.5.0"
+version = "2.6.0"
 description = "Pydoll is a library for automating chromium-based browsers without a WebDriver, offering realistic interactions."
 authors = ["Thalison Fernandes <thalissfernandes99@gmail.com>"]
 readme = "README.md"