<p align="center">
<a title="edaa-org.github.io/pyEDAA.CLITool" href="https://edaa-org.github.io/pyEDAA.CLITool"><img height="80px" src="doc/_static/logo.svg"/></a>
</p>
[](https://GitHub.com/edaa-org/pyEDAA.CLITool)
[](LICENSE.md)
[](https://edaa-org.github.io/pyEDAA.CLITool/)
[](LICENSE.md)
[](https://gitter.im/hdl/community)
[](https://pypi.org/project/pyEDAA.CLITool/)
[](https://GitHub.com/edaa-org/pyEDAA.CLITool/actions/workflows/Pipeline.yml)
[](https://libraries.io/github/edaa-org/pyEDAA.CLITool)
[](https://www.codacy.com/gh/edaa-org/pyEDAA.CLITool)
[](https://www.codacy.com/gh/edaa-org/pyEDAA.CLITool)
[](https://codecov.io/gh/edaa-org/pyEDAA.CLITool)
<!--
[](https://github.com/edaa-org/pyEDAA.CLITool/network/dependents)
[](https://requires.io/github/edaa-org/pyEDAA.CLITool/requirements/?branch=main)
[](https://libraries.io/github/edaa-org/pyEDAA.CLITool/sourcerank)
-->
Provide unified interfaces to execute EDA tools via CLI from Python, agnostic to any specific configuration format/object.
# Main Goals
* Provide a pythonic solution to construct command line calls for EDA tools based on [pyTooling.CLIAbstraction](https://github.com/pyTooling/pyTooling.CLIAbstraction)
* Launch CLI tools and connect to STDIn, STDOUT, STDERR for realtime output post-processing.
# Features
* Support multiple native platforms: Linux, macOS, Windows.
* Support nested platforms like MSYS2 with MinGW32, MinGW64, URCT64, Clang64, ...
* Find CLI programs either in `PATH` or specify an exact installation location.
* Generate CLI options in correct order.
* Generate correctly escaped CLI options.
# Supported Tools
* Aldec
* 🚧 Active-HDL
* 🚧 Riviera-PRO
* Altera
* 🚧 Quartus
* 🚫 ModelSim Altera (Student) Edition
* Cadence
* 🙋 need a list of tools
* IntelFPGA
* 🚧 Quartus
* 🚫 ModelSim Altera (Student) Edition
* Lattice
* 🚧 Diamond
* 🚫 Active-HDL Lattice Edition
* 🚫 ModelSim Lattice Edition
* MentorGraphics
* ✅ ModelSim DE/SE/PE
* 🚫 QuestaSim
* SiemensEDA
* 🚫 ModelSim DE/SE/PE
* 🚫 QuestaSim
* Synopsys
* 🙋 need a list of tools
* Xilinx
* 🚧 ISE
* 🚧 Vivado
* 🚫 Vivado-SDK
* 🚫 Vitis
* System Tools
* ✅ Git
* Open Source
* ✅ GHDL
* ✅ GTKWave
* Yosys
* 🙋 need a list of tools
**Legend:**
✅ → implemented and tested
🚧 → under test
🚫 → planned but not yet implemented ⇒ accepting PRs
🙋 → need help
# Examples
```python
from pyEDAA.CLITool.GHDL import GHDL
tool = GHDL()
tool[tool.CommandAnalyze] = True
tool[tool.FlagVHDLStandard] = "08"
tool[tool.FlagSynopsys] = True
tool[tool.FlagRelaxed] = True
tool[tool.FlagExplicit] = True
tool[tool.FlagMultiByteComments] = True
tool[tool.FlagLibrary] = "lib_Test"
print(f"Calling GHDL: {tool}")
# Calling GHDL: "ghdl" "analyze" "--std=08" "-fsynopsys" "-frelaxed" "-fexplicit" "--work=lib_Test" "--mb-comments"
```
# Consumers
This layer is used by:
* 🚧 [pyEDAA.Workflow](https://github.com/edaa-org/pyEDAA.Workflow)
* 🚧 [pyEDAA.Launcher](https://github.com/edaa-org/pyEDAA.Launcher)
* 🚧 [Open Source Verification Bundle (OSVB)](https://umarcor.github.io/osvb)
# References
* [docs.siliconcompiler.com: Tools directory](https://docs.siliconcompiler.com/en/latest/reference_manual/tools.html)
* GHDL:
* [Paebbels/pyIPCMI: pyIPCMI/Simulator/GHDLSimulator.py](https://github.com/Paebbels/pyIPCMI/blob/0f91e26f989ca025c9380ff808d1e532614b9593/pyIPCMI/Simulator/GHDLSimulator.py#L49)
* [VUnit/vunit: vunit/sim_if/ghdl.py](https://github.com/VUnit/vunit/blob/f344c8b5642d7aa13db2e16f6fc7151585ca96d0/vunit/sim_if/ghdl.py#L29)
* [olofk/edalize: edalize/ghdl.py](https://github.com/olofk/edalize/blob/322773113716fa29fddd800c2e0992bb5dd2ed79/edalize/ghdl.py#L13)
* [im-tomu/fomu-workshop: hdl/mixed/blink/Makefile](https://github.com/im-tomu/fomu-workshop/blob/6e6318d820271750a99c8e419ee1b9abd9aa6b81/hdl/mixed/blink/Makefile#L45-L51)
* [PyFPGA/pyfpga: fpga/tool/openflow.py](https://github.com/PyFPGA/pyfpga/blob/507631b780a4ab658304bfcdcec133a0e9b8a769/fpga/tool/openflow.py#L28)
* [XedaHQ/xeda: xeda/flows/ghdl/__init__.py](https://github.com/XedaHQ/xeda/blob/e5bea8663a9001d0e98f6b7a91575e13fba06493/xeda/flows/ghdl/__init__.py#L8)
* [cocotb/cocotb: cocotb/runner.py](https://github.com/cocotb/cocotb/blob/fa7a826cc855d783b7fbc81444d4e6b9edc487b9/cocotb/runner.py#L444) ([cocotb/cocotb#2634](https://github.com/cocotb/cocotb/pull/2634))
* [stnolting/neorv32: tasks/examples.py](https://github.com/stnolting/neorv32/blob/6dd30e78101cd08310fe02b8818050745dd3a6ad/tasks/examples.py#L13) ([stnolting/neorv32#110](https://github.com/stnolting/neorv32/pull/110))
* [ghdl/ghdl: scripts/vendors/shared.sh](https://github.com/ghdl/ghdl/blob/7e41be2dabf79b21f3d0be210e3d01d541a7e82c/scripts/vendors/shared.sh#L132)
* [ghdl/ghdl: scripts/vendors/shared.psm1](https://github.com/ghdl/ghdl/blob/7e41be2dabf79b21f3d0be210e3d01d541a7e82c/scripts/vendors/shared.psm1#L261)
* [OSVVM/OSVVM-Scripts: VendorScripts_GHDL.tcl](https://github.com/OSVVM/OSVVM-Scripts/blob/3f52f725603166b4bfd6c862629f1dad363fd2f7/VendorScripts_GHDL.tcl#L143)
# Contributors
* [Patrick Lehmann](https://github.com/Paebbels) (Maintainer)
* [Unai Martinez-Corral](https://github.com/umarcor)
* [and more...](https://github.com/edaa-org/pyEDAA.CLITool/graphs/contributors)
# License
This Python package (source code) is licensed under [Apache License 2.0](LICENSE.md).
The accompanying documentation is licensed under [Creative Commons - Attribution 4.0 (CC-BY 4.0)](doc/Doc-License.rst).
---
SPDX-License-Identifier: Apache-2.0
Raw data
{
"_id": null,
"home_page": "https://GitHub.com/edaa-org/pyEDAA.CLITool",
"name": "pyEDAA.CLITool",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "cli,abstraction layer,eda",
"author": "Patrick Lehmann",
"author_email": "Paebbels@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/e1/52/afa7a4cbc1d8c6a0aa0b874e4bb20b061f09d4afaac33f58e468385ee39a/pyEDAA.CLITool-0.2.1.tar.gz",
"platform": null,
"description": "<p align=\"center\">\n <a title=\"edaa-org.github.io/pyEDAA.CLITool\" href=\"https://edaa-org.github.io/pyEDAA.CLITool\"><img height=\"80px\" src=\"doc/_static/logo.svg\"/></a>\n</p>\n\n[](https://GitHub.com/edaa-org/pyEDAA.CLITool)\n[](LICENSE.md)\n[](https://edaa-org.github.io/pyEDAA.CLITool/)\n[](LICENSE.md)\n[](https://gitter.im/hdl/community) \n[](https://pypi.org/project/pyEDAA.CLITool/)\n\n \n[](https://GitHub.com/edaa-org/pyEDAA.CLITool/actions/workflows/Pipeline.yml)\n[](https://libraries.io/github/edaa-org/pyEDAA.CLITool)\n[](https://www.codacy.com/gh/edaa-org/pyEDAA.CLITool)\n[](https://www.codacy.com/gh/edaa-org/pyEDAA.CLITool)\n[](https://codecov.io/gh/edaa-org/pyEDAA.CLITool)\n\n<!--\n[](https://github.com/edaa-org/pyEDAA.CLITool/network/dependents)\n[](https://requires.io/github/edaa-org/pyEDAA.CLITool/requirements/?branch=main)\n[](https://libraries.io/github/edaa-org/pyEDAA.CLITool/sourcerank) \n-->\n\n\nProvide unified interfaces to execute EDA tools via CLI from Python, agnostic to any specific configuration format/object.\n\n\n# Main Goals\n\n* Provide a pythonic solution to construct command line calls for EDA tools based on [pyTooling.CLIAbstraction](https://github.com/pyTooling/pyTooling.CLIAbstraction)\n* Launch CLI tools and connect to STDIn, STDOUT, STDERR for realtime output post-processing.\n\n\n# Features\n\n* Support multiple native platforms: Linux, macOS, Windows.\n* Support nested platforms like MSYS2 with MinGW32, MinGW64, URCT64, Clang64, ...\n* Find CLI programs either in `PATH` or specify an exact installation location.\n* Generate CLI options in correct order.\n* Generate correctly escaped CLI options.\n\n\n# Supported Tools\n\n* Aldec\n * \ud83d\udea7 Active-HDL\n * \ud83d\udea7 Riviera-PRO\n* Altera\n * \ud83d\udea7 Quartus\n * \ud83d\udeab ModelSim Altera (Student) Edition\n* Cadence\n * \ud83d\ude4b need a list of tools\n* IntelFPGA\n * \ud83d\udea7 Quartus\n * \ud83d\udeab ModelSim Altera (Student) Edition\n* Lattice\n * \ud83d\udea7 Diamond\n * \ud83d\udeab Active-HDL Lattice Edition\n * \ud83d\udeab ModelSim Lattice Edition\n* MentorGraphics\n * \u2705 ModelSim DE/SE/PE\n * \ud83d\udeab QuestaSim\n* SiemensEDA\n * \ud83d\udeab ModelSim DE/SE/PE\n * \ud83d\udeab QuestaSim\n* Synopsys\n * \ud83d\ude4b need a list of tools\n* Xilinx\n * \ud83d\udea7 ISE\n * \ud83d\udea7 Vivado\n * \ud83d\udeab Vivado-SDK\n * \ud83d\udeab Vitis\n* System Tools\n * \u2705 Git\n* Open Source\n * \u2705 GHDL\n * \u2705 GTKWave\n* Yosys\n * \ud83d\ude4b need a list of tools\n\n**Legend:** \n\u2705 → implemented and tested \n\ud83d\udea7 → under test \n\ud83d\udeab → planned but not yet implemented ⇒ accepting PRs \n\ud83d\ude4b → need help\n\n# Examples\n\n```python\nfrom pyEDAA.CLITool.GHDL import GHDL\n\ntool = GHDL()\ntool[tool.CommandAnalyze] = True\ntool[tool.FlagVHDLStandard] = \"08\"\ntool[tool.FlagSynopsys] = True\ntool[tool.FlagRelaxed] = True\ntool[tool.FlagExplicit] = True\ntool[tool.FlagMultiByteComments] = True\ntool[tool.FlagLibrary] = \"lib_Test\"\n\nprint(f\"Calling GHDL: {tool}\")\n# Calling GHDL: \"ghdl\" \"analyze\" \"--std=08\" \"-fsynopsys\" \"-frelaxed\" \"-fexplicit\" \"--work=lib_Test\" \"--mb-comments\"\n```\n\n# Consumers\n\nThis layer is used by:\n\n* \ud83d\udea7 [pyEDAA.Workflow](https://github.com/edaa-org/pyEDAA.Workflow)\n* \ud83d\udea7 [pyEDAA.Launcher](https://github.com/edaa-org/pyEDAA.Launcher)\n* \ud83d\udea7 [Open Source Verification Bundle (OSVB)](https://umarcor.github.io/osvb)\n\n\n# References\n\n* [docs.siliconcompiler.com: Tools directory](https://docs.siliconcompiler.com/en/latest/reference_manual/tools.html)\n* GHDL:\n * [Paebbels/pyIPCMI: pyIPCMI/Simulator/GHDLSimulator.py](https://github.com/Paebbels/pyIPCMI/blob/0f91e26f989ca025c9380ff808d1e532614b9593/pyIPCMI/Simulator/GHDLSimulator.py#L49)\n * [VUnit/vunit: vunit/sim_if/ghdl.py](https://github.com/VUnit/vunit/blob/f344c8b5642d7aa13db2e16f6fc7151585ca96d0/vunit/sim_if/ghdl.py#L29)\n * [olofk/edalize: edalize/ghdl.py](https://github.com/olofk/edalize/blob/322773113716fa29fddd800c2e0992bb5dd2ed79/edalize/ghdl.py#L13)\n * [im-tomu/fomu-workshop: hdl/mixed/blink/Makefile](https://github.com/im-tomu/fomu-workshop/blob/6e6318d820271750a99c8e419ee1b9abd9aa6b81/hdl/mixed/blink/Makefile#L45-L51)\n * [PyFPGA/pyfpga: fpga/tool/openflow.py](https://github.com/PyFPGA/pyfpga/blob/507631b780a4ab658304bfcdcec133a0e9b8a769/fpga/tool/openflow.py#L28)\n * [XedaHQ/xeda: xeda/flows/ghdl/__init__.py](https://github.com/XedaHQ/xeda/blob/e5bea8663a9001d0e98f6b7a91575e13fba06493/xeda/flows/ghdl/__init__.py#L8)\n * [cocotb/cocotb: cocotb/runner.py](https://github.com/cocotb/cocotb/blob/fa7a826cc855d783b7fbc81444d4e6b9edc487b9/cocotb/runner.py#L444) ([cocotb/cocotb#2634](https://github.com/cocotb/cocotb/pull/2634))\n * [stnolting/neorv32: tasks/examples.py](https://github.com/stnolting/neorv32/blob/6dd30e78101cd08310fe02b8818050745dd3a6ad/tasks/examples.py#L13) ([stnolting/neorv32#110](https://github.com/stnolting/neorv32/pull/110))\n * [ghdl/ghdl: scripts/vendors/shared.sh](https://github.com/ghdl/ghdl/blob/7e41be2dabf79b21f3d0be210e3d01d541a7e82c/scripts/vendors/shared.sh#L132)\n * [ghdl/ghdl: scripts/vendors/shared.psm1](https://github.com/ghdl/ghdl/blob/7e41be2dabf79b21f3d0be210e3d01d541a7e82c/scripts/vendors/shared.psm1#L261)\n * [OSVVM/OSVVM-Scripts: VendorScripts_GHDL.tcl](https://github.com/OSVVM/OSVVM-Scripts/blob/3f52f725603166b4bfd6c862629f1dad363fd2f7/VendorScripts_GHDL.tcl#L143)\n\n# Contributors\n\n* [Patrick Lehmann](https://github.com/Paebbels) (Maintainer)\n* [Unai Martinez-Corral](https://github.com/umarcor)\n* [and more...](https://github.com/edaa-org/pyEDAA.CLITool/graphs/contributors)\n\n\n# License\n\nThis Python package (source code) is licensed under [Apache License 2.0](LICENSE.md). \nThe accompanying documentation is licensed under [Creative Commons - Attribution 4.0 (CC-BY 4.0)](doc/Doc-License.rst).\n\n---\nSPDX-License-Identifier: Apache-2.0\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "An abstraction layer of EDA CLI tools.",
"version": "0.2.1",
"project_urls": {
"Documentation": "https://edaa-org.GitHub.io/pyEDAA.CLITool",
"Homepage": "https://GitHub.com/edaa-org/pyEDAA.CLITool",
"Issue Tracker": "https://GitHub.com/edaa-org/pyEDAA.CLITool/issues",
"Source Code": "https://GitHub.com/edaa-org/pyEDAA.CLITool"
},
"split_keywords": [
"cli",
"abstraction layer",
"eda"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "974b42b3a153f2892945eab73e625b7fe6fccf461034847e2db2f17b28ab0a66",
"md5": "2c12dc8879022382ae82e7e011e35ed0",
"sha256": "a32006b86d0c162103f9e71c58f5b72bc6e1cab51fb66fb58cb3668af1400de6"
},
"downloads": -1,
"filename": "pyEDAA.CLITool-0.2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2c12dc8879022382ae82e7e011e35ed0",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 31573,
"upload_time": "2023-07-07T22:49:00",
"upload_time_iso_8601": "2023-07-07T22:49:00.664948Z",
"url": "https://files.pythonhosted.org/packages/97/4b/42b3a153f2892945eab73e625b7fe6fccf461034847e2db2f17b28ab0a66/pyEDAA.CLITool-0.2.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e152afa7a4cbc1d8c6a0aa0b874e4bb20b061f09d4afaac33f58e468385ee39a",
"md5": "9196c3c25886e2c9f861896e4a6ba928",
"sha256": "6cbf1929402805bc04d31bb33eece5bef58ba3cd4b0312f207de1572464a4181"
},
"downloads": -1,
"filename": "pyEDAA.CLITool-0.2.1.tar.gz",
"has_sig": false,
"md5_digest": "9196c3c25886e2c9f861896e4a6ba928",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 19928,
"upload_time": "2023-07-07T22:48:58",
"upload_time_iso_8601": "2023-07-07T22:48:58.000831Z",
"url": "https://files.pythonhosted.org/packages/e1/52/afa7a4cbc1d8c6a0aa0b874e4bb20b061f09d4afaac33f58e468385ee39a/pyEDAA.CLITool-0.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-07-07 22:48:58",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "pyedaa.clitool"
}
JSON