gitlab 3.0.0 → 4.0.0

data/lib/gitlab/client/milestones.rb

@@ -1,18 +1,19 @@
 class Gitlab::Client
   # Defines methods related to milestones.
+  # @see https://docs.gitlab.com/ce/api/milestones.html
   module Milestones
     # Gets a list of project's milestones.
     #
     # @example
     #   Gitlab.milestones(5)
     #
-    # @param  [Integer] project The ID of a project.
+    # @param  [Integer, String] project The ID or name of a project.
     # @param  [Hash] options A customizable set of options.
     # @option options [Integer] :page The page number.
     # @option options [Integer] :per_page The number of results per page.
     # @return [Array<Gitlab::ObjectifiedHash>]
     def milestones(project, options={})
-      get("/projects/#{project}/milestones", :query => options)
+      get("/projects/#{url_encode project}/milestones", query: options)
     end
 
     # Gets a single milestone.
@@ -20,29 +21,63 @@ class Gitlab::Client
     # @example
     #   Gitlab.milestone(5, 36)
     #
-    # @param  [Integer, String] project The ID of a project.
+    # @param  [Integer, String] project The ID or name of a project.
     # @param  [Integer] id The ID of a milestone.
     # @return [Gitlab::ObjectifiedHash]
     def milestone(project, id)
-      get("/projects/#{project}/milestones/#{id}")
+      get("/projects/#{url_encode project}/milestones/#{id}")
+    end
+
+    # Gets the issues of a given milestone.
+    #
+    # @example
+    #   Gitlab.milestone_issues(5, 2)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer, String] milestone The ID of a milestone.
+    # @option options [Integer] :page The page number.
+    # @option options [Integer] :per_page The number of results per page.
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def milestone_issues(project, milestone, options={})
+      get("/projects/#{url_encode project}/milestones/#{milestone}/issues", query: options)
+    end
+
+    # Gets the merge_requests of a given milestone.
+    #
+    # @example
+    #   Gitlab.milestone_merge_requests(5, 2)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer, String] milestone The ID of a milestone.
+    # @option options [Integer] :page The page number.
+    # @option options [Integer] :per_page The number of results per page.
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def milestone_merge_requests(project, milestone, options={})
+      get("/projects/#{url_encode project}/milestones/#{milestone}/merge_requests", query: options)
     end
 
     # Creates a new milestone.
     #
-    # @param  [Integer] project The ID of a project.
+    # @example
+    #   Gitlab.create_milestone(5, 'v1.0')
+    #
+    # @param  [Integer, String] project The ID or name of a project.
     # @param  [String] title The title of a milestone.
     # @param  [Hash] options A customizable set of options.
     # @option options [String] :description The description of a milestone.
     # @option options [String] :due_date The due date of a milestone.
     # @return [Gitlab::ObjectifiedHash] Information about created milestone.
     def create_milestone(project, title, options={})
-      body = {:title => title}.merge(options)
-      post("/projects/#{project}/milestones", :body => body)
+      body = { title: title }.merge(options)
+      post("/projects/#{url_encode project}/milestones", body: body)
     end
 
     # Updates a milestone.
     #
-    # @param  [Integer] project The ID of a project.
+    # @example
+    #   Gitlab.edit_milestone(5, 2, { state_event: 'activate' })
+    #
+    # @param  [Integer, String] project The ID or name of a project.
     # @param  [Integer] id The ID of a milestone.
     # @param  [Hash] options A customizable set of options.
     # @option options [String] :title The title of a milestone.
@@ -51,7 +86,7 @@ class Gitlab::Client
     # @option options [String] :state_event The state of a milestone ('close' or 'activate').
     # @return [Gitlab::ObjectifiedHash] Information about updated milestone.
     def edit_milestone(project, id, options={})
-      put("/projects/#{project}/milestones/#{id}", :body => options)
+      put("/projects/#{url_encode project}/milestones/#{id}", body: options)
     end
   end
 end

data/lib/gitlab/client/namespaces.rb

