improve label functionality

docs/Event/CardLabelEvent.md

@@ -0,0 +1,13 @@
+
+======================
+
+### Set label
+```php
+setLabel(\Trello\Model\LabelInterface $label)
+```
+
+### Get label
+```php
+getLabel()
+```
+

docs/Manager.md

@@ -26,6 +26,11 @@ getList(string $id)
 getCard(string $id)
 ```
 
+### Get label by id or create a new one
+```php
+getLabel(string $id)
+```
+
 ### Get checklist by id or create a new one
 ```php
 getChecklist(string $id)

docs/Model/Board.md

@@ -151,6 +151,16 @@ setLabelNames(array $labelNames)
 getLabelNames()
 ```
 
+### Get labels
+```php
+getLabels()
+```
+
+### Get label that has name $name and color $color
+```php
+getLabel($name, $color)
+```
+
 ### Set power ups
 ```php
 setPowerUps(array $powerUps)

docs/Model/BoardInterface.md

@@ -151,6 +151,16 @@ setLabelNames(array $labelNames)
 getLabelNames()
 ```
 
+### Get labels
+```php
+getLabels()
+```
+
+### Get label that has name $name and color $color
+```php
+getLabel($name, $color)
+```
+
 ### Set power ups
 ```php
 setPowerUps(array $powerUps)

docs/Model/Card.md

@@ -281,24 +281,24 @@ setLabels(array $labels)
 getLabels()
 ```
 
-### Get the colors of labels associated to this card
+### Get the ids of labels associated to this card
 ```php
-getLabelColors()
+getLabelIds()
 ```
 
-### Does the card have the label of which the color is $color?
+### Does the card have the label?
 ```php
-hasLabel($color)
+hasLabel(LabelInterface $label)
 ```
 
-### Add the label of color $color
+### Add the label $label
 ```php
-addLabel($color)
+addLabel(LabelInterface $label)
 ```
 
-### Remove the label of color $color
+### Remove the label $label
 ```php
