Metadata-Version: 2.1
Name: itoolkit
Version: 1.6.2
Summary: IBM i XMLSERVICE toolkit for Python
Home-page: https://bitbucket.org/litmis/python-itoolkit
Author: IBM
License: MIT
Description: Python XMLSERVICE Toolkit
        =========================
        
        [![Build Status](https://travis-ci.com/IBM/python-itoolkit.svg?branch=master)](https://travis-ci.com/IBM/python-itoolkit)
        [![Latest version released on PyPi](https://img.shields.io/pypi/v/itoolkit.svg)](https://pypi.python.org/pypi/itoolkit)
        [![](https://img.shields.io/pypi/pyversions/itoolkit.svg)](https://pypi.org/project/itoolkit/)
        [![Documentation Status](https://readthedocs.org/projects/python-itoolkit/badge/?version=latest)](https://python-itoolkit.readthedocs.io/en/latest/?badge=latest)
        
        itoolkit is a Python interface to the [XMLSERVICE](https://bitbucket.org/inext/xmlservice-rpg) toolkit for the [IBM i](https://en.wikipedia.org/wiki/IBM_i) platform.
        
        ```python
        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](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](https://github.com/IBM/python-itoolkit/issues/17) 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`:
        
        ```bash
        python -m pip install itoolkit
        ```
        
        Tests
        -----
        
        To test the installed itoolkit
        
        ```bash
        python -m pytest tests
        ```
        
        To test the local code:
        
        ```bash
        PYTHONPATH=src python -m pytest tests
        ```
        
        Contributing
        ------------
        
        Please read the [contribution guidelines](CONTRIBUTING.md).
        
        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](LICENSE)
        
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Description-Content-Type: text/markdown