@@ -0,0 +1,20 @@
+class Gitlab::Client
+  # Defines methods related to namespaces
+  # @see https://docs.gitlab.com/ce/api/namespaces.html
+  module Namespaces
+    # Gets a list of namespaces.
+    # @see https://docs.gitlab.com/ce/api/namespaces.html#list-namespaces
+    #
+    # @example
+    #   Gitlab.namespaces
+    #
+    # @param  [Hash] options A customizable set of options.
+    # @options options [Integer] :page The page number.
+    # @options options [Integer] :per_page The number of results per page.
+    # @options opttion [String]  :search The string to search for.
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def namespaces(options={})
+      get("/namespaces", query: options)
+    end
+  end
+end

data/lib/gitlab/client/notes.rb

@@ -1,5 +1,6 @@
 class Gitlab::Client
   # Defines methods related to notes.
+  # @see https://docs.gitlab.com/ce/api/notes.html
   module Notes
     # Gets a list of projects notes.
     #
@@ -7,9 +8,11 @@ class Gitlab::Client
     #   Gitlab.notes(5)
     #
     # @param [Integer] project The ID of a project.
+    # @option options [Integer] :page The page number.
+    # @option options [Integer] :per_page The number of results per page.
     # @return [Array<Gitlab::ObjectifiedHash>]
-    def notes(project)
-      get("/projects/#{project}/notes")
+    def notes(project, options={})
+      get("/projects/#{url_encode project}/notes", query: options)
     end
 
     # Gets a list of notes for a issue.
@@ -19,9 +22,11 @@ class Gitlab::Client
     #
     # @param [Integer] project The ID of a project.
     # @param [Integer] issue The ID of an issue.
+    # @option options [Integer] :page The page number.
+    # @option options [Integer] :per_page The number of results per page.
     # @return [Array<Gitlab::ObjectifiedHash>]
-    def issue_notes(project, issue)
-      get("/projects/#{project}/issues/#{issue}/notes")
+    def issue_notes(project, issue, options={})
+      get("/projects/#{url_encode project}/issues/#{issue}/notes", query: options)
     end
 
     # Gets a list of notes for a snippet.
@@ -31,9 +36,25 @@ class Gitlab::Client
     #
     # @param [Integer] project The ID of a project.
     # @param [Integer] snippet The ID of a snippet.
+    # @option options [Integer] :page The page number.
+    # @option options [Integer] :per_page The number of results per page.
     # @return [Array<Gitlab::ObjectifiedHash>]
-    def snippet_notes(project, snippet)
-      get("/projects/#{project}/snippets/#{snippet}/notes")
+    def snippet_notes(project, snippet, options={})
+      get("/projects/#{url_encode project}/snippets/#{snippet}/notes", query: options)
+    end
+
+    # Gets a list of notes for a merge request.
+    #
+    # @example
+    #   Gitlab.merge_request_notes(5, 1)
+    #
+    # @param [Integer] project The ID of a project.
+    # @param [Integer] merge_request The ID of a merge request.
+    # @option options [Integer] :page The page number.
+    # @option options [Integer] :per_page The number of results per page.
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def merge_request_notes(project, merge_request, options={})
+      get("/projects/#{url_encode project}/merge_requests/#{merge_request}/notes", query: options)
     end
 
     # Gets a single wall note.
@@ -45,7 +66,7 @@ class Gitlab::Client
     # @param [Integer] id The ID of a note.
     # @return [Gitlab::ObjectifiedHash]
     def note(project, id)
-      get("/projects/#{project}/notes/#{id}")
+      get("/projects/#{url_encode project}/notes/#{id}")
     end
 
     # Gets a single issue note.
@@ -58,7 +79,7 @@ class Gitlab::Client
     # @param [Integer] id The ID of a note.
     # @return [Gitlab::ObjectifiedHash]
     def issue_note(project, issue, id)
-      get("/projects/#{project}/issues/#{issue}/notes/#{id}")
+      get("/projects/#{url_encode project}/issues/#{issue}/notes/#{id}")
     end
 
     # Gets a single snippet note.
