Files
wehub-resource-sync e52ddb7dd4
CodeQL / Analyze (python) (push) Failing after 1s
Linting and testing / build (3.11) (push) Failing after 0s
Package exe with PyInstaller - Windows / build (push) Failing after 2s
Linting and testing / build (3.10) (push) Failing after 1s
Linting and testing / minimal-install (push) Failing after 1s
Update sites rating and statistics / build (push) Failing after 1s
Build docker image and push to DockerHub / docker (push) Failing after 1s
Linting and testing / build (3.12) (push) Failing after 1s
Linting and testing / build (3.14) (push) Failing after 1s
Linting and testing / build (3.13) (push) Failing after 2s
chore: import upstream snapshot with attribution
2026-07-13 12:10:17 +08:00

303 lines
11 KiB
Python

"""Smoke tests for the Flask web interface in maigret.web.app.
The goal is to catch breakage in the basic user flow (render index, kick off
search, redirect to results) without making real network calls. Heavy maigret
internals are mocked; the report-generation smoke test keeps `save_graph_report`
unmocked so regressions like `nt.options.groups = ...` (AttributeError on a
plain dict) are caught automatically.
"""
import os
import pytest
import maigret
import maigret.report
import maigret.settings
from maigret.web import app as web_app_module
CUR_PATH = os.path.dirname(os.path.realpath(__file__))
TEST_DB = os.path.join(CUR_PATH, 'db.json')
class _SyncThread:
"""Drop-in for threading.Thread that runs target synchronously on start()."""
def __init__(self, target=None, args=(), kwargs=None, **_):
self._target = target
self._args = args
self._kwargs = kwargs or {}
def start(self):
self._target(*self._args, **self._kwargs)
@pytest.fixture
def web_app(tmp_path):
web_app_module.app.config['TESTING'] = True
web_app_module.app.config['REPORTS_FOLDER'] = str(tmp_path)
web_app_module.app.config['MAIGRET_DB_FILE'] = TEST_DB
web_app_module.background_jobs.clear()
web_app_module.job_results.clear()
yield web_app_module
web_app_module.background_jobs.clear()
web_app_module.job_results.clear()
@pytest.fixture
def client(web_app):
return web_app.app.test_client()
def test_index_renders(client):
resp = client.get('/')
assert resp.status_code == 200
body = resp.get_data(as_text=True)
assert 'name="usernames"' in body
assert '<form' in body
def test_search_empty_input_redirects_to_index(client):
resp = client.post('/search', data={'usernames': ''})
assert resp.status_code == 302
assert resp.location.rstrip('/').endswith('') or resp.location.endswith('/')
def test_search_redirects_to_status(client, web_app, monkeypatch):
monkeypatch.setattr(web_app, 'process_search_task', lambda *a, **kw: None)
monkeypatch.setattr(web_app, 'Thread', _SyncThread)
resp = client.post('/search', data={'usernames': 'soxoj'})
assert resp.status_code == 302
assert '/status/' in resp.location
def test_invalid_timestamp_redirects_to_index(client):
resp = client.get('/status/nonexistent_ts')
assert resp.status_code == 302
assert resp.location.endswith('/')
def test_status_running_renders_status_page(client, web_app, monkeypatch):
"""While the background job is still running, /status/<ts> returns 200."""
def never_completes(usernames, options, timestamp):
# leave background_jobs[timestamp]['completed'] as False
pass
monkeypatch.setattr(web_app, 'process_search_task', never_completes)
monkeypatch.setattr(web_app, 'Thread', _SyncThread)
post = client.post('/search', data={'usernames': 'soxoj'})
status_resp = client.get(post.location)
assert status_resp.status_code == 200
def test_completed_search_redirects_to_results(client, web_app, monkeypatch):
"""Happy path: POST /search → background completes → /status/<ts> → /results/<session>."""
def fake_task(usernames, options, timestamp):
web_app.job_results[timestamp] = {
'status': 'completed',
'session_folder': f'search_{timestamp}',
'graph_file': f'search_{timestamp}/combined_graph.html',
'usernames': usernames,
'individual_reports': [],
}
web_app.background_jobs[timestamp]['completed'] = True
monkeypatch.setattr(web_app, 'process_search_task', fake_task)
monkeypatch.setattr(web_app, 'Thread', _SyncThread)
post = client.post('/search', data={'usernames': 'soxoj'})
assert post.status_code == 302
status_resp = client.get(post.location)
assert status_resp.status_code == 302
assert '/results/search_' in status_resp.location
results_resp = client.get(status_resp.location)
assert results_resp.status_code == 200
assert b'soxoj' in results_resp.data
def test_failed_task_redirects_to_index(client, web_app, monkeypatch):
def failing_task(usernames, options, timestamp):
web_app.job_results[timestamp] = {'status': 'failed', 'error': 'boom'}
web_app.background_jobs[timestamp]['completed'] = True
monkeypatch.setattr(web_app, 'process_search_task', failing_task)
monkeypatch.setattr(web_app, 'Thread', _SyncThread)
post = client.post('/search', data={'usernames': 'soxoj'})
status_resp = client.get(post.location)
assert status_resp.status_code == 302
assert status_resp.location.endswith('/')
def test_download_report_serves_file_inside_reports_folder(client, web_app, tmp_path):
"""Happy path: a real file inside REPORTS_FOLDER is served back."""
target = tmp_path / 'session1'
target.mkdir()
(target / 'report.json').write_text('{"ok": true}')
resp = client.get('/reports/session1/report.json')
assert resp.status_code == 200
assert resp.get_data() == b'{"ok": true}'
def test_download_report_blocks_dotdot_traversal(client, web_app, tmp_path):
"""A literal ../ in the path must not escape REPORTS_FOLDER."""
secret = tmp_path.parent / 'outside_secret.txt'
secret.write_text('SECRET')
resp = client.get('/reports/..%2Foutside_secret.txt')
assert resp.status_code == 404
assert b'SECRET' not in resp.get_data()
def test_download_report_blocks_sibling_prefix_bypass(client, web_app, tmp_path):
"""Regression: the previous startswith() check let `<reports_root>2/secret`
bypass containment because '/tmp/maigret_reports2'.startswith('/tmp/maigret_reports')
is True. send_from_directory enforces a real boundary."""
sibling = tmp_path.parent / (tmp_path.name + '_sibling')
sibling.mkdir()
(sibling / 'leak.txt').write_text('LEAK')
encoded = '..%2F' + sibling.name + '%2Fleak.txt'
resp = client.get('/reports/' + encoded)
assert resp.status_code == 404
assert b'LEAK' not in resp.get_data()
def test_download_report_blocks_absolute_path(client, web_app, tmp_path):
"""An absolute filename must not escape REPORTS_FOLDER."""
secret = tmp_path.parent / 'abs_secret.txt'
secret.write_text('ABSOLUTE')
resp = client.get('/reports/' + str(secret).lstrip('/'))
assert resp.status_code == 404
assert b'ABSOLUTE' not in resp.get_data()
def test_search_passes_cloudflare_bypass_from_settings(client, web_app, monkeypatch):
"""If settings.json enables cloudflare_bypass with a valid FlareSolverr module,
the web search must forward that config to maigret.search via the
cloudflare_bypass kwarg. Guards the wiring in maigret_search()."""
captured = {}
async def fake_search(*args, **kwargs):
captured.update(kwargs)
return {}
def fake_load(self, paths=None):
self.cloudflare_bypass = {
"enabled": True,
"session_prefix": "test-prefix",
"trigger_protection": ["cf_js_challenge"],
"modules": [
{
"name": "flaresolverr",
"method": "json_api",
"url": "http://flare.test:8191/v1",
"max_timeout_ms": 60000,
}
],
}
return True, ""
monkeypatch.setattr(maigret.settings.Settings, 'load', fake_load)
monkeypatch.setattr(maigret, 'search', fake_search)
monkeypatch.setattr(maigret.report, 'save_graph_report', lambda *a, **kw: None)
monkeypatch.setattr(maigret.report, 'save_csv_report', lambda *a, **kw: None)
monkeypatch.setattr(maigret.report, 'save_json_report', lambda *a, **kw: None)
monkeypatch.setattr(maigret.report, 'save_pdf_report', lambda *a, **kw: None)
monkeypatch.setattr(maigret.report, 'save_html_report', lambda *a, **kw: None)
monkeypatch.setattr(maigret.report, 'generate_report_context', lambda *a, **kw: {})
monkeypatch.setattr(web_app, 'Thread', _SyncThread)
client.post('/search', data={'usernames': 'testuser'})
assert 'cloudflare_bypass' in captured, (
'maigret.search was not given a cloudflare_bypass kwarg'
)
cf = captured['cloudflare_bypass']
assert cf is not None
assert cf['session_prefix'] == 'test-prefix'
assert cf['trigger_protection'] == ['cf_js_challenge']
assert len(cf['modules']) == 1
assert cf['modules'][0]['url'] == 'http://flare.test:8191/v1'
assert cf['modules'][0]['method'] == 'json_api'
def test_search_omits_cloudflare_bypass_when_disabled(client, web_app, monkeypatch):
"""When settings has no cloudflare_bypass (or enabled=false), the kwarg
must be None so the default checker pipeline runs."""
captured = {}
async def fake_search(*args, **kwargs):
captured.update(kwargs)
return {}
def fake_load(self, paths=None):
# no cloudflare_bypass attribute at all
return True, ""
monkeypatch.setattr(maigret.settings.Settings, 'load', fake_load)
monkeypatch.setattr(maigret, 'search', fake_search)
monkeypatch.setattr(maigret.report, 'save_graph_report', lambda *a, **kw: None)
monkeypatch.setattr(maigret.report, 'save_csv_report', lambda *a, **kw: None)
monkeypatch.setattr(maigret.report, 'save_json_report', lambda *a, **kw: None)
monkeypatch.setattr(maigret.report, 'save_pdf_report', lambda *a, **kw: None)
monkeypatch.setattr(maigret.report, 'save_html_report', lambda *a, **kw: None)
monkeypatch.setattr(maigret.report, 'generate_report_context', lambda *a, **kw: {})
monkeypatch.setattr(web_app, 'Thread', _SyncThread)
client.post('/search', data={'usernames': 'testuser'})
assert captured.get('cloudflare_bypass') is None
def test_real_report_generation_does_not_crash(client, web_app, monkeypatch):
"""End-to-end with mocked maigret.search but REAL report generation.
This is the regression guard for bugs inside `save_graph_report` and friends
(e.g. `nt.options.groups = ...` raising AttributeError on a dict). If any of
the unmocked report functions throws, the task records a failed status and
this assertion catches it.
"""
async def fake_search(*args, **kwargs):
return {}
monkeypatch.setattr(maigret, 'search', fake_search)
# Mock the per-username report writers — they are not what we care about here,
# and pdf/html generation pulls in xhtml2pdf which is slow and brittle.
monkeypatch.setattr(maigret.report, 'save_csv_report', lambda *a, **kw: None)
monkeypatch.setattr(maigret.report, 'save_json_report', lambda *a, **kw: None)
monkeypatch.setattr(maigret.report, 'save_pdf_report', lambda *a, **kw: None)
monkeypatch.setattr(maigret.report, 'save_html_report', lambda *a, **kw: None)
monkeypatch.setattr(maigret.report, 'generate_report_context', lambda *a, **kw: {})
monkeypatch.setattr(web_app, 'Thread', _SyncThread)
post = client.post('/search', data={'usernames': 'testuser'})
timestamp = post.location.rsplit('/', 1)[1]
assert timestamp in web_app.job_results, 'background task did not record any result'
result = web_app.job_results[timestamp]
assert result['status'] == 'completed', (
f"report generation failed: {result.get('error')!r}"
)