Python XMLSERVICE Toolkit

itoolkit is a Python interface to the XMLSERVICE toolkit for the IBM i platform.

from itoolkit import *
from itoolkit.transport import DatabaseTransport
import ibm_db_dbi

conn = ibm_db_dbi.connect()
itransport = DatabaseTransport(conn)
itool = iToolKit()

itool.add(iCmd5250('wrkactjob', 'WRKACTJOB'))
itool.call(itransport)
wrkactjob = itool.dict_out('wrkactjob')

print(wrkactjob)

For more, check out the samples.

Feature Support

• Call ILE programs & service programs
• Call CL Commands
• Call PASE shell commands

iLibCall and 64-bit Support

:rotating_light: WARNING WARNING WARNING :rotating_light:

Due to limitations in XMLSERVICE, using iLibCall in a 64-bit process results in failure. See this bug for more info.

Documentation

The docs can be found at http://python-itoolkit.readthedocs.io/en/latest

Installation

You can install itoolkit simply using pip:

python -m pip install itoolkit

Tests

To test the installed itoolkit

python -m pytest tests

To test the local code:

PYTHONPATH=src python -m pytest tests

Contributing

Please read the contribution guidelines.

Releasing a New Version

Run the following commands

# checkout and pull the latest code from master
git checkout master
git pull

# bump to a release version (a tag and commit are made)
bumpversion release

# remove any old distributions
rm dist/*

# build the new distribution
python setup.py sdist

# bump to the new dev version (a commit is made)
bumpversion --no-tag patch

# push the new tag and commits
git push origin master --tags

# upload the distribution to PyPI
twine upload dist/*

License

MIT - See LICENSE