Infusion.Naming (infusion v0.1.0)

Turns OpenAPI names into Elixir module and function names.

Each operation gets a module path (["Repos"], ["ZeroTrust", "Devices"]) and a function name, from the first strategy that applies:

Vendor SDK hints: x-fern-sdk-group-name (dot-separated groups) and x-fern-sdk-method-name. Cloudflare sets them on nearly every operation, so its SDK matches the official ones.
group/action operation IDs, as GitHub uses (repos/get).
The path, when the operation has no tag (all of Stripe, part of OpenAI): GET /v1/customers is Customers.list, POST /v1/customers/{id} is Customers.update, POST /v1/payment_intents/{id}/cancel is PaymentIntents.cancel, and /v1/customers/{id}/sources is a nested Customers.Sources.
The tag and the operation ID, with version prefixes taken off the tag (Twilio's Api20100401Recording) and the module's words taken off the function (list_recording in Recording is list).

Summary

Functions

function_name(name)

A function or field name: "createChatCompletion", "repos/get-pages" -> snake_case.

module_part(name)

A module name part: "vector stores", "vector_stores", "vector-stores" -> "VectorStores".

operation(op, path, method)

Names an operation. op is the operation object, path and method its location.

package(base)

The package name for a base module, as the vendor writes it: OpenAI is openai, GitHub is github (not open_ai, git_hub). Used for the app, the directory and the API key's environment variable.

words(name)

Splits camelCase, PascalCase, kebab, snake, dotted and spaced names into lowercase words.

Types

operation_name()

@type operation_name() :: %{
  module: [String.t()],
  function: String.t(),
  strategy: atom()
}