| Module | Gitlab::Client::Projects |
| In: |
lib/gitlab/client/projects.rb
|
Defines methods related to projects. @see github.com/gitlabhq/gitlabhq/blob/master/doc/api/projects.md
Adds a project git hook. See: docs.gitlab.com/ee/api/projects.html#add-project-git-hook
@example
Gitlab.add_git_hook(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 git hook.
Adds a new hook to the project.
@example
Gitlab.add_project_hook(42, 'https://api.example.net/v1/webhooks/ci')
@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.
Adds a user to project team.
@example
Gitlab.add_team_member('gitlab', 2, 40)
@param [Integer, String] project The ID or name of a project. @param [Integer] id The ID of a user. @param [Integer] access_level The access level to project. @param [Hash] options A customizable set of options. @return [Gitlab::ObjectifiedHash] Information about added team member.
Creates a new deploy key.
@example
Gitlab.create_deploy_key(42, 'My Key', 'Key contents')
@param [Integer] project The ID 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.
Forks a project into the user namespace.
@example
Gitlab.create_fork(42)
Gitlab.create_fork(42, { sudo: 'another_username' })
@param [Integer] project The ID 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.
Creates a new project.
@example
Gitlab.create_project('gitlab')
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). @option options [Boolean] :snippets_enabled The snippets integration for a project (0 = false, 1 = true). @option options [Boolean] :merge_requests_enabled The merge requests functionality for a project (0 = false, 1 = true). @option options [Boolean] :public The setting for making a project public (0 = false, 1 = true). @option options [Integer] :user_id The user/owner id of a project. @return [Gitlab::ObjectifiedHash] Information about created project.
Deletes a deploy key from project.
@example
Gitlab.delete_deploy_key(42, 1)
@param [Integer] project The ID of a project. @param [Integer] id The ID of a deploy key. @return [Gitlab::ObjectifiedHash] Information about deleted deploy key.
Deletes a git hook from a project. See: docs.gitlab.com/ee/api/projects.html#delete-project-git-hook
@example
Gitlab.delete_git_hook(42)
@param [Integer] id The ID of a project. @return [Gitlab::ObjectifiedHash] Information about deleted git hook.
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.
Deletes a hook from project.
@example
Gitlab.delete_project_hook('gitlab', 4)
@param [Integer, String] project The ID or name of a project. @param [String] id The ID of the hook. @return [Gitlab::ObjectifiedHash] Information about deleted hook.
Gets a single project deploy key.
@example
Gitlab.deploy_key(42, 1)
@param [Integer, String] project The ID of a project. @param [Integer] id The ID of a deploy key. @return [Gitlab::ObjectifiedHash]
Gets a project deploy keys.
@example
Gitlab.deploy_keys(42)
@param [Integer] project The ID 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>]
Updates a project git hook. See: docs.gitlab.com/ee/api/projects.html#edit-project-git-hook
@example
Gitlab.edit_git_hook(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 git hook.
Updates an existing project.
@example
Gitlab.edit_project(42)
Gitlab.edit_project(42, { name: 'project_name' })
@param [Integer] project The ID 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.
Updates a project hook URL.
@example
Gitlab.edit_project_hook(42, 1, 'https://api.example.net/v1/webhooks/ci')
@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.
Updates a team member‘s project access level.
@example
Gitlab.edit_team_member('gitlab', 3, 20)
@param [Integer, String] project The ID or name of a project. @param [Integer] id The ID of a user. @param [Integer] access_level The access level to project. @param [Hash] options A customizable set of options. @return [Array<Gitlab::ObjectifiedHash>] Information about updated team member.
Gets a project git hook. See: docs.gitlab.com/ee/api/projects.html#show-project-git-hooks
@example
Gitlab.git_hook(42)
@param [Integer] id The ID of a project. @return [Gitlab::ObjectifiedHash]
Gets information about a project.
@example
Gitlab.project(3)
Gitlab.project('gitlab')
@param [Integer, String] id The ID or name of a project. @return [Gitlab::ObjectifiedHash]
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>]
Gets a project hook.
@example
Gitlab.project_hook(42, 5)
Gitlab.project_hook('gitlab', 5)
@param [Integer, String] project The ID or name of a project. @param [Integer] id The ID of a hook. @return [Gitlab::ObjectifiedHash]
Gets a list of project hooks.
@example
Gitlab.project_hooks(42)
Gitlab.project_hooks('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>]
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>]
Gets a list of projects owned by the authenticated user.
@example
Gitlab.projects
@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>]
Removes a user from project team.
@example
Gitlab.remove_team_member('gitlab', 2)
@param [Integer, String] project The ID or name of a project. @param [Integer] id The ID of a user. @param [Hash] options A customizable set of options. @return [Gitlab::ObjectifiedHash] Information about removed team member.
Gets a project team member.
@example
Gitlab.team_member('gitlab', 2)
@param [Integer, String] project The ID or name of a project. @param [Integer] id The ID of a project team member. @return [Gitlab::ObjectifiedHash]
Gets a list of project team members.
@example
Gitlab.team_members(42)
Gitlab.team_members('gitlab')
@param [Integer, String] project The ID or name of a project. @param [Hash] options A customizable set of options. @option options [String] :query The search query. @option options [Integer] :page The page number. @option options [Integer] :per_page The number of results per page. @return [Array<Gitlab::ObjectifiedHash>]