Ignition Scripting API
Project description
Ignition
Ignition is a set of packages and modules that allows developers to get code completion for Ignition Scripting API scripting functions in their IDE of choice.
Releases
Check the releases page and download the one for your current version.
If you can't find it, feel free to submit your request on our Discussions.
Prerequisites
Before you begin, ensure you have met the following requirements:
- You have installed Python 2.7.18 (download here)
- You are familiar with Ignition 7.9 Scripting Functions
Packages
Ignition consists of the following packages:
- com
- java/javax
- system
com
These are libraries for some of Inductive Automation's Java packages and functions that are imported in system
packages.
java/javax
These are libraries for some Java packages and functions that are imported in system
packages meant to be used on systems where no JDK can be installed, and the project interpreter is Python 2.
system
Is a package that includes all Ignition Scripting Functions.
Installation and usage
To use Ignition, you may install it by doing any of the following.
Installing with pip
The preferred method is to install it by running pip
. It requires Python 2.7.18.
python2 -m pip install ignition-api==7.9.18.post3
This will install it as package to your Python installation, which will allow you to call Ignition Scripting functions from Python's REPL, and get code completion using an IDE (we recommend PyCharm).
$ 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 system.util
>>> print(system.util.__doc__)
Utility Functions.
The following functions give you access to view various Gateway and
Client data, as well as interact with other various systems.
>>> system.util.beep()
>>> quit()
And to uninstall:
python2 -m pip uninstall ignition-api
Downloading from releases
You may also download the code targeted to your desired version from the releases page and add it as a dependency to your scripting project.
Using Ignition as a dependency on PyCharm
To include Ignition as a dependency on 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
Ignition
, navigate toFile > Open
and select theIgnition
project folder - Choose
Attach
when prompted - Under the
Ignition
project folder, right-click on thesrc/
folder and chooseMark Directory as > Sources Root
Contributing to Ignition
To contribute to Ignition, follow these steps:
- Fork this repository
- Create a local copy on your machine
- Create a branch
- Make your changes and commit them
- Push to the original branch
- Create the pull request
Alternatively see the GitHub documentation on creating a pull request.
Contributors
Thanks to everyone who has contributed to this project.
Up-to-date list of contributors can be found here.
License
See the LICENSE.
Code of conduct
This project has adopted the Microsoft Open Source Code of Conduct.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for ignition-api-7.9.18.post3.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 08f97b266fa3f01cca54f234619fd7bc3538d98db1a9c8cb194ef87be0bcdfb0 |
|
MD5 | 0f2d2f5e5cf03dcd3dedcc3f5d586d2e |
|
BLAKE2b-256 | 0964b6de003766fb9457dc1abe8a926a639d01f36bbe58a8fec208409e7684cf |
Hashes for ignition_api-7.9.18.post3-py2-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 977f50c398474d621c3b094d568edb903685ffb7ddc9cf4b5f3ef9057de82c1f |
|
MD5 | 86b65413505903c13011f2c47d8396c8 |
|
BLAKE2b-256 | 3679a9069764d16bfa02857d983b2e166dc1514b9c6ce86fe545afb8c72541d3 |