siliconcompiler 0.35.0__py3-none-any.whl → 0.35.1__py3-none-any.whl

siliconcompiler/tools/opensta/timing.py

@@ -6,6 +6,8 @@ from siliconcompiler import sc_open
 
 from siliconcompiler.tools.opensta import OpenSTATask
 
+from siliconcompiler import TaskSkip
+
 
 class TimingTaskBase(OpenSTATask):
     '''
@@ -251,3 +253,14 @@ class FPGATimingTask(TimingTaskBase):
 
         self.add_input_file(ext="sdc")
         self.add_input_file(ext="typical.sdf")
+
+    def pre_process(self):
+        """
+        Skip this node if no non-empty sdc files in inputs
+        """
+        file_path = f"inputs/{self.design_topmodule}.sdc"
+
+        if os.path.getsize(file_path) == 0:
+            raise TaskSkip(f"an empty {self.design_topmodule}.sdc file")
+
+        super().pre_process()

siliconcompiler/tools/yosys/syn_fpga.py

@@ -17,12 +17,13 @@ class FPGASynthesis(YosysTask):
         self.add_parameter(
             "synth_opt_mode",
             "<none,delay,area>",
-            "blah",
+            "optimization mode: 'none' for a balanced optimization, 'delay' to"
+            " prioritize path delay, 'area' to prioritize utilization",
             "none")
         self.add_parameter(
             "synth_insert_buffers",
             "bool",
-            "blah",
+            "perform buffer insertion",
             True)
 
     def task(self):

siliconcompiler/toolscripts/_tools.json

@@ -1,7 +1,7 @@
 {
   "openroad": {
     "git-url": "https://github.com/The-OpenROAD-Project/OpenROAD.git",
-    "git-commit": "0150a2f6ec5cba3046ab28c943897e34e4ec7415",
+    "git-commit": "dee927a657e719812a07799b87934328d1e31657",
     "docker-cmds": [
       "# Remove OR-Tools files",
       "RUN rm -f $SC_PREFIX/Makefile $SC_PREFIX/README.md",
@@ -17,7 +17,7 @@
   },
   "opensta": {
     "git-url": "https://github.com/parallaxsw/OpenSTA.git",
-    "git-commit": "c11bb38f58c34d4f804fd6f05debf644b733ce87",
+    "git-commit": "8f8f397610cebc9e647531914a6c071bcccd2757",
     "auto-update": true
   },
   "netgen": {
@@ -157,7 +157,7 @@
   },
   "yosys-wildebeest": {
     "git-url": "https://github.com/zeroasiccorp/wildebeest.git",
-    "git-commit": "99151b62c6a5d10012d1099bc7ec10674bb0cc7d",
+    "git-commit": "d79f06403b500b95b4cb33288f520e4e24fb9c47",
     "docker-depends": "yosys",
     "auto-update": true
   },

siliconcompiler/utils/__init__.py

@@ -1,4 +1,5 @@
 import contextlib
+import logging
 import re
 import pathlib
 import psutil
@@ -10,9 +11,9 @@ import os.path
 
 from io import StringIO
 from pathlib import Path
-from jinja2 import Environment, FileSystemLoader
+from jinja2 import Environment, FileSystemLoader, Template
 
-from typing import Dict
+from typing import Dict, Optional, Union, Callable, List, TYPE_CHECKING
 
 import sys
 if sys.version_info < (3, 10):
@@ -22,6 +23,9 @@ else:
 
 from siliconcompiler.utils.paths import builddir
 
+if TYPE_CHECKING:
+    from siliconcompiler.project import Project
+
 
 def link_symlink_copy(srcfile, dstfile):
     # first try hard linking, then symbolic linking,
@@ -191,7 +195,7 @@ def default_email_credentials_file() -> str:
 
 
 @contextlib.contextmanager
-def sc_open(path, *args, **kwargs):
+def sc_open(path: str, *args, **kwargs):
     if 'errors' not in kwargs:
         kwargs['errors'] = 'ignore'
     kwargs["newline"] = "\n"
@@ -203,12 +207,12 @@ def sc_open(path, *args, **kwargs):
         pass
 
 
-def get_file_template(path,
-                      root=os.path.join(
+def get_file_template(path: str,
+                      root: str = os.path.join(
                           os.path.dirname(
                               os.path.dirname(os.path.abspath(__file__))),
                           'data',
-                          'templates')):
+                          'templates')) -> Template:
     if os.path.isabs(path):
         root = os.path.dirname(path)
         path = os.path.basename(path)
@@ -221,7 +225,7 @@ def get_file_template(path,
 
 
 #######################################
-def safecompare(value, op, goal):
+def safecompare(value: Union[int, float], op: str, goal: Union[int, float]) -> bool:
     # supported relational operations
     # >, >=, <=, <. ==, !=
     if op == ">":
@@ -241,7 +245,7 @@ def safecompare(value, op, goal):
 
 
 ###########################################################################
-def grep(project, args, line):
+def grep(project: "Project", args: str, line: str) -> Union[None, str]:
     """
     Emulates the Unix grep command on a string.
 
@@ -275,6 +279,9 @@ def grep(project, args, line):
     # Split into repeating switches and everything else
     match = re.match(r'\s*((?:\-\w\s)*)(.*)', args)
 
+    if not match:
+        return None
+
     pattern = match.group(2)
 
     # Split space separated switch string into list
@@ -302,7 +309,7 @@ def grep(project, args, line):
         return line
 
 
-def get_plugins(system, name=None):
+def get_plugins(system: str, name: Optional[str] = None) -> List[Callable]:
     '''
     Search for python modules with a specific function
     '''
@@ -319,7 +326,7 @@ def get_plugins(system, name=None):
     return plugins
 
 
-def truncate_text(text, width):
+def truncate_text(text: str, width: int) -> str:
     width = max(width, 5)
 
     if len(text) <= width:
@@ -338,7 +345,7 @@ def truncate_text(text, width):
     return text
 
 
-def get_cores(physical=False):
+def get_cores(physical: bool = False) -> int:
     '''
     Get max number of cores for this machine.
 
