Add docs and fix ID of gitlab_project_protected_branches

Signed-off-by: Sune Keller <[email protected]>

Author: sirlatrom

docs/data-sources/project_protected_branch.md

@@ -0,0 +1,49 @@
+# gitlab\_project\_protected\_branch
+
+Provides details about a specific protected branch in a given project.
+
+## Example Usage
+
+```hcl
+data "gitlab_project_protected_branch" "example" {
+  project_id = 30
+  name       = "main"
+}
+```
+
+```hcl
+data "gitlab_project_protected_branch" "example" {
+  project_id = "foo/bar/baz"
+  name       = "main"
+}
+```
+
+## Argument Reference
+
+The following arguments are supported:
+
+* `project_id` - (Required) The integer or path with namespace that uniquely identifies the project.
+
+* `name` - (Required) The name of the protected branch.
+
+## Attributes Reference
+
+The following attributes are exported:
+
+* `push_access_levels`, `merge_access_levels`, `unprotect_access_levels` - Each block contains a list of which access levels, users or groups are allowed to perform the respective actions (documented below).
+
+* `code_owner_approval_required` - Reject code pushes that change files listed in the CODEOWNERS file.
+
+## Nested Blocks
+
+### `push_access_levels`, `merge_access_levels`, `unprotect_access_levels`
+
+#### Attributes
+
+* `access_level` - The access level allowed to perform the respective action (shows as 40 - "maintainer" if `user_id` or `group_id` are present).
+
+* `access_level_description` - A description of the allowed access level(s), or the name of the user or group if `user_id` or `group_id` are present.
+
+* `user_id` - If present, indicates that the user is allowed to perform the respective action.
+
+* `group_id` - If present, indicates that the group is allowed to perform the respective action.

docs/data-sources/project_protected_branches.md

@@ -0,0 +1,53 @@
+# gitlab\_project\_protected\_branches
+
+Provides details about all protected branches in a given project.
+
+## Example Usage
+
+```hcl
+data "gitlab_project_protected_branches" "example" {
+  project_id = 30
+}
+```
+
+```hcl
+data "gitlab_project_protected_branches" "example" {
+  project_id = "foo/bar/baz"
+}
+```
+
+## Argument Reference
+
+The following arguments are supported:
+
+* `project_id` - (Required) The integer or path with namespace that uniquely identifies the project.
+
+## Attributes Reference
+
+The following attributes are exported:
+
+* `protected_branches` - A list of protected branches, as defined below.
+
+## Nested Blocks
+
+### `protected_branches`
+
+* `id` - The ID of the protected branch.
+
+* `name` - The name of the protected branch.
+
+* `push_access_levels`, `merge_access_levels`, `unprotect_access_levels` - Each block contains a list of which access levels, users or groups are allowed to perform the respective actions (documented below).
+
+* `code_owner_approval_required` - Reject code pushes that change files listed in the CODEOWNERS file.
+
+### `push_access_levels`, `merge_access_levels`, `unprotect_access_levels`
+
+#### Attributes
+
+* `access_level` - The access level allowed to perform the respective action (shows as 40 - "maintainer" if `user_id` or `group_id` are present).
+
+* `access_level_description` - A description of the allowed access level(s), or the name of the user or group if `user_id` or `group_id` are present.
+
+* `user_id` - If present, indicates that the user is allowed to perform the respective action.
+
+* `group_id` - If present, indicates that the group is allowed to perform the respective action.

gitlab/data_source_gitlab_project_protected_branches.go

@@ -69,11 +69,10 @@ func dataSourceGitlabProjectProtectedBranchesRead(d *schema.ResourceData, meta i
 
 	allProtectedBranches := make([]stateProtectedBranch, 0)
 	totalPages := -1
-	for page := 0; page != totalPages; page++ {
+	opts := &gitlab.ListProtectedBranchesOptions{}
+	for opts.Page = 0; opts.Page != totalPages; opts.Page++ {
 		// Get protected branch by project ID/path and branch name
-		pbs, resp, err := client.ProtectedBranches.ListProtectedBranches(project, &gitlab.ListProtectedBranchesOptions{
-			Page: page + 1,
-		})
+		pbs, resp, err := client.ProtectedBranches.ListProtectedBranches(project, opts)
 		if err != nil {
 			return err
 		}
@@ -94,7 +93,7 @@ func dataSourceGitlabProjectProtectedBranchesRead(d *schema.ResourceData, meta i
 		return err
 	}
 
-	h, err := hashstructure.Hash(project, nil)
+	h, err := hashstructure.Hash(*opts, nil)
 	if err != nil {
 		return err
 	}