@@ -68,39 +89,73 @@ class Gitlab::Client
     #
     # @param [Integer] project The ID of a project.
     # @param [Integer] snippet The ID of a snippet.
-    # @param [Integer] id The ID of an note.
+    # @param [Integer] id The ID of a note.
     # @return [Gitlab::ObjectifiedHash]
     def snippet_note(project, snippet, id)
-      get("/projects/#{project}/snippets/#{snippet}/notes/#{id}")
+      get("/projects/#{url_encode project}/snippets/#{snippet}/notes/#{id}")
+    end
+
+    # Gets a single merge_request note.
+    #
+    # @example
+    #   Gitlab.merge_request_note(5, 11, 3)
+    #
+    # @param [Integer] project The ID of a project.
+    # @param [Integer] merge_request The ID of a merge_request.
+    # @param [Integer] id The ID of a note.
+    # @return [Gitlab::ObjectifiedHash]
+    def merge_request_note(project, merge_request, id)
+      get("/projects/#{url_encode project}/merge_requests/#{merge_request}/notes/#{id}")
     end
 
     # Creates a new wall note.
     #
-    # @param  [Integer] project The ID of a project.
+    # @example
+    #   Gitlab.create_note(5, 'This is a wall note!')
+    #
+    # @param  [Integer, String] project The ID or name of a project.
     # @param  [String] body The body of a note.
     # @return [Gitlab::ObjectifiedHash] Information about created note.
     def create_note(project, body)
-      post("/projects/#{project}/notes", :body => {:body => body})
+      post("/projects/#{url_encode project}/notes", body: { body: body })
     end
 
     # Creates a new issue note.
     #
-    # @param  [Integer] project The ID of a project.
+    # @example
+    #   Gitlab.create_issue_note(6, 1, 'Adding a note to my issue.')
+    #
+    # @param  [Integer, String] project The ID or name of a project.
     # @param  [Integer] issue The ID of an issue.
     # @param  [String] body The body of a note.
     # @return [Gitlab::ObjectifiedHash] Information about created note.
     def create_issue_note(project, issue, body)
-      post("/projects/#{project}/issues/#{issue}/notes", :body => {:body => body})
+      post("/projects/#{url_encode project}/issues/#{issue}/notes", body: { body: body })
     end
 
     # Creates a new snippet note.
     #
-    # @param  [Integer] project The ID of a project.
+    # @example
+    #   Gitlab.create_snippet_note(3, 2, 'Look at this awesome snippet!')
+    #
+    # @param  [Integer, String] project The ID or name of a project.
     # @param  [Integer] snippet The ID of a snippet.
     # @param  [String] body The body of a note.
     # @return [Gitlab::ObjectifiedHash] Information about created note.
     def create_snippet_note(project, snippet, body)
-      post("/projects/#{project}/snippets/#{snippet}/notes", :body => {:body => body})
+      post("/projects/#{url_encode project}/snippets/#{snippet}/notes", body: { body: body })
+    end
+
+    # Creates a new note for a single merge request.
+    #
+    # @example
+    #   Gitlab.create_merge_request_note(5, 3, 'This MR is ready for review.')
+    #
+    # @param [Integer] project The ID of a project.
+    # @param [Integer] merge_request The ID of a merge request.
+    # @param [String] body The content of a note.
+    def create_merge_request_note(project, merge_request, body)
+      post("/projects/#{url_encode project}/merge_requests/#{merge_request}/notes", body: { body: body })
     end
   end
 end

data/lib/gitlab/client/pipelines.rb