@@ -360,7 +367,7 @@ def get_cores(physical=False):
     return cores
 
 
-def print_traceback(logger, exception):
+def print_traceback(logger: logging.Logger, exception: Exception):
     logger.error(f'{exception}')
     trace = StringIO()
     traceback.print_tb(exception.__traceback__, file=trace)
@@ -370,21 +377,21 @@ def print_traceback(logger, exception):
 
 
 class FilterDirectories:
-    def __init__(self, project):
+    def __init__(self, project: "Project"):
         self.file_count = 0
         self.directory_file_limit = None
         self.abspath = None
         self.project = project
 
     @property
-    def logger(self):
+    def logger(self) -> logging.Logger:
         return self.project.logger
 
     @property
-    def builddir(self):
+    def builddir(self) -> str:
         return builddir(self.project)
 
-    def filter(self, path, files):
+    def filter(self, path: str, files: List[str]) -> List[str]:
         if pathlib.Path(path) == pathlib.Path.home():
             # refuse to collect home directory
             self.logger.error(f'Cannot collect user home directory: {path}')

siliconcompiler/utils/curation.py

@@ -3,7 +3,7 @@ import tarfile
 
 import os.path
 
-from typing import List
+from typing import List, Optional, TYPE_CHECKING
 
 from siliconcompiler.schema.parametervalue import NodeListValue, NodeSetValue
 from siliconcompiler.utils import FilterDirectories
@@ -11,11 +11,14 @@ from siliconcompiler.utils.paths import collectiondir
 from siliconcompiler.scheduler import SchedulerNode
 from siliconcompiler.flowgraph import RuntimeFlowgraph
 
+if TYPE_CHECKING:
+    from siliconcompiler.project import Project
 
