Feature bettercap

[whotwagner]

• Added executor that communicates with the bettercap rest-api
• Added docs for the bettercap-commands
• Added tests for the bettercap-executor

[thorinaboenke]

Suggestion: avoid the same pain as with the different sliver commands we can try to have one Bettercap Command with type "bettercap" and a list of possible literals for the "cmd" attribute

BettercapCmds = Literal[
    'get_events',
    'get_session_modules',
    'get_session_env',
    'get_session_gateway',
    'get_session_hid',
    'get_session_ble',
    'get_session_interface',
    'get_session_lan',
    'get_session_options',
    'get_session_packets',
    'get_session_started_at',
    'get_session_wifi',
    'get_file',
    'post_api_session',
    'delete_api_events'
]

then

class BettercapCommand(BaseCommand):
    type: Literal['bettercap'] = 'bettercap'
    cmd: BettercapCmds
etc.

and enforce the required fields for certain commands (like get_file needing a file name, does post_api session needs "data"?) with model validators (like in vnc.py)

required_fields = {
            'get_file': ['filename'],
etc.
        }       

 if cmd in required_fields:
            missing_fields = [field for field in required_fields[cmd] if getattr(values, field, None) is None]
            if missing_fields:
                raise ValueError(f'Command "{cmd}" requires {", ".join(missing_fields)} field(s).')

and then in the executor itself to decide what to do not check for what instance of a command class but which value of cmd the Bettercap command has. (and if it has a mac value -> treat it as a mac command)

[thorinaboenke]

instead of checking what command instance checking for value of cmd (pseudocody)

command_name = command.cmd
# treat mac commands
if command_name.startswith('get_session_') and hasattr(command, 'mac'):
                (code, headers, result) = getattr(self.client, command_name)(command.mac)

#treat other commands
elif command_name.startswith('get_') or command_name.startswith('delete_'):
                #exception for get file
                if command_name == 'get_file':
                    (code, headers, result) = self.client.get_file(command.filename)
                # other exceptions?
                elif
                # commands without parameters