opencos-eda 0.2.54__py3-none-any.whl → 0.2.56__py3-none-any.whl

opencos/tools/quartus.py

@@ -19,6 +19,7 @@ from opencos.eda_base import Tool
 from opencos.commands import (
     CommandSynth, CommandBuild, CommandFList, CommandProj, CommandUpload, CommandOpen
 )
+from opencos.utils.str_helpers import sanitize_defines_for_sh, strip_outer_quotes
 
 class ToolQuartus(Tool):
     '''ToolQuartus used by opencos.eda for --tool=quartus'''
@@ -150,6 +151,7 @@ class CommandSynthQuartus(CommandSynth, ToolQuartus):
         self.write_tcl_file(tcl_file=tcl_file)
 
         # execute Quartus synthesis
+        command_list_gui = [self.quartus_gui_exe, '-t', tcl_file]
         command_list = [
             self.quartus_exe, '-t', tcl_file
         ]
@@ -170,9 +172,27 @@ class CommandSynthQuartus(CommandSynth, ToolQuartus):
             typ='text', description='Quartus Synthesis Report'
         )
 
-        self.exec(self.args['work-dir'], command_list)
+        if self.args['gui'] and self.quartus_gui_exe:
+            self.exec(self.args['work-dir'], command_list_gui)
+        else:
+            self.exec(self.args['work-dir'], command_list)
+
+
+        saved_qpf_filename = self.args["top"] + '.qpf'
+        if not os.path.isfile(os.path.join(self.args['work-dir'], saved_qpf_filename)):
+            self.error('Saved project file does not exist:',
+                       os.path.join(self.args['work-dir'], saved_qpf_filename))
+
         util.info(f"Synthesis done, results are in: {self.args['work-dir']}")
 
+        # Note: in GUI mode, if you ran: quaruts -t build.tcl, it will exit on completion,
+        # so we'll re-open the project.
+        if self.args['gui'] and self.quartus_gui_exe:
+            self.exec(
+                work_dir=self.args['work-dir'],
+                command_list=[self.quartus_gui_exe, saved_qpf_filename]
+            )
+
     def write_tcl_file(self, tcl_file: str) -> None:  # pylint: disable=too-many-locals,too-many-branches
         '''Writes synthesis capable Quartus tcl file to filepath 'tcl_file'.'''
 
@@ -206,6 +226,18 @@ class CommandSynthQuartus(CommandSynth, ToolQuartus):
         for incdir in self.incdirs:
             tcl_lines.append(f"set_global_assignment -name SEARCH_PATH \"{incdir}\"")
 
+        # Parameters -->  set_parameter -name <Parameter_Name> <Value>
+        for k,v in self.parameters.items():
+            if not isinstance(v, (int, str)):
+                util.warning(f'parameter {k} has value: {v}, parameters must be int/string types')
+            if isinstance(v, int):
+                tcl_lines.append(f"set_parameter -name {k} {v}")
+            else:
+                v = strip_outer_quotes(v.strip('\n'))
+                v = '"' + v + '"'
+                tcl_lines.append(f"set_parameter -name {k} {sanitize_defines_for_sh(v)}")
+
+
         # Add all include directories as user libraries for better include resolution
         for incdir in self.incdirs:
             if os.path.exists(incdir):
@@ -221,11 +253,27 @@ class CommandSynthQuartus(CommandSynth, ToolQuartus):
                 tcl_lines.append(f"set_global_assignment -name VERILOG_MACRO \"{key}={value}\"")
 
         # Add constraints
+        default_sdc = False
+        sdc_files = []
         if self.args['sdc']:
-            tcl_lines.append(f"set_global_assignment -name SDC_FILE \"{self.args['sdc']}\"")
+            sdc_files = [os.path.abspath(self.args['sdc'])]
         elif self.files_sdc:
