Added support for iterations and group iterations

Author: Daniel Steinke

group_iterations.go

@@ -0,0 +1,92 @@
+//
+// Copyright 2022, stonebyte
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+package gitlab
+
+import (
+	"fmt"
+	"net/http"
+	"time"
+)
+
+// IterationsAPI handles communication with the iterations related methods
+// of the GitLab API
+//
+// GitLab API docs: https://docs.gitlab.com/ee/api/group_iterations.html
+
+type GroupIterationsService struct {
+	client *Client
+}
+
+// GroupInteration represents a GitLab iteration.
+//
+// GitLab API docs: https://docs.gitlab.com/ee/api/group_iterations.html
+
+type GroupIteration struct {
+	ID          int        `json:"id"`
+	IID         int        `json:"iid"`
+	GroupID     int        `json:"group_id"`
+	Title       string     `json:"title"`
+	Description string     `json:"description"`
+	State       int        `json:"state"`
+	CreatedAt   *time.Time `json:"created_at"`
+	UpdatedAt   *time.Time `json:"updated_at"`
+	DueDate     *ISOTime   `json:"due_date"`
+	StartDate   *ISOTime   `json:"start_date"`
+	WebURL      string     `json:"web_url"`
+}
+
+func (i GroupIteration) String() string {
+	return Stringify(i)
+}
+
+// ListGroupIterationsOptions contains the available
+// ListGroupIterations() options
+//
+// GitLab API docs: https://docs.gitlab.com/ee/api/group_iterations.html#list-group-iterations
+
+type ListGroupIterationsOptions struct {
+	ListOptions
+	State            *string `url:"state,omitempty" json:"state,omitempty"`
+	Search           *string `url:"search,omitempty" json:"search,omitempty"`
+	IncludeAncestors *bool   `url:"include_ancestors,omitempty" json:"include_ancestors,omitempty"`
+}
+
+// ListGroupIterations returns alist of group iterations.
+//
+// GitLab API docs: https://docs.gitlab.com/ee/api/group_iterations.html#list-group-iterations
+
+func (s *GroupIterationsService) ListGroupIterations(gid interface{}, opt *ListGroupIterationsOptions, options ...RequestOptionFunc) ([]*GroupIteration, *Response, error) {
+	group, err := parseID(gid)
+	if err != nil {
+		return nil, nil, err
+	}
+	u := fmt.Sprintf("groups/%s/iterations", PathEscape(group))
+
+	req, err := s.client.NewRequest(http.MethodGet, u, opt, options)
+	if err != nil {
+		return nil, nil, err
+	}
+
+	var i []*GroupIteration
+	resp, err := s.client.Do(req, &i)
+	if err != nil {
+		return nil, nil, err
+	}
+
+	return i, resp, err
+
+}

iterations.go

@@ -0,0 +1,86 @@
+//
+// Copyright 2022, stonebyte
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+package gitlab
+
+import (
+	"fmt"
+	"net/http"
+	"time"
+)
+
+// IterationsAPI handles communication with the iterations related methods
+// of the GitLab API
+//
+// GitLab API docs: https://docs.gitlab.com/ee/api/iterations.html
+
+type IterationsService struct {
+	client *Client
+}
+
+type Iteration struct {
+	ID          int        `json:"id"`
+	IID         int        `json:"iid"`
+	GroupID     int        `json:"group_id"`
+	Title       string     `json:"title"`
+	Description string     `json:"description"`
+	State       int        `json:"state"`
+	CreatedAt   *time.Time `json:"created_at"`
+	UpdatedAt   *time.Time `json:"updated_at"`
+	DueDate     *ISOTime   `json:"due_date"`
+	StartDate   *ISOTime   `json:"start_date"`
+	WebURL      string     `json:"web_url"`
+}
+
+func (i Iteration) String() string {
+	return Stringify(i)
+}
+
+// ListGroupIterationsOptions contains the available
+// ListGroupIterations() options
+//
+// GitLab API docs: https://docs.gitlab.com/ee/api/group_iterations.html#list-project-iterations
+type ListProjectIterationsOptions struct {
+	ListOptions
+	State            *string `url:"state,omitempty" json:"state,omitempty"`
+	Search           *string `url:"search,omitempty" json:"search,omitempty"`
+	IncludeAncestors *bool   `url:"include_ancestors,omitempty" json:"include_ancestors,omitempty"`
+}
+
+//ListProjectIterations lists all iterations of the projects ancestor groups.
+//As of GitLab 13.5, there are not direct project-level iterations.
+
+// GitLab API docs: https://docs.gitlab.com/ee/api/iterations.html
+func (i *IterationsService) ListProjectIterations(pid interface{}, opt *ListGroupProjectsOptions, options ...RequestOptionFunc) ([]*Iteration, *Response, error) {
+	project, err := parseID(pid)
+	if err != nil {
+		return nil, nil, err
+	}
+	u := fmt.Sprintf("projects/%s/iterations", PathEscape(project))
+
+	req, err := i.client.NewRequest(http.MethodGet, u, opt, options)
+	if err != nil {
+		return nil, nil, err
+	}
+
+	var it []*Iteration
+	resp, err := i.client.Do(req, &it)
+	if err != nil {
+		return nil, resp, err
+	}
+
+	return it, resp, err
+}