pytrends-modern 0.2.1__tar.gz → 0.2.2__tar.gz

{pytrends_modern-0.2.1/pytrends_modern.egg-info → pytrends_modern-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pytrends-modern
-Version: 0.2.1
+Version: 0.2.2
 Summary: Modern Google Trends API - Combining the best of pytrends, with RSS feeds, Selenium scraping, DrissionPage browser automation, and enhanced features
 Author: pytrends-modern contributors
 License: MIT
@@ -175,11 +175,16 @@ RUN mkdir -p /root/.config && \
     cd /root/.config && \
     tar -xzf /tmp/profile.tar.gz
 
-# 3. Use headless mode in container
-config = BrowserConfig(headless=True)
+# 3. Use headless="virtual" in container
+config = BrowserConfig(headless="virtual")  # Use Xvfb for Docker
 ```
 
-See `Dockerfile.example` for complete Docker setup.
+**Headless Options:**
+- `headless=False` - Show browser window (local development)
+- `headless=True` - Standard headless (servers with display)
+- `headless="virtual"` - Xvfb virtual display (Docker containers)
+
+See `Dockerfile.example` and `examples/example_docker_usage.py` for complete Docker setup.
 
 ⚠️ **Security**: Profile contains Google session - keep secure, don't commit to git!
 

{pytrends_modern-0.2.1 → pytrends_modern-0.2.2}/README.md

@@ -125,11 +125,16 @@ RUN mkdir -p /root/.config && \
     cd /root/.config && \
     tar -xzf /tmp/profile.tar.gz
 
-# 3. Use headless mode in container
-config = BrowserConfig(headless=True)
+# 3. Use headless="virtual" in container
+config = BrowserConfig(headless="virtual")  # Use Xvfb for Docker
 ```
 
-See `Dockerfile.example` for complete Docker setup.
+**Headless Options:**
+- `headless=False` - Show browser window (local development)
+- `headless=True` - Standard headless (servers with display)
+- `headless="virtual"` - Xvfb virtual display (Docker containers)
+
+See `Dockerfile.example` and `examples/example_docker_usage.py` for complete Docker setup.
 
 ⚠️ **Security**: Profile contains Google session - keep secure, don't commit to git!
 

pytrends_modern-0.2.2/examples/example_docker_usage.py

@@ -0,0 +1,50 @@
+#!/usr/bin/env python3
+"""
+Example: Using pytrends-modern in Docker containers
+
+When running in Docker, use headless="virtual" to enable Xvfb virtual display.
+This prevents display errors in containerized environments.
+"""
+
+import asyncio
+from pytrends_modern import AsyncTrendReq, BrowserConfig
+
+
+async def main():
+    """Example async usage in Docker container"""
+    
+    # Configure for Docker environment
+    config = BrowserConfig(
+        headless="virtual",  # Use Xvfb virtual display for Docker
+        humanize=True,
+        os='linux',
+        geoip=True
+    )
+    
+    # For local development, use:
+    # config = BrowserConfig(headless=False)  # Show browser window
+    # config = BrowserConfig(headless=True)   # Standard headless
+    
+    print("🐳 Running pytrends-modern in Docker container...")
+    print(f"📁 Profile: {config.user_data_dir}")
+    
+    async with AsyncTrendReq(browser_config=config) as pytrends:
+        pytrends.kw_list = ["Docker"]
+        
+        # Get interest over time
+        print("\n📊 Fetching interest_over_time...")
+        df = await pytrends.interest_over_time()
+        print(f"✓ Got {len(df)} rows")
+        print(df.head())
+        
+        # Get interest by region
+        print("\n🌍 Fetching interest_by_region...")
+        df_region = await pytrends.interest_by_region()
+        print(f"✓ Got {len(df_region)} rows")
+        print(df_region.head())
+    
+    print("\n✅ Complete!")
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

{pytrends_modern-0.2.1 → pytrends_modern-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pytrends-modern"
-version = "0.2.1"
+version = "0.2.2"
 description = "Modern Google Trends API - Combining the best of pytrends, with RSS feeds, Selenium scraping, DrissionPage browser automation, and enhanced features"
 readme = "README.md"
 requires-python = ">=3.8"

{pytrends_modern-0.2.1 → pytrends_modern-0.2.2}/pytrends_modern/__init__.py

@@ -2,7 +2,7 @@
 pytrends-modern: Modern Google Trends API
 """
 
-__version__ = "0.2.1"
+__version__ = "0.2.2"
 __author__ = "pytrends-modern contributors"
 __license__ = "MIT"
 

{pytrends_modern-0.2.1 → pytrends_modern-0.2.2}/pytrends_modern/browser_config_camoufox.py

@@ -1,6 +1,6 @@
 """Browser configuration for Camoufox automation"""
 
-from typing import Optional
+from typing import Optional, Union
 import os as os_module
 
 
@@ -18,7 +18,9 @@ class BrowserConfig:
     
     Args:
         headless: Run browser in headless mode (default: False)
-                 Set to 'virtual' on Linux to use Xvfb
+                 - False: Show browser window (for local development)
+                 - True: Standard headless mode (for servers with display)
+                 - 'virtual': Use Xvfb virtual display (for Docker containers)
         proxy_server: Proxy server URL (e.g., 'http://proxy.com:8080')
         proxy_username: Proxy username (for authenticated proxies)
         proxy_password: Proxy password (for authenticated proxies)
@@ -47,7 +49,7 @@ class BrowserConfig:
     
     def __init__(
         self,
-        headless: bool = False,
+        headless: Union[bool, str] = False,
         proxy_server: Optional[str] = None,
         proxy_username: Optional[str] = None,
         proxy_password: Optional[str] = None,

{pytrends_modern-0.2.1 → pytrends_modern-0.2.2/pytrends_modern.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pytrends-modern
-Version: 0.2.1
+Version: 0.2.2
 Summary: Modern Google Trends API - Combining the best of pytrends, with RSS feeds, Selenium scraping, DrissionPage browser automation, and enhanced features
 Author: pytrends-modern contributors
 License: MIT
@@ -175,11 +175,16 @@ RUN mkdir -p /root/.config && \
     cd /root/.config && \
     tar -xzf /tmp/profile.tar.gz
 
-# 3. Use headless mode in container
-config = BrowserConfig(headless=True)
+# 3. Use headless="virtual" in container
+config = BrowserConfig(headless="virtual")  # Use Xvfb for Docker
 ```
 
-See `Dockerfile.example` for complete Docker setup.
+**Headless Options:**
+- `headless=False` - Show browser window (local development)
+- `headless=True` - Standard headless (servers with display)
+- `headless="virtual"` - Xvfb virtual display (Docker containers)
+
+See `Dockerfile.example` and `examples/example_docker_usage.py` for complete Docker setup.
 
 ⚠️ **Security**: Profile contains Google session - keep secure, don't commit to git!
 

{pytrends_modern-0.2.1 → pytrends_modern-0.2.2}/pytrends_modern.egg-info/SOURCES.txt

@@ -5,6 +5,7 @@ pyproject.toml
 examples/advanced_usage.py
 examples/basic_usage.py
 examples/example_browser_mode.py
+examples/example_docker_usage.py
 examples/test_async_integration.py
 pytrends_modern/__init__.py
 pytrends_modern/browser_config.py