mpyw / cowitter

src/ClientInterface.php

Doc Comments +84 added lines, -14 removed lines

@@ -29,14 +29,19 @@ 
      *       e.g. [CURLOPT_USERAGENT => 'abc'],
      *            ['CURLOPT_USERAGENT' => 'abc']
      *
-     * @param bool $assoc
-     *     Use Assoc-style or not.
      *
-     * @param bool $stringify
-     *     Stringify CURLOPT_* constant names or not.
+     * @return void
      */
     public function __construct(array $credentials, array $options = []);
+
+    /**
+     * @return Traits\BaseClientTrait
+     */
     public function withCredentials(array $credentails); // : ClientInterface
+
+    /**
+     * @return Traits\BaseClientTrait
+     */
     public function withOptions(array $options); // : ClientInterface
     public function getCredentials($assoc = false); // : array
     public function getOptions($stringify = false); // : array
@@ -45,15 +50,12 @@ 
      * Retrive part of credentials using magic methods or ArrayAccess interface.
      *
      * @param string $key
-     * @param string $offset
-     *
-     *       e.g.
-     *           $a = $client->consumer_key;
-     *           $b = $client['consumer_secret'];
-     *           $c = $client[2];
-     *           $d = $client->tokenSecret;
      */
     public function __get($key); // : string
+
+    /**
+     * @return boolean
+     */
     public function __isset($key); // : boolean
     public function offsetGet($offset); // : string
     public function offsetExists($offset); // : boolean
@@ -71,18 +73,31 @@ 
      * login() uses scraping.
      *
      * @param string|null $oauth_callback Callback URL or "oob".
-     * @param string      $oauth_verifier
-     * @param string      $username       Username or email.
-     * @param string      $password
      * @throws HttpExceptionInterface
      */
     public function oauthForRequestToken($oauth_callback = null); // : ClientInterface
     public function oauthForAccessToken($oauth_verifier); // : ClientInterface
     public function xauthForAccessToken($username, $password); // : ClientInterface
     public function login($username, $password); // : ClientInterface
+
+    /**
+     * @return \Generator
+     */
     public function oauthForRequestTokenAsync($oauth_callback = null); // : \Generator<ClientInterface>
+
+    /**
+     * @return \Generator
+     */
     public function oauthForAccessTokenAsync($oauth_verifier); // : \Generator<ClientInterface>
+
+    /**
+     * @return \Generator
+     */
     public function xauthForAccessTokenAsync($username, $password); // : \Generator<ClientInterface>
+
+    /**
+     * @return \Generator
+     */
     public function loginAsync($username, $password); // : \Generator<ClientInterface>
 
     /**
@@ -107,8 +122,20 @@ 
     public function get($endpoint, array $params = [], $return_response_object = false); // : \stdClass|array|ResponseInterface
     public function post($endpoint, array $params = [], $return_response_object = false); // : \stdClass|null|ResponseInterface
     public function postMultipart($endpoint, array $params = [], $return_response_object = false); // : \stdClass|null|ResponseInterface
+
+    /**
+     * @return \Generator
+     */
     public function getAsync($endpoint, array $params = [], $return_response_object = false); // : \Generator<\stdClass|array|ResponseInterface
+
+    /**
+     * @return \Generator
+     */
     public function postAsync($endpoint, array $params = [], $return_response_object = false); // : \Generator<\stdClass|null|ResponseInterface>
+
+    /**
+     * @return \Generator
+     */
     public function postMultipartAsync($endpoint, array $params = [], $return_response_object = false); // : \Generator<\stdClass|null|ResponseInterface>
 
     /**
@@ -132,8 +159,20 @@ 
     public function getOut($url, array $params = [], $return_response_object = false); // : \stdClass|array|ResponseInterface
     public function postOut($url, array $params = [], $return_response_object = false); // : \stdClass|null|ResponseInterface
     public function postMultipartOut($url, array $params = [], $return_response_object = false); // : \stdClass|null|ResponseInterface
+
+    /**
+     * @return \Generator
+     */
     public function getOutAsync($url, array $params = [], $return_response_object = false); // : \Generator<\stdClass|array|ResponseInterface
