# Licensed to the Software Freedom Conservancy (SFC) under one # or more contributor license agreements. See the NOTICE file # distributed with this work for additional information # regarding copyright ownership. The SFC licenses this file # to you under the Apache License, Version 2.0 (the # "License"); you may not use this file except in compliance # with the License. You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, # software distributed under the License is distributed on an # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. from typing import Union import warnings from selenium.webdriver.common.desired_capabilities import DesiredCapabilities from selenium.webdriver.firefox.firefox_binary import FirefoxBinary from selenium.webdriver.firefox.firefox_profile import FirefoxProfile from selenium.webdriver.common.options import ArgOptions class Log: def __init__(self): self.level = None def to_capabilities(self) -> dict: if self.level: return {"log": {"level": self.level}} return {} class Options(ArgOptions): KEY = "moz:firefoxOptions" def __init__(self): super().__init__() self._binary: FirefoxBinary = None self._preferences: dict = {} self._profile = None self._proxy = None self.log = Log() @property def binary(self) -> FirefoxBinary: """Returns the FirefoxBinary instance""" return self._binary @binary.setter def binary(self, new_binary: Union[str, FirefoxBinary]): """Sets location of the browser binary, either by string or ``FirefoxBinary`` instance. """ if not isinstance(new_binary, FirefoxBinary): new_binary = FirefoxBinary(new_binary) self._binary = new_binary @property def binary_location(self) -> str: """ :Returns: The location of the binary. """ return self.binary._start_cmd @binary_location.setter # noqa def binary_location(self, value: str): """ Sets the location of the browser binary by string """ self.binary = value @property def preferences(self) -> dict: """:Returns: A dict of preferences.""" return self._preferences def set_preference(self, name: str, value: Union[str, int, bool]): """Sets a preference.""" self._preferences[name] = value @property def profile(self) -> FirefoxProfile: """ :Returns: The Firefox profile to use. """ if self._profile: warnings.warn( "Getting a profile has been deprecated.", DeprecationWarning, stacklevel=2 ) return self._profile @profile.setter def profile(self, new_profile: Union[str, FirefoxProfile]): """Sets location of the browser profile to use, either by string or ``FirefoxProfile``. """ warnings.warn( "Setting a profile has been deprecated. Please use the set_preference and install_addons methods", DeprecationWarning, stacklevel=2 ) if not isinstance(new_profile, FirefoxProfile): new_profile = FirefoxProfile(new_profile) self._profile = new_profile @property def headless(self) -> bool: """ :Returns: True if the headless argument is set, else False """ return '-headless' in self._arguments @headless.setter def headless(self, value: bool): """ Sets the headless argument Args: value: boolean value indicating to set the headless option """ if value: self._arguments.append('-headless') elif '-headless' in self._arguments: self._arguments.remove('-headless') def enable_mobile(self, android_package: str = "org.mozilla.firefox", android_activity=None, device_serial=None): super().enable_mobile(android_package, android_activity, device_serial) def to_capabilities(self) -> dict: """Marshals the Firefox options to a `moz:firefoxOptions` object. """ # This intentionally looks at the internal properties # so if a binary or profile has _not_ been set, # it will defer to geckodriver to find the system Firefox # and generate a fresh profile. caps = self._caps opts = {} if self._binary: opts["binary"] = self._binary._start_cmd if self._preferences: opts["prefs"] = self._preferences if self._proxy: self._proxy.add_to_capabilities(caps) if self._profile: opts["profile"] = self._profile.encoded if self._arguments: opts["args"] = self._arguments if self.mobile_options: opts.update(self.mobile_options) opts.update(self.log.to_capabilities()) if opts: caps[Options.KEY] = opts return caps @property def default_capabilities(self) -> dict: return DesiredCapabilities.FIREFOX.copy()