-def collect(project,
-            directory: str = None,
+
+def collect(project: "Project",
+            directory: Optional[str] = None,
             verbose: bool = True,
-            whitelist: List[str] = None):
+            whitelist: Optional[List[str]] = None) -> None:
     '''
     Collects files and directories specified in the schema and places
     them in a collection directory. The function only copies items that have
@@ -165,7 +168,10 @@ def collect(project,
             shutil.copy2(abs_path, import_path)
 
 
-def archive(project, jobname: str = None, include: List[str] = None, archive_name: str = None):
+def archive(project: "Project",
+            jobname: Optional[str] = None,
+            include: Optional[List[str]] = None,
+            archive_name: Optional[str] = None) -> None:
     '''Archive a job directory into a compressed tarball.
 
     Creates a single compressed archive (.tgz) based on the specified job.

siliconcompiler/utils/multiprocessing.py

@@ -5,6 +5,8 @@ import tempfile
 
 import os.path
 
+from typing import Union, Optional
+
 from datetime import datetime
 from multiprocessing.managers import SyncManager
 
@@ -29,7 +31,7 @@ class _ManagerSingleton(type):
     _lock = multiprocessing.Lock()
 
     @staticmethod
-    def has_cls(cls):
+    def has_cls(mcls):
         """
         Checks if a singleton instance exists for the given class.
 
@@ -39,10 +41,10 @@ class _ManagerSingleton(type):
         Returns:
             bool: True if an instance exists, False otherwise.
         """
-        return cls in _ManagerSingleton._instances
+        return mcls in _ManagerSingleton._instances
 
     @staticmethod
-    def remove_cls(cls):
+    def remove_cls(mcls):
         """
         Removes a class's singleton instance from the registry.
 
@@ -52,12 +54,12 @@ class _ManagerSingleton(type):
         Args:
             cls (type): The class whose instance should be removed.
         """
-        if not _ManagerSingleton.has_cls(cls):
+        if not _ManagerSingleton.has_cls(mcls):
             return
 
         with _ManagerSingleton._lock:
-            if cls in _ManagerSingleton._instances:
-                del _ManagerSingleton._instances[cls]
+            if mcls in _ManagerSingleton._instances:
+                del _ManagerSingleton._instances[mcls]
 
     def __call__(cls, *args, **kwargs):
         """
@@ -86,7 +88,7 @@ class MPManager(metaclass=_ManagerSingleton):
     It is designed to be instantiated once and accessed globally.
     """
     __ENABLE_LOGGER: bool = True
-    __address: str = None
+    __address: Union[None, str] = None
     __authkey: bytes = b'siliconcompiler-manager-authkey'  # arbitrary authkey value
 
     def __init__(self):
@@ -98,7 +100,7 @@ class MPManager(metaclass=_ManagerSingleton):
         """
         pass
 
-    def _init_singleton(self):
+    def _init_singleton(self) -> None:
         """
         Performs the one-time initialization of the singleton instance.
 
@@ -140,7 +142,7 @@ class MPManager(metaclass=_ManagerSingleton):
         # Register cleanup function to run at exit
         atexit.register(MPManager.stop)
 
-    def _init_logger(self):
+    def _init_logger(self) -> None:
         """
         Initializes the logging configuration for SiliconCompiler.
 
@@ -175,7 +177,7 @@ class MPManager(metaclass=_ManagerSingleton):
                 pass
 
     @staticmethod
-    def stop():
+    def stop() -> None:
         """
         Cleans up all managed resources as a static method.
 
@@ -220,7 +222,7 @@ class MPManager(metaclass=_ManagerSingleton):
         _ManagerSingleton.remove_cls(MPManager)
 
     @staticmethod
-    def error(msg: str = None):
+    def error(msg: Optional[str] = None):
         """
         Logs an error and flags the session as having an error.
 
@@ -238,7 +240,7 @@ class MPManager(metaclass=_ManagerSingleton):
         manager.__error = True
 
     @staticmethod
-    def get_manager():
+    def get_manager() -> SyncManager:
         """
         Provides access to the shared multiprocessing.Manager instance.
 
@@ -277,7 +279,7 @@ class MPManager(metaclass=_ManagerSingleton):
         return MPManager().__logger
 
     @staticmethod
-    def _set_manager_address(address: str):
+    def _set_manager_address(address: str) -> None:
         """
         Set the address of the manager
         """
