Selenium Wrapper

The darc.selenium module wraps around the selenium module, and provides some simple interface for the darc project.

darc.selenium.get_capabilities(type='null')

Generate desied capabilities.

Parameters:

type (str) – Proxy type for capabilities.

Return type:

Dict[str, str]

Returns:

The desied capabilities for the web driver WebDriver.

Raises:

UnsupportedProxy – If the proxy type is NOT null, tor or i2p.

See also

• darc.proxy.tor.TOR_SELENIUM_PROXY

• darc.proxy.i2p.I2P_SELENIUM_PROXY

darc.selenium.get_options(type='null')

Generate options.

Parameters:

type (str) – Proxy type for options.

Returns:

The options for the web driver

WebDriver.

Return type:

selenium.webdriver.chrome.options.Options

Raises:

• UnsupportedPlatform – If the operation system is NOT macOS or Linux and CHROME_BINARY_LOCATION is NOT set.

• UnsupportedProxy – If the proxy type is NOT null, tor or i2p.

Important

The function raises UnsupportedPlatform in cases where BINARY_LOCATION is None.

Please provide CHROME_BINARY_LOCATION when running darc in loader mode on non macOS and/or Linux systems.

See also

• darc.proxy.tor.TOR_PORT

• darc.proxy.i2p.I2P_PORT

References

• Google Chrome command line switches

• Disable sandbox (--no-sandbox) when running as root user

  • https://crbug.com/638180

  • https://stackoverflow.com/a/50642913/7218152

• Disable usage of /dev/shm

  • http://crbug.com/715363

• Using Socks proxy

darc.selenium.i2p_driver()

I2P (.i2p) driver.

Returns:

The web driver object with I2P proxy settings.

Return type:

selenium.webdriver.chrome.webdriver.WebDriver

See also

• darc.selenium.get_options()

• darc.selenium.get_capabilities()

darc.selenium.null_driver()

No proxy driver.

Returns:

The web driver object with no proxy settings.

Return type:

selenium.webdriver.chrome.webdriver.WebDriver

See also

• darc.selenium.get_options()

• darc.selenium.get_capabilities()

darc.selenium.request_driver(link)

Get selenium driver.

Parameters:

link (Link) – Link requesting for WebDriver.

Returns:

The web driver object with corresponding proxy settings.

Return type:

selenium.webdriver.chrome.webdriver.WebDriver

Raises:

UnsupportedLink – If the proxy type of link if not specified in the LINK_MAP.

See also

• darc.proxy.LINK_MAP

darc.selenium.tor_driver()

Tor (.onion) driver.

Returns:

The web driver object with Tor proxy settings.

Return type:

selenium.webdriver.chrome.webdriver.WebDriver

See also

• darc.selenium.get_options()

• darc.selenium.get_capabilities()

darc.selenium.BINARY_LOCATION: str | None

Path to Google Chrome binary location.

Default:

google-chrome

Environ:

CHROME_BINARY_LOCATION