@@ -0,0 +1,68 @@
+class Gitlab::Client
+  # Defines methods related to pipelines.
+  # @see https://docs.gitlab.com/ce/api/pipelines.html
+  module Pipelines
+    # Gets a list of project pipelines.
+    #
+    # @example
+    #   Gitlab.pipelines(5)
+    #   Gitlab.pipelines(5, { per_page: 10, page:  2 })
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Hash] options A customizable set of options.
+    # @option options [Integer] :page The page number.
+    # @option options [Integer] :per_page The number of results per page.
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def pipelines(project, options={})
+      get("/projects/#{url_encode project}/pipelines", query: options)
+    end
+
+    # Gets a single pipeline.
+    #
+    # @example
+    #   Gitlab.pipeline(5, 36)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of a pipeline.
+    # @return [Gitlab::ObjectifiedHash]
+    def pipeline(project, id)
+      get("/projects/#{url_encode project}/pipelines/#{id}")
+    end
+
+    # Create a pipeline.
+    #
+    # @example
+    #   Gitlab.create_pipeline(5, 'master')
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [String] ref Reference to commit.
+    # @return [Gitlab::ObjectifiedHash] The pipelines changes.
+    def create_pipeline(project, ref)
+      post("/projects/#{url_encode project}/pipeline?ref=#{ref}")
+    end
+
+    # Cancels a pipeline.
+    #
+    # @example
+    #   Gitlab.cancel_pipeline(5, 1)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of a pipeline.
+    # @return [Gitlab::ObjectifiedHash] The pipelines changes.
+    def cancel_pipeline(project, id)
+      post("/projects/#{url_encode project}/pipelines/#{id}/cancel")
+    end
+
+    # Retry a pipeline.
+    #
+    # @example
+    #   Gitlab.retry_pipeline(5, 1)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of a pipeline.
+    # @return [Array<Gitlab::ObjectifiedHash>] The pipelines changes.
+    def retry_pipeline(project, id)
+      post("/projects/#{url_encode project}/pipelines/#{id}/retry")
+    end
+  end
+end

data/lib/gitlab/client/projects.rb

@@ -1,5 +1,6 @@
 class Gitlab::Client
   # Defines methods related to projects.
+  # @see https://docs.gitlab.com/ce/api/projects.html
   module Projects
     # Gets a list of projects owned by the authenticated user.
     #
@@ -9,11 +10,34 @@ class Gitlab::Client
     # @param  [Hash] options A customizable set of options.
     # @option options [Integer] :page The page number.
     # @option options [Integer] :per_page The number of results per page.
+    # @option options [String] :scope Scope of projects. 'owned' for list of projects owned by the authenticated user, 'all' to get all projects (admin only)
     # @return [Array<Gitlab::ObjectifiedHash>]
     def projects(options={})
-      get("/projects", :query => options)
+      if options[:scope]
+        get("/projects/#{options[:scope]}", query: options)
+      else
+        get("/projects", query: options)
+      end
     end
 
+    # Search for projects by name.
+    #
+    # @example
+    #   Gitlab.project_search('gitlab')
+    #   Gitlab.project_search('gitlab', { order_by: 'last_activity_at' })
+    #   Gitlab.search_projects('gitlab', { order_by: 'name', sort: 'asc' })
+    #
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :per_page Number of projects to return per page
+    # @option options [String] :page The page to retrieve
+    # @option options [String] :order_by Return requests ordered by id, name, created_at or last_activity_at fields
+    # @option options [String] :sort Return requests sorted in asc or desc order
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def project_search(query, options={})
+      get("/projects/search/#{query}", query: options)
+    end
+    alias_method :search_projects, :project_search
+
     # Gets information about a project.
     #
     # @example
@@ -23,20 +47,36 @@ class Gitlab::Client
     # @param  [Integer, String] id The ID or name of a project.
     # @return [Gitlab::ObjectifiedHash]
     def project(id)
-      get("/projects/#{id}")
+      get("/projects/#{url_encode id}")
+    end
+
+    # Gets a list of project events.
+    #
+    # @example
+    #   Gitlab.project_events(42)
+    #   Gitlab.project_events('gitlab')
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Hash] options A customizable set of options.
+    # @option options [Integer] :page The page number.
+    # @option options [Integer] :per_page The number of results per page.
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def project_events(project, options={})
+      get("/projects/#{url_encode project}/events", query: options)
     end
 
     # Creates a new project.
     #
     # @example
     #   Gitlab.create_project('gitlab')
