FlatCAM/tclCommands/TclCommandHelp.py

# ##########################################################
# FlatCAM: 2D Post-processing for Manufacturing            #
# File Author: Marius Adrian Stanciu (c)                   #
# Content was borrowed from FlatCAM proper                 #
# Date: 4/22/2020                                          #
# MIT Licence                                              #
# ##########################################################

from tclCommands.TclCommand import TclCommand

import collections
import math

import gettext
import FlatCAMTranslation as fcTranslate
import builtins

fcTranslate.apply_language('strings')
if '_' not in builtins.__dict__:
    _ = gettext.gettext


class TclCommandHelp(TclCommand):
    """
    Tcl shell command to get the value of a system variable

    example:
        get_sys excellon_zeros
    """

    # List of all command aliases, to be able use old names for backward compatibility (add_poly, add_polygon)
    aliases = ['help']

    description = '%s %s' % ("--", "PRINTS to TCL the HELP.")

    # Dictionary of types from Tcl command, needs to be ordered
    arg_names = collections.OrderedDict([
        ('name', str)
    ])

    # Dictionary of types from Tcl command, needs to be ordered , this  is  for options  like -optionname value
    option_types = collections.OrderedDict([

    ])

    # array of mandatory options for current Tcl command: required = {'name','outname'}
    required = []

    # structured help for current command, args needs to be ordered
    help = {
        'main': "Returns to TCL the value for the entered system variable.",
        'args': collections.OrderedDict([
            ('name', 'Name of a Tcl Command for which to display the Help.'),
        ]),
        'examples': ['help add_circle']
    }

    def execute(self, args, unnamed_args):
        """

        :param args:
        :param unnamed_args:
        :return:
        """
        print(self.app.tcl_commands_storage)

        if 'name' in args:
            name = args['name']
            if name not in self.app.tcl_commands_storage:
                return "Unknown command: %s" % name

            print(self.app.tcl_commands_storage[name]["help"])
        else:
            if args is None:
                cmd_enum = _("Available commands:\n")

                displayed_text = []
                try:
                    # find the maximum length of a command name
                    max_len = 0
                    for cmd_name in self.app.tcl_commands_storage:
                        curr_len = len(cmd_name)
                        if curr_len > max_len:
                            max_len = curr_len
                    max_tabs = math.ceil(max_len / 8)

                    for cmd_name in sorted(self.app.tcl_commands_storage):
                        cmd_description = self.app.tcl_commands_storage[cmd_name]['description']

                        curr_len = len(cmd_name)
                        tabs = '\t'

                        cmd_name_colored = "<span style=\" color:#ff0000;\" >"
                        cmd_name_colored += str(cmd_name)
                        cmd_name_colored += "</span>"

                        # make sure to add the right number of tabs (1 tab = 8 spaces) so all the commands
                        # descriptions are aligned
                        if curr_len == max_len:
                            cmd_line_txt = ' %s%s%s' % (cmd_name_colored, tabs, cmd_description)
                        else:
                            nr_tabs = 0

                            for x in range(max_tabs):
                                if curr_len <= (x * 8):
                                    nr_tabs += 1

                            # nr_tabs = 2 if curr_len <= 8 else 1
                            cmd_line_txt = ' %s%s%s' % (cmd_name_colored, nr_tabs * tabs, cmd_description)

                        displayed_text.append(cmd_line_txt)
                except Exception as err:
                    self.app.log.debug("App.setup_shell.shelp() when run as 'help' --> %s" % str(err))
                    displayed_text = [' %s' % cmd for cmd in sorted(self.app.tcl_commands_storage)]

                cmd_enum += '\n'.join(displayed_text)
                cmd_enum += '\n\n%s\n%s' % (_("Type help <command_name> for usage."), _("Example: help open_gerber"))

                print(cmd_enum)