# incendium
<!--- Badges --->
[](https://github.com/ignition-devs/incendium/actions/workflows/ci.yml)
[](https://pepy.tech/project/incendium)
[](https://github.com/ignition-devs/incendium/discussions)
Package that extends and wraps some functions from Ignition's Scripting API.
For more information, please refer to the [Wiki].
## Prerequisites
Before you begin, ensure you have met the following requirements:
- You are familiar with [Ignition 8.1 System Functions]
- You have installed [Python 2.7.18]
- You have installed [Java 17] and [Jython 2.7.3]
## Installation and usage
### Installing as a dependency for your scripting projects
To use `incendium`, you may install it with `pip`. It requires
[Python 2.7.18] or [Jython 2.7.3].
```sh
python2 -m pip install incendium
```
Or
```sh
jython -m pip install incendium
```
This will install it as package to your Python installation, which will allow
you to call `incendium`'s Scripting functions from Python's REPL, and get code
completion using an IDE (PyCharm or Visual Studio Code).
And to uninstall:
```sh
python2 -m pip uninstall incendium
```
Or
```sh
jython -m pip uninstall incendium
```
### Using as a dependency in PyCharm
To include `incendium` as a dependency in PyCharm, you will need to attach
it to your project.
1. Clone the repo or download from [releases]
2. With your project open where you want to include `incendium`, navigate to
`File > Open` and select the `incendium` project folder
3. Choose `Attach` when prompted
4. Under the `incendium` project folder, right-click on the `src/` folder and
choose `Mark Directory as > Sources Root`
### Installing `incendium` on your Gateway
> [!TIP]
> You may use the [Python in Ignition] guide as reference.
#### As a Jython package
To install `incendium` as a Jython package on your Gateway, follow
these steps:
1. Install [Java 17]
2. Install [Jython 2.7.3]
3. Run `jython -m pip install incendium`
4. Copy the `incendium` directory and `typing.py` from
`$JYTHON_HOME/Lib/site-packages` to
`$IGNITION_DIR/user-lib/pylib/site-packages`
5. Done
#### As a Python package
To install `incendium` as a Python package on your Gateway, follow these steps:
1. Install [Python 2.7.18]
2. Run `python -m pip install incendium`
3. Copy the `incendium` directory and `typing.py` from
`$PYTHON2_HOME/Lib/site-packages` to
`$IGNITION_DIR/user-lib/pylib/site-packages`
4. Done
## Contributing to `incendium`
See [CONTRIBUTING.md].
## Discussions
Feel free to post your questions and/or ideas at [Discussions].
## Contributors
Thanks to everyone who has contributed to this project.
Up-to-date list of [contributors].
## License
See [LICENSE].
## Code of conduct
See [CODE_OF_CONDUCT.md].
<!-- Links -->
[CODE_OF_CONDUCT.md]: https://github.com/ignition-devs/.github/blob/main/CODE_OF_CONDUCT.md
[CONTRIBUTING.md]: ./CONTRIBUTING.md#contributing-to-incendium
[contributors]: https://github.com/ignition-devs/incendium/graphs/contributors
[Discussions]: https://github.com/ignition-devs/incendium/discussions
[Ignition 8.1 System Functions]: https://docs.inductiveautomation.com/docs/8.1/appendix/scripting-functions
[Java 17]: https://www.azul.com/downloads/?version=java-17-lts&package=jre#zulu
[Jython 2.7.3]: https://repo1.maven.org/maven2/org/python/jython-installer/2.7.3/jython-installer-2.7.3.jar
[LICENSE]: ./LICENSE
[Python 2.7.18]: https://www.python.org/downloads/release/python-2718/
[Python in Ignition]: https://support.inductiveautomation.com/hc/en-us/articles/360056397252-Python-In-Ignition
[releases]: https://github.com/ignition-devs/incendium/releases
[Wiki]: https://github.com/ignition-devs/incendium/wiki
Raw data
{
"_id": null,
"home_page": "https://github.com/ignition-incendium/incendium",
"name": "incendium",
"maintainer": null,
"docs_url": null,
"requires_python": "<3,>=2.7",
"maintainer_email": null,
"keywords": "coatl-dev, hmi, ignition, inductive automation, scada",
"author": "C\u00e9sar Rom\u00e1n",
"author_email": "cesar@coatl.dev",
"download_url": "https://files.pythonhosted.org/packages/7e/00/0a691f9c673f995be8c13da8cfed8bf980f374cd4f3dffd3f792a1529c02/incendium-2024.10.0.tar.gz",
"platform": null,
"description": "# incendium\n\n<!--- Badges --->\n[](https://github.com/ignition-devs/incendium/actions/workflows/ci.yml)\n[](https://pepy.tech/project/incendium)\n[](https://github.com/ignition-devs/incendium/discussions)\n\nPackage that extends and wraps some functions from Ignition's Scripting API.\n\nFor more information, please refer to the [Wiki].\n\n## Prerequisites\n\nBefore you begin, ensure you have met the following requirements:\n\n- You are familiar with [Ignition 8.1 System Functions]\n- You have installed [Python 2.7.18]\n- You have installed [Java 17] and [Jython 2.7.3]\n\n## Installation and usage\n\n### Installing as a dependency for your scripting projects\n\nTo use `incendium`, you may install it with `pip`. It requires\n[Python 2.7.18] or [Jython 2.7.3].\n\n```sh\npython2 -m pip install incendium\n```\n\nOr\n\n```sh\njython -m pip install incendium\n```\n\nThis will install it as package to your Python installation, which will allow\nyou to call `incendium`'s Scripting functions from Python's REPL, and get code\ncompletion using an IDE (PyCharm or Visual Studio Code).\n\nAnd to uninstall:\n\n```sh\npython2 -m pip uninstall incendium\n```\n\nOr\n\n```sh\njython -m pip uninstall incendium\n```\n\n### Using as a dependency in PyCharm\n\nTo include `incendium` as a dependency in PyCharm, you will need to attach\nit to your project.\n\n1. Clone the repo or download from [releases]\n2. With your project open where you want to include `incendium`, navigate to\n `File > Open` and select the `incendium` project folder\n3. Choose `Attach` when prompted\n4. Under the `incendium` project folder, right-click on the `src/` folder and\n choose `Mark Directory as > Sources Root`\n\n### Installing `incendium` on your Gateway\n\n> [!TIP]\n> You may use the [Python in Ignition] guide as reference.\n\n#### As a Jython package\n\nTo install `incendium` as a Jython package on your Gateway, follow\nthese steps:\n\n1. Install [Java 17]\n2. Install [Jython 2.7.3]\n3. Run `jython -m pip install incendium`\n4. Copy the `incendium` directory and `typing.py` from\n `$JYTHON_HOME/Lib/site-packages` to\n `$IGNITION_DIR/user-lib/pylib/site-packages`\n5. Done\n\n#### As a Python package\n\nTo install `incendium` as a Python package on your Gateway, follow these steps:\n\n1. Install [Python 2.7.18]\n2. Run `python -m pip install incendium`\n3. Copy the `incendium` directory and `typing.py` from\n `$PYTHON2_HOME/Lib/site-packages` to\n `$IGNITION_DIR/user-lib/pylib/site-packages`\n4. Done\n\n## Contributing to `incendium`\n\nSee [CONTRIBUTING.md].\n\n## Discussions\n\nFeel free to post your questions and/or ideas at [Discussions].\n\n## Contributors\n\nThanks to everyone who has contributed to this project.\n\nUp-to-date list of [contributors].\n\n## License\n\nSee [LICENSE].\n\n## Code of conduct\n\nSee [CODE_OF_CONDUCT.md].\n\n<!-- Links -->\n[CODE_OF_CONDUCT.md]: https://github.com/ignition-devs/.github/blob/main/CODE_OF_CONDUCT.md\n[CONTRIBUTING.md]: ./CONTRIBUTING.md#contributing-to-incendium\n[contributors]: https://github.com/ignition-devs/incendium/graphs/contributors\n[Discussions]: https://github.com/ignition-devs/incendium/discussions\n[Ignition 8.1 System Functions]: https://docs.inductiveautomation.com/docs/8.1/appendix/scripting-functions\n[Java 17]: https://www.azul.com/downloads/?version=java-17-lts&package=jre#zulu\n[Jython 2.7.3]: https://repo1.maven.org/maven2/org/python/jython-installer/2.7.3/jython-installer-2.7.3.jar\n[LICENSE]: ./LICENSE\n[Python 2.7.18]: https://www.python.org/downloads/release/python-2718/\n[Python in Ignition]: https://support.inductiveautomation.com/hc/en-us/articles/360056397252-Python-In-Ignition\n[releases]: https://github.com/ignition-devs/incendium/releases\n[Wiki]: https://github.com/ignition-devs/incendium/wiki\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Package that extends and wraps Ignition Scripting API",
"version": "2024.10.0",
"project_urls": {
"Documentation": "https://github.com/ignition-devs/incendium/wiki",
"Funding": "https://github.com/sponsors/cesarcoatl",
"Homepage": "https://github.com/ignition-incendium/incendium",
"Source": "https://github.com/ignition-devs/incendium",
"Tracker": "https://github.com/ignition-devs/incendium/issues"
},
"split_keywords": [
"coatl-dev",
" hmi",
" ignition",
" inductive automation",
" scada"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4e7754f35c1149075c56257d4cae0569349c63464f49836be31fbd95e38efa06",
"md5": "07ac2dec6332dc5a664901f45f94504f",
"sha256": "356ffa1356be3292ade18870c55cd2a7a115c8c78f8697bfa614da9837a8fe69"
},
"downloads": -1,
"filename": "incendium-2024.10.0-py2-none-any.whl",
"has_sig": false,
"md5_digest": "07ac2dec6332dc5a664901f45f94504f",
"packagetype": "bdist_wheel",
"python_version": "py2",
"requires_python": "<3,>=2.7",
"size": 21075,
"upload_time": "2024-10-28T21:45:16",
"upload_time_iso_8601": "2024-10-28T21:45:16.932938Z",
"url": "https://files.pythonhosted.org/packages/4e/77/54f35c1149075c56257d4cae0569349c63464f49836be31fbd95e38efa06/incendium-2024.10.0-py2-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "7e000a691f9c673f995be8c13da8cfed8bf980f374cd4f3dffd3f792a1529c02",
"md5": "7498872409e9e234e3854f2aa27424c4",
"sha256": "ccf8a3a1d40fd4a23ff3350c3bb603032dd19aa5f1d975bf14b88acda9fdd3db"
},
"downloads": -1,
"filename": "incendium-2024.10.0.tar.gz",
"has_sig": false,
"md5_digest": "7498872409e9e234e3854f2aa27424c4",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3,>=2.7",
"size": 18396,
"upload_time": "2024-10-28T21:45:18",
"upload_time_iso_8601": "2024-10-28T21:45:18.558082Z",
"url": "https://files.pythonhosted.org/packages/7e/00/0a691f9c673f995be8c13da8cfed8bf980f374cd4f3dffd3f792a1529c02/incendium-2024.10.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-28 21:45:18",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ignition-incendium",
"github_project": "incendium",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"tox": true,
"lcname": "incendium"
}
JSON