-    #   Gitlab.create_project('viking', :description => 'Awesome project')
-    #   Gitlab.create_project('Red', :wall_enabled => false)
+    #   Gitlab.create_project('viking', { description: 'Awesome project' })
+    #   Gitlab.create_project('Red', { wall_enabled: false })
     #
     # @param  [String] name The name of a project.
     # @param  [Hash] options A customizable set of options.
     # @option options [String] :description The description of a project.
     # @option options [String] :default_branch The default branch of a project.
+    # @option options [String] :namespace_id The namespace in which to create a project.
     # @option options [Boolean] :wiki_enabled The wiki integration for a project (0 = false, 1 = true).
     # @option options [Boolean] :wall_enabled The wall functionality for a project (0 = false, 1 = true).
     # @option options [Boolean] :issues_enabled The issues integration for a project (0 = false, 1 = true).
@@ -47,7 +87,18 @@ class Gitlab::Client
     # @return [Gitlab::ObjectifiedHash] Information about created project.
     def create_project(name, options={})
       url = options[:user_id] ? "/projects/user/#{options[:user_id]}" : "/projects"
-      post(url, :body => {:name => name}.merge(options))
+      post(url, body: { name: name }.merge(options))
+    end
+
+    # Deletes a project.
+    #
+    # @example
+    #   Gitlab.delete_project(4)
+    #
+    # @param  [Integer, String] id The ID or name of a project.
+    # @return [Gitlab::ObjectifiedHash] Information about deleted project.
+    def delete_project(id)
+      delete("/projects/#{id}")
     end
 
     # Gets a list of project team members.
@@ -63,7 +114,7 @@ class Gitlab::Client
     # @option options [Integer] :per_page The number of results per page.
     # @return [Array<Gitlab::ObjectifiedHash>]
     def team_members(project, options={})
-      get("/projects/#{project}/members", :query => options)
+      get("/projects/#{url_encode project}/members", query: options)
     end
 
     # Gets a project team member.
@@ -75,7 +126,7 @@ class Gitlab::Client
     # @param  [Integer] id The ID of a project team member.
     # @return [Gitlab::ObjectifiedHash]
     def team_member(project, id)
-      get("/projects/#{project}/members/#{id}")
+      get("/projects/#{url_encode project}/members/#{id}")
     end
 
     # Adds a user to project team.
@@ -89,7 +140,7 @@ class Gitlab::Client
     # @param  [Hash] options A customizable set of options.
     # @return [Gitlab::ObjectifiedHash] Information about added team member.
     def add_team_member(project, id, access_level)
-      post("/projects/#{project}/members", :body => {:user_id => id, :access_level => access_level})
+      post("/projects/#{url_encode project}/members", body: { user_id: id, access_level: access_level })
     end
 
     # Updates a team member's project access level.
@@ -103,7 +154,7 @@ class Gitlab::Client
     # @param  [Hash] options A customizable set of options.
     # @return [Array<Gitlab::ObjectifiedHash>] Information about updated team member.
     def edit_team_member(project, id, access_level)
-      put("/projects/#{project}/members/#{id}", :body => {:access_level => access_level})
+      put("/projects/#{url_encode project}/members/#{id}", body: { access_level: access_level })
     end
 
     # Removes a user from project team.
@@ -116,7 +167,7 @@ class Gitlab::Client
     # @param  [Hash] options A customizable set of options.
     # @return [Gitlab::ObjectifiedHash] Information about removed team member.
     def remove_team_member(project, id)
-      delete("/projects/#{project}/members/#{id}")
+      delete("/projects/#{url_encode project}/members/#{id}")
     end
 
     # Gets a list of project hooks.
@@ -131,7 +182,7 @@ class Gitlab::Client
     # @option options [Integer] :per_page The number of results per page.
     # @return [Array<Gitlab::ObjectifiedHash>]
     def project_hooks(project, options={})
