Metadata-Version: 2.4
Name: akcli
Version: 0.1.1
Summary: Command-line interface to make requests to Akamai API.
License: MIT
License-File: LICENSE
Author: Javier Correa Guerrero
Author-email: jcorreag@pm.me
Requires-Python: >=3.9,<3.14
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: edgegrid-python (>=2.0,<3.0)
Requires-Dist: merge-args (>=0.1,<0.2)
Requires-Dist: platformdirs (>=4.4,<5.0)
Requires-Dist: pydantic (>=2.12,<3.0)
Requires-Dist: requests (>=2.32,<3.0)
Requires-Dist: rich (>=14.2,<15.0)
Requires-Dist: tomli (>=2.3,<3.0)
Requires-Dist: tomli-w (>=1.2,<2.0)
Requires-Dist: typer (>=0.20,<0.21)
Project-URL: Homepage, https://github.com/jvicg/akcli
Project-URL: Repository, https://github.com/jvicg/akcli
Description-Content-Type: text/markdown

# akcli

[![Pactester latest version](https://img.shields.io/pypi/v/akcli.svg)](https://pypi.org/project/akcli/)
[![CI tests status](https://github.com/jvicg/akcli/actions/workflows/tests.yml/badge.svg)](https://github.com/jvicg/akcli/actions/workflows/tests.yml)
[![Current available Python versions](https://img.shields.io/pypi/pyversions/akcli.svg)](https://pypi.org/project/akcli/)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](jvicg/akcli/blob/main/LICENSE)

A modern command-line interface for interacting with Akamai's API.

Built for engineers who work with Akamai on a daily basis, `akcli` removes the friction of
working with Akamai's API directly. It exposes a set of commands to interact with different
Akamai API endpoints, providing a fast and intuitive way to work with the platform without
leaving the terminal.

![akcli demo gif](https://raw.githubusercontent.com/jvicg/akcli/main/docs/source/_static/demo.gif)

## Features

- Transparent EdgeGrid authentication — just point `akcli` to your `.edgerc` file and it handles the rest.
- Response caching to avoid hitting the API unnecessarily, with configurable TTL and cache directory.
- Proxy support to route requests through an HTTP/HTTPS proxy with a single config option.
- SSL certificate validation enabled by default, with the option to disable it for internal or development environments.
- TOML config file to persist your preferred defaults and never repeat the same flags.
- Visually modern CLI experience built with [Typer](https://typer.tiangolo.com/) and [Rich](https://rich.readthedocs.io/).

## Installation

Requires Python 3.9 or higher and a valid Akamai `.edgerc` credentials file.

```bash
pip install akcli
```

Alternatively, you may download the wheel file from the
[releases page](https://github.com/jvicg/akcli/releases).

## Quick start

Generate a config file with all the default values:

```bash
akcli --init-config-file
```

Explore the available commands:

```bash
akcli --help
```

## Documentation

Full documentation is available on [Read the Docs](https://akcli.readthedocs.io).

## License

This project is licensed under the MIT License.
You are free to use, modify, and distribute this software under the terms of the license.
See the [LICENSE](https://github.com/jvicg/akcli/blob/main/LICENSE) file for full details.