-            for sdc_file in self.files_sdc:
-                tcl_lines.append(f"set_global_assignment -name SDC_FILE \"{sdc_file}\"")
+            # Use files from DEPS target or command line.
+            sdc_files = self.files_sdc
+        else:
+            default_sdc = True
+            sdc_file = self.args['top'] + '.sdc'
+            sdc_files = [sdc_file]
+
+        for f in sdc_files:
+            for attr in ('SDC_FILE', 'SYN_SDC_FILE', 'RTL_SDC_FILE'):
+                tcl_lines.extend([
+                    f"set_global_assignment -name {attr} \"{f}\""
+                ])
+        tcl_lines.append("set_global_assignment -name SYNTH_TIMING_DRIVEN_SYNTHESIS ON")
+
+        if default_sdc:
+            self.write_default_sdc(sdc_file=os.path.join(self.args['work-dir'], sdc_file))
 
         tcl_lines += [
             "# Run synthesis",
@@ -237,6 +285,25 @@ class CommandSynthQuartus(CommandSynth, ToolQuartus):
             ftcl.write('\n'.join(tcl_lines))
 
 
+    def write_default_sdc(self, sdc_file: str) -> None:
+        '''Writes a default SDC file to filepath 'sdc_file'.'''
+
+        sdc_lines = []
+        util.info("Creating default constraints: clock:",
+                  f"{self.args['clock-name']}, {self.args['clock-ns']} (ns),")
+
+        clock_name = self.args['clock-name']
+        period = self.args['clock-ns']
+
+        sdc_lines += [
+            ("create_clock -name {" + clock_name + "} -period {" + str(period) + "} [get_ports "
+             "{" + clock_name + "}]")
+        ]
+
+        with open( sdc_file, 'w', encoding='utf-8' ) as fsdc:
+            fsdc.write('\n'.join(sdc_lines))
+
+
 class CommandBuildQuartus(CommandBuild, ToolQuartus):
     '''CommandBuildQuartus is a command handler for: eda build --tool=quartus'''
 
@@ -253,7 +320,7 @@ class CommandBuildQuartus(CommandBuild, ToolQuartus):
             'flow-tcl-files': [],
         })
 
-    def do_it(self) -> None: # pylint: disable=too-many-branches,too-many-statements
+    def do_it(self) -> None: # pylint: disable=too-many-branches,too-many-statements,too-many-locals
         # add defines for this job
         self.set_tool_defines()
         self.write_eda_config_and_args()
@@ -286,15 +353,25 @@ class CommandBuildQuartus(CommandBuild, ToolQuartus):
         # create an eda.flist_input.f that we'll pass to flist:
         with open(os.path.join(self.args['work-dir'], 'eda.flist_input.f'),
                   'w', encoding='utf-8') as f:
+
+            # defines
+            for key,value in self.defines.items():
+                if value is None:
+                    f.write(f"+define+{key}\n")
+                else:
+                    f.write(shlex.quote(f"+define+{key}={value}") + "\n")
+
+            # incdirs:
+            for incdir in self.incdirs:
+                f.write(f'+incdir+{incdir}\n')
+
+            # files:
             f.write('\n'.join(self.files_v + self.files_sv + self.files_vhd + ['']))
+
+
         command_list.append('--input-file=eda.flist_input.f')
 
 
-        for key,value in self.defines.items():
-            if value is None:
-                command_list += [ f"+define+{key}" ]
-            else:
-                command_list += [ shlex.quote(f"+define+{key}={value}") ]
 
         # Write out a .sh command for debug
         command_list = util.ShellCommandList(command_list, tee_fpath='run_eda_flist.log')
@@ -371,7 +448,8 @@ class CommandBuildQuartus(CommandBuild, ToolQuartus):
         util.write_shell_command_file(dirpath=self.args['work-dir'], filename='run_quartus_gui.sh',
                                       command_lists=[
                                           command_list_gui,
-                                          ['quartus', saved_qpf_filename], # reopen when done.
+                                          # reopen when done.
+                                          [self.quartus_gui_exe, saved_qpf_filename],
                                       ], line_breaks=True)
 
         # Add artifact tracking for build