+
+    /**
+     * @return \Generator
+     */
     public function postOutAsync($url, array $params = [], $return_response_object = false); // : \Generator<\stdClass|null|ResponseInterface>
+
+    /**
+     * @return \Generator
+     */
     public function postMultipartOutAsync($url, array $params = [], $return_response_object = false); // : \Generator<\stdClass|null|ResponseInterface>
 
     /**
@@ -160,8 +199,13 @@ 
      *       Signature: function (ResponseInterface $response);
      *
      * @throws HttpExceptionInterface
+     * @return void
      */
     public function streaming($endpoint, callable $event_handler, array $params = [], callable $header_response_handler = null); // : null
+
+    /**
+     * @return \Generator
+     */
     public function streamingAsync($endpoint, callable $event_handler, array $params = [], callable $header_response_handler = null); // : \Generator<null>
 
     /**
@@ -183,10 +227,23 @@ 
      *     File data is split into chunks with specified size.
      *
      * @throws HttpExceptionInterface
+     * @return \Generator
      */
     public function uploadAsync(\SplFileObject $file, $media_category = null, callable $on_progress = null, $chunk_size = 300000); // : \Generator<\stdClass>
+
+    /**
+     * @return \Generator
+     */
     public function uploadImageAsync(\SplFileObject $file, callable $on_progress = null, $chunk_size = 300000); // : \Generator<\stdClass>
+
+    /**
+     * @return \Generator
+     */
     public function uploadAnimeGifAsync(\SplFileObject $file, callable $on_progress = null, $chunk_size = 300000); // : \Generator<\stdClass>
+
+    /**
+     * @return \Generator
+     */
     public function uploadVideoAsync(\SplFileObject $file, callable $on_progress = null, $chunk_size = 300000); // : \Generator<\stdClass>
 
     /**
@@ -195,14 +252,23 @@ 
      * @throws HttpExceptionInterface
      */
     public function oauthForBearerToken(); // : ClientInterface
+
+    /**
+     * @return \Generator
+     */
     public function oauthForBearerTokenAsync(); // : \Generator<ClientInterface>
 
     /**
      * Invalidate OAuth 2.0 token.
      *
      * @throws HttpExceptionInterface
+     * @return void
      */
     public function invalidateBearerToken(); // : null
+
+    /**
+     * @return \Generator
+     */
     public function invalidateBearerTokenAsync(); // : \Generator<null>
 
     /**
@@ -223,5 +289,9 @@ 
      * @throws HttpExceptionInterface
      */
     public function get2($endpoint, array $params = [], $return_response_object = false); // : \stdClass|array|ResponseInterface
+
+    /**
+     * @return \Generator
+     */
     public function get2Async($endpoint, array $params = [], $return_response_object = false); // : \Generator<\stdClass|array|ResponseInterface>
 }

src/Components/StreamHandler.php

Doc Comments +3 added lines

@@ -36,6 +36,9 @@
         return strlen($str);
     }
 
+    /**
+     * @param string $line
+     */
     protected function processLine($ch, $line)
     {
         $handle = $this->eventHandler;

src/Traits/UploaderTrait.php

Doc Comments +13 added lines

@@ -9,10 +9,20 @@ 
 
 trait UploaderTrait
 {
+    /**
+     * @param string $endpoint
+     */
     abstract public function getAsync($endpoint, array $params = [], $return_response_object = false);
+
+    /**
+     * @param string $endpoint
+     */
     abstract public function postAsync($endpoint, array $params = [], $return_response_object = false);
     abstract public function postMultipartAsync($endpoint, array $params = [], $return_response_object = false);
 
+    /**
+     * @param integer $value
+     */
     protected static function validateChunkSize($value)
     {
         if (false === $value = filter_var($value, FILTER_VALIDATE_INT)) {
@@ -32,6 +42,9 @@ 
         return $type;
     }
 
+    /**
+     * @param string $media_category
+     */
     public function uploadAsync(\SplFileObject $file, $media_category = null, callable $on_uploading = null, callable $on_processing = null, $chunk_size = 300000)
     {
         $response = (yield $this->uploadStep1($file, $media_category, $chunk_size, $on_uploading));