hate_crack/TESTING.md

Testing

Quick Start

# Run all tests (auto-sets HATE_CRACK_SKIP_INIT when needed)
make test

# With coverage
make coverage

Environment Variables

Variable	Purpose
HATE_CRACK_SKIP_INIT=1	Skip binary/config validation at startup. Required in worktrees and CI where submodules are not built. make test sets this automatically.
HASHMOB_TEST_REAL=1	Enable live Hashmob connectivity tests
HASHVIEW_TEST_REAL=1	Enable live Hashview CLI menu tests
WEAKPASS_TEST_REAL=1	Enable live Weakpass CLI menu tests
HATE_CRACK_REQUIRE_DEPS=1	Fail if 7z or transmission-cli are missing
HATE_CRACK_RUN_LIVE_TESTS=1	Enable live Hashview upload test (requires valid credentials in config.json)
HATE_CRACK_RUN_LIVE_HASHVIEW_TESTS=1	Enable live Hashview wordlist upload test
HATE_CRACK_RUN_E2E=1	Enable local uv tool install E2E test
HATE_CRACK_RUN_DOCKER_TESTS=1	Enable Docker-based E2E test
HATE_CRACK_RUN_LIMA_TESTS=1	Enable Lima VM E2E test (macOS, requires limactl)

Running Tests Directly

# All tests
uv run pytest -v

# Single file
HATE_CRACK_SKIP_INIT=1 uv run pytest tests/test_attacks_behavior.py -v

# Specific test
uv run pytest tests/test_hashview.py::TestHashviewAPI::test_create_job_workflow -v

# With coverage
uv run pytest --cov=hate_crack --cov-report=term-missing

Test Files

Unit / Offline Tests (always run)

No external services, binaries, or network access required.

File	What it covers
test_attacks_behavior.py	Attack handler logic via mocked ctx
test_hashcat_wrappers.py	Low-level hashcat subprocess wrappers
test_api.py	Hashview, Weakpass, Hashmob API clients (mocked HTTP)
test_api_downloads.py	Download helpers and file extraction
test_cli_menus.py	CLI argument parsing and menu dispatch
test_cli_weakpass.py	Weakpass CLI subcommands
test_hashview.py	HashviewAPI class (mocked responses)
test_hashview_cli_subcommands.py	Hashview CLI subcommand routing
test_hashview_cli_subcommands_subprocess.py	Hashview subcommands via subprocess
test_ui_menu_options.py	Menu option snapshot tests via CLI_MODULE
test_proxy.py	hate_crack.py proxy to hate_crack.main
test_main_utils.py	Utility functions in main.py
test_utils.py	Shared utility helpers
test_ntlm_preprocessing.py	NTLM hash preprocessing
test_ntlm_preprocessing_edge_cases.py	Edge cases for NTLM preprocessing
test_fingerprint_expander_and_hybrid.py	Fingerprint and hybrid attack helpers
test_hashcat_rules.py	Hashcat rule parsing and analysis
test_asset_path_separation.py	hate_path vs hcatPath path distinction
test_invalid_hcatpath.py	Startup error on invalid hashcat path
test_version_check.py	Update check logic
test_omen_attack.py	OMEN attack handler
test_pipal.py	Pipal integration helpers
test_pipal_integration.py	Pipal menu and output parsing
test_dependencies.py	External dependency detection
test_hashmob_connectivity.py	Hashmob connectivity check (mocked by default)

Opt-In Tests

Live API

HASHMOB_TEST_REAL=1 uv run pytest tests/test_hashmob_connectivity.py -v
HASHVIEW_TEST_REAL=1 uv run pytest tests/test_cli_menus.py -v
WEAKPASS_TEST_REAL=1 uv run pytest tests/test_cli_weakpass.py -v

Live Hashview Upload

Requires valid hashview_url and hashview_api_key in config.json.

HATE_CRACK_RUN_LIVE_TESTS=1 uv run pytest tests/test_upload_cracked_hashes.py -v
HATE_CRACK_RUN_LIVE_HASHVIEW_TESTS=1 uv run pytest tests/test_upload_wordlist.py -v

Submodules

Requires built submodules (make first).

uv run pytest tests/test_submodule_hashcat_utils.py -v

End-to-End

# Local uv tool install (creates a temporary HOME)
HATE_CRACK_RUN_E2E=1 uv run pytest tests/test_e2e_local_install.py -v

# Docker-based full install and basic hashcat crack
HATE_CRACK_RUN_DOCKER_TESTS=1 uv run pytest tests/test_docker_script_install.py -v

# Lima VM install (macOS only, requires: brew install lima)
HATE_CRACK_RUN_LIMA_TESTS=1 uv run pytest tests/test_lima_vm_install.py -v

# Installed tool smoke test
uv run pytest tests/test_installed_tool_execution.py -v
uv run pytest tests/test_uv_tool_install_dryrun.py -v

The Lima test provisions a real Ubuntu 24.04 VM via Lima. The first run is slow (VM provisioning + apt-get). The VM is named uniquely per session and deleted in teardown - verify cleanup with limactl list.

Test Architecture

• conftest.py - Provides the hc_module fixture via load_hate_crack_module(), which dynamically imports hate_crack.py with HATE_CRACK_SKIP_INIT=1. Each test gets an isolated module instance.
• CLI_MODULE - Menu option tests patch against this reference to exercise the proxy layer between hate_crack.py and hate_crack.main.
• HTTP mocking - API tests mock requests at the boundary. No real network calls in offline tests.
• Subprocess mocking - Hashcat wrapper tests mock subprocess.Popen; no hashcat binary required.

Pre-push hooks (via prek) run ruff, ty, and pytest locally before each push:

# Install hooks
prek install --hook-type pre-push --hook-type post-commit

# Run manually
prek run