123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113 |
- //
- // Copyright 2018, Sander van Harmelen
- //
- // 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/url"
- "time"
- )
- // DiscussionsService handles communication with the discussions related
- // methods of the GitLab API.
- //
- // GitLab API docs: https://docs.gitlab.com/ce/api/discussions.html
- type DiscussionsService struct {
- client *Client
- }
- // Discussion represents a GitLab discussion.
- //
- // GitLab API docs: https://docs.gitlab.com/ce/api/discussions.html
- type Discussion struct {
- ID string `json:"id"`
- IndividualNote bool `json:"individual_note"`
- Notes []*Note `json:"notes"`
- }
- func (d Discussion) String() string {
- return Stringify(d)
- }
- // ListIssueDiscussionsOptions represents the available ListIssueDiscussions()
- // options.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#list-project-issue-discussions
- type ListIssueDiscussionsOptions ListOptions
- // ListIssueDiscussions gets a list of all discussions for a single
- // issue.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#list-project-issue-discussions
- func (s *DiscussionsService) ListIssueDiscussions(pid interface{}, issue int, opt *ListIssueDiscussionsOptions, options ...OptionFunc) ([]*Discussion, *Response, error) {
- project, err := parseID(pid)
- if err != nil {
- return nil, nil, err
- }
- u := fmt.Sprintf("projects/%s/issues/%d/discussions", url.QueryEscape(project), issue)
- req, err := s.client.NewRequest("GET", u, opt, options)
- if err != nil {
- return nil, nil, err
- }
- var ds []*Discussion
- resp, err := s.client.Do(req, &ds)
- if err != nil {
- return nil, resp, err
- }
- return ds, resp, err
- }
- // GetIssueDiscussion returns a single discussion for a specific project issue.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#get-single-issue-discussion
- func (s *DiscussionsService) GetIssueDiscussion(pid interface{}, issue int, discussion string, options ...OptionFunc) (*Discussion, *Response, error) {
- project, err := parseID(pid)
- if err != nil {
- return nil, nil, err
- }
- u := fmt.Sprintf("projects/%s/issues/%d/discussions/%s",
- url.QueryEscape(project),
- issue,
- discussion,
- )
- req, err := s.client.NewRequest("GET", u, nil, options)
- if err != nil {
- return nil, nil, err
- }
- d := new(Discussion)
- resp, err := s.client.Do(req, d)
- if err != nil {
- return nil, resp, err
- }
- return d, resp, err
- }
- // CreateIssueDiscussionOptions represents the available CreateIssueDiscussion()
- // options.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#create-new-issue-discussion
- type CreateIssueDiscussionOptions struct {
- Body *string `url:"body,omitempty" json:"body,omitempty"`
- CreatedAt *time.Time `url:"created_at,omitempty" json:"created_at,omitempty"`
- }
- // CreateIssueDiscussion creates a new discussion to a single project issue.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#create-new-issue-discussion
- func (s *DiscussionsService) CreateIssueDiscussion(pid interface{}, issue int, opt *CreateIssueDiscussionOptions, options ...OptionFunc) (*Discussion, *Response, error) {
- project, err := parseID(pid)
- if err != nil {
- return nil, nil, err
- }
- u := fmt.Sprintf("projects/%s/issues/%d/discussions", url.QueryEscape(project), issue)
- req, err := s.client.NewRequest("POST", u, opt, options)
- if err != nil {
- return nil, nil, err
- }
- d := new(Discussion)
- resp, err := s.client.Do(req, d)
- if err != nil {
- return nil, resp, err
- }
- return d, resp, err
- }
- // AddIssueDiscussionNoteOptions represents the available AddIssueDiscussionNote()
- // options.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#add-note-to-existing-issue-discussion
- type AddIssueDiscussionNoteOptions struct {
- Body *string `url:"body,omitempty" json:"body,omitempty"`
- CreatedAt *time.Time `url:"created_at,omitempty" json:"created_at,omitempty"`
- }
- // AddIssueDiscussionNote creates a new discussion to a single project issue.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#add-note-to-existing-issue-discussion
- func (s *DiscussionsService) AddIssueDiscussionNote(pid interface{}, issue int, discussion string, opt *AddIssueDiscussionNoteOptions, options ...OptionFunc) (*Note, *Response, error) {
- project, err := parseID(pid)
- if err != nil {
- return nil, nil, err
- }
- u := fmt.Sprintf("projects/%s/issues/%d/discussions/%s/notes",
- url.QueryEscape(project),
- issue,
- discussion,
- )
- req, err := s.client.NewRequest("POST", u, opt, options)
- if err != nil {
- return nil, nil, err
- }
- n := new(Note)
- resp, err := s.client.Do(req, n)
- if err != nil {
- return nil, resp, err
- }
- return n, resp, err
- }
- // UpdateIssueDiscussionNoteOptions represents the available
- // UpdateIssueDiscussion() options.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#modify-existing-issue-discussion-note
- type UpdateIssueDiscussionNoteOptions struct {
- Body *string `url:"body,omitempty" json:"body,omitempty"`
- CreatedAt *time.Time `url:"created_at,omitempty" json:"created_at,omitempty"`
- }
- // UpdateIssueDiscussionNote modifies existing discussion of an issue.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#modify-existing-issue-discussion-note
- func (s *DiscussionsService) UpdateIssueDiscussionNote(pid interface{}, issue int, discussion string, note int, opt *UpdateIssueDiscussionNoteOptions, options ...OptionFunc) (*Note, *Response, error) {
- project, err := parseID(pid)
- if err != nil {
- return nil, nil, err
- }
- u := fmt.Sprintf("projects/%s/issues/%d/discussions/%s/notes/%d",
- url.QueryEscape(project),
- issue,
- discussion,
- note,
- )
- req, err := s.client.NewRequest("PUT", u, opt, options)
- if err != nil {
- return nil, nil, err
- }
- n := new(Note)
- resp, err := s.client.Do(req, n)
- if err != nil {
- return nil, resp, err
- }
- return n, resp, err
- }
- // DeleteIssueDiscussionNote deletes an existing discussion of an issue.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#delete-an-issue-discussion-note
- func (s *DiscussionsService) DeleteIssueDiscussionNote(pid interface{}, issue int, discussion string, note int, options ...OptionFunc) (*Response, error) {
- project, err := parseID(pid)
- if err != nil {
- return nil, err
- }
- u := fmt.Sprintf("projects/%s/issues/%d/discussions/%s/notes/%d",
- url.QueryEscape(project),
- issue,
- discussion,
- note,
- )
- req, err := s.client.NewRequest("DELETE", u, nil, options)
- if err != nil {
- return nil, err
- }
- return s.client.Do(req, nil)
- }
- // ListSnippetDiscussionsOptions represents the available ListSnippetDiscussions()
- // options.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#list-all-snippet-discussions
- type ListSnippetDiscussionsOptions ListOptions
- // ListSnippetDiscussions gets a list of all discussions for a single
- // snippet. Snippet discussions are comments users can post to a snippet.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#list-all-snippet-discussions
- func (s *DiscussionsService) ListSnippetDiscussions(pid interface{}, snippet int, opt *ListSnippetDiscussionsOptions, options ...OptionFunc) ([]*Discussion, *Response, error) {
- project, err := parseID(pid)
- if err != nil {
- return nil, nil, err
- }
- u := fmt.Sprintf("projects/%s/snippets/%d/discussions", url.QueryEscape(project), snippet)
- req, err := s.client.NewRequest("GET", u, opt, options)
- if err != nil {
- return nil, nil, err
- }
- var ds []*Discussion
- resp, err := s.client.Do(req, &ds)
- if err != nil {
- return nil, resp, err
- }
- return ds, resp, err
- }
- // GetSnippetDiscussion returns a single discussion for a given snippet.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#get-single-snippet-discussion
- func (s *DiscussionsService) GetSnippetDiscussion(pid interface{}, snippet int, discussion string, options ...OptionFunc) (*Discussion, *Response, error) {
- project, err := parseID(pid)
- if err != nil {
- return nil, nil, err
- }
- u := fmt.Sprintf("projects/%s/snippets/%d/discussions/%s",
- url.QueryEscape(project),
- snippet,
- discussion,
- )
- req, err := s.client.NewRequest("GET", u, nil, options)
- if err != nil {
- return nil, nil, err
- }
- d := new(Discussion)
- resp, err := s.client.Do(req, d)
- if err != nil {
- return nil, resp, err
- }
- return d, resp, err
- }
- // CreateSnippetDiscussionOptions represents the available
- // CreateSnippetDiscussion() options.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#create-new-snippet-discussion
- type CreateSnippetDiscussionOptions struct {
- Body *string `url:"body,omitempty" json:"body,omitempty"`
- CreatedAt *time.Time `url:"created_at,omitempty" json:"created_at,omitempty"`
- }
- // CreateSnippetDiscussion creates a new discussion for a single snippet.
- // Snippet discussions are comments users can post to a snippet.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#create-new-snippet-discussion
- func (s *DiscussionsService) CreateSnippetDiscussion(pid interface{}, snippet int, opt *CreateSnippetDiscussionOptions, options ...OptionFunc) (*Discussion, *Response, error) {
- project, err := parseID(pid)
- if err != nil {
- return nil, nil, err
- }
- u := fmt.Sprintf("projects/%s/snippets/%d/discussions", url.QueryEscape(project), snippet)
- req, err := s.client.NewRequest("POST", u, opt, options)
- if err != nil {
- return nil, nil, err
- }
- d := new(Discussion)
- resp, err := s.client.Do(req, d)
- if err != nil {
- return nil, resp, err
- }
- return d, resp, err
- }
- // AddSnippetDiscussionNoteOptions represents the available
- // AddSnippetDiscussionNote() options.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#add-note-to-existing-snippet-discussion
- type AddSnippetDiscussionNoteOptions struct {
- Body *string `url:"body,omitempty" json:"body,omitempty"`
- CreatedAt *time.Time `url:"created_at,omitempty" json:"created_at,omitempty"`
- }
- // AddSnippetDiscussionNote creates a new discussion to a single project
- // snippet.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#add-note-to-existing-snippet-discussion
- func (s *DiscussionsService) AddSnippetDiscussionNote(pid interface{}, snippet int, discussion string, opt *AddSnippetDiscussionNoteOptions, options ...OptionFunc) (*Note, *Response, error) {
- project, err := parseID(pid)
- if err != nil {
- return nil, nil, err
- }
- u := fmt.Sprintf("projects/%s/snippets/%d/discussions/%s/notes",
- url.QueryEscape(project),
- snippet,
- discussion,
- )
- req, err := s.client.NewRequest("POST", u, opt, options)
- if err != nil {
- return nil, nil, err
- }
- n := new(Note)
- resp, err := s.client.Do(req, n)
- if err != nil {
- return nil, resp, err
- }
- return n, resp, err
- }
- // UpdateSnippetDiscussionNoteOptions represents the available
- // UpdateSnippetDiscussion() options.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#modify-existing-snippet-discussion-note
- type UpdateSnippetDiscussionNoteOptions struct {
- Body *string `url:"body,omitempty" json:"body,omitempty"`
- CreatedAt *time.Time `url:"created_at,omitempty" json:"created_at,omitempty"`
- }
- // UpdateSnippetDiscussionNote modifies existing discussion of a snippet.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#modify-existing-snippet-discussion-note
- func (s *DiscussionsService) UpdateSnippetDiscussionNote(pid interface{}, snippet int, discussion string, note int, opt *UpdateSnippetDiscussionNoteOptions, options ...OptionFunc) (*Note, *Response, error) {
- project, err := parseID(pid)
- if err != nil {
- return nil, nil, err
- }
- u := fmt.Sprintf("projects/%s/snippets/%d/discussions/%s/notes/%d",
- url.QueryEscape(project),
- snippet,
- discussion,
- note,
- )
- req, err := s.client.NewRequest("PUT", u, opt, options)
- if err != nil {
- return nil, nil, err
- }
- n := new(Note)
- resp, err := s.client.Do(req, n)
- if err != nil {
- return nil, resp, err
- }
- return n, resp, err
- }
- // DeleteSnippetDiscussionNote deletes an existing discussion of a snippet.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#delete-a-snippet-discussion-note
- func (s *DiscussionsService) DeleteSnippetDiscussionNote(pid interface{}, snippet int, discussion string, note int, options ...OptionFunc) (*Response, error) {
- project, err := parseID(pid)
- if err != nil {
- return nil, err
- }
- u := fmt.Sprintf("projects/%s/snippets/%d/discussions/%s/notes/%d",
- url.QueryEscape(project),
- snippet,
- discussion,
- note,
- )
- req, err := s.client.NewRequest("DELETE", u, nil, options)
- if err != nil {
- return nil, err
- }
- return s.client.Do(req, nil)
- }
- // ListGroupEpicDiscussionsOptions represents the available
- // ListEpicDiscussions() options.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ee/api/discussions.html#list-all-epic-discussions
- type ListGroupEpicDiscussionsOptions ListOptions
- // ListGroupEpicDiscussions gets a list of all discussions for a single
- // epic. Epic discussions are comments users can post to a epic.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ee/api/discussions.html#list-all-epic-discussions
- func (s *DiscussionsService) ListGroupEpicDiscussions(gid interface{}, epic int, opt *ListGroupEpicDiscussionsOptions, options ...OptionFunc) ([]*Discussion, *Response, error) {
- group, err := parseID(gid)
- if err != nil {
- return nil, nil, err
- }
- u := fmt.Sprintf("groups/%s/epics/%d/discussions",
- url.QueryEscape(group),
- epic,
- )
- req, err := s.client.NewRequest("GET", u, opt, options)
- if err != nil {
- return nil, nil, err
- }
- var ds []*Discussion
- resp, err := s.client.Do(req, &ds)
- if err != nil {
- return nil, resp, err
- }
- return ds, resp, err
- }
- // GetEpicDiscussion returns a single discussion for a given epic.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ee/api/discussions.html#get-single-epic-discussion
- func (s *DiscussionsService) GetEpicDiscussion(gid interface{}, epic int, discussion string, options ...OptionFunc) (*Discussion, *Response, error) {
- group, err := parseID(gid)
- if err != nil {
- return nil, nil, err
- }
- u := fmt.Sprintf("groups/%s/epics/%d/discussions/%s",
- url.QueryEscape(group),
- epic,
- discussion,
- )
- req, err := s.client.NewRequest("GET", u, nil, options)
- if err != nil {
- return nil, nil, err
- }
- d := new(Discussion)
- resp, err := s.client.Do(req, d)
- if err != nil {
- return nil, resp, err
- }
- return d, resp, err
- }
- // CreateEpicDiscussionOptions represents the available CreateEpicDiscussion()
- // options.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ee/api/discussions.html#create-new-epic-discussion
- type CreateEpicDiscussionOptions struct {
- Body *string `url:"body,omitempty" json:"body,omitempty"`
- CreatedAt *time.Time `url:"created_at,omitempty" json:"created_at,omitempty"`
- }
- // CreateEpicDiscussion creates a new discussion for a single epic. Epic
- // discussions are comments users can post to a epic.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ee/api/discussions.html#create-new-epic-discussion
- func (s *DiscussionsService) CreateEpicDiscussion(gid interface{}, epic int, opt *CreateEpicDiscussionOptions, options ...OptionFunc) (*Discussion, *Response, error) {
- group, err := parseID(gid)
- if err != nil {
- return nil, nil, err
- }
- u := fmt.Sprintf("groups/%s/epics/%d/discussions",
- url.QueryEscape(group),
- epic,
- )
- req, err := s.client.NewRequest("POST", u, opt, options)
- if err != nil {
- return nil, nil, err
- }
- d := new(Discussion)
- resp, err := s.client.Do(req, d)
- if err != nil {
- return nil, resp, err
- }
- return d, resp, err
- }
- // AddEpicDiscussionNoteOptions represents the available
- // AddEpicDiscussionNote() options.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ee/api/discussions.html#add-note-to-existing-epic-discussion
- type AddEpicDiscussionNoteOptions struct {
- Body *string `url:"body,omitempty" json:"body,omitempty"`
- CreatedAt *time.Time `url:"created_at,omitempty" json:"created_at,omitempty"`
- }
- // AddEpicDiscussionNote creates a new discussion to a single project epic.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ee/api/discussions.html#add-note-to-existing-epic-discussion
- func (s *DiscussionsService) AddEpicDiscussionNote(gid interface{}, epic int, discussion string, opt *AddEpicDiscussionNoteOptions, options ...OptionFunc) (*Note, *Response, error) {
- group, err := parseID(gid)
- if err != nil {
- return nil, nil, err
- }
- u := fmt.Sprintf("groups/%s/epics/%d/discussions/%s/notes",
- url.QueryEscape(group),
- epic,
- discussion,
- )
- req, err := s.client.NewRequest("POST", u, opt, options)
- if err != nil {
- return nil, nil, err
- }
- n := new(Note)
- resp, err := s.client.Do(req, n)
- if err != nil {
- return nil, resp, err
- }
- return n, resp, err
- }
- // UpdateEpicDiscussionNoteOptions represents the available UpdateEpicDiscussion()
- // options.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ee/api/discussions.html#modify-existing-epic-discussion-note
- type UpdateEpicDiscussionNoteOptions struct {
- Body *string `url:"body,omitempty" json:"body,omitempty"`
- CreatedAt *time.Time `url:"created_at,omitempty" json:"created_at,omitempty"`
- }
- // UpdateEpicDiscussionNote modifies existing discussion of a epic.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ee/api/discussions.html#modify-existing-epic-discussion-note
- func (s *DiscussionsService) UpdateEpicDiscussionNote(gid interface{}, epic int, discussion string, note int, opt *UpdateEpicDiscussionNoteOptions, options ...OptionFunc) (*Note, *Response, error) {
- group, err := parseID(gid)
- if err != nil {
- return nil, nil, err
- }
- u := fmt.Sprintf("groups/%s/epics/%d/discussions/%s/notes/%d",
- url.QueryEscape(group),
- epic,
- discussion,
- note,
- )
- req, err := s.client.NewRequest("PUT", u, opt, options)
- if err != nil {
- return nil, nil, err
- }
- n := new(Note)
- resp, err := s.client.Do(req, n)
- if err != nil {
- return nil, resp, err
- }
- return n, resp, err
- }
- // DeleteEpicDiscussionNote deletes an existing discussion of a epic.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ee/api/discussions.html#delete-an-epic-discussion-note
- func (s *DiscussionsService) DeleteEpicDiscussionNote(gid interface{}, epic int, discussion string, note int, options ...OptionFunc) (*Response, error) {
- group, err := parseID(gid)
- if err != nil {
- return nil, err
- }
- u := fmt.Sprintf("groups/%s/epics/%d/discussions/%s/notes/%d",
- url.QueryEscape(group),
- epic,
- discussion,
- note,
- )
- req, err := s.client.NewRequest("DELETE", u, nil, options)
- if err != nil {
- return nil, err
- }
- return s.client.Do(req, nil)
- }
- // ListMergeRequestDiscussionsOptions represents the available
- // ListMergeRequestDiscussions() options.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#list-all-merge-request-discussions
- type ListMergeRequestDiscussionsOptions ListOptions
- // ListMergeRequestDiscussions gets a list of all discussions for a single
- // merge request.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#list-all-merge-request-discussions
- func (s *DiscussionsService) ListMergeRequestDiscussions(pid interface{}, mergeRequest int, opt *ListMergeRequestDiscussionsOptions, options ...OptionFunc) ([]*Discussion, *Response, error) {
- project, err := parseID(pid)
- if err != nil {
- return nil, nil, err
- }
- u := fmt.Sprintf("projects/%s/merge_requests/%d/discussions",
- url.QueryEscape(project),
- mergeRequest,
- )
- req, err := s.client.NewRequest("GET", u, opt, options)
- if err != nil {
- return nil, nil, err
- }
- var ds []*Discussion
- resp, err := s.client.Do(req, &ds)
- if err != nil {
- return nil, resp, err
- }
- return ds, resp, err
- }
- // GetMergeRequestDiscussion returns a single discussion for a given merge
- // request.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#get-single-merge-request-discussion
- func (s *DiscussionsService) GetMergeRequestDiscussion(pid interface{}, mergeRequest int, discussion string, options ...OptionFunc) (*Discussion, *Response, error) {
- project, err := parseID(pid)
- if err != nil {
- return nil, nil, err
- }
- u := fmt.Sprintf("projects/%s/merge_requests/%d/discussions/%s",
- url.QueryEscape(project),
- mergeRequest,
- discussion,
- )
- req, err := s.client.NewRequest("GET", u, nil, options)
- if err != nil {
- return nil, nil, err
- }
- d := new(Discussion)
- resp, err := s.client.Do(req, d)
- if err != nil {
- return nil, resp, err
- }
- return d, resp, err
- }
- // CreateMergeRequestDiscussionOptions represents the available
- // CreateMergeRequestDiscussion() options.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#create-new-merge-request-discussion
- type CreateMergeRequestDiscussionOptions struct {
- Body *string `url:"body,omitempty" json:"body,omitempty"`
- CreatedAt *time.Time `url:"created_at,omitempty" json:"created_at,omitempty"`
- Position *NotePosition `url:"position,omitempty" json:"position,omitempty"`
- }
- // CreateMergeRequestDiscussion creates a new discussion for a single merge
- // request.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#create-new-merge-request-discussion
- func (s *DiscussionsService) CreateMergeRequestDiscussion(pid interface{}, mergeRequest int, opt *CreateMergeRequestDiscussionOptions, options ...OptionFunc) (*Discussion, *Response, error) {
- project, err := parseID(pid)
- if err != nil {
- return nil, nil, err
- }
- u := fmt.Sprintf("projects/%s/merge_requests/%d/discussions",
- url.QueryEscape(project),
- mergeRequest,
- )
- req, err := s.client.NewRequest("POST", u, opt, options)
- if err != nil {
- return nil, nil, err
- }
- d := new(Discussion)
- resp, err := s.client.Do(req, d)
- if err != nil {
- return nil, resp, err
- }
- return d, resp, err
- }
- // ResolveMergeRequestDiscussionOptions represents the available
- // ResolveMergeRequestDiscussion() options.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ee/api/discussions.html#resolve-a-merge-request-discussion
- type ResolveMergeRequestDiscussionOptions struct {
- Resolved *bool `url:"resolved,omitempty" json:"resolved,omitempty"`
- }
- // ResolveMergeRequestDiscussion resolves/unresolves whole discussion of a merge
- // request.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ee/api/discussions.html#resolve-a-merge-request-discussion
- func (s *DiscussionsService) ResolveMergeRequestDiscussion(pid interface{}, mergeRequest int, discussion string, opt *ResolveMergeRequestDiscussionOptions, options ...OptionFunc) (*Discussion, *Response, error) {
- project, err := parseID(pid)
- if err != nil {
- return nil, nil, err
- }
- u := fmt.Sprintf("projects/%s/merge_requests/%d/discussions/%s",
- url.QueryEscape(project),
- mergeRequest,
- discussion,
- )
- req, err := s.client.NewRequest("PUT", u, opt, options)
- if err != nil {
- return nil, nil, err
- }
- d := new(Discussion)
- resp, err := s.client.Do(req, d)
- if err != nil {
- return nil, resp, err
- }
- return d, resp, err
- }
- // AddMergeRequestDiscussionNoteOptions represents the available
- // AddMergeRequestDiscussionNote() options.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#add-note-to-existing-merge-request-discussion
- type AddMergeRequestDiscussionNoteOptions struct {
- Body *string `url:"body,omitempty" json:"body,omitempty"`
- CreatedAt *time.Time `url:"created_at,omitempty" json:"created_at,omitempty"`
- }
- // AddMergeRequestDiscussionNote creates a new discussion to a single project
- // merge request.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#add-note-to-existing-merge-request-discussion
- func (s *DiscussionsService) AddMergeRequestDiscussionNote(pid interface{}, mergeRequest int, discussion string, opt *AddMergeRequestDiscussionNoteOptions, options ...OptionFunc) (*Note, *Response, error) {
- project, err := parseID(pid)
- if err != nil {
- return nil, nil, err
- }
- u := fmt.Sprintf("projects/%s/merge_requests/%d/discussions/%s/notes",
- url.QueryEscape(project),
- mergeRequest,
- discussion,
- )
- req, err := s.client.NewRequest("POST", u, opt, options)
- if err != nil {
- return nil, nil, err
- }
- n := new(Note)
- resp, err := s.client.Do(req, n)
- if err != nil {
- return nil, resp, err
- }
- return n, resp, err
- }
- // UpdateMergeRequestDiscussionNoteOptions represents the available
- // UpdateMergeRequestDiscussion() options.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#modify-existing-merge-request-discussion-note
- type UpdateMergeRequestDiscussionNoteOptions struct {
- Body *string `url:"body,omitempty" json:"body,omitempty"`
- CreatedAt *time.Time `url:"created_at,omitempty" json:"created_at,omitempty"`
- Resolved *bool `url:"resolved,omitempty" json:"resolved,omitempty"`
- }
- // UpdateMergeRequestDiscussionNote modifies existing discussion of a merge
- // request.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#modify-existing-merge-request-discussion-note
- func (s *DiscussionsService) UpdateMergeRequestDiscussionNote(pid interface{}, mergeRequest int, discussion string, note int, opt *UpdateMergeRequestDiscussionNoteOptions, options ...OptionFunc) (*Note, *Response, error) {
- project, err := parseID(pid)
- if err != nil {
- return nil, nil, err
- }
- u := fmt.Sprintf("projects/%s/merge_requests/%d/discussions/%s/notes/%d",
- url.QueryEscape(project),
- mergeRequest,
- discussion,
- note,
- )
- req, err := s.client.NewRequest("PUT", u, opt, options)
- if err != nil {
- return nil, nil, err
- }
- n := new(Note)
- resp, err := s.client.Do(req, n)
- if err != nil {
- return nil, resp, err
- }
- return n, resp, err
- }
- // DeleteMergeRequestDiscussionNote deletes an existing discussion of a merge
- // request.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#delete-a-merge-request-discussion-note
- func (s *DiscussionsService) DeleteMergeRequestDiscussionNote(pid interface{}, mergeRequest int, discussion string, note int, options ...OptionFunc) (*Response, error) {
- project, err := parseID(pid)
- if err != nil {
- return nil, err
- }
- u := fmt.Sprintf("projects/%s/merge_requests/%d/discussions/%s/notes/%d",
- url.QueryEscape(project),
- mergeRequest,
- discussion,
- note,
- )
- req, err := s.client.NewRequest("DELETE", u, nil, options)
- if err != nil {
- return nil, err
- }
- return s.client.Do(req, nil)
- }
- // ListCommitDiscussionsOptions represents the available
- // ListCommitDiscussions() options.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#list-project-commit-discussions
- type ListCommitDiscussionsOptions ListOptions
- // ListCommitDiscussions gets a list of all discussions for a single
- // commit.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#list-project-commit-discussions
- func (s *DiscussionsService) ListCommitDiscussions(pid interface{}, commit string, opt *ListCommitDiscussionsOptions, options ...OptionFunc) ([]*Discussion, *Response, error) {
- project, err := parseID(pid)
- if err != nil {
- return nil, nil, err
- }
- u := fmt.Sprintf("projects/%s/repository/commits/%s/discussions",
- url.QueryEscape(project),
- commit,
- )
- req, err := s.client.NewRequest("GET", u, opt, options)
- if err != nil {
- return nil, nil, err
- }
- var ds []*Discussion
- resp, err := s.client.Do(req, &ds)
- if err != nil {
- return nil, resp, err
- }
- return ds, resp, err
- }
- // GetCommitDiscussion returns a single discussion for a specific project
- // commit.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#get-single-commit-discussion
- func (s *DiscussionsService) GetCommitDiscussion(pid interface{}, commit string, discussion string, options ...OptionFunc) (*Discussion, *Response, error) {
- project, err := parseID(pid)
- if err != nil {
- return nil, nil, err
- }
- u := fmt.Sprintf("projects/%s/repository/commits/%s/discussions/%s",
- url.QueryEscape(project),
- commit,
- discussion,
- )
- req, err := s.client.NewRequest("GET", u, nil, options)
- if err != nil {
- return nil, nil, err
- }
- d := new(Discussion)
- resp, err := s.client.Do(req, d)
- if err != nil {
- return nil, resp, err
- }
- return d, resp, err
- }
- // CreateCommitDiscussionOptions represents the available
- // CreateCommitDiscussion() options.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#create-new-commit-discussion
- type CreateCommitDiscussionOptions struct {
- Body *string `url:"body,omitempty" json:"body,omitempty"`
- CreatedAt *time.Time `url:"created_at,omitempty" json:"created_at,omitempty"`
- Position *NotePosition `url:"position,omitempty" json:"position,omitempty"`
- }
- // CreateCommitDiscussion creates a new discussion to a single project commit.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#create-new-commit-discussion
- func (s *DiscussionsService) CreateCommitDiscussion(pid interface{}, commit string, opt *CreateCommitDiscussionOptions, options ...OptionFunc) (*Discussion, *Response, error) {
- project, err := parseID(pid)
- if err != nil {
- return nil, nil, err
- }
- u := fmt.Sprintf("projects/%s/repository/commits/%s/discussions",
- url.QueryEscape(project),
- commit,
- )
- req, err := s.client.NewRequest("POST", u, opt, options)
- if err != nil {
- return nil, nil, err
- }
- d := new(Discussion)
- resp, err := s.client.Do(req, d)
- if err != nil {
- return nil, resp, err
- }
- return d, resp, err
- }
- // AddCommitDiscussionNoteOptions represents the available
- // AddCommitDiscussionNote() options.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#add-note-to-existing-commit-discussion
- type AddCommitDiscussionNoteOptions struct {
- Body *string `url:"body,omitempty" json:"body,omitempty"`
- CreatedAt *time.Time `url:"created_at,omitempty" json:"created_at,omitempty"`
- }
- // AddCommitDiscussionNote creates a new discussion to a single project commit.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#add-note-to-existing-commit-discussion
- func (s *DiscussionsService) AddCommitDiscussionNote(pid interface{}, commit string, discussion string, opt *AddCommitDiscussionNoteOptions, options ...OptionFunc) (*Note, *Response, error) {
- project, err := parseID(pid)
- if err != nil {
- return nil, nil, err
- }
- u := fmt.Sprintf("projects/%s/repository/commits/%s/discussions/%s/notes",
- url.QueryEscape(project),
- commit,
- discussion,
- )
- req, err := s.client.NewRequest("POST", u, opt, options)
- if err != nil {
- return nil, nil, err
- }
- n := new(Note)
- resp, err := s.client.Do(req, n)
- if err != nil {
- return nil, resp, err
- }
- return n, resp, err
- }
- // UpdateCommitDiscussionNoteOptions represents the available
- // UpdateCommitDiscussion() options.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#modify-existing-commit-discussion-note
- type UpdateCommitDiscussionNoteOptions struct {
- Body *string `url:"body,omitempty" json:"body,omitempty"`
- CreatedAt *time.Time `url:"created_at,omitempty" json:"created_at,omitempty"`
- }
- // UpdateCommitDiscussionNote modifies existing discussion of an commit.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#modify-existing-commit-discussion-note
- func (s *DiscussionsService) UpdateCommitDiscussionNote(pid interface{}, commit string, discussion string, note int, opt *UpdateCommitDiscussionNoteOptions, options ...OptionFunc) (*Note, *Response, error) {
- project, err := parseID(pid)
- if err != nil {
- return nil, nil, err
- }
- u := fmt.Sprintf("projects/%s/repository/commits/%s/discussions/%s/notes/%d",
- url.QueryEscape(project),
- commit,
- discussion,
- note,
- )
- req, err := s.client.NewRequest("PUT", u, opt, options)
- if err != nil {
- return nil, nil, err
- }
- n := new(Note)
- resp, err := s.client.Do(req, n)
- if err != nil {
- return nil, resp, err
- }
- return n, resp, err
- }
- // DeleteCommitDiscussionNote deletes an existing discussion of an commit.
- //
- // GitLab API docs:
- // https://docs.gitlab.com/ce/api/discussions.html#delete-an-commit-discussion-note
- func (s *DiscussionsService) DeleteCommitDiscussionNote(pid interface{}, commit string, discussion string, note int, options ...OptionFunc) (*Response, error) {
- project, err := parseID(pid)
- if err != nil {
- return nil, err
- }
- u := fmt.Sprintf("projects/%s/repository/commits/%s/discussions/%s/notes/%d",
- url.QueryEscape(project),
- commit,
- discussion,
- note,
- )
- req, err := s.client.NewRequest("DELETE", u, nil, options)
- if err != nil {
- return nil, err
- }
- return s.client.Do(req, nil)
- }
|