PyAltiumRun
[](https://pypi.org/project/PyAltiumRunTop/) [](https://github.com/krakdustten/PyAltiumRun/blob/master/LICENSE) [](https://pypi.org/project/PyAltiumRunTop/)
A Python interface that can run Delphiscript in [Altium Designer](https://www.altium.com/).
New features can be requested in the [Github Issues](https://github.com/krakdustten/PyAltiumRun/issues).
## Update
Fix bug log_str
## Add
Add Parameter Pas File
## Installation requirements
Altium designer must be installed before running this library.
## Quick start
```shell script
pip install PyAltiumRunTop
```
~~~python
from PyAltiumRunTop.AltiumRun import AltiumRun
run = AltiumRun(use_internal_logger=True) #Create runner object
run.clear_log_file() #Clear the logs of the previous run
run.set_project_to_open(r"Altium_project/Arduino_uno.PrjPcb") #Define an Altium project to open
run.add_script(r"Altium_scripts/generate_docs.pas") #Add a script to the runner
run.set_function("gen_docs", "Arduino_uno") #Set the function to run
run.run() #Run
~~~
## Delphi addons
These are the delphi script addons created.
### Logger
For this module to work the "use_internal_logger" parameter of the runner constructor should be True.
This module creates a log file in the data folder under the scripting project.
It logs everything in the following format:
~~~
[DAY/MONTH/YEAR HOUR:MINUTE:SECOND:MILISECOND]: LOGGED_STRING
~~~
Resulting in a log that looks like this:
~~~
[09/01/22 10:53:30.573]: Starting script
[09/01/22 10:53:30.576]: Opening project: Altium_project/Arduino_uno.PrjPcb
[09/01/22 10:53:30.657]: Arduino_uno
~~~
Raw data
{
"_id": null,
"home_page": "https://github.com/wqh0109663/PyAltiumRun",
"name": "PyAltiumRunTop",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "Altium,Scripting,Runner",
"author": "Dylan Gybels,wqh0109663",
"author_email": "dylangybels@gmail.com,wqh0109663@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/99/6e/5016807b2c4aedf922f5615375ffc8fb3755e4948b1963c078f7c5ad8fc8/PyAltiumRunTop-0.2.4.9.tar.gz",
"platform": "win32",
"description": "PyAltiumRun\r\n\r\n[](https://pypi.org/project/PyAltiumRunTop/) [](https://github.com/krakdustten/PyAltiumRun/blob/master/LICENSE) [](https://pypi.org/project/PyAltiumRunTop/)\r\n\r\nA Python interface that can run Delphiscript in [Altium Designer](https://www.altium.com/).\r\n\r\nNew features can be requested in the [Github Issues](https://github.com/krakdustten/PyAltiumRun/issues).\r\n\r\n## Update \r\nFix bug log_str\r\n## Add \r\nAdd Parameter Pas File\r\n\r\n## Installation requirements\r\n\r\nAltium designer must be installed before running this library.\r\n\r\n## Quick start\r\n```shell script\r\npip install PyAltiumRunTop\r\n```\r\n~~~python\r\nfrom PyAltiumRunTop.AltiumRun import AltiumRun\r\n\r\nrun = AltiumRun(use_internal_logger=True) #Create runner object\r\nrun.clear_log_file() #Clear the logs of the previous run\r\nrun.set_project_to_open(r\"Altium_project/Arduino_uno.PrjPcb\") #Define an Altium project to open\r\nrun.add_script(r\"Altium_scripts/generate_docs.pas\") #Add a script to the runner\r\nrun.set_function(\"gen_docs\", \"Arduino_uno\") #Set the function to run\r\nrun.run() #Run\r\n~~~\r\n\r\n## Delphi addons\r\n\r\nThese are the delphi script addons created.\r\n\r\n### Logger\r\n\r\nFor this module to work the \"use_internal_logger\" parameter of the runner constructor should be True.\r\n\r\nThis module creates a log file in the data folder under the scripting project.\r\nIt logs everything in the following format:\r\n\r\n~~~\r\n[DAY/MONTH/YEAR HOUR:MINUTE:SECOND:MILISECOND]: LOGGED_STRING\r\n~~~\r\n\r\nResulting in a log that looks like this:\r\n\r\n~~~\r\n[09/01/22 10:53:30.573]: Starting script\r\n[09/01/22 10:53:30.576]: Opening project: Altium_project/Arduino_uno.PrjPcb\r\n[09/01/22 10:53:30.657]: Arduino_uno\r\n~~~\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A library that can run scripts in altium designer",
"version": "0.2.4.9",
"project_urls": {
"Homepage": "https://github.com/wqh0109663/PyAltiumRun"
},
"split_keywords": [
"altium",
"scripting",
"runner"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "996e5016807b2c4aedf922f5615375ffc8fb3755e4948b1963c078f7c5ad8fc8",
"md5": "bccc3bdc70fc460e001c5ae7f100423b",
"sha256": "8416a53d81807bf5b70d106eeec8a2ba93e024ba15b9ff41acce917eeb0919e7"
},
"downloads": -1,
"filename": "PyAltiumRunTop-0.2.4.9.tar.gz",
"has_sig": false,
"md5_digest": "bccc3bdc70fc460e001c5ae7f100423b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 16423,
"upload_time": "2024-01-10T09:18:08",
"upload_time_iso_8601": "2024-01-10T09:18:08.273256Z",
"url": "https://files.pythonhosted.org/packages/99/6e/5016807b2c4aedf922f5615375ffc8fb3755e4948b1963c078f7c5ad8fc8/PyAltiumRunTop-0.2.4.9.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-10 09:18:08",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "wqh0109663",
"github_project": "PyAltiumRun",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"tox": true,
"lcname": "pyaltiumruntop"
}
JSON
