package api import ( "context" "encoding/json" "fmt" "testing" "github.com/grafana/grafana/pkg/api/dtos" "github.com/grafana/grafana/pkg/api/response" "github.com/grafana/grafana/pkg/api/routing" "github.com/grafana/grafana/pkg/bus" dboards "github.com/grafana/grafana/pkg/dashboards" "github.com/grafana/grafana/pkg/models" "github.com/grafana/grafana/pkg/services/dashboards" "github.com/grafana/grafana/pkg/setting" "github.com/stretchr/testify/assert" "github.com/stretchr/testify/require" ) func TestFoldersAPIEndpoint(t *testing.T) { t.Run("Given a correct request for creating a folder", func(t *testing.T) { cmd := models.CreateFolderCommand{ Uid: "uid", Title: "Folder", } mock := &fakeFolderService{ CreateFolderResult: &models.Folder{Id: 1, Uid: "uid", Title: "Folder"}, } createFolderScenario(t, "When calling POST on", "/api/folders", "/api/folders", mock, cmd, func(sc *scenarioContext) { callCreateFolder(sc) folder := dtos.Folder{} err := json.NewDecoder(sc.resp.Body).Decode(&folder) require.NoError(t, err) assert.Equal(t, int64(1), folder.Id) assert.Equal(t, "uid", folder.Uid) assert.Equal(t, "Folder", folder.Title) }) }) t.Run("Given incorrect requests for creating a folder", func(t *testing.T) { testCases := []struct { Error error ExpectedStatusCode int }{ {Error: models.ErrFolderWithSameUIDExists, ExpectedStatusCode: 409}, {Error: models.ErrFolderTitleEmpty, ExpectedStatusCode: 400}, {Error: models.ErrFolderSameNameExists, ExpectedStatusCode: 409}, {Error: models.ErrDashboardInvalidUid, ExpectedStatusCode: 400}, {Error: models.ErrDashboardUidTooLong, ExpectedStatusCode: 400}, {Error: models.ErrFolderAccessDenied, ExpectedStatusCode: 403}, {Error: models.ErrFolderNotFound, ExpectedStatusCode: 404}, {Error: models.ErrFolderVersionMismatch, ExpectedStatusCode: 412}, {Error: models.ErrFolderFailedGenerateUniqueUid, ExpectedStatusCode: 500}, } cmd := models.CreateFolderCommand{ Uid: "uid", Title: "Folder", } for _, tc := range testCases { mock := &fakeFolderService{ CreateFolderError: tc.Error, } createFolderScenario(t, fmt.Sprintf("Expect '%s' error when calling POST on", tc.Error.Error()), "/api/folders", "/api/folders", mock, cmd, func(sc *scenarioContext) { callCreateFolder(sc) assert.Equalf(t, tc.ExpectedStatusCode, sc.resp.Code, "Wrong status code for error %s", tc.Error) }) } }) t.Run("Given a correct request for updating a folder", func(t *testing.T) { cmd := models.UpdateFolderCommand{ Title: "Folder upd", } mock := &fakeFolderService{ UpdateFolderResult: &models.Folder{Id: 1, Uid: "uid", Title: "Folder upd"}, } updateFolderScenario(t, "When calling PUT on", "/api/folders/uid", "/api/folders/:uid", mock, cmd, func(sc *scenarioContext) { callUpdateFolder(sc) folder := dtos.Folder{} err := json.NewDecoder(sc.resp.Body).Decode(&folder) require.NoError(t, err) assert.Equal(t, int64(1), folder.Id) assert.Equal(t, "uid", folder.Uid) assert.Equal(t, "Folder upd", folder.Title) }) }) t.Run("Given incorrect requests for updating a folder", func(t *testing.T) { testCases := []struct { Error error ExpectedStatusCode int }{ {Error: models.ErrFolderWithSameUIDExists, ExpectedStatusCode: 409}, {Error: models.ErrFolderTitleEmpty, ExpectedStatusCode: 400}, {Error: models.ErrFolderSameNameExists, ExpectedStatusCode: 409}, {Error: models.ErrDashboardInvalidUid, ExpectedStatusCode: 400}, {Error: models.ErrDashboardUidTooLong, ExpectedStatusCode: 400}, {Error: models.ErrFolderAccessDenied, ExpectedStatusCode: 403}, {Error: models.ErrFolderNotFound, ExpectedStatusCode: 404}, {Error: models.ErrFolderVersionMismatch, ExpectedStatusCode: 412}, {Error: models.ErrFolderFailedGenerateUniqueUid, ExpectedStatusCode: 500}, } cmd := models.UpdateFolderCommand{ Title: "Folder upd", } for _, tc := range testCases { mock := &fakeFolderService{ UpdateFolderError: tc.Error, } updateFolderScenario(t, fmt.Sprintf("Expect '%s' error when calling PUT on", tc.Error.Error()), "/api/folders/uid", "/api/folders/:uid", mock, cmd, func(sc *scenarioContext) { callUpdateFolder(sc) assert.Equalf(t, tc.ExpectedStatusCode, sc.resp.Code, "Wrong status code for %s", tc.Error) }) } }) } func callCreateFolder(sc *scenarioContext) { sc.fakeReqWithParams("POST", sc.url, map[string]string{}).exec() } func createFolderScenario(t *testing.T, desc string, url string, routePattern string, mock *fakeFolderService, cmd models.CreateFolderCommand, fn scenarioFunc) { t.Run(fmt.Sprintf("%s %s", desc, url), func(t *testing.T) { t.Cleanup(bus.ClearBusHandlers) hs := HTTPServer{ Bus: bus.GetBus(), Cfg: setting.NewCfg(), } sc := setupScenarioContext(t, url) sc.defaultHandler = routing.Wrap(func(c *models.ReqContext) response.Response { c.Req.Body = mockRequestBody(cmd) sc.context = c sc.context.SignedInUser = &models.SignedInUser{OrgId: testOrgID, UserId: testUserID} return hs.CreateFolder(c) }) origNewFolderService := dashboards.NewFolderService mockFolderService(mock) sc.m.Post(routePattern, sc.defaultHandler) defer func() { dashboards.NewFolderService = origNewFolderService }() fn(sc) }) } func callUpdateFolder(sc *scenarioContext) { sc.fakeReqWithParams("PUT", sc.url, map[string]string{}).exec() } func updateFolderScenario(t *testing.T, desc string, url string, routePattern string, mock *fakeFolderService, cmd models.UpdateFolderCommand, fn scenarioFunc) { t.Run(fmt.Sprintf("%s %s", desc, url), func(t *testing.T) { defer bus.ClearBusHandlers() hs := HTTPServer{ Cfg: setting.NewCfg(), } sc := setupScenarioContext(t, url) sc.defaultHandler = routing.Wrap(func(c *models.ReqContext) response.Response { c.Req.Body = mockRequestBody(cmd) sc.context = c sc.context.SignedInUser = &models.SignedInUser{OrgId: testOrgID, UserId: testUserID} return hs.UpdateFolder(c) }) origNewFolderService := dashboards.NewFolderService t.Cleanup(func() { dashboards.NewFolderService = origNewFolderService }) mockFolderService(mock) sc.m.Put(routePattern, sc.defaultHandler) fn(sc) }) } type fakeFolderService struct { dashboards.FolderService GetFoldersResult []*models.Folder GetFoldersError error GetFolderByUIDResult *models.Folder GetFolderByUIDError error GetFolderByIDResult *models.Folder GetFolderByIDError error CreateFolderResult *models.Folder CreateFolderError error UpdateFolderResult *models.Folder UpdateFolderError error DeleteFolderResult *models.Folder DeleteFolderError error DeletedFolderUids []string } func (s *fakeFolderService) GetFolders(ctx context.Context, limit int64, page int64) ([]*models.Folder, error) { return s.GetFoldersResult, s.GetFoldersError } func (s *fakeFolderService) GetFolderByID(ctx context.Context, id int64) (*models.Folder, error) { return s.GetFolderByIDResult, s.GetFolderByIDError } func (s *fakeFolderService) GetFolderByUID(ctx context.Context, uid string) (*models.Folder, error) { return s.GetFolderByUIDResult, s.GetFolderByUIDError } func (s *fakeFolderService) CreateFolder(ctx context.Context, title, uid string) (*models.Folder, error) { return s.CreateFolderResult, s.CreateFolderError } func (s *fakeFolderService) UpdateFolder(ctx context.Context, existingUID string, cmd *models.UpdateFolderCommand) error { cmd.Result = s.UpdateFolderResult return s.UpdateFolderError } func (s *fakeFolderService) DeleteFolder(ctx context.Context, uid string, forceDeleteRules bool) (*models.Folder, error) { s.DeletedFolderUids = append(s.DeletedFolderUids, uid) return s.DeleteFolderResult, s.DeleteFolderError } func mockFolderService(mock *fakeFolderService) { dashboards.NewFolderService = func(orgId int64, user *models.SignedInUser, dashboardStore dboards.Store) dashboards.FolderService { return mock } }