-      get("/projects/#{project}/hooks", :query => options)
+      get("/projects/#{url_encode project}/hooks", query: options)
     end
 
     # Gets a project hook.
@@ -144,7 +195,7 @@ class Gitlab::Client
     # @param  [Integer] id The ID of a hook.
     # @return [Gitlab::ObjectifiedHash]
     def project_hook(project, id)
-      get("/projects/#{project}/hooks/#{id}")
+      get("/projects/#{url_encode project}/hooks/#{id}")
     end
 
     # Adds a new hook to the project.
@@ -154,9 +205,15 @@ class Gitlab::Client
     #
     # @param  [Integer, String] project The ID or name of a project.
     # @param  [String] url The hook URL.
+    # @param  [Hash] options A customizable set of options.
+    # @param  option [Boolean] :push_events Trigger hook on push events (0 = false, 1 = true)
+    # @param  option [Boolean] :issues_events Trigger hook on issues events (0 = false, 1 = true)
+    # @param  option [Boolean] :merge_requests_events Trigger hook on merge_requests events (0 = false, 1 = true)
+    # @param  option [Boolean] :tag_push_events Trigger hook on push_tag events (0 = false, 1 = true)
     # @return [Gitlab::ObjectifiedHash] Information about added hook.
-    def add_project_hook(project, url)
-      post("/projects/#{project}/hooks", :body => {:url => url})
+    def add_project_hook(project, url, options={})
+      body = { url: url }.merge(options)
+      post("/projects/#{url_encode project}/hooks", body: body)
     end
 
     # Updates a project hook URL.
@@ -167,9 +224,15 @@ class Gitlab::Client
     # @param  [Integer, String] project The ID or name of a project.
     # @param  [Integer] id The ID of the hook.
     # @param  [String] url The hook URL.
+    # @param  [Hash] options A customizable set of options.
+    # @param  option [Boolean] :push_events Trigger hook on push events (0 = false, 1 = true)
+    # @param  option [Boolean] :issues_events Trigger hook on issues events (0 = false, 1 = true)
+    # @param  option [Boolean] :merge_requests_events Trigger hook on merge_requests events (0 = false, 1 = true)
+    # @param  option [Boolean] :tag_push_events Trigger hook on push_tag events (0 = false, 1 = true)
     # @return [Gitlab::ObjectifiedHash] Information about updated hook.
-    def edit_project_hook(project, id, url)
-      put("/projects/#{project}/hooks/#{id}", :body => {:url => url})
+    def edit_project_hook(project, id, url, options={})
+      body = { url: url }.merge(options)
+      put("/projects/#{url_encode project}/hooks/#{id}", body: body)
     end
 
     # Deletes a hook from project.
@@ -181,7 +244,61 @@ class Gitlab::Client
     # @param  [String] id The ID of the hook.
     # @return [Gitlab::ObjectifiedHash] Information about deleted hook.
     def delete_project_hook(project, id)
