ciel 0.21.0.dev0__tar.gz → 1.0.0__tar.gz

{ciel-0.21.0.dev0 → ciel-1.0.0}/PKG-INFO

@@ -1,10 +1,11 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.1
 Name: ciel
-Version: 0.21.0.dev0
+Version: 1.0.0
 Summary: An PDK builder/version manager for PDKs in the open_pdks format
+Home-page: https://github.com/fossi-foundation/ciel
 License: Apache-2.0
-Author: Efabless Corporation and Contributors
-Author-email: donn@efabless.com
+Author: Mohamed Gaber
+Author-email: me@donn.website
 Requires-Python: >=3.8
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: Apache Software License
@@ -23,18 +24,18 @@ Requires-Dist: pcpp (>=1.2,<2)
 Requires-Dist: pyyaml (>=5,<7)
 Requires-Dist: rich (>=12,<14)
 Requires-Dist: zstandard (>=0.19.0,<1)
-Project-URL: Repository, https://github.com/donn/cielo
+Project-URL: Repository, https://github.com/fossi-foundation/ciel
 Description-Content-Type: text/markdown
 
-<h1 align="center">☁️ Cielo</h1>
+<h1 align="center">🌌 Ciel</h1>
 <p align="center">
     <a href="https://opensource.org/licenses/Apache-2.0"><img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="License: Apache 2.0"/></a>
-    <img src="https://github.com/efabless/cielo/actions/workflows/ci.yml/badge.svg?branch=main" alt="CI Status" />
-    <a href="https://invite.skywater.tools"><img src="https://img.shields.io/badge/Community-Skywater%20PDK%20Slack-ff69b4?logo=slack" alt="Invite to the Skywater PDK Slack"/></a>
+    <img src="https://github.com/fossi-foundation/ciel/actions/workflows/ci.yml/badge.svg?branch=main" alt="CI Status" />
+    <a href="https://fossi-chat.org"><img src="https://img.shields.io/badge/Community-FOSSi%20Chat-1bb378?logo=element" alt="Invite to the Skywater PDK Slack"/></a>
     <a href="https://github.com/psf/black"><img src="https://img.shields.io/badge/code%20style-black-000000.svg" alt="Code Style: Black"/></a>
 </p>
 
-<p align="center">Cielo is a version manager (and builder) for builds of <a href="https://github.com/google/open-source-pdks">Google open-source PDKs</a> using <a href="https://github.com/rtimothyedwards/open_pdks">open_pdks</a>.</p>
+<p align="center">Ciel is a version manager (and builder) for builds of open-source process design kits (PDKs).</p>
 
 # Requirements
 * Python 3.8+ with PIP
@@ -65,33 +66,39 @@ sudo yum install -y python3 python3-pip
 # Installation and Upgrades
 ```sh
 # To install (or upgrade)
-python3 -m pip install --user --upgrade --no-cache-dir cielo
+python3 -m pip install --user --upgrade --no-cache-dir ciel
 
 # To verify it works
-cielo --version
+ciel --version
 ```
 
 # About the builds
