📦 Package that extends and wraps some functions from Ignition's Scripting API.
For more information, please refer to the Wiki.
Before you begin, ensure you have met the following requirements:
- You are familiar with Ignition 8.1 System Functions
To use incendium
in your scripting projects, you may install it by doing any
of the following.
Tip
To install incendium
as a Jython package for your Gateway, follow
these instructions
The preferred method is to install it by running pip
on a virtual environment
using Python 2.7.18.
python2 -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).
$ python2
Python 2.7.18 (default, Nov 9 2020, 16:23:15)
[GCC Apple LLVM 12.0.0 (clang-1200.0.32.21)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> from __future__ import print_function
>>> import incendium.vision.gui
>>> print(incendium.vision.gui.__doc__)
GUI module.
>>> incendium.vision.gui.warning("This one is a warning")
This one is a warning es_MX False
Warning es_MX False
None This one is a warning Warning 2 None
And to uninstall:
python2 -m pip uninstall incendium
To include incendium
as a dependency in PyCharm, you will need to attach it to
your project.
- Clone the repo or download from releases
- With your project open where you want to include
incendium
, navigate toFile > Open
and select theincendium
project folder - Choose
Attach
when prompted - Under the
incendium
project folder, right-click on thesrc/
folder and chooseMark Directory as > Sources Root
Starting with version 2024.4.0, this package can be installed using Jython. You may use the Python in Ignition guide as reference. But here are the basic steps:
- Install Java 17
- Install Jython 2.7.3
- Run
jython -m pip install incendium
- Copy the
incendium
directory andtyping.py
from$JYTHON_HOME/Lib/site-packages
to$IGNITION_DIR/user-lib/pylib/site-packages
- Done
$ jython
Jython 2.7.3 (tags/v2.7.3:5f29801fe, Sep 10 2022, 18:52:49)
[OpenJDK 64-Bit Server VM (Azul Systems, Inc.)] on java17.0.11
Type "help", "copyright", "credits" or "license" for more information.
>>> from __future__ import print_function
>>> import incendium
>>> print(incendium.__doc__)
incendium.
incendium is a package that extends and wraps some functions from
Ignition Scripting API.
For more information, please refer to the Wiki.
https://github.com/ignition-incendium/incendium/wiki
To install incendium
as a Python package on your Gateway, simply follow these
steps:
- Install Python 2.7.18
- Run
python -m pip install incendium
- Copy the
incendium
directory andtyping.py
from$PYTHON2_HOME/Lib/site-packages
to$IGNITION_DIR/user-lib/pylib/site-packages
- Done
See CONTRIBUTING.md.
Feel free to post your questions and/or ideas at Discussions.
Thanks to everyone who has contributed to this project.
Up-to-date list of contributors.
See LICENSE.
See CODE_OF_CONDUCT.md.