-      delete("/projects/#{project}/hooks/#{id}")
+      delete("/projects/#{url_encode project}/hooks/#{id}")
+    end
+
+    # Gets a project push rule.
+    # @see https://docs.gitlab.com/ee/api/projects.html#show-project-push-rules
+    #
+    # @example
+    #   Gitlab.push_rule(42)
+    #
+    # @param  [Integer] id The ID of a project.
+    # @return [Gitlab::ObjectifiedHash]
+    def push_rule(id)
+      get("/projects/#{id}/push_rule")
+    end
+
+    # Adds a project push rule.
+    # @see https://docs.gitlab.com/ee/api/projects.html#add-project-push-rule
+    #
+    # @example
+    #   Gitlab.add_push_rule(42, { deny_delete_tag: false, commit_message_regex: '\\b[A-Z]{3}-[0-9]+\\b' })
+    #
+    # @param  [Integer] id The ID of a project.
+    # @param  [Hash] options A customizable set of options.
+    # @param  option [Boolean] :deny_delete_tag Do not allow users to remove git tags with git push (0 = false, 1 = true)
+    # @param  option [String] :commit_message_regex Commit message regex
+    # @return [Gitlab::ObjectifiedHash] Information about added push rule.
+    def add_push_rule(id, options={})
+      post("/projects/#{id}/push_rule", body: options)
+    end
+
+    # Updates a project push rule.
+    # @see https://docs.gitlab.com/ee/api/projects.html#edit-project-push-rule
+    #
+    # @example
+    #   Gitlab.edit_push_rule(42, { deny_delete_tag: false, commit_message_regex: '\\b[A-Z]{3}-[0-9]+\\b' })
+    #
+    # @param  [Integer] id The ID of a project.
+    # @param  [Hash] options A customizable set of options.
+    # @param  option [Boolean] :deny_delete_tag Do not allow users to remove git tags with git push (0 = false, 1 = true)
+    # @param  option [String] :commit_message_regex Commit message regex
+    # @return [Gitlab::ObjectifiedHash] Information about updated push rule.
+    def edit_push_rule(id, options={})
+      put("/projects/#{id}/push_rule", body: options)
+    end
+
+    # Deletes a push rule from a project.
+    # @see https://docs.gitlab.com/ee/api/projects.html#delete-project-push-rule
+    #
+    # @example
+    #   Gitlab.delete_push_rule(42)
+    #
+    # @param  [Integer] id The ID of a project.
+    # @return [Gitlab::ObjectifiedHash] Information about deleted push rule.
+    def delete_push_rule(id, options={})
+      delete("/projects/#{id}/push_rule")
     end
 
     # Mark this project as forked from the other
@@ -193,7 +310,7 @@ class Gitlab::Client
     # @param  [Integer] id The ID of the project it is forked from.
     # @return [Gitlab::ObjectifiedHash] Information about the forked project.
     def make_forked_from(project, id)
-      post("/projects/#{project}/fork/#{id}")
+      post("/projects/#{url_encode project}/fork/#{id}")
     end
 
     # Remove a forked_from relationship for a project.
@@ -205,7 +322,7 @@ class Gitlab::Client
     # @param  [Integer] project The ID of the project it is forked from
     # @return [Gitlab::ObjectifiedHash] Information about the forked project.
     def remove_forked(project)
-      delete("/projects/#{project}/fork")
+      delete("/projects/#{url_encode project}/fork")
     end
 
     # Gets a project deploy keys.
@@ -213,13 +330,13 @@ class Gitlab::Client
     # @example
     #   Gitlab.deploy_keys(42)
     #
-    # @param  [Integer] project The ID of a project.
+    # @param  [Integer, String] project The ID or name of a project.
     # @param  [Hash] options A customizable set of options.
     # @option options [Integer] :page The page number.
     # @option options [Integer] :per_page The number of results per page.
     # @return [Array<Gitlab::ObjectifiedHash>]
     def deploy_keys(project, options={})
-      get("/projects/#{project}/keys", :query => options)
+      get("/projects/#{url_encode project}/deploy_keys", query: options)
     end
 
     # Gets a single project deploy key.
@@ -227,11 +344,11 @@ class Gitlab::Client
     # @example
     #   Gitlab.deploy_key(42, 1)
     #
-    # @param  [Integer, String] project The ID of a project.
+    # @param  [Integer, String] project The ID or name of a project.
     # @param  [Integer] id The ID of a deploy key.
     # @return [Gitlab::ObjectifiedHash]
     def deploy_key(project, id)
-      get("/projects/#{project}/keys/#{id}")
+      get("/projects/#{url_encode project}/deploy_keys/#{id}")
     end
 
     # Creates a new deploy key.
@@ -239,12 +356,36 @@ class Gitlab::Client
     # @example
     #   Gitlab.create_deploy_key(42, 'My Key', 'Key contents')
     #
-    # @param  [Integer] project The ID of a project.
+    # @param  [Integer, String] project The ID or name of a project.
     # @param  [String] title The title of a deploy key.
     # @param  [String] key The content of a deploy key.
     # @return [Gitlab::ObjectifiedHash] Information about created deploy key.
     def create_deploy_key(project, title, key)