-In its current inception, cielo supports builds of **sky130** and **gf180mcu** PDKs using [Open_PDKs](https://github.com/efabless/open_pdks), including the following libraries:
-
-|sky130|gf180mcu|
-|-|-|
-|sky130_fd_io|gf180mcu_fd_io|
-|sky130_fd_pr|gf180mcu_fd_pr|
-|sky130_fd_sc_hd|gf180mcu_fd_sc_mcu7t5v0|
-|sky130_fd_sc_hvl|gf180mcu_fd_sc_mcu9t5v0|
-|sky130 sram modules|gf180mcu_fd_ip_sram|
-
-All builds are identified by their **open_pdks** commit hash.
+In its current inception, ciel supports builds of **sky130** and **gf180mcu** PDKs using [Open_PDKs](https://github.com/efabless/open_pdks), including the following libraries:
+
+|sky130|gf180mcu|ihp_sg13g2|
+|-|-|-|
+|sky130_fd_io|gf180mcu_fd_io|sg13g2_io|
+|sky130_fd_pr|gf180mcu_fd_pr|sg13g2_pr|
+|sky130_fd_pr_reram$|gf180mcu_fd_pr|sg13g2_pr|
+|sky130_fd_sc_hd|gf180mcu_fd_sc_mcu7t5v0|sg13g2_stdcell|
+|sky130_ml_xx_hd|gf180mcu_fd_sc_mcu9t5v0|-|
+|sky130_fd_sc_hvl|gf180mcu_osu_sc_gp9t3v3|-|
+|sky130_fd_sc_lp|gf180mcu_osu_sc_gp12t3v3|-|
+|sky130_fd_sc_ls|-|-|
+|sky130_fd_sc_ms|-|-|
+|sky130_fd_sc_hs|-|-|
+|sky130_sram_macros|gf180mcu_fd_ip_sram|sg13g2_sram|
+
+Builds for sky130 and gf180mcu are identified by their [**open_pdks**](https://github.com/rtimothyedwards/open_pdks) commit hashes. Builds for ihp_sg13g2 are identified by their [**IHP-Open-PDK**](https://github.com/ihp-gmbh/ihp-open-pdk) commit hashes.
 
 # Usage
-Cielo requires a so-called **PDK Root**. This PDK root can be anywhere on your computer, but by default it's the folder `~/.cielo` in your home directory. If you have the variable `PDK_ROOT` set, cielo will use that instead. You can also manually override both values by supplying the `--pdk-root` commandline argument.
+Ciel requires a so-called **PDK Root**. This PDK root can be anywhere on your computer, but by default it's the folder `~/.ciel` in your home directory. If you have the variable `PDK_ROOT` set, ciel will use that instead. You can also manually override both values by supplying the `--pdk-root` commandline argument.
 
 ## Listing All Available PDKs
-To list all available pre-built PDKs hosted in this repository, you can just invoke `cielo ls-remote --pdk <PDK>`. If you omit the `--pdk` argument, `sky130` will be used as a default.
+To list all available pre-built PDKs hosted in this repository, you can just invoke `ciel ls-remote --pdk <PDK>`. If you omit the `--pdk` argument, `sky130` will be used as a default.
 
 ```sh
-$ cielo ls-remote --pdk sky130
+$ ciel ls-remote --pdk sky130
 Pre-built sky130 PDK versions
 ├── 44a43c23c81b45b8e774ae7a84899a5a778b6b0b (2022.08.16) (enabled)
 ├── e8294524e5f67c533c5d0c3afa0bcc5b2a5fa066 (2022.07.29) (installed)
@@ -101,19 +108,19 @@ Pre-built sky130 PDK versions
 ├── 8fe7f760ece2bb49b1c310e60243f0558977dae5 (2022.04.06)
 └── 7519dfb04400f224f140749cda44ee7de6f5e095 (2022.02.10)
 
-$ cielo ls-remote --pdk gf180mcu
+$ ciel ls-remote --pdk gf180mcu
 Pre-built gf180mcu PDK versions
 └── 120b0bd69c745825a0b8b76f364043a1cd08bb6a (2022.09.22)
 ```
 
-It includes a commit hash, which is the `open_pdks` version used to build this particular PDK, the date that this commit was created, and whether you already installed this PDK and/or if it is the currently enabled PDK.
+It includes a hash of the commit of the relevant repo used for that particular build, the date that this commit was created, and whether you already installed this PDK and/or if it is the currently enabled PDK.
 
 ## Listing Installed PDKs
-Typing `cielo ls --pdk <pdk>` in the terminal shows you your PDK Root and the PDKs you currently have installed. Again, if you omit the `--pdk` argument, `sky130` will be used as a default.
+Typing `ciel ls --pdk <pdk>` in the terminal shows you your PDK Root and the PDKs you currently have installed. Again, if you omit the `--pdk` argument, `sky130` will be used as a default.
 
 ```sh
-$ cielo ls --pdk sky130
-/home/test/cielo/sky130/versions
+$ ciel ls --pdk sky130
+/home/test/ciel/sky130/versions
 ├── 44a43c23c81b45b8e774ae7a84899a5a778b6b0b (2022.08.16) (enabled)
 ├── e8294524e5f67c533c5d0c3afa0bcc5b2a5fa066 (2022.07.29)
 └── 41c0908b47130d5675ff8484255b43f66463a7d6 (2022.04.14)
@@ -123,31 +130,29 @@ $ cielo ls --pdk sky130
 
 
 ## Downloading and Enabling PDKs
-You can enable a particular sky130 PDK by invoking `cielo enable --pdk <pdk> <open_pdks commit hash>`. This will automatically download that particular version of the PDK, if found, and set it as your currently used PDK.
+You can enable a particular sky130 PDK by invoking `ciel enable --pdk <pdk> <open_pdks commit hash>`. This will automatically download that particular version of the PDK, if found, and set it as your currently used PDK.
 
-For example, to activate a build of sky130 using open_pdks `7519dfb04400f224f140749cda44ee7de6f5e095`, you invoke `cielo enable --pdk sky130 7519dfb04400f224f140749cda44ee7de6f5e095`, as shown below:
+For example, to activate a build of sky130 using open_pdks `7519dfb04400f224f140749cda44ee7de6f5e095`, you invoke `ciel enable --pdk sky130 7519dfb04400f224f140749cda44ee7de6f5e095`, as shown below:
 
 ```sh
-$ cielo enable --pdk sky130 7519dfb04400f224f140749cda44ee7de6f5e095
+$ ciel enable --pdk sky130 7519dfb04400f224f140749cda44ee7de6f5e095
 Downloading pre-built tarball for 7519dfb04400f224f140749cda44ee7de6f5e095… ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 0:00:00
 Unpacking…                                                                  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 0:00:00
 PDK version 7519dfb04400f224f140749cda44ee7de6f5e095 enabled.
 ```
 
-What's more is: if you're using a repository with a `tool_metadata.yml` file, such as [OpenLane](https://github.com/The-OpenROAD-Project/OpenLane) or [DFFRAM](https://github.com/Cloud-V/DFFRAM), you can just invoke `cielo enable --pdk sky130` without the commit hash and Cielo will automatically extract the version required by the utility. Once again, if you omit the `--pdk` argument, `sky130` will be used as a default.
-
 ## Building PDKs
-For special cases, you may have to build the PDK yourself, which Cielo does support.
+For special cases, you may have to build the PDK yourself, which Ciel does support.
 
-You'll need Magic installed and in PATH. You can either do that manually or, if you have [Nix](https://nixos.org), invoke `nix shell github:efabless/openlane2#magic` before building.
+You'll need Magic installed and in PATH. You can either do that manually or, if you have [Nix](https://nixos.org), invoke `nix shell github:fossi-foundation/nix-eda#magic` before building.
 
-You can invoke `cielo build --help` for more options. Be aware, the built PDK won't automatically be enabled and you'll have to `cielo enable` the appropriate version.
+You can invoke `ciel build --help` for more options. Be aware, the built PDK won't automatically be enabled and you'll have to `ciel enable` the appropriate version.
 
 # License
 The Apache License, version 2.0. See 'License'.
 
 
-Cielo is based on [Volare](https://github.com/efabless/volare) by Efabless
+Ciel is based on [Volare](https://github.com/efabless/volare) by Efabless
 Corporation:
 
 ```

{ciel-0.21.0.dev0 → ciel-1.0.0}/Readme.md

@@ -1,12 +1,12 @@
-<h1 align="center">☁️ Cielo</h1>
+<h1 align="center">🌌 Ciel</h1>
 <p align="center">
     <a href="https://opensource.org/licenses/Apache-2.0"><img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="License: Apache 2.0"/></a>
-    <img src="https://github.com/efabless/cielo/actions/workflows/ci.yml/badge.svg?branch=main" alt="CI Status" />
-    <a href="https://invite.skywater.tools"><img src="https://img.shields.io/badge/Community-Skywater%20PDK%20Slack-ff69b4?logo=slack" alt="Invite to the Skywater PDK Slack"/></a>
+    <img src="https://github.com/fossi-foundation/ciel/actions/workflows/ci.yml/badge.svg?branch=main" alt="CI Status" />
+    <a href="https://fossi-chat.org"><img src="https://img.shields.io/badge/Community-FOSSi%20Chat-1bb378?logo=element" alt="Invite to the Skywater PDK Slack"/></a>
     <a href="https://github.com/psf/black"><img src="https://img.shields.io/badge/code%20style-black-000000.svg" alt="Code Style: Black"/></a>
 </p>
 
-<p align="center">Cielo is a version manager (and builder) for builds of <a href="https://github.com/google/open-source-pdks">Google open-source PDKs</a> using <a href="https://github.com/rtimothyedwards/open_pdks">open_pdks</a>.</p>
+<p align="center">Ciel is a version manager (and builder) for builds of open-source process design kits (PDKs).</p>
 
 # Requirements
 * Python 3.8+ with PIP
@@ -37,33 +37,39 @@ sudo yum install -y python3 python3-pip
 # Installation and Upgrades
 ```sh
 # To install (or upgrade)
-python3 -m pip install --user --upgrade --no-cache-dir cielo
+python3 -m pip install --user --upgrade --no-cache-dir ciel
 
 # To verify it works
-cielo --version
+ciel --version
 ```
 
 # About the builds
-In its current inception, cielo supports builds of **sky130** and **gf180mcu** PDKs using [Open_PDKs](https://github.com/efabless/open_pdks), including the following libraries:
-
-|sky130|gf180mcu|
-|-|-|
-|sky130_fd_io|gf180mcu_fd_io|
-|sky130_fd_pr|gf180mcu_fd_pr|
-|sky130_fd_sc_hd|gf180mcu_fd_sc_mcu7t5v0|
-|sky130_fd_sc_hvl|gf180mcu_fd_sc_mcu9t5v0|
-|sky130 sram modules|gf180mcu_fd_ip_sram|
-
-All builds are identified by their **open_pdks** commit hash.
+In its current inception, ciel supports builds of **sky130** and **gf180mcu** PDKs using [Open_PDKs](https://github.com/efabless/open_pdks), including the following libraries:
+
+|sky130|gf180mcu|ihp_sg13g2|
+|-|-|-|
+|sky130_fd_io|gf180mcu_fd_io|sg13g2_io|
+|sky130_fd_pr|gf180mcu_fd_pr|sg13g2_pr|
+|sky130_fd_pr_reram$|gf180mcu_fd_pr|sg13g2_pr|
+|sky130_fd_sc_hd|gf180mcu_fd_sc_mcu7t5v0|sg13g2_stdcell|
+|sky130_ml_xx_hd|gf180mcu_fd_sc_mcu9t5v0|-|
+|sky130_fd_sc_hvl|gf180mcu_osu_sc_gp9t3v3|-|
+|sky130_fd_sc_lp|gf180mcu_osu_sc_gp12t3v3|-|
+|sky130_fd_sc_ls|-|-|
+|sky130_fd_sc_ms|-|-|
+|sky130_fd_sc_hs|-|-|
+|sky130_sram_macros|gf180mcu_fd_ip_sram|sg13g2_sram|
+
+Builds for sky130 and gf180mcu are identified by their [**open_pdks**](https://github.com/rtimothyedwards/open_pdks) commit hashes. Builds for ihp_sg13g2 are identified by their [**IHP-Open-PDK**](https://github.com/ihp-gmbh/ihp-open-pdk) commit hashes.
 
 # Usage
-Cielo requires a so-called **PDK Root**. This PDK root can be anywhere on your computer, but by default it's the folder `~/.cielo` in your home directory. If you have the variable `PDK_ROOT` set, cielo will use that instead. You can also manually override both values by supplying the `--pdk-root` commandline argument.
+Ciel requires a so-called **PDK Root**. This PDK root can be anywhere on your computer, but by default it's the folder `~/.ciel` in your home directory. If you have the variable `PDK_ROOT` set, ciel will use that instead. You can also manually override both values by supplying the `--pdk-root` commandline argument.
 
 ## Listing All Available PDKs
-To list all available pre-built PDKs hosted in this repository, you can just invoke `cielo ls-remote --pdk <PDK>`. If you omit the `--pdk` argument, `sky130` will be used as a default.
+To list all available pre-built PDKs hosted in this repository, you can just invoke `ciel ls-remote --pdk <PDK>`. If you omit the `--pdk` argument, `sky130` will be used as a default.
 
 ```sh
-$ cielo ls-remote --pdk sky130
+$ ciel ls-remote --pdk sky130
 Pre-built sky130 PDK versions
 ├── 44a43c23c81b45b8e774ae7a84899a5a778b6b0b (2022.08.16) (enabled)
 ├── e8294524e5f67c533c5d0c3afa0bcc5b2a5fa066 (2022.07.29) (installed)
@@ -73,19 +79,19 @@ Pre-built sky130 PDK versions
 ├── 8fe7f760ece2bb49b1c310e60243f0558977dae5 (2022.04.06)
 └── 7519dfb04400f224f140749cda44ee7de6f5e095 (2022.02.10)
 
-$ cielo ls-remote --pdk gf180mcu
+$ ciel ls-remote --pdk gf180mcu
 Pre-built gf180mcu PDK versions
 └── 120b0bd69c745825a0b8b76f364043a1cd08bb6a (2022.09.22)
 ```
 
-It includes a commit hash, which is the `open_pdks` version used to build this particular PDK, the date that this commit was created, and whether you already installed this PDK and/or if it is the currently enabled PDK.
+It includes a hash of the commit of the relevant repo used for that particular build, the date that this commit was created, and whether you already installed this PDK and/or if it is the currently enabled PDK.
 
 ## Listing Installed PDKs
-Typing `cielo ls --pdk <pdk>` in the terminal shows you your PDK Root and the PDKs you currently have installed. Again, if you omit the `--pdk` argument, `sky130` will be used as a default.
+Typing `ciel ls --pdk <pdk>` in the terminal shows you your PDK Root and the PDKs you currently have installed. Again, if you omit the `--pdk` argument, `sky130` will be used as a default.
 
 ```sh
-$ cielo ls --pdk sky130
-/home/test/cielo/sky130/versions
+$ ciel ls --pdk sky130
+/home/test/ciel/sky130/versions
 ├── 44a43c23c81b45b8e774ae7a84899a5a778b6b0b (2022.08.16) (enabled)
 ├── e8294524e5f67c533c5d0c3afa0bcc5b2a5fa066 (2022.07.29)
 └── 41c0908b47130d5675ff8484255b43f66463a7d6 (2022.04.14)
@@ -95,31 +101,29 @@ $ cielo ls --pdk sky130
 
 
 ## Downloading and Enabling PDKs
-You can enable a particular sky130 PDK by invoking `cielo enable --pdk <pdk> <open_pdks commit hash>`. This will automatically download that particular version of the PDK, if found, and set it as your currently used PDK.
+You can enable a particular sky130 PDK by invoking `ciel enable --pdk <pdk> <open_pdks commit hash>`. This will automatically download that particular version of the PDK, if found, and set it as your currently used PDK.
 
-For example, to activate a build of sky130 using open_pdks `7519dfb04400f224f140749cda44ee7de6f5e095`, you invoke `cielo enable --pdk sky130 7519dfb04400f224f140749cda44ee7de6f5e095`, as shown below:
+For example, to activate a build of sky130 using open_pdks `7519dfb04400f224f140749cda44ee7de6f5e095`, you invoke `ciel enable --pdk sky130 7519dfb04400f224f140749cda44ee7de6f5e095`, as shown below:
 
 ```sh
-$ cielo enable --pdk sky130 7519dfb04400f224f140749cda44ee7de6f5e095
+$ ciel enable --pdk sky130 7519dfb04400f224f140749cda44ee7de6f5e095
 Downloading pre-built tarball for 7519dfb04400f224f140749cda44ee7de6f5e095… ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 0:00:00
 Unpacking…                                                                  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 0:00:00
 PDK version 7519dfb04400f224f140749cda44ee7de6f5e095 enabled.
 ```
 
-What's more is: if you're using a repository with a `tool_metadata.yml` file, such as [OpenLane](https://github.com/The-OpenROAD-Project/OpenLane) or [DFFRAM](https://github.com/Cloud-V/DFFRAM), you can just invoke `cielo enable --pdk sky130` without the commit hash and Cielo will automatically extract the version required by the utility. Once again, if you omit the `--pdk` argument, `sky130` will be used as a default.
-
 ## Building PDKs
-For special cases, you may have to build the PDK yourself, which Cielo does support.
+For special cases, you may have to build the PDK yourself, which Ciel does support.
 
-You'll need Magic installed and in PATH. You can either do that manually or, if you have [Nix](https://nixos.org), invoke `nix shell github:efabless/openlane2#magic` before building.
+You'll need Magic installed and in PATH. You can either do that manually or, if you have [Nix](https://nixos.org), invoke `nix shell github:fossi-foundation/nix-eda#magic` before building.
 
-You can invoke `cielo build --help` for more options. Be aware, the built PDK won't automatically be enabled and you'll have to `cielo enable` the appropriate version.
+You can invoke `ciel build --help` for more options. Be aware, the built PDK won't automatically be enabled and you'll have to `ciel enable` the appropriate version.
 
 # License
 The Apache License, version 2.0. See 'License'.
 
 
-Cielo is based on [Volare](https://github.com/efabless/volare) by Efabless
+Ciel is based on [Volare](https://github.com/efabless/volare) by Efabless
 Corporation:
 
 ```

{ciel-0.21.0.dev0 → ciel-1.0.0}/ciel/__init__.py

@@ -18,7 +18,7 @@ from .manage import (
     fetch,
 )
 from .common import (
-    get_cielo_home,
+    get_ciel_home,
     Version,
 )
 from .families import Family

{ciel-0.21.0.dev0 → ciel-1.0.0}/ciel/__main__.py

@@ -1,3 +1,7 @@
+# Copyright 2025 The American University in Cairo
+#
+# Adapted from the Volare project
+#
 # Copyright 2022-2023 Efabless Corporation
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -21,15 +25,11 @@ from rich.console import Console
 from .__version__ import __version__
 from .common import (
     Version,
-    get_cielo_home,
+    get_ciel_home,
     resolve_version,
 )
 from .click_common import (
-    opt,
-    opt_build,
-    opt_push,
     opt_pdk_root,
-    opt_token,
 )
 from .manage import (
     print_installed_list,
@@ -41,6 +41,8 @@ from .build import (
     build_cmd,
     push_cmd,
 )
+from .github import opt_github_token
+from .source import opt_data_source
 
 
 @click.command("output")
@@ -57,15 +59,11 @@ def output_cmd(pdk_root, pdk):
     if sys.stdout.isatty():
         if version is None:
             print(f"No version of the PDK {pdk} is currently enabled at {pdk_root}.")
-            print(
-                "Invoke cielo --help for assistance installing and enabling versions."
-            )
+            print("Invoke ciel --help for assistance installing and enabling versions.")
             exit(1)
         else:
             print(f"Installed: {pdk} v{version.name}")
-            print(
-                "Invoke cielo --help for assistance installing and enabling versions."
-            )
+            print("Invoke ciel --help for assistance installing and enabling versions.")
     else:
         if version is None:
             exit(1)
@@ -117,9 +115,10 @@ def rm_cmd(pdk_root, pdk, version):
 
 
 @click.command("ls")
-@opt_token
+@opt_data_source
+@opt_github_token
 @opt_pdk_root
-def list_cmd(pdk_root, pdk):
+def list_cmd(data_source, pdk_root, pdk):
     """Lists PDK versions that are locally installed. JSON if not outputting to a tty."""
 
     pdk_versions = Version.get_all_installed(pdk_root, pdk)
@@ -129,6 +128,7 @@ def list_cmd(pdk_root, pdk):
         print_installed_list(
             pdk_root,
             pdk,
+            data_source=data_source,
             console=console,
             installed_list=pdk_versions,
         )
@@ -137,14 +137,14 @@ def list_cmd(pdk_root, pdk):
 
 
 @click.command("ls-remote")
-@opt_token
+@opt_github_token
+@opt_data_source
 @opt_pdk_root
-def list_remote_cmd(pdk_root, pdk):
+def list_remote_cmd(data_source, pdk_root, pdk):
     """Lists PDK versions that are remotely available. JSON if not outputting to a tty."""
 
     try:
-        all_versions = Version._from_github()
-        pdk_versions = all_versions.get(pdk) or []
+        pdk_versions = data_source.get_available_versions(pdk)
 
         if sys.stdout.isatty():
             console = Console()
@@ -152,6 +152,13 @@ def list_remote_cmd(pdk_root, pdk):
         else:
             for version in pdk_versions:
                 print(version.name)
+    except ValueError as e:
+        if sys.stdout.isatty():
+            console = Console()
+            console.print(f"[red]{e}")
+        else:
+            print(f"{e}", file=sys.stderr)
+        sys.exit(-1)
     except httpx.HTTPStatusError as e:
         if sys.stdout.isatty():
             console = Console()
@@ -175,7 +182,7 @@ def list_remote_cmd(pdk_root, pdk):
 @click.argument("version", required=False)
 def path_cmd(pdk_root, pdk, version):
     """
-    Prints the path of the cielo PDK root.
+    Prints the path of the ciel PDK root.
 
     If a version is provided over the commandline, it prints the path to this
     version instead.
@@ -184,11 +191,12 @@ def path_cmd(pdk_root, pdk, version):
         version = Version(version, pdk)
         print(version.get_dir(pdk_root), end="")
     else:
-        print(get_cielo_home(pdk_root))
+        print(get_ciel_home(pdk_root))
 
 
 @click.command("enable")
-@opt_token
+@opt_data_source
+@opt_github_token
 @opt_pdk_root
 @click.option(
     "-f",
@@ -206,6 +214,7 @@ def path_cmd(pdk_root, pdk, version):
 )
 @click.argument("version", required=False)
 def enable_cmd(
+    data_source,
     pdk_root,
     pdk,
     tool_metadata_file_path,
@@ -238,6 +247,7 @@ def enable_cmd(
             version,
             include_libraries=include_libraries,
             output=console,
+            data_source=data_source,
         )
     except Exception as e:
         console.print(f"[red]{e}")
@@ -245,7 +255,8 @@ def enable_cmd(
 
 
 @click.command("fetch")
-@opt_token
+@opt_data_source
+@opt_github_token
 @opt_pdk_root
 @click.option(
     "-f",
@@ -263,6 +274,7 @@ def enable_cmd(
 )
 @click.argument("version", required=False)
 def fetch_cmd(
+    data_source,
     pdk_root,
     pdk,
     tool_metadata_file_path,
@@ -270,7 +282,7 @@ def fetch_cmd(
     include_libraries,
 ):
     """
-    Fetches a PDK to Cielo's store without setting it as the "enabled" version
+    Fetches a PDK to Ciel's store without setting it as the "enabled" version
     in ``PDK_ROOT``.
 
     Parameters: <version> (Optional)
@@ -291,6 +303,7 @@ def fetch_cmd(
 
     try:
         version = fetch(
+            data_source=data_source,
             pdk_root=pdk_root,
             pdk=pdk,
             version=version,
@@ -304,83 +317,10 @@ def fetch_cmd(
         exit(-1)
 
 
-@click.command("enable_or_build", hidden=True)
-@opt_token
-@opt_pdk_root
-@opt_push
-@opt_build
-@opt("--also-push/--dont-push", default=False, help="Also push.")
-@click.option(
-    "-f",
-    "--metadata-file",
-    "tool_metadata_file_path",
-    default=None,
-    help="Explicitly define a tool metadata file instead of searching for a metadata file",
-)
-@click.argument("version")
-def enable_or_build_cmd(
-    include_libraries,
-    jobs,
-    pdk_root,
-    pdk,
-    owner,
-    repository,
-    pre,
-    clear_build_artifacts,
-    tool_metadata_file_path,
-    also_push,
-    version,
-    use_repo_at,
-    push_libraries,
-):
-    """
-    Attempts to activate a given PDK version. If the version is not found locally or remotely,
-    it will instead attempt to build said version.
-
-    Parameters: <version>
-    """
-    if include_libraries == ():
-        include_libraries = None
-    if push_libraries == ():
-        push_libraries = include_libraries
-
-    console = Console()
-    try:
-        version = resolve_version(version, tool_metadata_file_path)
-    except Exception as e:
-        console.print(f"Could not determine open_pdks version: {e}")
-        exit(-1)
-    try:
-        enable(
-            pdk_root=pdk_root,
-            pdk=pdk,
-            version=version,
-            build_if_not_found=True,
-            also_push=also_push,
-            build_kwargs={
-                "include_libraries": include_libraries,
-                "jobs": jobs,
-                "clear_build_artifacts": clear_build_artifacts,
-                "use_repo_at": use_repo_at,
-            },
-            push_kwargs={
-                "owner": owner,
-                "repository": repository,
-                "pre": pre,
-                "push_libraries": push_libraries,
-            },
-            include_libraries=include_libraries,
-            output=console,
-        )
-    except Exception as e:
-        console.print(f"[red]{e}")
-        exit(-1)
-
-
 @click.group()
 @click.version_option(
     __version__,
-    message="""Cielo v%(version)s ©2022-2025 Efabless Corporation and Contributors
+    message="""Ciel v%(version)s ©2022-2025 Efabless Corporation and Contributors
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this program except in compliance with the License.
@@ -408,7 +348,6 @@ cli.add_command(list_cmd)
 cli.add_command(list_remote_cmd)
 cli.add_command(enable_cmd)
 cli.add_command(fetch_cmd)
-cli.add_command(enable_or_build_cmd)
 
 try:
     import ssl  # noqa: F401
@@ -421,7 +360,7 @@ except ModuleNotFoundError as e:
         "Please install Python 3 with all (optional) dependencies using your operating system's package manager.",
         file=sys.stderr,
     )
-    print("This is a fatal error. Cielo will now quit.", file=sys.stderr)
+    print("This is a fatal error. Ciel will now quit.", file=sys.stderr)
     exit(-1)
 
 

{ciel-0.21.0.dev0 → ciel-1.0.0}/ciel/build/__init__.py

@@ -1,3 +1,7 @@
+# Copyright 2025 The American University in Cairo
+#
+# Adapted from the Volare project
+#
 # Copyright 2022-2023 Efabless Corporation
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -28,7 +32,7 @@ from rich.progress import Progress
 from ..github import (
     GitHubSession,
     get_commit_date,
-    volare_repo,
+    opt_github_token,
 )
 from ..common import (
     Version,
@@ -40,7 +44,6 @@ from ..click_common import (
     opt_push,
     opt_build,
     opt_pdk_root,
-    opt_token,
 )
 from ..families import Family
 
@@ -79,7 +82,7 @@ def build(
 
 
 @click.command("build")
-@opt_token
+@opt_github_token
 @opt_pdk_root
 @opt_build
 @click.option(
@@ -135,16 +138,14 @@ def push(
     pdk,
     version,
     *,
-    owner=volare_repo.owner,
-    repository=volare_repo.name,
+    owner,
+    repository,
     pre=False,
     push_libraries=None,
-    session: Optional[GitHubSession] = None,
 ):
     family = Family.by_name[pdk]
 
-    if session is None:
-        session = GitHubSession()
+    session = GitHubSession()
     if session.github_token is None:
         raise TypeError("No GitHub token was provided.")
 
@@ -160,7 +161,7 @@ def push(
         raise FileNotFoundError(f"Version {version} not found.")
 
     tempdir = tempfile.gettempdir()
-    tarball_directory = os.path.join(tempdir, "cielo", f"{uuid.uuid4()}", version)
+    tarball_directory = os.path.join(tempdir, "ciel", f"{uuid.uuid4()}", version)
     mkdirp(tarball_directory)
 
     final_tarballs = []
@@ -200,7 +201,7 @@ def push(
     # If someone wants to rewrite this to not use ghr, please, by all means.
     console.log("Starting upload…")
 
-    body = f"{pdk} variants built using cielo"
+    body = f"{pdk} variants built using ciel"
     date = get_commit_date(version, family.repo, session)
     if date is not None:
         body = f"{pdk} variants (released on {date_to_iso8601(date)})"
@@ -231,7 +232,7 @@ def push(
 
 
 @click.command("push", hidden=True)
-@opt_token
+@opt_github_token
 @opt_pdk_root
 @opt_push
 @click.argument("version")