apps: add ListBuildpacks, UpgradeBuildpack

Author: Kamal Nasser

apps.gen.go

@@ -51,6 +51,9 @@ type AppsService interface {
 	UpdateAlertDestinations(ctx context.Context, appID, alertID string, update *AlertDestinationUpdateRequest) (*AppAlert, *Response, error)
 
 	Detect(ctx context.Context, detect *DetectRequest) (*DetectResponse, *Response, error)
+
+	ListBuildpacks(ctx context.Context) ([]*Buildpack, *Response, error)
+	UpgradeBuildpack(ctx context.Context, appID string, opts UpgradeBuildpackOptions) (*UpgradeBuildpackResponse, *Response, error)
 }
 
 // AppLogs represent app logs.
@@ -75,6 +78,16 @@ type AlertDestinationUpdateRequest struct {
 	SlackWebhooks []*AppAlertSlackWebhook `json:"slack_webhooks"`
 }
 
+// UpgradeBuildpackOptions struct for UpgradeBuildpackOptions
+type UpgradeBuildpackOptions struct {
+	// The ID of the buildpack to upgrade.
+	BuildpackID string `json:"buildpack_id,omitempty"`
+	// The Major Version to upgrade the buildpack to. If omitted, the latest available major version will be used.
+	MajorVersion int32 `json:"major_version,omitempty"`
+	// Whether or not to trigger a deployment for the app after upgrading the buildpack.
+	TriggerDeployment bool `json:"trigger_deployment,omitempty"`
+}
+
 type appRoot struct {
 	App *App `json:"app"`
 }
@@ -123,6 +136,10 @@ type appAlertRoot struct {
 	Alert *AppAlert `json:"alert"`
 }
 
+type buildpacksRoot struct {
+	Buildpacks []*Buildpack `json:"buildpacks,omitempty"`
+}
+
 // AppsServiceOp handles communication with Apps methods of the DigitalOcean API.
 type AppsServiceOp struct {
 	client *Client
@@ -444,6 +461,36 @@ func (s *AppsServiceOp) Detect(ctx context.Context, detect *DetectRequest) (*Det
 	return res, resp, nil
 }
 
+// ListBuildpacks lists the available buildpacks on App Platform.
+func (s *AppsServiceOp) ListBuildpacks(ctx context.Context) ([]*Buildpack, *Response, error) {
+	path := fmt.Sprintf("%s/buildpacks", appsBasePath)
+	req, err := s.client.NewRequest(ctx, http.MethodGet, path, nil)
+	if err != nil {
+		return nil, nil, err
+	}
+	root := new(buildpacksRoot)
+	resp, err := s.client.Do(ctx, req, root)
+	if err != nil {
+		return nil, resp, err
+	}
+	return root.Buildpacks, resp, nil
+}
+
+// UpgradeBuildpack upgrades a buildpack for an app.
+func (s *AppsServiceOp) UpgradeBuildpack(ctx context.Context, appID string, opts UpgradeBuildpackOptions) (*UpgradeBuildpackResponse, *Response, error) {
+	path := fmt.Sprintf("%s/%s/upgrade_buildpack", appsBasePath, appID)
+	req, err := s.client.NewRequest(ctx, http.MethodPost, path, opts)
+	if err != nil {
+		return nil, nil, err
+	}
+	root := new(UpgradeBuildpackResponse)
+	resp, err := s.client.Do(ctx, req, root)
+	if err != nil {
+		return nil, resp, err
+	}
+	return root, resp, nil
+}
+
 // AppComponentType is an app component type.
 type AppComponentType string
 

apps.go

@@ -210,6 +210,21 @@ var (
 			},
 		},
 	}
+
+	testBuildpacks = []*Buildpack{
+		{
+			ID:           "digitalocean/node",
+			Name:         "Node.js",
+			Version:      "1.2.3",
+			MajorVersion: 1,
+		},
+		{
+			ID:           "digitalocean/php",
+			Name:         "PHP",
+			Version:      "0.3.5",
+			MajorVersion: 0,
+		},
+	}
 )
 
 func TestApps_CreateApp(t *testing.T) {
@@ -631,6 +646,55 @@ func TestApps_Detect(t *testing.T) {
 	assert.Equal(t, component, res.Components[0])
 }
 
+func TestApps_ListBuildpacks(t *testing.T) {
+	setup()
+	defer teardown()
+
+	ctx := context.Background()
+
+	mux.HandleFunc("/v2/apps/buildpacks", func(w http.ResponseWriter, r *http.Request) {
+		testMethod(t, r, http.MethodGet)
+
+		json.NewEncoder(w).Encode(&buildpacksRoot{Buildpacks: testBuildpacks})
+	})
+
+	bps, _, err := client.Apps.ListBuildpacks(ctx)
+	require.NoError(t, err)
+	assert.Equal(t, testBuildpacks, bps)
+}
+
+func TestApps_UpgradeBuildpack(t *testing.T) {
+	setup()
+	defer teardown()
+
+	ctx := context.Background()
+
+	response := &UpgradeBuildpackResponse{
+		AffectedComponents: []string{"api", "frontend"},
+		Deployment:         &testDeployment,
+	}
+	opts := UpgradeBuildpackOptions{
+		BuildpackID:       "digitalocean/node",
+		MajorVersion:      3,
+		TriggerDeployment: true,
+	}
+
+	mux.HandleFunc(fmt.Sprintf("/v2/apps/%s/upgrade_buildpack", testApp.ID), func(w http.ResponseWriter, r *http.Request) {
+		testMethod(t, r, http.MethodPost)
+
+		var gotOpts UpgradeBuildpackOptions
+		err := json.NewDecoder(r.Body).Decode(&gotOpts)
+		require.NoError(t, err)
+		assert.Equal(t, opts, gotOpts)
+
+		json.NewEncoder(w).Encode(response)
+	})
+
+	gotResponse, _, err := client.Apps.UpgradeBuildpack(ctx, testApp.ID, opts)
+	require.NoError(t, err)
+	assert.Equal(t, response, gotResponse)
+}
+
 func TestApps_ToURN(t *testing.T) {
 	app := &App{
 		ID: "deadbeef-dead-4aa5-beef-deadbeef347d",