Akamai Network Lists

A package for Akamai CLI to interact with the Network Lists API. An API summary can be found here.

Usage

Usage: akamai_network_lists [OPTIONS] COMMAND [ARGS]...

Options:
  -e, --edgerc        Location of the credentials file [$AKAMAI_EDGERC]
  -s, --section       Section of the credentials file [$AKAMAI_EDGERC_SECTION]
  -a, --account-key   Account Key
  --version           Show the version and exit.
  -h, --help          Show this message and exit.

Commands:
  activate             Activate Network List
  activation-snapshot  Get Activation Snapshot
  activation-status    Get Activation Status
  add-element          Add Network List Element
  append               Append Elements to Network List
  create               Create Network List
  delete               Delete Network List
  help                 Show help information
  list                 List Network Lists
  remove-element       Remove Network List Element
  retrieve             Retrieve Network List
  update               Update Network List
  update-details       Update Network List details

Development

This project is using hatch as it's build system. For this reason I also used it to manage the development environment. The following commands can be used to create and activate a virtual environment. Alternatively you're free to use the Python venv module.

You may need to install hatch (pip install hatch)

hatch env create
hatch shell

The main "binary" is located in bin/akamai-network-lists.py. The reason is because the akamai-cli tool has it's own format a python module must adhere to. It looks for files under the bin directory that match the pattern of akamai-command-name.

We also need to list our dependencies in a requirements.txt file, as we are using pyproject.toml to define our build system requirements and dependencies, this means we have only included akamai-network-lists in requirements.txt and this module will be installed from PyPi.

There is some information in the README.md for akamai-cli, but a lot of the specifics seem un-written..

Build

python3 -m pip install --upgrade build
python3 -m pip install --upgrade twine

python3 -m build
python3 -m twine upload dist/*

Install in akamai-cli

# i'm using ubuntu 22.04 and there's an issue with the default python pip package
# for that reason i need to use a later version of python that the akamai-cli
# can use, the following three lines may not be necessary on any other configuration
python3.11 -m venv test_venv
source test_venv/bin/activate
PYTHONUSERBASE="test_venv/lib/python3.11/site-packages"

akamai install https://github.com/ryanlinnit-sky/akamai-cli-network-lists.git

akamai network-lists