Metadata-Version: 2.1
Name: iam-to-sqlite
Version: 0.1
Summary: Load Amazon IAM data into a SQLite database
Home-page: https://github.com/simonw/iam-to-sqlite
Author: Simon Willison
License: Apache License, Version 2.0
Project-URL: Issues, https://github.com/simonw/iam-to-sqlite/issues
Project-URL: CI, https://github.com/simonw/iam-to-sqlite/actions
Project-URL: Changelog, https://github.com/simonw/iam-to-sqlite/releases
Platform: UNKNOWN
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: click
Requires-Dist: sqlite-utils
Provides-Extra: test
Requires-Dist: pytest ; extra == 'test'

# iam-to-sqlite

[![PyPI](https://img.shields.io/pypi/v/iam-to-sqlite.svg)](https://pypi.org/project/iam-to-sqlite/)
[![Changelog](https://img.shields.io/github/v/release/simonw/iam-to-sqlite?include_prereleases&label=changelog)](https://github.com/simonw/iam-to-sqlite/releases)
[![Tests](https://github.com/simonw/iam-to-sqlite/workflows/Test/badge.svg)](https://github.com/simonw/iam-to-sqlite/actions?query=workflow%3ATest)
[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://github.com/simonw/iam-to-sqlite/blob/master/LICENSE)

Load Amazon IAM data into a SQLite database

## Installation

Install this tool using `pip`:

    $ pip install iam-to-sqlite

You will also need the `aws` command-line tool. Here are [the installation instructions](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html) for that.

## Usage

Run this tool like so:

    iam-to-sqlite iam.db

This will create a SQLite database called `iam.db` containing the following tables:

- `Groups`
- `Policies`
- `Users`
- `Roles`

## Development

To contribute to this tool, first checkout the code. Then create a new virtual environment:

    cd iam-to-sqlite
    python -mvenv venv
    source venv/bin/activate

Or if you are using `pipenv`:

    pipenv shell

Now install the dependencies and tests:

    pip install -e '.[test]'

To run the tests:

    pytest


