headless-driver 0.0.1__tar.gz

headless_driver-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Nuhman Pk
+
+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.

headless_driver-0.0.1/PKG-INFO

@@ -0,0 +1,113 @@
+Metadata-Version: 2.4
+Name: headless-driver
+Version: 0.0.1
+Summary: A simple Python package for managing Selenium Chrome drivers in headless mode.
+Author-email: nuhmanpk <nuhmanpk7@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2025 Nuhman Pk
+        
+        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.
+        
+Project-URL: Homepage, https://github.com/nuhmanpk/headless-driver
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: selenium>=4.0.0
+Dynamic: license-file
+
+[![PyPI version](https://badge.fury.io/py/headless-driver.svg)](https://badge.fury.io/py/headless-driver)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Build Status](https://github.com/nuhmanpk/headless-driver/actions/workflows/python-package.yml/badge.svg)](https://github.com/nuhmanpk/headless-driver/actions)
+
+# headless-driver
+
+A simple Python package for managing Selenium Chrome drivers in headless mode.
+
+## Features
+- Headless Chrome driver management
+- Temporary user data directory
+- Custom window size and user agent
+- Easy cleanup and context manager support
+- Remote and local driver support
+
+## Installation
+
+```bash
+pip install headless-driver
+```
+
+## Usage
+
+```python
+from headless import Headless
+
+hl = Headless()
+driver = hl.get_driver()
+driver.get("https://example.com")
+print(driver.title)
+hl.quit()
+```
+
+Or use as a context manager:
+
+```python
+from headless import Headless
+
+with Headless() as driver:
+    driver.get("https://example.com")
+    print(driver.title)
+```
+
+## API Documentation
+
+### Headless class
+
+```python
+Headless(
+    user_data_dir: Optional[str] = None,
+    window_size: Tuple[int, int] = (1920, 1080),
+    user_agent: Optional[str] = None,
+    headless: bool = True,
+    chrome_driver_path: Optional[str] = '/opt/homebrew/bin/chromedriver',
+    additional_args: Optional[List[str]] = None,
+    remote_url: Optional[str] = None,
+)
+```
+
+- `user_data_dir`: Path for Chrome user data (temporary if not provided)
+- `window_size`: Browser window size (default: 1920x1080)
+- `user_agent`: Custom user agent string
+- `headless`: Run Chrome in headless mode (default: True)
+- `chrome_driver_path`: Path to chromedriver executable
+- `additional_args`: List of extra Chrome arguments
+- `remote_url`: Use remote Selenium server if provided
+
+### Methods
+- `get_driver()`: Returns a Selenium WebDriver instance
+- `quit()`: Quits the driver and cleans up user data
+
+## Running Tests
+
+```bash
+python -m unittest discover tests
+```
+
+## License
+MIT

headless_driver-0.0.1/README.md

@@ -0,0 +1,79 @@
+[![PyPI version](https://badge.fury.io/py/headless-driver.svg)](https://badge.fury.io/py/headless-driver)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Build Status](https://github.com/nuhmanpk/headless-driver/actions/workflows/python-package.yml/badge.svg)](https://github.com/nuhmanpk/headless-driver/actions)
+
+# headless-driver
+
+A simple Python package for managing Selenium Chrome drivers in headless mode.
+
+## Features
+- Headless Chrome driver management
+- Temporary user data directory
+- Custom window size and user agent
+- Easy cleanup and context manager support
+- Remote and local driver support
+
+## Installation
+
+```bash
+pip install headless-driver
+```
+
+## Usage
+
+```python
+from headless import Headless
+
+hl = Headless()
+driver = hl.get_driver()
+driver.get("https://example.com")
+print(driver.title)
+hl.quit()
+```
+
+Or use as a context manager:
+
+```python
+from headless import Headless
+
+with Headless() as driver:
+    driver.get("https://example.com")
+    print(driver.title)
+```
+
+## API Documentation
+
+### Headless class
+
+```python
+Headless(
+    user_data_dir: Optional[str] = None,
+    window_size: Tuple[int, int] = (1920, 1080),
+    user_agent: Optional[str] = None,
+    headless: bool = True,
+    chrome_driver_path: Optional[str] = '/opt/homebrew/bin/chromedriver',
+    additional_args: Optional[List[str]] = None,
+    remote_url: Optional[str] = None,
+)
+```
+
+- `user_data_dir`: Path for Chrome user data (temporary if not provided)
+- `window_size`: Browser window size (default: 1920x1080)
+- `user_agent`: Custom user agent string
+- `headless`: Run Chrome in headless mode (default: True)
+- `chrome_driver_path`: Path to chromedriver executable
+- `additional_args`: List of extra Chrome arguments
+- `remote_url`: Use remote Selenium server if provided
+
+### Methods
+- `get_driver()`: Returns a Selenium WebDriver instance
+- `quit()`: Quits the driver and cleans up user data
+
+## Running Tests
+
+```bash
+python -m unittest discover tests
+```
+
+## License
+MIT

headless_driver-0.0.1/headless/__init__.py

@@ -0,0 +1 @@
+# headless package init

headless_driver-0.0.1/headless/core.py

@@ -0,0 +1,98 @@
+import os
+import uuid
+import shutil
+import tempfile
+from typing import List, Optional, Tuple
+
+from selenium import webdriver
+from selenium.webdriver.chrome.options import Options
+from selenium.webdriver.chrome.service import Service
+from selenium.webdriver.remote.webdriver import WebDriver
+
+class Headless:
+    def __init__(
+        self,
+        user_data_dir: Optional[str] = None,
+        window_size: Tuple[int, int] = (1920, 1080),
+        user_agent: Optional[str] = None,
+        headless: bool = True,
+        chrome_driver_path: Optional[str] = '/opt/homebrew/bin/chromedriver',
+        additional_args: Optional[List[str]] = None,
+        remote_url: Optional[str] = None,
+    ):
+        self.id = uuid.uuid4().hex
+        if user_data_dir:
+            self.user_data_dir = user_data_dir
+            self._cleanup_dir = False
+        else:
+            prefix = f"chrome-user-data-{self.id}-"
+            self.user_data_dir = tempfile.mkdtemp(prefix=prefix)
+            self._cleanup_dir = True
+
+        self.window_size = window_size
+        self.user_agent = (
+            user_agent
+            or "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 "
+               "(KHTML, like Gecko) Chrome/87.0.4280.88 Safari/537.36"
+        )
+        self.headless = headless
+        self.additional_args = additional_args or []
+        self.chrome_driver_path = chrome_driver_path
+        self.remote_url = remote_url
+        self._driver: Optional[WebDriver] = None
+
+    def _build_options(self) -> Options:
+        opts = Options()
+        opts.add_argument(f"--user-data-dir={self.user_data_dir}")
+        if self.headless:
+            opts.add_argument("--headless=new")
+        opts.add_argument(f"--window-size={self.window_size[0]},{self.window_size[1]}")
+        opts.add_argument("--disable-gpu")
+        opts.add_argument("--no-sandbox")
+        opts.add_argument("--disable-dev-shm-usage")
+        opts.add_argument(f"user-agent={self.user_agent}")
+        for arg in self.additional_args:
+            opts.add_argument(arg)
+        return opts
+
+    def get_driver(self) -> WebDriver:
+        if self._driver:
+            return self._driver
+
+        opts = self._build_options()
+
+        if self.remote_url:
+            self._driver = webdriver.Remote(
+                command_executor=self.remote_url,
+                options=opts
+            )
+        else:
+            if self.chrome_driver_path:
+                service = Service(executable_path=self.chrome_driver_path)
+                self._driver = webdriver.Chrome(
+                    service=service,
+                    options=opts
+                )
+            else:
+                self._driver = webdriver.Chrome(
+                    options=opts
+                )
+
+        return self._driver
+
+    def quit(self) -> None:
+        if self._driver:
+            try:
+                self._driver.quit()
+            except Exception:
+                pass
+            self._driver = None
+
+        if self._cleanup_dir and os.path.isdir(self.user_data_dir):
+            shutil.rmtree(self.user_data_dir, ignore_errors=True)
+
+    def __enter__(self) -> WebDriver:
+        return self.get_driver()
+
+    def __exit__(self) -> None:
+        self.quit()

headless_driver-0.0.1/headless_driver.egg-info/PKG-INFO

@@ -0,0 +1,113 @@
+Metadata-Version: 2.4
+Name: headless-driver
+Version: 0.0.1
+Summary: A simple Python package for managing Selenium Chrome drivers in headless mode.
+Author-email: nuhmanpk <nuhmanpk7@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2025 Nuhman Pk
+        
+        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.
+        
+Project-URL: Homepage, https://github.com/nuhmanpk/headless-driver
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: selenium>=4.0.0
+Dynamic: license-file
+
+[![PyPI version](https://badge.fury.io/py/headless-driver.svg)](https://badge.fury.io/py/headless-driver)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Build Status](https://github.com/nuhmanpk/headless-driver/actions/workflows/python-package.yml/badge.svg)](https://github.com/nuhmanpk/headless-driver/actions)
+
+# headless-driver
+
+A simple Python package for managing Selenium Chrome drivers in headless mode.
+
+## Features
+- Headless Chrome driver management
+- Temporary user data directory
+- Custom window size and user agent
+- Easy cleanup and context manager support
+- Remote and local driver support
+
+## Installation
+
+```bash
+pip install headless-driver
+```
+
+## Usage
+
+```python
+from headless import Headless
+
+hl = Headless()
+driver = hl.get_driver()
+driver.get("https://example.com")
+print(driver.title)
+hl.quit()
+```
+
+Or use as a context manager:
+
+```python
+from headless import Headless
+
+with Headless() as driver:
+    driver.get("https://example.com")
+    print(driver.title)
+```
+
+## API Documentation
+
+### Headless class
+
+```python
+Headless(
+    user_data_dir: Optional[str] = None,
+    window_size: Tuple[int, int] = (1920, 1080),
+    user_agent: Optional[str] = None,
+    headless: bool = True,
+    chrome_driver_path: Optional[str] = '/opt/homebrew/bin/chromedriver',
+    additional_args: Optional[List[str]] = None,
+    remote_url: Optional[str] = None,
+)
+```
+
+- `user_data_dir`: Path for Chrome user data (temporary if not provided)
+- `window_size`: Browser window size (default: 1920x1080)
+- `user_agent`: Custom user agent string
+- `headless`: Run Chrome in headless mode (default: True)
+- `chrome_driver_path`: Path to chromedriver executable
+- `additional_args`: List of extra Chrome arguments
+- `remote_url`: Use remote Selenium server if provided
+
+### Methods
+- `get_driver()`: Returns a Selenium WebDriver instance
+- `quit()`: Quits the driver and cleans up user data
+
+## Running Tests
+
+```bash
+python -m unittest discover tests
+```
+
+## License
+MIT

headless_driver-0.0.1/headless_driver.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+headless/__init__.py
+headless/core.py
+headless_driver.egg-info/PKG-INFO
+headless_driver.egg-info/SOURCES.txt
+headless_driver.egg-info/dependency_links.txt
+headless_driver.egg-info/requires.txt
+headless_driver.egg-info/top_level.txt
+tests/test_core.py

headless_driver-0.0.1/headless_driver.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

headless_driver-0.0.1/headless_driver.egg-info/requires.txt

@@ -0,0 +1 @@
+selenium>=4.0.0

headless_driver-0.0.1/headless_driver.egg-info/top_level.txt

@@ -0,0 +1 @@
+headless

headless_driver-0.0.1/pyproject.toml

@@ -0,0 +1,20 @@
+[build-system]
+requires = ["setuptools>=42", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "headless-driver"
+version = "0.0.1"
+description = "A simple Python package for managing Selenium Chrome drivers in headless mode."
+authors = [
+    { name="nuhmanpk", email="nuhmanpk7@gmail.com" }
+]
+license = { file = "LICENSE" }
+readme = "README.md"
+requires-python = ">=3.7"
+dependencies = [
+    "selenium>=4.0.0"
+]
+
+[project.urls]
+Homepage = "https://github.com/nuhmanpk/headless-driver"

headless_driver-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

headless_driver-0.0.1/tests/test_core.py

@@ -0,0 +1,13 @@
+import unittest
+from headless.core import Headless
+
+class TestHeadless(unittest.TestCase):
+    def test_driver_creation_and_quit(self):
+        hl = Headless(headless=True)
+        driver = hl.get_driver()
+        self.assertIsNotNone(driver)
+        hl.quit()
+        self.assertIsNone(hl._driver)
+
+if __name__ == "__main__":
+    unittest.main()