ichrome

Chrome controller for Humans, base on Chrome Devtools Protocol(CDP) and python3.7+. Read Docs

If you encounter any problems, please let me know through issues, some of them will be a good opinion for the enhancement of ichrome.

Install

pip install ichrome -U

Uninstall & Clear the user data folder

    $ python3 -m ichrome --clean
    $ pip uninstall ichrome

Quick Start

import asyncio
from ichrome import AsyncChromeDaemon


async def test():
    async with AsyncChromeDaemon() as cd:
        # create a new tab
        async with cd.connect_tab(index=None) as tab:
            await tab.goto('https://github.com/ClericPy/ichrome', timeout=5)
            print(await tab.title)
        # Privacy Mode, proxyServer arg maybe not work on Chrome, for `Target.createBrowserContext` is the EXPERIMENTAL feature(but chromium is ok).
        # https://chromedevtools.github.io/devtools-protocol/tot/Target/#method-createBrowserContext
        async with cd.incognito_tab(proxyServer='http://127.0.0.1:8080') as tab:
            await tab.goto('https://httpbin.org/ip', timeout=5)
            print(await tab.html)


asyncio.run(test())

Read Docs

Why?

• In desperate need of a stable toolkit to communicate with Chrome browser (or other Blink-based browsers such as Chromium)
  • ichrome includes fast http & websocket connections (based on aiohttp) within an asyncio environment
• Pyppeteer is awesome
  • But I don't need so much, and the spelling of pyppeteer is confused
  • Event-driven architecture(EDA) is not always smart.
• Selenium is slow
  • Webdriver often comes with memory leak
    • PhantomJS development is suspended
  • No native coroutine(asyncio) support
• Playwright comes too late
  • This may be a good choice for both sync and async usage
    • The 1st author of puppeteer joined it.
  • But its core code is based on Node.js, which is too hard to monkey-patch.

Features

As we known, Javascript is the first-class citizen of the Browser world, so learn to use it with ichrome frequently.

• A process daemon of Chrome instances
  • auto-restart
  • command-line usage
  • async environment compatible
• Connect to an existing Chrome
• Operations on Tabs under stable websocket
  • Commonly used functions
  • Incognito Mode
• ChromeEngine as the progress pool
  • support HTTP api router with FastAPI (EXPERIMENTAL)
    • launch the chrome pool with python -m ichrome.web
      • python -m ichrome.web --help for usage
• Flatten mode with sessionId
  • Create only 1 WebSocket connection
  • New in version 2.9.0
    • EXPERIMENTAL
    • Share the same Websocket connection and use sessionId to distinguish requests
  • After v3.0.1
    • AsyncTab._DEFAULT_FLATTEN = True
• The install script of chromium
• debug mode for sync usage with ichrome.debugger >4.0.0 (EXPERIMENTAL)