Haketilo

# SPDX-License-Identifier: GPL-3.0-or-later

"""

Common fixtures for Haketilo unit tests

"""

# This file is part of Haketilo.

#

# Copyright (C) 2021 Wojtek Kosior <koszko@koszko.org>

#

# This program is free software: you can redistribute it and/or modify

# it under the terms of the GNU General Public License as published by

# the Free Software Foundation, either version 3 of the License, or

# (at your option) any later version.

#

# This program is distributed in the hope that it will be useful,

# but WITHOUT ANY WARRANTY; without even the implied warranty of

# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

# GNU General Public License for more details.

#

# You should have received a copy of the GNU General Public License

# along with this program.  If not, see <https://www.gnu.org/licenses/>.

#

# I, Wojtek Kosior, thereby promise not to sue for violation of this file's

# license. Although I request that you do not make use this code in a

# proprietary program, I am not going to enforce this in court.

import pytest

from ..profiles      import firefox_safe_mode

from ..server        import do_an_internet

from ..script_loader import load_script

@pytest.fixture(scope="package")

def proxy():

    httpd = do_an_internet()

    yield httpd

    httpd.shutdown()

@pytest.fixture(scope="package")

def driver(proxy):

    with firefox_safe_mode() as driver:

        yield driver

        driver.quit()

script_injecting_script = '''\

/*

 * Selenium by default executes scripts in some weird one-time context. We want

 * separately-loaded scripts to be able to access global variables defined

 * before, including those declared with `const` or `let`. To achieve that, we

 * run our scripts by injecting them into the page inside a <script> tag. We use

 * custom properties of the `window` object to communicate with injected code.

 */

const script_elem = document.createElement('script');

script_elem.textContent = arguments[0];

delete window.haketilo_selenium_return_value;

delete window.haketilo_selenium_exception;

window.returnval = (val => window.haketilo_selenium_return_value = val);

window.arguments = arguments[1];

document.body.append(script_elem);

/*

 * To ease debugging, we want this script to forward signal all exceptions from

 * the injectee.

 */

try {

    if (window.haketilo_selenium_exception !== false)

        throw 'Error in injected script! Check your geckodriver.log!';

} finally {

    script_elem.remove();

}

return window.haketilo_selenium_return_value;

'''

def _execute_in_page_context(driver, script, *args):

    script = script + '\n;\nwindow.haketilo_selenium_exception = false;'

    try:

        return driver.execute_script(script_injecting_script, script, args)

    except Exception as e:

        import sys

        lines = enumerate(script.split('\n'), 1)

        for err_info in [('Failing script\n',), *lines]:

            print(*err_info, file=sys.stderr)

        raise e from None

@pytest.fixture(scope="package")

def execute_in_page(driver):

    def do_execute(script, *args, **kwargs):

        if 'page' in kwargs:

            driver.get(kwargs['page'])

        return _execute_in_page_context(driver, script, args)

    yield do_execute

@pytest.fixture(scope="package")

def load_into_page(driver):

    def do_load(path, import_dirs, *args, **kwargs):

        if 'page' in kwargs:

            driver.get(kwargs['page'])

        _execute_in_page_context(driver, load_script(path, import_dirs), args)

    yield do_load