devlab-fpga 0.1.0__tar.gz → 0.1.2__tar.gz

{devlab_fpga-0.1.0/devlab_fpga.egg-info → devlab_fpga-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devlab-fpga
-Version: 0.1.0
+Version: 0.1.2
 Summary: FPGA development helper for installing OSS CAD Suite and running build/flash flows.
 Author-email: Mrju10 <name@email.com>
 License: MIT
@@ -64,6 +64,24 @@ YosysHQ. The installer selects the correct asset for:
 The default install location is `~/.devlab`. Set `DEVLAB_HOME` to use a
 different directory.
 
+On Windows, OSS CAD Suite may be distributed as a 7-Zip self-extracting `.exe`
+archive. `devlab install` extracts it automatically into `~/.devlab/toolchains`
+without opening an installer:
+
+```powershell
+devlab install
+```
+
+The installed tree keeps the official OSS CAD Suite layout:
+
+```text
+~/.devlab/toolchains/oss-cad-suite-2026-07-06-windows-x64/
+  oss-cad-suite/
+    bin/
+    environment.bat
+    environment.ps1
+```
+
 ## OSS CAD Suite Source
 
 Default release:

{devlab_fpga-0.1.0 → devlab_fpga-0.1.2}/README.md

@@ -40,6 +40,24 @@ YosysHQ. The installer selects the correct asset for:
 The default install location is `~/.devlab`. Set `DEVLAB_HOME` to use a
 different directory.
 
+On Windows, OSS CAD Suite may be distributed as a 7-Zip self-extracting `.exe`
+archive. `devlab install` extracts it automatically into `~/.devlab/toolchains`
+without opening an installer:
+
+```powershell
+devlab install
+```
+
+The installed tree keeps the official OSS CAD Suite layout:
+
+```text
+~/.devlab/toolchains/oss-cad-suite-2026-07-06-windows-x64/
+  oss-cad-suite/
+    bin/
+    environment.bat
+    environment.ps1
+```
+
 ## OSS CAD Suite Source
 
 Default release:

{devlab_fpga-0.1.0 → devlab_fpga-0.1.2}/devlab/__init__.py

@@ -2,5 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "0.1.0"
-
+__version__ = "0.1.2"

{devlab_fpga-0.1.0 → devlab_fpga-0.1.2}/devlab/cli.py

@@ -24,8 +24,13 @@ def build_parser() -> argparse.ArgumentParser:
         description="Install FPGA toolchains and run local FPGA build flows.",
     )
     parser.add_argument("--version", action="version", version=f"devlab {__version__}")
+    parser.add_argument(
+        "--run-installer",
+        action="store_true",
+        help="Deprecated compatibility flag. Windows install is automatic.",
+    )
 