@@ -285,7 +287,7 @@ class MPManager(metaclass=_ManagerSingleton):
             MPManager.__address = address
 
     @staticmethod
-    def _get_manager_address() -> str:
+    def _get_manager_address() -> Union[None, str]:
         """
         Get the address of the manager
         """

siliconcompiler/utils/paths.py

@@ -1,9 +1,19 @@
 import os.path
 
-from typing import Union
+from typing import Union, Optional, TYPE_CHECKING
 
+if TYPE_CHECKING:
+    from siliconcompiler.project import Project
 
-def builddir(project) -> str:
+
+def cwdir(project: "Project") -> str:
+    from siliconcompiler import Project
+    if not isinstance(project, Project):
+        raise TypeError("project must be a Project type")
+    return project._Project__cwd
+
+
+def builddir(project: "Project") -> str:
     """
     Returns the absolute path to the project's build directory.
 
@@ -24,14 +34,14 @@ def builddir(project) -> str:
     if not isinstance(project, Project):
         raise TypeError("project must be a Project type")
 
-    builddir = project.get('option', 'builddir')
+    builddir: str = project.get('option', 'builddir')
     if os.path.isabs(builddir):
         return builddir
 
-    return os.path.join(project._Project__cwd, builddir)
+    return os.path.join(cwdir(project), builddir)
 
 
-def jobdir(project) -> str:
+def jobdir(project: "Project") -> str:
     """
     Returns the absolute path to the current job directory.
 
@@ -55,13 +65,15 @@ def jobdir(project) -> str:
     if not project.name:
         raise ValueError("name has not been set")
 
-    return os.path.join(
-        builddir(project),
-        project.name,
-        project.get('option', 'jobname'))
+    jobname: str = project.get('option', 'jobname')
+
+    return os.path.join(builddir(project), project.name, jobname)
 
 
-def workdir(project, step: str = None, index: Union[int, str] = None, relpath: bool = False) -> str:
+def workdir(project: "Project",
+            step: Optional[str] = None,
+            index: Optional[Union[int, str]] = None,
+            relpath: Optional[bool] = False) -> str:
     """
     Returns path to the working directory for a given step and index.
 
@@ -100,12 +112,12 @@ def workdir(project, step: str = None, index: Union[int, str] = None, relpath: b
 
     path = os.path.join(jobdir(project), *dirlist)
     if relpath:
-        return os.path.relpath(path, project._Project__cwd)
+        return os.path.relpath(path, cwdir(project))
 
     return path
 
 
-def collectiondir(project) -> str:
+def collectiondir(project: "Project") -> Union[None, str]:
     """
     Returns the absolute path to the file collection directory.
 

siliconcompiler/utils/units.py

@@ -1,6 +1,8 @@
 import math
 import re
 
