Bitbucket\API\Groups

Complexity

Total Complexity

8

Size/Duplication

Total Lines	96
Duplicated Lines	0 %

Coupling/Cohesion

Components	0
Dependencies	1

Test Coverage

Coverage

100%

Importance

Changes	3
Bugs	2	Features	0

5 Methods

Rating	Name	Duplication	Size	Complexity
A	create()	0	7	1
A	update()	0	7	1
A	delete()	0	6	1
A	members()	0	4	1
A	get()	0	15	4

<?php

/**
 * This file is part of the bitbucket-api package.
 *
 * (c) Alexandru G. <alex@gentle.ro>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

namespace Bitbucket\API;

use Buzz\Message\MessageInterface;

/**
 * Provides functionality for querying information about groups,
 * creating new ones, updating memberships, and deleting them.
 *
 * @author  Alexandru G.    <alex@gentle.ro>
 */
class Groups extends Api
{
    /**
     * Get a list of groups.
     *
     * If `$filters` is not omitted, will return a list of matching groups.
     *
     * <example>
     * $filters = array(
     *     'group' => array('account_name/group_slug', 'other_account/group_slug')
     * );
     * </example>
     *
     * @access public
     * @param  string           $account The team or individual account owning the repository.
     * @param  array            $filters
     * @return MessageInterface
     */
    public function get($account, array $filters = array())
    {
        // Default: fetch groups list
        $endpoint = sprintf('groups/%s/', $account);

        if (!empty($filters)) {
            $endpoint = 'groups';

            if (isset($filters['group']) && is_array($filters['group'])) {
                $filters['group'] = implode('&group=', $filters['group']);
            }
        }

        return $this->requestGet($endpoint, $filters);
    }

    /**
     * Create a new group
     *
     * @access public
     * @param  string           $account The team or individual account owning the repository.
     * @param  string           $name    The name of the group.
     * @return MessageInterface
     */
    public function create($account, $name)
    {
        return $this->requestPost(
            sprintf('groups/%s/', $account),
            array('name' => $name)
        );
    }

    /**
     * Update a group
     *
     * @access public
     * @param  string           $account The team or individual account owning the repository.
     * @param  string           $name    The name of the group.
     * @param  array            $params
     * @return MessageInterface
     */
    public function update($account, $name, array $params)
    {
        return $this->requestPut(
            sprintf('groups/%s/%s/', $account, $name),
            $params
        );
    }

    /**
     * Delete a group
     *
     * @access public
     * @param  string           $account The team or individual account owning the repository.
     * @param  string           $name    The name of the group.
     * @return MessageInterface
     */
    public function delete($account, $name)
    {
        return $this->requestDelete(
            sprintf('groups/%s/%s/', $account, $name)
        );
    }

    /**
     * Get members
     *
     * @access public
     * @return Groups\Members
     *
     * @throws \InvalidArgumentException
     * @codeCoverageIgnore
     */
    public function members()
    {
        return $this->api('Groups\\Members');
    }
}