-    commands = parser.add_subparsers(dest="command", required=True)
+    commands = parser.add_subparsers(dest="command")
 
     doctor_parser = commands.add_parser("doctor", help="Check local FPGA tools.")
     doctor_parser.add_argument(
@@ -40,7 +45,7 @@ def build_parser() -> argparse.ArgumentParser:
     install_parser.add_argument(
         "--run-installer",
         action="store_true",
-        help="On Windows, execute the downloaded OSS CAD Suite installer.",
+        help="Deprecated compatibility flag. Windows install is automatic.",
     )
     install_parser.set_defaults(func=_install)
 
@@ -105,6 +110,11 @@ def main(argv: list[str] | None = None) -> int:
     parser = build_parser()
     args = parser.parse_args(argv)
     try:
+        if args.command is None:
+            if args.run_installer:
+                args.force = False
+                return _install(args)
+            parser.error("the following arguments are required: command")
         return args.func(args)
     except DevlabError as exc:
         parser.exit(2, f"devlab: error: {exc}\n")

{devlab_fpga-0.1.0 → devlab_fpga-0.1.2}/devlab/toolchain.py

@@ -9,6 +9,7 @@ import sys
 import tarfile
 import tempfile
 import urllib.request
+import zipfile
 from dataclasses import dataclass
 from pathlib import Path
 
@@ -104,13 +105,18 @@ def archive_path(asset: ToolchainAsset | None = None, home: Path | None = None)
 
 def bin_dir(path: Path | None = None) -> Path:
     path = path or install_path()
-    return path / "bin"
+    return path / "oss-cad-suite" / "bin"
+
+
+def bin_dirs(path: Path | None = None) -> list[Path]:
+    path = path or install_path()
+    return [path / "oss-cad-suite" / "bin", path / "bin"]
 
 
 def env_with_toolchain(path: Path | None = None) -> dict[str, str]:
     env = os.environ.copy()
-    binary_dir = str(bin_dir(path))
-    env["PATH"] = binary_dir + os.pathsep + env.get("PATH", "")
+    binary_dirs = os.pathsep.join(str(candidate) for candidate in bin_dirs(path))
+    env["PATH"] = binary_dirs + os.pathsep + env.get("PATH", "")
     return env
 
 
@@ -120,9 +126,9 @@ def find_executable(name: str, path: Path | None = None) -> str | None:
         suffixes = [".exe", ".bat", ".cmd", ""]
 
     candidates: list[str] = []
-    binary_dir = bin_dir(path)
-    for suffix in suffixes:
-        candidates.append(str(binary_dir / f"{name}{suffix}"))
+    for binary_dir in bin_dirs(path):
+        for suffix in suffixes:
+            candidates.append(str(binary_dir / f"{name}{suffix}"))
 
     for candidate in candidates:
         if Path(candidate).exists():
@@ -179,45 +185,75 @@ def install_oss_cad_suite(
     asset = select_asset()
     destination = install_path(asset, home)
 
-    if destination.exists() and not force:
+    if destination.exists() and find_executable("yosys", destination) and not force:
         return destination
 
     archive = download_asset(asset, archive_path(asset, home), force=force)
 
     if asset.name.endswith(".exe"):
-        if not run_windows_installer:
+        _extract_windows_sfx(archive, destination, force=force)
+        if not find_executable("yosys", destination):
             raise DevlabError(
-                "Windows uses the OSS CAD Suite .exe installer. "
-                f"The file was downloaded to {archive}. Re-run with "
-                "--run-installer to execute it."
+                "The Windows OSS CAD Suite archive was extracted, "
+                "but yosys was not found in "
+                f"{destination}\\oss-cad-suite\\bin or {destination}\\bin. "
+                "Check the extracted files, then run `devlab doctor`."
             )
-        subprocess.check_call([str(archive)])
+        return destination
+
+    if asset.name.endswith(".zip"):
+        _extract_zip(archive, destination, force=force)
         return destination
 
     _extract_tarball(archive, destination, force=force)
-    _mark_executables(bin_dir(destination))
+    for binary_dir in bin_dirs(destination):
+        _mark_executables(binary_dir)
     return destination
 
 
-def _extract_tarball(archive: Path, destination: Path, force: bool) -> None:
+def _move_extracted_tree(source: Path, destination: Path, force: bool) -> None:
     destination.parent.mkdir(parents=True, exist_ok=True)
     if destination.exists():
-        if not force:
+        if not force and find_executable("yosys", destination):
             raise DevlabError(f"Install destination already exists: {destination}")
         shutil.rmtree(destination)
 
+    destination.mkdir(parents=True)
+    for child in source.iterdir():
+        shutil.move(str(child), destination / child.name)
+
+
+def _extract_windows_sfx(archive: Path, destination: Path, force: bool) -> None:
+    destination.parent.mkdir(parents=True, exist_ok=True)
+    with tempfile.TemporaryDirectory(
+        prefix="devlab-oss-cad-suite-", dir=destination.parent
+    ) as tmp:
+        tmp_path = Path(tmp)
+        try:
+            subprocess.check_call([str(archive), f"-o{tmp_path}", "-y"], cwd=tmp_path)
+        except subprocess.CalledProcessError as exc:
+            raise DevlabError(
+                f"Could not extract Windows OSS CAD Suite archive: {exc}"
+            ) from exc
+        _move_extracted_tree(tmp_path, destination, force=force)
+
+
+def _extract_zip(archive: Path, destination: Path, force: bool) -> None:
+    with tempfile.TemporaryDirectory(prefix="devlab-oss-cad-suite-") as tmp:
+        tmp_path = Path(tmp)
+        with zipfile.ZipFile(archive) as zip_file:
+            _safe_extract_zip(zip_file, tmp_path)
+
+        _move_extracted_tree(tmp_path, destination, force=force)
+
+
+def _extract_tarball(archive: Path, destination: Path, force: bool) -> None:
     with tempfile.TemporaryDirectory(prefix="devlab-oss-cad-suite-") as tmp:
         tmp_path = Path(tmp)
         with tarfile.open(archive, "r:gz") as tar:
             _safe_extract(tar, tmp_path)
 
-        children = [child for child in tmp_path.iterdir()]
-        if len(children) == 1 and children[0].is_dir():
-            shutil.move(str(children[0]), destination)
-        else:
-            destination.mkdir(parents=True)
-            for child in children:
-                shutil.move(str(child), destination / child.name)
+        _move_extracted_tree(tmp_path, destination, force=force)
 
 
 def _safe_extract(tar: tarfile.TarFile, destination: Path) -> None:
@@ -232,6 +268,15 @@ def _safe_extract(tar: tarfile.TarFile, destination: Path) -> None:
         tar.extractall(destination)
 
 
+def _safe_extract_zip(zip_file: zipfile.ZipFile, destination: Path) -> None:
+    destination = destination.resolve()
+    for member in zip_file.infolist():
+        target = (destination / member.filename).resolve()
+        if destination != target and destination not in target.parents:
+            raise DevlabError(f"Unsafe path in archive: {member.filename}")
+    zip_file.extractall(destination)
+
+
 def _mark_executables(path: Path) -> None:
     if not path.exists():
         return

{devlab_fpga-0.1.0 → devlab_fpga-0.1.2/devlab_fpga.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devlab-fpga
-Version: 0.1.0
+Version: 0.1.2
 Summary: FPGA development helper for installing OSS CAD Suite and running build/flash flows.
 Author-email: Mrju10 <name@email.com>
 License: MIT
@@ -64,6 +64,24 @@ YosysHQ. The installer selects the correct asset for:
 The default install location is `~/.devlab`. Set `DEVLAB_HOME` to use a
 different directory.
 
+On Windows, OSS CAD Suite may be distributed as a 7-Zip self-extracting `.exe`
+archive. `devlab install` extracts it automatically into `~/.devlab/toolchains`
+without opening an installer:
+
+```powershell
+devlab install
+```
+
+The installed tree keeps the official OSS CAD Suite layout:
+
+```text
+~/.devlab/toolchains/oss-cad-suite-2026-07-06-windows-x64/
+  oss-cad-suite/
+    bin/
+    environment.bat
+    environment.ps1
+```
+
 ## OSS CAD Suite Source
 
 Default release:

{devlab_fpga-0.1.0 → devlab_fpga-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "devlab-fpga"
-version = "0.1.0"
+version = "0.1.2"
 description = "FPGA development helper for installing OSS CAD Suite and running build/flash flows."
 readme = "README.md"
 requires-python = ">=3.9"