🕵️♂️ (2-in-1) Email & Username OSINT suite featuring native MCP support for deep data extraction just from a single Email/Username. Analyzes 2720+ actively maintained scan vectors (210+ email / 2510+ username) for security research, investigations, and digital footprinting.
Python cybersecuritycybersecurity-toolsemail-osintethical-hackingethical-hacking-toolsidentificationinfosecosintosint-emailosint-toolosint-toolsosint-usernamepentestingpythonredteam-toolsredteamingthreat-intelligence
import contextlib
import io
import json
import sys
import pytest
from user_scanner.core.result import Result
import user_scanner.__main__ as cli
def test_json_export_new_file(monkeypatch, tmp_path):
output = tmp_path / "new_report.json"
monkeypatch.setattr(
sys, "argv", ["user-scanner", "-u", "audit", "-f", "json", "-o", str(output)]
)
monkeypatch.setattr(cli, "check_for_updates", lambda: None)
monkeypatch.setattr(cli, "print_banner", lambda: None)
monkeypatch.setattr(
cli, "run_user_full", lambda *args: [Result.taken(username="audit", site_name="Example")]
)
with contextlib.redirect_stdout(io.StringIO()) as captured:
cli.main()
assert output.exists()
data = json.loads(output.read_text(encoding="utf-8"))
assert len(data) == 1
assert data[0]["username"] == "audit"
assert "JSON Results saved" in captured.getvalue()
def test_json_export_append_valid_existing(monkeypatch, tmp_path):
output = tmp_path / "report.json"
initial_data = [{"username": "prior_user", "site_name": "PriorSite"}]
output.write_text(json.dumps(initial_data), encoding="utf-8")
monkeypatch.setattr(
sys, "argv", ["user-scanner", "-u", "audit", "-f", "json", "-o", str(output)]
)
monkeypatch.setattr(cli, "check_for_updates", lambda: None)
monkeypatch.setattr(cli, "print_banner", lambda: None)
monkeypatch.setattr(
cli, "run_user_full", lambda *args: [Result.taken(username="audit", site_name="Example")]
)
with contextlib.redirect_stdout(io.StringIO()) as captured:
cli.main()
data = json.loads(output.read_text(encoding="utf-8"))
assert len(data) == 2
assert data[0]["username"] == "prior_user"
assert data[1]["username"] == "audit"
assert "JSON Results saved" in captured.getvalue()
@pytest.mark.parametrize(
"corrupt_content",
[
'[{"prior": "truncated"}',
'{"prior": "valid_object_not_list"}',
'"string_not_list"',
'42',
],
)
def test_json_export_preserves_corrupt_existing_file(monkeypatch, tmp_path, corrupt_content):
output = tmp_path / "report.json"
output.write_text(corrupt_content, encoding="utf-8")
monkeypatch.setattr(
sys, "argv", ["user-scanner", "-u", "audit", "-f", "json", "-o", str(output)]
)
monkeypatch.setattr(cli, "check_for_updates", lambda: None)
monkeypatch.setattr(cli, "print_banner", lambda: None)
monkeypatch.setattr(
cli, "run_user_full", lambda *args: [Result.taken(username="audit", site_name="Example")]
)
with contextlib.redirect_stdout(io.StringIO()) as captured:
cli.main()
# Original corrupt file bytes must remain untouched
assert output.read_text(encoding="utf-8") == corrupt_content
stdout = captured.getvalue()
assert "Failed to append to existing JSON file" in stdout
assert "JSON Results saved" not in stdout
def test_json_export_empty_existing_file(monkeypatch, tmp_path):
output = tmp_path / "empty_report.json"
output.write_text("", encoding="utf-8")
monkeypatch.setattr(
sys, "argv", ["user-scanner", "-u", "audit", "-f", "json", "-o", str(output)]
)
monkeypatch.setattr(cli, "check_for_updates", lambda: None)
monkeypatch.setattr(cli, "print_banner", lambda: None)
monkeypatch.setattr(
cli, "run_user_full", lambda *args: [Result.taken(username="audit", site_name="Example")]
)
with contextlib.redirect_stdout(io.StringIO()) as captured:
cli.main()
data = json.loads(output.read_text(encoding="utf-8"))
assert len(data) == 1
assert data[0]["username"] == "audit"
assert "JSON Results saved" in captured.getvalue()