@@ -422,7 +500,7 @@ class CommandBuildQuartus(CommandBuild, ToolQuartus):
         if self.args['gui'] and self.quartus_gui_exe:
             self.exec(
                 work_dir=self.args['work-dir'],
-                command_list=['quartus', saved_qpf_filename]
+                command_list=[self.quartus_gui_exe, saved_qpf_filename]
             )
 
 
@@ -432,6 +510,9 @@ class CommandFListQuartus(CommandFList, ToolQuartus):
     def __init__(self, config: dict):
         CommandFList.__init__(self, config=config)
         ToolQuartus.__init__(self, config=self.config)
+        self.args.update({
+            'emit-parameter': False
+        })
 
 
 class CommandProjQuartus(CommandProj, ToolQuartus):

opencos/tools/questa.py

@@ -267,7 +267,21 @@ class CommandFListQuesta(CommandFList, ToolQuesta):
 class CommandElabQuesta(CommandSimQuesta):
     '''Command handler for: eda elab --tool=questa'''
 
+    command_name = 'elab'
+
+    def __init__(self, config:dict):
+        CommandSimQuesta.__init__(self, config)
+        # add args specific to this simulator
+        self.args['stop-after-elaborate'] = True
+
+
+class CommandLintQuesta(CommandSimQuesta):
+    '''Command handler for: eda lint --tool=questa'''
+
+    command_name = 'lint'
+
     def __init__(self, config:dict):
         CommandSimQuesta.__init__(self, config)
         # add args specific to this simulator
+        self.args['stop-after-compile'] = True
         self.args['stop-after-elaborate'] = True

opencos/tools/questa_fse.py

@@ -56,8 +56,21 @@ class CommandSimQuestaFse(CommandSimModelsimAse):
 class CommandElabQuestaFse(CommandSimQuestaFse):
     '''CommandElabQuestaFse is a command handler for: eda elab --tool=questa_fse'''
 
+    command_name = 'elab'
+
+    def __init__(self, config:dict):
+        super().__init__(config)
+        self.args['stop-after-elaborate'] = True
+
+
+class CommandLintQuestaFse(CommandSimQuestaFse):
+    '''CommandLintQuestaFse is a command handler for: eda lint --tool=questa_fse'''
+
+    command_name = 'lint'
+
     def __init__(self, config:dict):
         super().__init__(config)
+        self.args['stop-after-compile'] = True
         self.args['stop-after-elaborate'] = True
 
 

opencos/tools/riviera.py

@@ -74,6 +74,17 @@ class CommandSimRiviera(CommandSimModelsimAse, ToolRiviera):
     # Note: many of these we follow the same flow as CommandSimModelsimAse:
     # do_it, prepare_compile, compile, elaborate, simulate
 
