Metadata-Version: 2.1
Name: cyral
Version: 1.0.0
Summary: The Cyral CLI tool
License: MIT
Author: Deepak Gupta
Author-email: deepak@cyral.com
Requires-Python: >=3.9,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Requires-Dist: awscli (>=1.25,<2.0)
Requires-Dist: click (>=8.1,<9.0)
Requires-Dist: columnar (>=1.4,<2.0)
Requires-Dist: oauthlib (>=3.2,<4.0)
Requires-Dist: requests (>=2.28,<3.0)
Description-Content-Type: text/markdown

# The Cyral CLI Tool

Use this tool to obtain credentials for accessing a data repo via the Cyral sidecar.
Note: This tool does not work with Cyral versions before 3.0. If you are using an
older version of Cyral, please use the [gimme-db-token](https://pypi.org/project/cyral-gimme-db-token/)
tool instead.

## Usage

```
cyral <global options> <command> <subcommand> <command options>
```

For detailed usage instructions:

```bash
cyral --help
```

### Global Options

- `--cp-address <control plane address>` Cyral Control Plane Address, e.g., `mycompany.app.cyral.com` (the address may need a :8000 suffix in some cases).
- `--idp <idp alias>` The identity provider to use for authentication.
- `--offline-access` Obtain a long-lived offline access token for authentication to the control plane.
- `--no-stored-creds` Do not store or use a stored refresh token.
- `--help` Show command help.

### Top Level Commands

The only top level command currently supported is `access`. It has the following subcommands.

- `token` Print a token for authenticating to a repo using your email address as user name.
- `repo` Show list of accessible data repos and print connection information for the selected repo.
  + Use `--type`, `--tag`, `--name` options to specify repo filters.
- `s3` Write configuration needed to access S3 to AWS config files.
- `pg` Write configuration needed to access selected postgres database to `.pgpass` file.