-      post("/projects/#{project}/keys", title: title, key: key)
+      post("/projects/#{url_encode project}/deploy_keys", body: { title: title, key: key })
+    end
+
+    # Enables a deploy key at the project.
+    #
+    # @example
+    #   Gitlab.enable_deploy_key(42, 66)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] key The ID of a deploy key.
+    # @return [Gitlab::ObjectifiedHash] Information about the enabled deploy key.
+    def enable_deploy_key(project, key)
+      post("/projects/#{url_encode project}/deploy_keys/#{key}/enable", body: { id: project, key_id: key })
+    end
+
+    # Disables a deploy key at the project.
+    #
+    # @example
+    #   Gitlab.disable_deploy_key(42, 66)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] key The ID of a deploy key.
+    # @return [Gitlab::ObjectifiedHash] Information about the disabled deploy key.
+    def disable_deploy_key(project, key)
+      post("/projects/#{url_encode project}/deploy_keys/#{key}/disable", body: { id: project, key_id: key })
     end
 
     # Deletes a deploy key from project.
@@ -252,11 +393,79 @@ class Gitlab::Client
     # @example
     #   Gitlab.delete_deploy_key(42, 1)
     #
-    # @param  [Integer] project The ID of a project.
+    # @param  [Integer, String] project The ID or name of a project.
     # @param  [Integer] id The ID of a deploy key.
     # @return [Gitlab::ObjectifiedHash] Information about deleted deploy key.
     def delete_deploy_key(project, id)
-      delete("/projects/#{project}/keys/#{id}")
+      delete("/projects/#{url_encode project}/deploy_keys/#{id}")
+    end
+
+    # Forks a project into the user namespace.
+    #
+    # @example
+    #   Gitlab.create_fork(42)
+    #   Gitlab.create_fork(42, { sudo: 'another_username' })
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :sudo The username the project will be forked for
+    # @return [Gitlab::ObjectifiedHash] Information about the forked project.
+    def create_fork(id, options={})
+      post("/projects/#{id}/fork", body: options)
+    end
+
+    # Updates an existing project.
+    #
+    # @example
+    #   Gitlab.edit_project(42)
+    #   Gitlab.edit_project(42, { name: 'project_name' })
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :name The name of a project
+    # @option options [String] :path The name of a project
+    # @option options [String] :description The name of a project
+    # @return [Gitlab::ObjectifiedHash] Information about the edited project.
+    def edit_project(id, options={})
+      put("/projects/#{id}", query: options)
+    end
+
+    # Share project with group.
+    #
+    # @example
+    #   Gitlab.share_project_with_group('gitlab', 2, 40)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of a group.
+    # @param  [Integer] group_access The access level to project.
+    def share_project_with_group(project, id, group_access)
+      post("/projects/#{url_encode project}/share", body: { group_id: id, group_access: group_access })
+    end
+
+    # Stars a project.
+    # @see https://docs.gitlab.com/ce/api/projects.html#star-a-project
+    # 
+    # @example
+    #   Gitlab.star_project(42)
+    #   Gitlab.star_project('gitlab-org/gitlab-ce')
+    # 
+    # @param  [Integer, String] id The ID or name of a project.
+    # @return [Gitlab::ObjectifiedHash] Information about starred project.
+    def star_project(id)
+      post("/projects/#{id}/star")
+    end
+
+    # Unstars a project.
+    # @see https://docs.gitlab.com/ce/api/projects.html#unstar-a-project
+    # 
+    # @example
+    #   Gitlab.unstar_project(42)
+    #   Gitlab.unstar_project('gitlab-org/gitlab-ce')
+    # 
+    # @param  [Integer, String] id The ID or name of a project.
+    # @return [Gitlab::ObjectifiedHash] Information about unstarred project.
+    def unstar_project(id)
+      delete("/projects/#{id}/star")
     end
   end
 end