python-itoolkit's Introduction

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 pyodbc

conn = pyodbc.connect("DSN=*LOCAL")
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

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

To test the local code:

PYTHONPATH=src python -m pytest

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

# build the new distribution and upload to PyPI
poetry publish --build

# 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