119 lines
4.3 KiB
Python
119 lines
4.3 KiB
Python
|
# ##########################################################
|
||
|
# 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)
|