Library Interface Brainstorming

[kespinola]

What do you all think of an interface like this?

defmodule Procore.Endpoint do
  def construct(%Procore.Company{id :id}), do: "/vapid/companies/#{id}"
  def construct(%Procore.Company{}), do: "/vapid/companies"
  def construct(%Procore.Inspection{project_id: project_id, id :id}), do: "/vapid/projects/#{project_id}/inspections/#{id}"
end

defmodule Procore.Api do
  def get(struct), do: struct |> Procore.Endpoint.construct() |> OauthClient.get()
  def post(struct, params), do: struct |> Procore.Endpoint.construct() |> OauthClient.post(params)
end

%Procore.ApiResponse{body: body} = Procore.Api.get(%Procore.Company{id: 1})
%Procore.ApiResponse{body: body} = Procore.Api.post(
  %Procore.Inspection{project_id: 2, id: 1},
  %{title: "example title"}
)

[kespinola]

Great to see the sdk take shape, but would still like to hear peoples' thoughts on the proposal.

I am thinking of ecto where there is a single repo which receives changesets or structs.

# ecto
post = MyRepo.get(Post, 42)

# sdk
company = Procore.Api.get(%Procore.Company, {id: 1})
or
company = Procore.Api.get(Procore.Company, 1)

Be great to generate the structs and endpoints from the docs like in the js sdk.
https://github.com/procore/js-sdk-endpoints

Excited for the project 👍 Let me know how I can help. A github project board may help.