+    def compile(self):
+        '''Override for CommandSimModelsimAse.compile() so we can set our own must_strings'''
+        if self.args['stop-before-compile']:
+            # don't run anything, save everyting we've already run in _prep_compile()
+            return
+        if self.args['stop-after-compile']:
+            vsim_command_lists = self.get_compile_command_lists()
+            self.run_commands_check_logs(vsim_command_lists, log_filename='sim.log',
+                                         must_strings=['Compile success 0 Errors'],
+                                         use_must_strings=False)
+
     def get_compile_command_lists(self, **kwargs) -> list:
         # This will also set up a compile.
         vsim_command_list = [
@@ -128,7 +139,6 @@ class CommandSimRiviera(CommandSimModelsimAse, ToolRiviera):
             if v is None:
                 vlog_dot_f_lines += [ f'+define+{k}' ]
             else:
-
                 # if the value v is a double-quoted string, such as v='"hi"', the
                 # entire +define+NAME="hi" needs to wrapped in double quotes with the
                 # value v double-quotes escaped: "+define+NAME=\"hi\""
@@ -170,11 +180,15 @@ class CommandSimRiviera(CommandSimModelsimAse, ToolRiviera):
 
         voptargs_str = ""
         if self.args['gui'] or self.args['waves'] or self.args['coverage']:
-            voptargs_str = self.tool_config.get('simulate-waves-args',
-                                                '+accb +accr +access +r+w')
+            voptargs_str += self.tool_config.get('simulate-waves-args',
+                                                 '+accb +accr +access +r+w')
         if self.args['coverage']:
             voptargs_str += self.tool_config.get('coverage-args', '')
 
+        # parameters
+        if self.parameters:
+            voptargs_str += ' ' + ' '.join(self.process_parameters_get_list(arg_prefix='-G'))
+
         # TODO(drew): support self.args['sim_libary', 'elab-args', sim-args'] (3 lists)
         # to add to vsim_one_liner.
 
@@ -289,6 +303,19 @@ class CommandSimRiviera(CommandSimModelsimAse, ToolRiviera):
 class CommandElabRiviera(CommandSimRiviera):
     '''CommandElabRiviera is a command handler for: eda elab --tool=riviera'''
 
+    command_name = 'elab'
+
+    def __init__(self, config:dict):
+        super().__init__(config)
+        self.args['stop-after-elaborate'] = True
+
+
+class CommandLintRiviera(CommandSimRiviera):
+    '''CommandLintRiviera is a command handler for: eda lint --tool=riviera'''
+
+    command_name = 'lint'
+
     def __init__(self, config:dict):
         super().__init__(config)
+        self.args['stop-after-compile'] = True
         self.args['stop-after-elaborate'] = True

opencos/tools/slang.py

@@ -115,7 +115,7 @@ class CommandElabSlang(CommandElab, ToolSlang):
         pass
 
     def elaborate(self):
-        ''' elaborate() - following parent Commandsim's run() flow, runs slang_command_lists'''
+        ''' elaborate() - following parent CommandSim's run() flow, runs slang_command_lists'''
         if self.args['stop-before-compile'] or \
            self.args['stop-after-compile']:
             return
@@ -143,6 +143,11 @@ class CommandElabSlang(CommandElab, ToolSlang):
                 # --define-macro {k}={v}
                 command_list.append( f'{k}={sanitize_defines_for_sh(v)}' )
 
+        # parameters
+        command_list.extend(
+            self.process_parameters_get_list(arg_prefix='-G ')
+        )
+
         # Because many elab target-name won't match the --top needed for
         # slang, we'll leave this to arg --slang-top:
         if self.args.get('slang-top', None):
@@ -208,3 +213,14 @@ class CommandElabSlang(CommandElab, ToolSlang):
                         )
 
         return command_list
+
+
+class CommandLintSlang(CommandElabSlang):
+    '''CommandLintSlang is a command handler for: eda lint --tool=slang.'''
+
+    command_name = 'lint'
+
+    def __init__(self, config: dict):
+        super().__init__(config)
+        # keep stop-after-compile=False, allow's CommandElabSlang.elaborate() to run.
+        self.args['slang-args'] = ['--lint-only', '--ignore-unknown-modules']

opencos/tools/slang_yosys.py

@@ -10,6 +10,8 @@ import os
 from opencos import util
 from opencos.tools.yosys import ToolYosys, CommonSynthYosys, CommandLecYosys
 
+from opencos.commands.sim import parameters_dict_get_command_list
+
 class ToolSlangYosys(ToolYosys):
     '''Uses slang.so in yosys plugins directory, called via yosys > plugin -i slang'''
     _TOOL = 'slang_yosys'
@@ -109,6 +111,13 @@ class CommandSynthSlangYosys(CommonSynthYosys, ToolSlangYosys):
         ]
 
         read_slang_cmd += self.get_yosys_read_verilog_defines_incdirs_files()
