flatcam/tclCommands/TclCommandOpenExcellon.py

63 lines
2.3 KiB
Python

from tclCommands.TclCommand import TclCommandSignaled
import collections
class TclCommandOpenExcellon(TclCommandSignaled):
"""
Tcl shell command to open an Excellon file.
"""
# array of all command aliases, to be able use old names for backward compatibility (add_poly, add_polygon)
aliases = ['open_excellon']
description = '%s %s' % ("--", "Opens an Excellon file, parse it and create a Excellon object from it.")
# Dictionary of types from Tcl command, needs to be ordered.
# For positional arguments
arg_names = collections.OrderedDict([
('filename', str)
])
# Dictionary of types from Tcl command, needs to be ordered.
# For options like -optionname value
option_types = collections.OrderedDict([
('outname', str)
])
# array of mandatory options for current Tcl command: required = {'name','outname'}
required = ['filename']
# structured help for current command, args needs to be ordered
help = {
'main': "Opens an Excellon file, parse it and create a Excellon object from it.",
'args': collections.OrderedDict([
('filename', 'Absolute path to file to open. Required.\n'
'WARNING: no spaces are allowed. If unsure enclose the entire path with quotes.'),
('outname', 'Name of the resulting Excellon object.')
]),
'examples': ['open_excellon D:\\my_excellon_file.DRL',
'open_excellon "D:\\my_excellon_file with spaces in the name.DRL"',
'open_excellon path_to_file']
}
def execute(self, args, unnamed_args):
"""
execute current TCL shell command
:param args: array of known named arguments and options
:param unnamed_args: array of other values which were passed into command
without -somename and we do not have them in known arg_names
:return: None or exception
"""
filename = args.pop('filename')
# if ' ' in filename:
# return "The absolute path to the project file contain spaces which is not allowed.\n" \
# "Please enclose the path within quotes."
args['plot'] = False
args['from_tcl'] = True
self.app.f_handlers.open_excellon(filename, **args)