Gracefully parse options from different formats. Handles: - Dict format (correct): {"key": "value", "key2": "value2"} - String f

Gets the initialized MSF client instance, raising an error if not ready.

Gets the MSF module object, handling potential path variations.

Sets options on a module object, performing basic type guessing.

Helper to execute a module synchronously via console.

Safely run a command on a Metasploit console and return the output. Relies primarily on detecting the MSF prompt for command completion.

Helper to execute an exploit, auxiliary, or post module as a background job via RPC. Includes polling logic for exploit sessions.

Finds an available TCP port.

Generate a Metasploit payload using the RPC API (payload.generate). Saves the generated payload to a file on the server if successful. A

Async context manager for creating and reliably destroying an MSF console.

List available Metasploit exploits, optionally filtered by search term. Args: search_term: Optional term to filter exploits (case-in

Run a Metasploit exploit module with specified options. Handles async (job) and sync (console) execution, and includes session polling for jo

Initializes the global Metasploit RPC client instance. Raises exceptions on failure.

List available Metasploit payloads, optionally filtered by platform and/or architecture. Args: platform: Optional platform filter (e

Start a new Metasploit handler (exploit/multi/handler) as a background job. Args: payload_type: The payload to handle (e.g., 'window

Run a command and handle errors.

Send a command to an active Metasploit session (Meterpreter or Shell) and get output. Uses session.run_with_output for Meterpreter, and a pro

Check if test dependencies are installed.

List active Metasploit sessions with their details.

Stop a running Metasploit job (handler or other). Verifies disappearance.

Forcefully terminate a Metasploit session using the session.stop() method. Args: session_id: ID of the session to terminate.

Handle Server-Sent Events connection for MCP communication.

Handle client POST messages for MCP communication.

Fixture to capture and provide log output.

Check the current status of the Metasploit RPC connection. Returns connection status information for debugging.

Check connectivity to the Metasploit RPC service.

List all active Metasploit jobs, categorizing exploit/multi/handler jobs.

Fixture to mock asyncio.to_thread for testing.

Fixture providing a mock MSF client.

Fixture providing a mock MSF client.

Fixture providing a mock MSF client.

Fixture providing mocked client and module.

Fixture providing a mock console.

Fixture providing mocked exploit execution environment.

Fixture providing mocked job management environment.

Fixture providing a mock logger.

Fixture providing a mock module object.

Session-scoped fixture that provides a complete mock MSF environment.

Fixture providing mocked session management environment.

Add custom command line options.

Modify test collection to add markers automatically.

Configure pytest with custom settings.

Setup hook to skip tests based on markers and options.

Automatically reset the global MSF client between tests.

Run a Metasploit auxiliary module. Args: module_name: Name/path of the auxiliary module (e.g., 'scanner/ssh/ssh_login'). opt

Run a Metasploit post-exploitation module against a session. Args: module_name: Name/path of the post module (e.g., 'windows/gather/

Fixture providing a temporary directory for payload saves.

Test boolean value conversion.

Test parsing complex values like file paths and URLs.

Test that dictionary format is passed through unchanged.

Test handling of empty values.

Test that empty dictionary returns empty dictionary.

Test that empty string returns empty dictionary.

Test parsing when value contains equals sign.

Test error handling for empty key.

Test error handling for invalid input types.

Test error handling for missing equals sign.

Test when all ports in range are busy.

Test finding port on second attempt.

Test finding an available port.

Test payload generation with dictionary options.

Test payload generation with empty options.

Test payload generation with invalid string options.

Test payload generation with string options.

Test module object retrieval with full path.

Test module object retrieval with MSF RPC error.

Test module object retrieval when module not found.

Test successful module object retrieval.

Test get_msf_client when client is initialized.

Test get_msf_client when client not initialized.

Test that cleanup errors don't propagate.

Test console creation error handling.

Test successful console creation and cleanup.

Test MSF client initialization with invalid port.

Test successful MSF client initialization.

Test handling of large numbers that might not fit in int.

Test listing active sessions.

Test listing exploits with MSF error.

Test listing exploits without filter.