browser-dog 0.0.1__tar.gz

browser_dog-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Chandler Song
+
+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.

browser_dog-0.0.1/PKG-INFO

@@ -0,0 +1,47 @@
+Metadata-Version: 2.1
+Name: browser_dog
+Version: 0.0.1
+Summary: chrome selenium browser by cookies
+Home-page: https://www.linkedin.com/in/chandlersong/
+Author: chandler song
+Author-email: 275737875@qq.com
+License: MIT
+Keywords: selenium automation browser cookies
+Platform: all
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Natural Language :: Chinese (Simplified)
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Topic :: Software Development :: Libraries
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# Introduction
+## Install package
+```shell
+pip install browser_dog
+```
+## Preparation
+
+- create file `linkedin_cookies.json`
+
+- please use Chrome Extension `EditThisCookie` to export linkedin cookies to `linkedin_cookies.json`
+
+##  Example Usage:
+
+```python
+from browser_dog.browser import BrowserDog
+
+cat = BrowserDog('cookie.json', 'https://gitee.com', headless=True)
+driver = cat.get_driver()
+
+driver.get("https://gitee.com/login")
+cat.long_wait()
+
+# Get HTML
+html = driver.page_source
+
+```

browser_dog-0.0.1/README.md

@@ -0,0 +1,26 @@
+# Introduction
+## Install package
+```shell
+pip install browser_dog
+```
+## Preparation
+
+- create file `linkedin_cookies.json`
+
+- please use Chrome Extension `EditThisCookie` to export linkedin cookies to `linkedin_cookies.json`
+
+##  Example Usage:
+
+```python
+from browser_dog.browser import BrowserDog
+
+cat = BrowserDog('cookie.json', 'https://gitee.com', headless=True)
+driver = cat.get_driver()
+
+driver.get("https://gitee.com/login")
+cat.long_wait()
+
+# Get HTML
+html = driver.page_source
+
+```

browser_dog-0.0.1/browser_dog/browser.py

@@ -0,0 +1,98 @@
+import time
+import random
+from selenium import webdriver
+from selenium.webdriver.chrome.options import Options
+import json
+import os
+from colorama import Fore, Style
+
+class BrowserDog:
+    def __init__(self, cookies_json: str, base_url: str, headless=False):
+        """
+        Initializes the Chrome Driver.
+        """
+        try:
+            print(Fore.BLACK + "=" * 30 + " Initializing Driver " + "=" * 30 + Style.RESET_ALL)
+            # use local selenium driver
+            self.options = Options()
+            # headless mode
+            if headless:
+                self.options.add_argument("--headless")
+            self.driver = webdriver.Chrome(options=self.options)
+
+            # use docker selenium/standalone-chrome
+            # selenium_grid_url = 'http://localhost:4444/wd/hub'
+            # option = Options()
+            # option.set_capability("browserName", "chrome")
+            # option.set_capability("platformName", "Linux")
+            # print('Initialize selenium')
+            # self.driver = webdriver.Remote(command_executor=selenium_grid_url, options=option)
+
+            self.driver.maximize_window()
+            print(Fore.GREEN + "Opening URL Page: " + base_url + Style.RESET_ALL)
+            self.driver.get(base_url)
+            self.medium_wait()
+
+            if not os.path.exists(cookies_json):
+                print(Fore.RED + "No cookies file found, please login first, default: cookies.json " + Style.RESET_ALL)
+            else:
+                with open(cookies_json, 'r') as file:
+                    cookies = json.loads(file.read())
+
+                for cookie in cookies:
+                    cookie['sameSite'] = "None"
+                    self.driver.add_cookie(cookie)
+
+                print(Fore.GREEN + "Refreshing the page to apply cookies" + Style.RESET_ALL)
+                self.driver.refresh()
+                self.medium_wait()
+                print(Fore.GREEN + "Successfully login the website, please start browsering..." + Style.RESET_ALL)
+        except Exception as e:
+            print(Fore.RED + f'Error: {e}' + Style.RESET_ALL)
+
+    def get_driver(self):
+        return self.driver
+
+    def scroll_to_bottom(self):
+        """
+        Scrolls to the bottom of the page.
+        """
+        self.driver.execute_script("window.scrollTo(0, document.body.scrollHeight);")
+
+    def scroll_to_top(self):
+        """
+        Scrolls to the top of the page.
+        """
+        self.driver.execute_script("window.scrollTo(0, 0);")
+
+    def scroll_to_middle(self):
+        """
+        Scrolls to the middle of the page.
+        """
+        self.driver.execute_script("window.scrollTo(0, document.body.scrollHeight/2);")
+
+    def scroll_to_random(self):
+        """
+        Scrolls to a random position of the page.
+        """
+        self.driver.execute_script("window.scrollTo(0, Math.floor(Math.random() * document.body.scrollHeight));")
+
+    def short_wait(self):
+        """
+        Sleeps for a random amount of time between 1 and 3 seconds.
+        """
+        time.sleep(random.randint(1, 3))
+
+    def medium_wait(self):
+        """
+        Sleeps for a random amount of time between 3 and 5 seconds.
+        """
+        time.sleep(random.randint(3, 5))
+
+    def long_wait(self):
+        """
+        Sleeps for a random amount of time between 5 and 10 seconds.
+        """
+        time.sleep(random.randint(5, 10))
+
+

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

