ion-cli

This package is considered experimental. It is under active/early development, and the API is subject to change.

Build Instructions

  1. Clone the repository git clone https://github.com/amzn/ion-cli.git

  2. Step into the newly created directory cd ion-cli

  3. Install Rust/Cargo via rustup

  4. Build the ion tool cargo install --path . This will put a copy of the ion executable in ~/.cargo/bin.

  5. Confirm that ~/.cargo/bin is on your $PATH. rustup will probably take care of this for you.

  6. Confirm that the executable is available ion help

Docker Instructions

  1. Install Docker (see OS specific instructions on the Docker website)
  2. Clone the repository (recursive clone not necessary) git clone https://github.com/amzn/ion-cli.git
  3. Step into the newly created directory cd ion-cli
  4. Build and run the image ```

    build the image

    docker build -t : .

    run the CLI binary inside the Docker image

    docker run -it --rm [optional flags...] : ion

    examples:

    build docker image with current release version

    docker build -t ion-cli:0.1.1 .

    print the help message

    docker run -it --rm ion-cli:0.1.1 ion -V

    mount current directory to /data volume and dump an ion file

    docker run -it --rm -v $PWD:/data ion-cli:0.1.1 ion dump /data/test.ion

    ```

Security

See CONTRIBUTING for more information.

License

This project is licensed under the Apache-2.0 License.