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.

Table of contents

• Releases
• Branches
  • Cloning a single branch
• Prerequisites
• Packages
• Installation and usage
  • PyCharm installation
  • Installing with pip
• Contributing to Ignition
• Discussions
• Contributors
• License
• Code of conduct

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.

Branches

This repository consists of the following branches:

main

This branch will contain all Scripting Functions from the latest Ignition Release requiring only Python

7.9

This branch will contain all Scripting Functions from the latest Ignition Release for the 7.9 version requiring only Python

8.0

This branch will contain all Scripting Functions from the latest Ignition Release for the 8.0 version requiring only Python

jython

This branch will contain all Scripting Functions from the latest Ignition Release requiring Jython (see jython prerequisites)

Cloning a single branch

If you wish to clone just one branch in particular, use any of the following commands:

• HTTPS

    git clone --single-branch --branch <name> https://github.com/thecesrom/Ignition.git [<directory>]
  

• SSH

    git clone --single-branch --branch <name> git@github.com:thecesrom/Ignition.git [<directory>]
  

• GitHub CLI

    gh repo clone thecesrom/Ignition [<directory>] -- --single-branch --branch <name>
  

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 8.1 System Functions

Packages

Ignition consists of the following packages:

• java/javax
• system

java/javax

These are libraries for some Java packages and functions that are imported in system packages meant to be used on development environments where no JDK can be installed, and the project interpreter is Python 2.7.

system

Is a package that includes all Ignition Scripting Functions.

Installation and usage

To use Ignition, download the code targeted to your desired version from the releases page and add it as a dependency to your scripting project.

PyCharm Installation

To use Ignition in PyCharm, you will need to attach it to your project.

1. With your project open that you want to use with Ignition, navigate to File > Open and select the Ignition project folder.
2. Choose Attach when you’re prompted on how to open the project.
3. Under the new Ignition project folder, right-click on the src/ folder and choose Mark Directory as > Sources Root.

Installing with pip

Also, it can be installed by running pip. It requires Python 2.7 (we recommend version 2.7.18).

$ python2 -m pip install ignition-api

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).

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

Contributing to Ignition

To contribute to Ignition, follow these steps:

1. Fork this repository
2. Create a local copy on your machine
3. Create a branch
4. Make your changes and commit them
5. Push to the main branch
6. Create the pull request

Alternatively see the GitHub documentation on creating a pull request.

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 can be found here.

License

See the LICENSE.

Code of conduct

This project has adopted the Microsoft Open Source Code of Conduct.