+
+        # For slang step, need to resolve parameters too. We do NOT do this on
+        # subsquent yosys read_verilog steps.
+        read_slang_cmd += parameters_dict_get_command_list(
+            params=self.parameters, arg_prefix='-G '
+        )
+
         read_slang_cmd.append(f'--top {self.args["top"]}')
         return ' '.join(read_slang_cmd)
 

opencos/tools/surelog.py

@@ -63,6 +63,7 @@ class CommandElabSurelog(CommandElab, ToolSurelog):
         ToolSurelog.__init__(self, config=self.config)
         self.args.update({
             'surelog-top': '',
+            'surelog-args': [],
         })
 
         self.surelog_command_lists = []
@@ -98,6 +99,7 @@ class CommandElabSurelog(CommandElab, ToolSurelog):
             'compile-args',
             '-parse').split()
         command_list += config_compile_args
+        command_list += self.args['surelog-args']
 
         if util.args.get('debug', None) or \
            util.args.get('verbose', None):
@@ -107,6 +109,11 @@ class CommandElabSurelog(CommandElab, ToolSurelog):
         for value in self.incdirs:
             command_list.append('+incdir+' + value)
 
+        # parameters
+        command_list.extend(
+            self.process_parameters_get_list(arg_prefix='-P')
+        )
+
         # defines:
         for k,v in self.defines.items():
             if v is None:
@@ -139,3 +146,14 @@ class CommandElabSurelog(CommandElab, ToolSurelog):
             dirpath=self.args['work-dir'], filename='run_surelog.sh',
             command_lists=self.surelog_command_lists, line_breaks=True
         )
+
+
+class CommandLintSurelog(CommandElabSurelog):
+    '''CommandLintSurelog is a command handler for: eda lint --tool=surelog.'''
+    command_name = 'lint'
+
+    def __init__(self, config: dict):
+        super().__init__(config)
+        # keep stop-after-compile=False, allow's CommandElabSurelog.elaborate() to run.
+        # run the "compile" step only for surelog by setting -noelab:
+        self.args['surelog-args'] = ['-noelab']

opencos/tools/verilator.py

@@ -244,6 +244,11 @@ class VerilatorSim(CommandSim, ToolVerilator):
                 # +define+{k}={v}, but also for SystemVerilog plusargs
                 verilate_command_list += [ f'+define+{k}={sanitize_defines_for_sh(v)}' ]
 