+from typing import Optional, Tuple
+
 SI_UNITS = (
     ('y', -24),
     ('z', -21),
@@ -51,7 +53,7 @@ BINARY_TYPES = (
 )
 
 
-def convert(value, from_unit=None, to_unit=None):
+def convert(value: float, from_unit: Optional[str] = None, to_unit: Optional[str] = None) -> float:
     '''
     Convert a value to from one SI power to another SI power
 
@@ -80,7 +82,7 @@ def convert(value, from_unit=None, to_unit=None):
     return value * scale
 
 
-def _get_scale(unit):
+def _get_scale(unit: Optional[str]) -> int:
     if not unit:
         unit = ''
     unit_prefix = get_si_prefix(unit)
@@ -91,7 +93,7 @@ def _get_scale(unit):
     return 1
 
 
-def get_si_prefix(unit):
+def get_si_prefix(unit: Optional[str]) -> str:
     '''
     Get the SI prefix of the specific unit.
 
@@ -107,8 +109,10 @@ def get_si_prefix(unit):
         if matches:
             return matches[0][0]
 
+    return ''
+
 
-def get_si_power(unit):
+def get_si_power(unit: Optional[str]) -> int:
     '''
     Get the SI power of the specific unit.
     This is mainly needed for area units.
@@ -129,28 +133,28 @@ def get_si_power(unit):
     return 1
 
 
-def is_base_si_unit(unit):
+def is_base_si_unit(unit: Optional[str]) -> bool:
     '''
     Check if a unit has no magnitude
     '''
     return unit in SI_TYPES
 
 
-def is_base_si_unit_power(unit):
+def is_base_si_unit_power(unit: Optional[str]) -> bool:
     '''
     Check if a unit has a power associated with it
     '''
     return get_si_power(unit) > 1
 
 
-def is_base_binary_unit(unit):
+def is_base_binary_unit(unit: Optional[str]) -> bool:
     '''
     Check if a unit is binary
     '''
     return unit in BINARY_TYPES
 
 
-def format_si(value, unit, margin=3, digits=3):
+def format_si(value: float, unit: str, margin: int = 3, digits: int = 3) -> str:
     '''
     Format a number as an SI number. Returns a string.
 
@@ -171,7 +175,7 @@ def format_si(value, unit, margin=3, digits=3):
     return f'{scaled_value:.{digits}f}{prefix}'
 
 
-def scale_si(value, unit, margin=3, digits=3):
+def scale_si(value: float, unit: str, margin: int = 3, digits: int = 3) -> Tuple[float, str]:
     '''
     Format a number as an SI number. Returns a float.
 
@@ -200,7 +204,7 @@ def scale_si(value, unit, margin=3, digits=3):
     return (float(f'{value:.{digits}f}'), '')
 
 
-def format_binary(value, unit, digits=3):
+def format_binary(value: float, unit: Optional[str], digits: int = 3) -> str:
     '''
     Format a number as a binary number. Returns a string.
 
@@ -214,7 +218,7 @@ def format_binary(value, unit, digits=3):
     return f'{scaled_value:.{digits}f}{prefix}'
 
 
-def scale_binary(value, unit, digits=3):
+def scale_binary(value: float, unit: Optional[str], digits: int = 3) -> Tuple[float, str]:
     '''
     Format a number as a binary number. Returns a float.
 
@@ -239,7 +243,7 @@ def scale_binary(value, unit, digits=3):
     return (float(f'{value:.{digits}f}'), '')
 
 
-def format_time(value):
+def format_time(value: float) -> str:
     '''
     Format a number as time.
     Prints as hh:mm:ss.ms (hours:minutes:seconds.milliseconds)

{siliconcompiler-0.35.0.dist-info → siliconcompiler-0.35.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: siliconcompiler
-Version: 0.35.0
+Version: 0.35.1
 Summary: A compiler framework that automates translation from source code to silicon.
 Author: Zero ASIC
 License: Apache License 2.0
@@ -24,7 +24,7 @@ Classifier: Topic :: Software Development :: Build Tools
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: aiohttp<3.13.0,>=3.10.11
+Requires-Dist: aiohttp<3.14.0,>=3.10.11
 Requires-Dist: distro<2.0.0,>=1.9.0
 Requires-Dist: docker<8.0.0,>=7.1.0
 Requires-Dist: fastjsonschema<2.22.0,>=2.20.0
@@ -37,7 +37,7 @@ Requires-Dist: PyYAML<7.0.0,>=6.0.0
 Requires-Dist: GitPython<3.2,>=3.1.44
 Requires-Dist: PyGithub<2.9.0,>=2.8.0
 Requires-Dist: urllib3>=1.26.0
-Requires-Dist: lambdapdk>=0.2.0
+Requires-Dist: lambdapdk>=0.2.1
 Requires-Dist: fasteners>=0.20
 Requires-Dist: pandas>=1.1.5
 Requires-Dist: psutil>=5.8.0
@@ -58,7 +58,6 @@ Requires-Dist: pytest-asyncio==1.2.0; extra == "test"
 Requires-Dist: pytest-cov==7.0.0; extra == "test"
 Requires-Dist: responses==0.25.8; extra == "test"
 Requires-Dist: PyVirtualDisplay==3.0; extra == "test"
-Requires-Dist: logiklib==0.1.0; extra == "test"
 Provides-Extra: lint
 Requires-Dist: flake8==7.3.0; extra == "lint"
 Requires-Dist: tclint==0.6.1; extra == "lint"