Amazon Ion Python

An implementation of Amazon Ion for Python.

This package is designed to work with Python 2.7+ and Python 3.4+

Getting Started

Start with the simpleion module, which provides four APIs (

dump

dumps

load

loads

For example:

>>> import amazon.ion.simpleion as ion
>>> obj = ion.loads('{abc: 123}')
>>> obj['abc']
123
>>> ion.dumps(obj, binary=False)
'$ion_1_0 {abc:123}'

For additional examples, consult the cookbook.

Git Setup

This repository contains a git submodule called

ion-tests

ion-python

The easiest way to clone the

ion-python

ion-tests

$ git clone --recursive https://github.com/amzn/ion-python.git ion-python

Alternatively, the submodule may be initialized independently from the clone by running the following commands.

$ git submodule init
$ git submodule update

Development

It is recommended to use

venv

$ python3 -m venv ./venv
...
$ . venv/bin/activate
$ pip install -r requirements.txt
$ pip install -e .

You can also run the tests through

setup.py

py.test

$ python setup.py test

Tox Setup

In order to verify that all platforms we support work with Ion Python, we use a combination of tox with pyenv.

Install relevant versions of Python:

$ for V in 2.7.16 3.4.10 3.5.7 3.6.8 3.7.3 pypy2.7-7.1.1 pypy3.6-7.1.1; do pyenv install $V; done

Once you have these installations, add them as a local

pyenv

$ pyenv local 2.7.16 3.4.10 3.5.7 3.6.8 3.7.3 pypy2.7-7.1.1 pypy3.6-7.1.1

Assuming you have

pyenv

pyenv init

tox

# Run tox for all versions of python which executes py.test.
$ tox

Run tox for just Python 2.7 and 3.5.
$ tox -e py27,py35
Run tox for a specific version and run py.test with high verbosity
$ tox -e py27 -- py.test -vv
Run tox for a specific version and just the virtual env REPL.
$ tox -e py27 -- python

TODO

The following build, deployment, or release tasks are required:

• Add support for code coverage reporting.
  • Publish coverage to something like Coverage.io
• Consider using something like PyPy.js to build an interactive shell for playing with Ion python and provide a client-side Ion playground.

Known Issues

tests/test_vectors.py defines skipList variables referencing test vectors that are not expected to work at this time.