Skip to content
AEP
Blog

Tooling and Ecosystem

In addition to an API design specification, AEPs also provide an ecosystem of tooling to help produce and interact with these APIs.

Diagram

The following is a diagram that illustrates an end-to-end workflow, including nodes of tooling that exists, or is intended to be created for the project.

Some of the tools in the diagram are not maintained by the AEP project. The diagram is intended to be a complete representation of tools available to help a user understand how the tools fit in to a development workflow.

tool

possible use case

user authored

generated

The service generation tooling looks like:

AEP Resource yaml

gRPC protobuf definition

OpenAPI Schema

GraphQL definitions

your proto service

HTTP REST APIs via grpc-gateway

api stubs via openapi-generator

your http service

While the client tooling for an AEP-compliant compatible API includes:

AEP-compliant REST API and OpenAPI definition

terraform provider generator (planned)

terraform provider

LLM plugin (external integration)

Language-specific libraries (e.g. via openapi-generator)

Asset inventory and policy management tooling (external integration)

Kubernetes Custom Resource Definitions generator

API documentation generator (planned)