+        # parameters
+        verilate_command_list.extend(
+            self.process_parameters_get_list(arg_prefix='-G')
+        )
+
         if not self.files_sv and not self.files_v:
             if not self.args['stop-before-compile']:
                 self.error(f'{self.target=} {self.files_sv=} and {self.files_v=} are empty,',
@@ -499,8 +504,22 @@ class VerilatorSim(CommandSim, ToolVerilator):
 
 class VerilatorElab(VerilatorSim):
     '''VerilatorElab is a command handler for: eda elab --tool=verilator'''
+    command_name = 'elab'
+
+    def __init__(self, config: dict):
+        super().__init__(config)
+        self.args['stop-after-elaborate'] = True
+        self.args['lint-only'] = True
+
+
+class VerilatorLint(VerilatorSim):
+    '''VerilatorLint is a command handler for: eda lint --tool=verilator.
+
+    For practical reasons, this is identical to VerilatorElab with --stop-after-compile.'''
+    command_name = 'lint'
 
     def __init__(self, config: dict):
         super().__init__(config)
+        self.args['stop-after-compile'] = True
         self.args['stop-after-elaborate'] = True
         self.args['lint-only'] = True

opencos/tools/vivado.py

@@ -22,6 +22,9 @@ from opencos.eda_base import Tool
 from opencos.commands import CommandSim, CommandSynth, CommandProj, CommandBuild, \
     CommandFList, CommandUpload, CommandOpen
 
+from opencos.commands import sim
+
+
 class ToolVivado(Tool):
     '''ToolVivado used by opencos.eda for --tool=vivado'''
 
@@ -214,6 +217,12 @@ class CommandSimVivado(CommandSim, ToolVivado):
             command_list[0] += ".bat"
         command_list += self.tool_config.get('elab-args',
                                              '-s snapshot -timescale 1ns/1ps --stats').split()
+
+        # parameters
+        command_list.extend(
+            self.process_parameters_get_list(arg_prefix='-generic_top ')
+        )
+
         if self.tool_config.get('elab-waves-args', ''):
             command_list += self.tool_config.get('elab-waves-args', '').split()
         elif self.args['gui'] and self.args['waves']:
@@ -347,9 +356,20 @@ class CommandSimVivado(CommandSim, ToolVivado):
 
 class CommandElabVivado(CommandSimVivado):
     '''CommandElabVivado is a command handler for: eda elab --tool=vivado, uses xvlog, xelab'''
+    command_name = 'elab'
+    def __init__(self, config: dict):
+        CommandSimVivado.__init__(self, config)
+        # add args specific to this tool
+        self.args['stop-after-elaborate'] = True
+
+
+class CommandLintVivado(CommandSimVivado):
+    '''CommandLintVivado is a command handler for: eda lint --tool=vivado, uses xvlog'''
+    command_name = 'lint'
     def __init__(self, config: dict):
         CommandSimVivado.__init__(self, config)
         # add args specific to this tool
+        self.args['stop-after-compile'] = True
         self.args['stop-after-elaborate'] = True
 
 
@@ -401,6 +421,9 @@ class CommandSynthVivado(CommandSynth, ToolVivado):
         defines = ""
         for key, value in self.defines.items():
             defines += (f"-verilog_define {key}" + (" " if value is None else f"={value} "))
+        parameters = ' '.join(
+            sim.parameters_dict_get_command_list(params=self.parameters, arg_prefix='-generic ')
+        )
         incdirs = ' '.join([f'-include_dirs {x}' for x in self.incdirs])
         flatten = ""
         if self.args['flatten-all']:
@@ -446,10 +469,10 @@ class CommandSynthVivado(CommandSynth, ToolVivado):
         tcl_lines += [
             "# FIRST PASS -- auto_detect_xpm",
             "synth_design -rtl -rtl_skip_ip -rtl_skip_constraints -no_timing_driven -no_iobuf " \
-            + f"-top {top} {incdirs} {defines} {v}",
+            + f"-top {top} {incdirs} {defines} {parameters} {v}",
             f"auto_detect_xpm {v} ",
             f"synth_design -no_iobuf -part {part} {flatten} -constrset constraints_1 " \
-            + f"-top {top} {incdirs} {defines} {v}",
+            + f"-top {top} {incdirs} {defines} {parameters} {v}",
             f"write_verilog -force {top}.vg {v}",
             f"report_utilization -file {top}.flat.util.rpt {v}",
             f"report_utilization -file {top}.hier.util.rpt {v} -hierarchical " \
@@ -742,6 +765,7 @@ class CommandFListVivado(CommandFList, ToolVivado):
         CommandFList.__init__(self, config=config)
         ToolVivado.__init__(self, config=self.config)
         self.args['all-sv'] = False
+        self.args['emit-parameter'] = False
 
 
 class CommandUploadVivado(CommandUpload, ToolVivado):

opencos/tools/yosys.py

@@ -219,6 +219,9 @@ class CommonSynthYosys(CommandSynth, ToolYosys):
         if not self.args['sta-scriptfile']:
             return []
 
+        # Add URL info for OpenSTA source code:
+        self._add_opensta_info()
+
         ret_list = []
         for i,fpath in enumerate(self.args['sta-scriptfile']):
             if not os.path.isfile(fpath):
@@ -377,6 +380,9 @@ class CommonSynthYosys(CommandSynth, ToolYosys):
         if not self.sta_exe:
             self.error(f'--sta is set, but "sta" was not found in PATH, see: {self._URL}')
 
+        # Add URL info for OpenSTA source code:
+        self._add_opensta_info()
+
         sta_command_list = util.ShellCommandList(
             [ self.sta_exe, '-no_init', '-exit', 'sta.f' ],
             tee_fpath = 'sta.log'
@@ -439,6 +445,15 @@ class CommonSynthYosys(CommandSynth, ToolYosys):
             ]
             f.write('\n'.join(lines))
 
+    def _add_opensta_info(self) -> None:
+        '''Adds OpenSTA URL information to artifacts and logs'''
+
+        opensta_repo_url = 'https://github.com/The-OpenROAD-Project/OpenSTA'
+
+        # Log GPL3.0 license information
+        util.info(f'Using OpenSTA (see URL for license and source): {opensta_repo_url}')
+        if hasattr(self, 'sta_version') and self.sta_version:
+            util.info(f'OpenSTA version: {self.sta_version}')
 
     def _get_read_verilog_one_liner(self) -> str:
         '''Returns a string, intended to be used w/out Slang, for Verilog or simple

opencos/util.py

@@ -1,5 +1,7 @@
 '''opencos.util -- support global logging, argparser for printing (colors)'''
 
+# pylint: disable=too-many-lines
+
 import argparse
 import atexit
 import datetime
@@ -89,6 +91,7 @@ class ArtifactTypes(Enum):
     TCL = 5
     SHELL = 6
     BITSTREAM = 7
+    LICENSE = 8
 
 class Artifacts:
     '''Class to hold file artifacts, for logs generated by EDA, or other artifcats created
@@ -198,7 +201,10 @@ class Artifacts:
         # Update all file sizes:
         remove_keys = set()
         for key, entry in self.data.items():
-            if os.path.isfile(entry['name']):
+            if entry['type'] == 'license':
+                # License entries are metadata, not files - keep them as-is
+                entry['size'] = 0
+            elif os.path.isfile(entry['name']):
                 entry['size'] = os.path.getsize(entry['name'])
             else:
                 # file doesn't exist, remove it from artifacts.

opencos/utils/str_helpers.py

@@ -7,14 +7,18 @@ import shlex
 import textwrap
 
 VALID_TARGET_INFO_STR = (
-    "should start with an underscore/letter, rest should be alpha-numeric, dashes, or underscores."
+    "should start with a . or underscore/letter, rest should be"
+    " ., alpha-numeric, dashes, or underscores."
 )
 
 def is_valid_target_name(s: str) -> bool:
-    '''Returns True if str starts with underscore/letter, rest  alphanum, dash, or underscores'''
-    if not s or not (s[0].isalpha() or s[0] == '_'):
+    '''Returns True if str starts with . or underscore/letter, rest alphanum, dash, dot,
+
+    or underscores. We allow '.' otherwise deps_file.py posts warnings about badly named
+    targets for files that are missing.'''
+    if not s or not (s[0].isalpha() or s[0] == '_' or s[0] == '.'):
         return False
-    return s.replace('_', '').replace('-', '').isalnum()
+    return s.replace('_', '').replace('-', '').replace('.', '').isalnum()
 
 def strip_all_quotes(s: str) -> str:
     '''Returns str with all ' and " removed'''

{opencos_eda-0.2.54.dist-info → opencos_eda-0.2.56.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: opencos-eda
-Version: 0.2.54
+Version: 0.2.56
 Summary: A simple Python package for wrapping RTL simuliatons and synthesis
 Author-email: Simon Sabato <simon@cognichip.ai>, Drew Ranck <drew@cognichip.ai>
 Project-URL: Homepage, https://github.com/cognichip/opencos
@@ -15,5 +15,5 @@ Requires-Dist: schema>=0.7.7
 Requires-Dist: toml>=0.10.2
 Requires-Dist: yamllint>=1.35.1
 Requires-Dist: PySerial>=3.5
-Requires-Dist: cocotb>=2.0.0b1
+Requires-Dist: cocotb>=2.0
 Dynamic: license-file