-removeLabel($color)
+removeLabel(LabelInterface $label)
 ```
 
 ### Set Badges

docs/Model/Label.md

@@ -0,0 +1,47 @@
+
+======================
+
+### Get id
+```php
+getId()
+```
+
+### Set name
+```php
+setName($name)
+```
+
+### Get name
+```php
+getName()
+```
+
+### Set color
+```php
+setColor($color)
+```
+
+### Get color
+```php
+getColor()
+```
+
+### Set boardId
+```php
+setBoardId($boardId)
+```
+
+### Get boardId
+```php
+getBoardId()
+```
+
+### Set board
+```php
+setBoard(\Trello\Model\BoardInterface $board)
+```
+
+### Get board
+```php
+getBoard()
+```

docs/Model/LabelInterface.md

@@ -0,0 +1,47 @@
+
+======================
+
+### Get id
+```php
+getId()
+```
+
+### Set name
+```php
+setName($name)
+```
+
+### Get name
+```php
+getName()
+```
+
+### Set color
+```php
+setColor($color)
+```
+
+### Get color
+```php
+getColor()
+```
+
+### Set boardId
+```php
+setBoardId($boardId)
+```
+
+### Get boardId
+```php
+getBoardId()
+```
+
+### Set board
+```php
+setBoard(\Trello\Model\BoardInterface $board)
+```
+
+### Get board
+```php
+getBoard()
+```

lib/Trello/Api/AbstractApi.php

@@ -211,13 +211,11 @@ protected function put($path, array $parameters = array(), $requestHeaders = arr
                 $parameters[$name] = $parameter ? 'true' : 'false';
             }
         }
-
         $response = $this->client->getHttpClient()->put(
             $path,
             $this->createParametersBody($parameters),
             $requestHeaders
         );
-
         return ResponseMediator::getContent($response);
     }
 
@@ -258,9 +256,7 @@ protected function createParametersBody(array $parameters)
                     if (is_bool($subParameter)) {
                         $subParameter = $subParameter ? 'true' : 'false';
                     }
-                    $parameters[$name.'/'.$subName] = $subParameter;
                 }
-                unset($parameters[$name]);
             } elseif ($parameter instanceof DateTime) {
                 $parameters[$name] = $parameter->format($parameter::ATOM);
             }

lib/Trello/Api/Label.php

@@ -0,0 +1,110 @@
+<?php
+
+namespace Trello\Api;
+
+use Trello\Exception\InvalidArgumentException;
+
+class Label extends AbstractApi
+{
+    /**
+     * Base path of labels api
+     * @var string
+     */
+    protected $path = 'labels';
+
+
+    public static $fields = array(
+        'idBoard',
+        'name',
+        'color',
+    );
+
+    /**
+     * Find a label by id
+     * @link https://developers.trello.com/reference/#id
+     *
+     * @param string $id     the label's id
+     * @param array  $params optional attributes
+     *
+     * @return array label info
+     */
+    public function show($id, array $params = array())
+    {
+        return $this->get($this->getPath().'/'.rawurlencode($id), $params);
+    }
+
+    /**
+     * Create a label
+     * @link https://developers.trello.com/reference/#id-1
+     *
+     * @param array  $params optional attributes
+     *
+     * @return array label info
+     */
+    public function create(array $params = array())
+    {
+        $this->validateRequiredParameters(array('name', 'idBoard', 'color'), $params);
+
+        return $this->post('boards/'.rawurlencode($params['idBoard']).'/labels/', $params);
+    }
+
+    /**
+     * Update a label
+     * @link https://developers.trello.com/reference/#id-1
+     *
+     * @param string $id     the label's id
+     * @param array  $params label attributes to update
+     *
+     * @return array label info
+     */
+    public function update($id, array $params = array())
+    {
+        return $this->put($this->getPath().'/'.rawurlencode($id).'/labels/', $params);
+    }
+
+    /**
+     * Set a given label's board
+     * @link https://developers.trello.com/reference/#id-1
+     *
+     * @param string $id      the label's id
+     * @param string $boardId the board's id
+     *
+     * @return array board info
+     */
+    public function setBoard($id, $boardId)
+    {
+        return $this->put($this->getPath().'/'.rawurlencode($id).'/idBoard', array('value' => $boardId));
+    }
+
+    /**
+     * Get a given label's board
+     * @link https://developers.trello.com/reference/#id
+     *
+     * @param string $id     the label's id
+     * @param array  $params optional parameters
+     *
+     * @return array board info
+     */
+    public function getBoard($id, array $params = array())
+    {
+        return $this->get($this->getPath().'/'.rawurlencode($id).'/board', $params);
+    }
+
+    /**
+     * Get the field of a board of a given label
+     * @link https://developers.trello.com/reference/#id
+     *
+     * @param string $id    the label's id
+     * @param array  $field the name of the field
+     *
+     * @return array
+     *
+     * @throws InvalidArgumentException if the field does not exist
+     */
+    public function getBoardField($id, $field)
+    {
+        $this->validateAllowedParameters(Board::$fields, $field, 'field');
+
+        return $this->get($this->getPath().'/'.rawurlencode($id).'/board/'.rawurlencode($field));
+    }
+}

lib/Trello/Client.php

@@ -137,6 +137,10 @@ public function api($name)
             case 'webhooks':
                 $api = new Api\Webhook($this);
                 break;
+            case 'label':
+            case 'labels':
+                $api = new Api\Label($this);
+                break;
             default:
                 throw new InvalidArgumentException(sprintf('Undefined api called: "%s"', $name));
         }

lib/Trello/Event/CardLabelEvent.php

@@ -0,0 +1,33 @@
+<?php
+
+namespace Trello\Event;
+
+use Trello\Model\LabelInterface;
+
+class CardChecklistEvent extends CardEvent
+{
+    /**
+     * @var LabelInterface
+     */
+    protected $checklist;
+
+    /**
+     * Set label
+     *
+     * @param LabelInterface $label
+     */
+    public function setLabel(LabelInterface $label)
+    {
+        $this->label = $label;
+    }
+
+    /**
+     * Get label
+     *
+     * @return LabelInterface
+     */
+    public function getLabel()
+    {
+        return $this->label;
+    }
+}

lib/Trello/Events.php

@@ -202,13 +202,13 @@ final class Events
 
     /**
      * When a new label is added to a card
-     * The event listener method receives a Trello\Event\CardEvent instance.
+     * The event listener method receives a Trello\Event\CardLabelEvent instance.
      */
     const CARD_ADD_LABEL                      = 'addLabelToCard';
 
     /**
      * When a new label is removed from a card
-     * The event listener method receives a Trello\Event\CardEvent instance.
+     * The event listener method receives a Trello\Event\CardLabelEvent instance.
      */
     const CARD_REMOVE_LABEL                   = 'removeLabelFromCard';