@@ -0,0 +1,47 @@
+Metadata-Version: 2.1
+Name: browser-dog
+Version: 0.0.1
+Summary: chrome selenium browser by cookies
+Home-page: https://www.linkedin.com/in/chandlersong/
+Author: chandler song
+Author-email: 275737875@qq.com
+License: MIT
+Keywords: selenium automation browser cookies
+Platform: all
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Natural Language :: Chinese (Simplified)
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Topic :: Software Development :: Libraries
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# Introduction
+## Install package
+```shell
+pip install browser_dog
+```
+## Preparation
+
+- create file `linkedin_cookies.json`
+
+- please use Chrome Extension `EditThisCookie` to export linkedin cookies to `linkedin_cookies.json`
+
+##  Example Usage:
+
+```python
+from browser_dog.browser import BrowserDog
+
+cat = BrowserDog('cookie.json', 'https://gitee.com', headless=True)
+driver = cat.get_driver()
+
+driver.get("https://gitee.com/login")
+cat.long_wait()
+
+# Get HTML
+html = driver.page_source
+
+```

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

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+setup.py
+browser_dog/__init__.py
+browser_dog/browser.py
+browser_dog.egg-info/PKG-INFO
+browser_dog.egg-info/SOURCES.txt
+browser_dog.egg-info/dependency_links.txt
+browser_dog.egg-info/requires.txt
+browser_dog.egg-info/top_level.txt

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,2 @@
+selenium
+colorama

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

@@ -0,0 +1 @@
+browser_dog

browser_dog-0.0.1/setup.cfg

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

browser_dog-0.0.1/setup.py

@@ -0,0 +1,32 @@
+from distutils.core import setup
+from setuptools import find_packages
+with open("README.md", "r",encoding='utf-8') as f:
+  long_description = f.read()
+setup(name='browser_dog',  # 包名
+      version='0.0.1',  # 版本号
+      description='chrome selenium browser by cookies',
+      long_description_content_type = 'text/markdown',
+      long_description=long_description,
+      author='chandler song',
+      author_email='275737875@qq.com',
+      url='https://www.linkedin.com/in/chandlersong/',
+      keywords = "selenium automation browser cookies",
+      license='MIT',
+      packages = find_packages(),
+      install_requires=[
+          "selenium",
+          "colorama",
+      ],
+      platforms=["all"],
+      classifiers=[
+          'Intended Audience :: Developers',
+          'Operating System :: OS Independent',
+          'Natural Language :: Chinese (Simplified)',
+          'Programming Language :: Python :: 3.7',
+          'Programming Language :: Python :: 3.8',
+          'Programming Language :: Python :: 3.9',
+          'Programming Language :: Python :: 3.10',
+          'Topic :: Software Development :: Libraries'
+      ],
+
+      )