Module src.onionrcommands.parser
Onionr - Private P2P Communication.
This module loads in the Onionr arguments and their help messages
Expand source code
"""Onionr - Private P2P Communication.
This module loads in the Onionr arguments and their help messages
"""
import sys
import os
import logger
import onionrexceptions
import onionrplugins
from onionrplugins import onionrpluginapi
from . import arguments, recommend
"""
    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.
    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.
    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.
"""
def plugin_command(cmd):
    """Build a plugin command function name."""
    return f'on_{cmd}_cmd'
def register_plugin_commands(cmd) -> bool:
    """Find a plugin command hook and execute it for a given cmd."""
    plugin_cmd = plugin_command(cmd)
    for pl in onionrplugins.get_enabled_plugins():
        pl = onionrplugins.get_plugin(pl)
        if hasattr(pl, plugin_cmd):
            getattr(pl, plugin_cmd)(onionrpluginapi.PluginAPI)
            return True
    return False
def _show_term(msg: str):
    logger.info(msg, terminal=True)
def register():
    """Register commands and handles help command processing."""
    def get_help_message(cmd: str,
                         default: str = 'No help available for this command'):
        """Print help message for a given command, supports plugin commands."""
        pl_cmd = plugin_command(cmd)
        for pl in onionrplugins.get_enabled_plugins():
            pl = onionrplugins.get_plugin(pl)
            if hasattr(pl, pl_cmd):
                try:
                    return getattr(pl, pl_cmd).onionr_help
                except AttributeError:
                    pass
        for i in arguments.get_arguments():
            for _ in i:
                try:
                    return arguments.get_help(cmd)
                except AttributeError:
                    pass
        return default  # Return the help string
    PROGRAM_NAME = "onionr"
    # Get the command
    try:
        cmd = sys.argv[1]
    except IndexError:
        logger.debug("Detected Onionr run with no commands specified")
        return
    is_help_cmd = False
    if cmd.replace('--', '').lower() == 'help':
        is_help_cmd = True
    try:
        try:
            if cmd not in ('start', 'details', 'show-details'):
                os.chdir(os.environ['ORIG_ONIONR_RUN_DIR'])
        except KeyError:
            pass
        try:
            arguments.get_func(cmd)()
        except KeyboardInterrupt:
            pass
    except onionrexceptions.NotFound:
        if not register_plugin_commands(cmd) and not is_help_cmd:
            recommend.recommend()
            sys.exit(3)
    if is_help_cmd:
        try:
            sys.argv[2]
        except IndexError:
            for i in arguments.get_arguments():
                _show_term('%s <%s>: %s' % (PROGRAM_NAME, '/'.join(i),
                                            get_help_message(i[0])))
            for pl in onionrplugins.get_enabled_plugins():
                pl = onionrplugins.get_plugin(pl)
                if hasattr(pl, 'ONIONR_COMMANDS'):
                    print('')
                    try:
                        _show_term('%s commands:' % (pl.plugin_name,))
                    except AttributeError:
                        _show_term('%s commands:' % (pl.__name__,))
                    for plugin_cmd in pl.ONIONR_COMMANDS:
                        _show_term('%s %s: %s' %
                                   (PROGRAM_NAME,
                                    plugin_cmd,
                                    get_help_message(plugin_cmd)),)
                    print('')
        else:
            try:
                _show_term('%s %s: %s' % (PROGRAM_NAME,
                                          sys.argv[2],
                                          get_help_message(sys.argv[2])))
            except KeyError:
                logger.error('%s: command does not exist.' % [sys.argv[2]],
                             terminal=True)
                sys.exit(3)
        return
Sub-modules
src.onionrcommands.parser.arguments- 
Onionr - Private P2P Communication …
 src.onionrcommands.parser.recommend- 
Onionr - Private P2P Communication …
 
Functions
def plugin_command(cmd)- 
Build a plugin command function name.
Expand source code
def plugin_command(cmd): """Build a plugin command function name.""" return f'on_{cmd}_cmd' def register()- 
Register commands and handles help command processing.
Expand source code
def register(): """Register commands and handles help command processing.""" def get_help_message(cmd: str, default: str = 'No help available for this command'): """Print help message for a given command, supports plugin commands.""" pl_cmd = plugin_command(cmd) for pl in onionrplugins.get_enabled_plugins(): pl = onionrplugins.get_plugin(pl) if hasattr(pl, pl_cmd): try: return getattr(pl, pl_cmd).onionr_help except AttributeError: pass for i in arguments.get_arguments(): for _ in i: try: return arguments.get_help(cmd) except AttributeError: pass return default # Return the help string PROGRAM_NAME = "onionr" # Get the command try: cmd = sys.argv[1] except IndexError: logger.debug("Detected Onionr run with no commands specified") return is_help_cmd = False if cmd.replace('--', '').lower() == 'help': is_help_cmd = True try: try: if cmd not in ('start', 'details', 'show-details'): os.chdir(os.environ['ORIG_ONIONR_RUN_DIR']) except KeyError: pass try: arguments.get_func(cmd)() except KeyboardInterrupt: pass except onionrexceptions.NotFound: if not register_plugin_commands(cmd) and not is_help_cmd: recommend.recommend() sys.exit(3) if is_help_cmd: try: sys.argv[2] except IndexError: for i in arguments.get_arguments(): _show_term('%s <%s>: %s' % (PROGRAM_NAME, '/'.join(i), get_help_message(i[0]))) for pl in onionrplugins.get_enabled_plugins(): pl = onionrplugins.get_plugin(pl) if hasattr(pl, 'ONIONR_COMMANDS'): print('') try: _show_term('%s commands:' % (pl.plugin_name,)) except AttributeError: _show_term('%s commands:' % (pl.__name__,)) for plugin_cmd in pl.ONIONR_COMMANDS: _show_term('%s %s: %s' % (PROGRAM_NAME, plugin_cmd, get_help_message(plugin_cmd)),) print('') else: try: _show_term('%s %s: %s' % (PROGRAM_NAME, sys.argv[2], get_help_message(sys.argv[2]))) except KeyError: logger.error('%s: command does not exist.' % [sys.argv[2]], terminal=True) sys.exit(3) return def register_plugin_commands(cmd)- 
Find a plugin command hook and execute it for a given cmd.
Expand source code
def register_plugin_commands(cmd) -> bool: """Find a plugin command hook and execute it for a given cmd.""" plugin_cmd = plugin_command(cmd) for pl in onionrplugins.get_enabled_plugins(): pl = onionrplugins.get_plugin(pl) if hasattr(pl, plugin_cmd): getattr(pl, plugin_cmd)(onionrpluginapi.PluginAPI) return True return False