futtta / autoptimize

classes/external/php/plugin-update-checker/Puc/v4p4/Vcs/GitLabApi.php

Indentation +267 added lines, -267 removed lines

@@ -2,273 +2,273 @@
 
 if ( !class_exists('Puc_v4p4_Vcs_GitLabApi', false) ):
 
-	class Puc_v4p4_Vcs_GitLabApi extends Puc_v4p4_Vcs_Api {
-		/**
-		 * @var string GitLab username.
-		 */
-		protected $userName;
-
-		/**
-		 * @var string GitLab server host.
-		 */
-		private $repositoryHost;
-
-		/**
-		 * @var string GitLab repository name.
-		 */
-		protected $repositoryName;
-
-		/**
-		 * @var string GitLab authentication token. Optional.
-		 */
-		protected $accessToken;
-
-		public function __construct($repositoryUrl, $accessToken = null) {
-			//Parse the repository host to support custom hosts.
-			$this->repositoryHost = @parse_url($repositoryUrl, PHP_URL_HOST);
-
-			//Find the repository information
-			$path = @parse_url($repositoryUrl, PHP_URL_PATH);
-			if ( preg_match('@^/?(?P<username>[^/]+?)/(?P<repository>[^/#?&]+?)/?$@', $path, $matches) ) {
-				$this->userName = $matches['username'];
-				$this->repositoryName = $matches['repository'];
-			} else {
-				//This is not a traditional url, it could be gitlab is in a deeper subdirectory.
-				//Get the path segments.
-				$segments = explode('/', untrailingslashit(ltrim($path, '/')));
-
-				//We need at least /user-name/repository-name/
-				if ( count($segments) < 2 ) {
-					throw new InvalidArgumentException('Invalid GitLab repository URL: "' . $repositoryUrl . '"');
-				}
-
-				//Get the username and repository name.
-				$usernameRepo = array_splice($segments, -2, 2);
-				$this->userName = $usernameRepo[0];
-				$this->repositoryName = $usernameRepo[1];
-
-				//Append the remaining segments to the host.
-				$this->repositoryHost = trailingslashit($this->repositoryHost) . implode('/', $segments);
-			}
-
-			parent::__construct($repositoryUrl, $accessToken);
-		}
-
-		/**
-		 * Get the latest release from GitLab.
-		 *
-		 * @return Puc_v4p4_Vcs_Reference|null
-		 */
-		public function getLatestRelease() {
-			return $this->getLatestTag();
-		}
-
-		/**
-		 * Get the tag that looks like the highest version number.
-		 *
-		 * @return Puc_v4p4_Vcs_Reference|null
-		 */
-		public function getLatestTag() {
-			$tags = $this->api('/:user/:repo/repository/tags');
-			if ( is_wp_error($tags) || empty($tags) || !is_array($tags) ) {
-				return null;
-			}
-
-			$versionTags = $this->sortTagsByVersion($tags);
-			if ( empty($versionTags) ) {
-				return null;
-			}
-
-			$tag = $versionTags[0];
-			return new Puc_v4p4_Vcs_Reference(array(
-				'name' => $tag->name,
-				'version' => ltrim($tag->name, 'v'),
-				'downloadUrl' => $this->buildArchiveDownloadUrl($tag->name),
-				'apiResponse' => $tag
-			));
-		}
-
-		/**
-		 * Get a branch by name.
-		 *
-		 * @param string $branchName
-		 * @return null|Puc_v4p4_Vcs_Reference
-		 */
-		public function getBranch($branchName) {
-			$branch = $this->api('/:user/:repo/repository/branches/' . $branchName);
-			if ( is_wp_error($branch) || empty($branch) ) {
-				return null;
-			}
-
-			$reference = new Puc_v4p4_Vcs_Reference(array(
-				'name' => $branch->name,
-				'downloadUrl' => $this->buildArchiveDownloadUrl($branch->name),
-				'apiResponse' => $branch,
-			));
-
-			if ( isset($branch->commit, $branch->commit->committed_date) ) {
-				$reference->updated = $branch->commit->committed_date;
-			}
-
-			return $reference;
-		}
-
-		/**
-		 * Get the timestamp of the latest commit that changed the specified branch or tag.
-		 *
-		 * @param string $ref Reference name (e.g. branch or tag).
-		 * @return string|null
-		 */
-		public function getLatestCommitTime($ref) {
-			$commits = $this->api('/:user/:repo/repository/commits/', array('ref_name' => $ref));
-			if ( is_wp_error($commits) || !is_array($commits) || !isset($commits[0]) ) {
-				return null;
-			}
-
-			return $commits[0]->committed_date;
-		}
-
-		/**
-		 * Perform a GitLab API request.
-		 *
-		 * @param string $url
-		 * @param array $queryParams
-		 * @return mixed|WP_Error
-		 */
-		protected function api($url, $queryParams = array()) {
-			$baseUrl = $url;
-			$url = $this->buildApiUrl($url, $queryParams);
-
-			$options = array('timeout' => 10);
-			if ( !empty($this->httpFilterName) ) {
-				$options = apply_filters($this->httpFilterName, $options);
-			}
+    class Puc_v4p4_Vcs_GitLabApi extends Puc_v4p4_Vcs_Api {
+        /**
+         * @var string GitLab username.
+         */
+        protected $userName;
+
+        /**
+         * @var string GitLab server host.
+         */
+        private $repositoryHost;
+
+        /**
+         * @var string GitLab repository name.
+         */
+        protected $repositoryName;
+
+        /**
+         * @var string GitLab authentication token. Optional.
+         */
+        protected $accessToken;
+
+        public function __construct($repositoryUrl, $accessToken = null) {
+            //Parse the repository host to support custom hosts.
+            $this->repositoryHost = @parse_url($repositoryUrl, PHP_URL_HOST);
+
+            //Find the repository information
+            $path = @parse_url($repositoryUrl, PHP_URL_PATH);
+            if ( preg_match('@^/?(?P<username>[^/]+?)/(?P<repository>[^/#?&]+?)/?$@', $path, $matches) ) {
+                $this->userName = $matches['username'];
+                $this->repositoryName = $matches['repository'];
+            } else {
+                //This is not a traditional url, it could be gitlab is in a deeper subdirectory.
+                //Get the path segments.
+                $segments = explode('/', untrailingslashit(ltrim($path, '/')));
+
+                //We need at least /user-name/repository-name/
+                if ( count($segments) < 2 ) {
+                    throw new InvalidArgumentException('Invalid GitLab repository URL: "' . $repositoryUrl . '"');
+                }
+
+                //Get the username and repository name.
+                $usernameRepo = array_splice($segments, -2, 2);
+                $this->userName = $usernameRepo[0];
+                $this->repositoryName = $usernameRepo[1];
+
+                //Append the remaining segments to the host.
+                $this->repositoryHost = trailingslashit($this->repositoryHost) . implode('/', $segments);
+            }
+
+            parent::__construct($repositoryUrl, $accessToken);
+        }
+
+        /**
+         * Get the latest release from GitLab.
+         *
+         * @return Puc_v4p4_Vcs_Reference|null
+         */
+        public function getLatestRelease() {
+            return $this->getLatestTag();
+        }
+
+        /**
+         * Get the tag that looks like the highest version number.
+         *
+         * @return Puc_v4p4_Vcs_Reference|null
+         */
+        public function getLatestTag() {
+            $tags = $this->api('/:user/:repo/repository/tags');
+            if ( is_wp_error($tags) || empty($tags) || !is_array($tags) ) {
+                return null;
+            }
+
+            $versionTags = $this->sortTagsByVersion($tags);
+            if ( empty($versionTags) ) {
+                return null;
+            }
+
+            $tag = $versionTags[0];
+            return new Puc_v4p4_Vcs_Reference(array(
+                'name' => $tag->name,
+                'version' => ltrim($tag->name, 'v'),
+                'downloadUrl' => $this->buildArchiveDownloadUrl($tag->name),
+                'apiResponse' => $tag
+            ));
+        }
+
+        /**
+         * Get a branch by name.
+         *
+         * @param string $branchName
+         * @return null|Puc_v4p4_Vcs_Reference
+         */
+        public function getBranch($branchName) {
+            $branch = $this->api('/:user/:repo/repository/branches/' . $branchName);
+            if ( is_wp_error($branch) || empty($branch) ) {
+                return null;
+            }
+
+            $reference = new Puc_v4p4_Vcs_Reference(array(
+                'name' => $branch->name,
+                'downloadUrl' => $this->buildArchiveDownloadUrl($branch->name),
+                'apiResponse' => $branch,
+            ));
+
+            if ( isset($branch->commit, $branch->commit->committed_date) ) {
+                $reference->updated = $branch->commit->committed_date;
+            }
+
+            return $reference;
+        }
+
+        /**
+         * Get the timestamp of the latest commit that changed the specified branch or tag.
+         *
+         * @param string $ref Reference name (e.g. branch or tag).
+         * @return string|null
+         */
+        public function getLatestCommitTime($ref) {
+            $commits = $this->api('/:user/:repo/repository/commits/', array('ref_name' => $ref));
+            if ( is_wp_error($commits) || !is_array($commits) || !isset($commits[0]) ) {
+                return null;
+            }
+
+            return $commits[0]->committed_date;
+        }
+
+        /**
+         * Perform a GitLab API request.
+         *
+         * @param string $url
+         * @param array $queryParams
+         * @return mixed|WP_Error
+         */
+        protected function api($url, $queryParams = array()) {
+            $baseUrl = $url;
+            $url = $this->buildApiUrl($url, $queryParams);
+
+            $options = array('timeout' => 10);
+            if ( !empty($this->httpFilterName) ) {
+                $options = apply_filters($this->httpFilterName, $options);
+            }
 			
-			$response = wp_remote_get($url, $options);
-			if ( is_wp_error($response) ) {
-				do_action('puc_api_error', $response, null, $url, $this->slug);
-				return $response;
-			}
-
-			$code = wp_remote_retrieve_response_code($response);
-			$body = wp_remote_retrieve_body($response);
-			if ( $code === 200 ) {
-				return json_decode($body);
-			}
-
-			$error = new WP_Error(
-				'puc-gitlab-http-error',
-				sprintf('GitLab API error. URL: "%s",  HTTP status code: %d.', $baseUrl, $code)
-			);
-			do_action('puc_api_error', $error, $response, $url, $this->slug);
-
-			return $error;
-		}
-
-		/**
-		 * Build a fully qualified URL for an API request.
-		 *
-		 * @param string $url
-		 * @param array $queryParams
-		 * @return string
-		 */
-		protected function buildApiUrl($url, $queryParams) {
-			$variables = array(
-				'user' => $this->userName,
-				'repo' => $this->repositoryName
-			);
-
-			foreach ($variables as $name => $value) {
-				$url = str_replace("/:{$name}", urlencode('/' . $value), $url);
-			}
-
-			$url = substr($url, 3);
-			$url = sprintf('https://%1$s/api/v4/projects/%2$s', $this->repositoryHost, $url);
-
-			if ( !empty($this->accessToken) ) {
-				$queryParams['private_token'] = $this->accessToken;
-			}
-
-			if ( !empty($queryParams) ) {
-				$url = add_query_arg($queryParams, $url);
-			}
-
-			return $url;
-		}
-
-		/**
-		 * Get the contents of a file from a specific branch or tag.
-		 *
-		 * @param string $path File name.
-		 * @param string $ref
-		 * @return null|string Either the contents of the file, or null if the file doesn't exist or there's an error.
-		 */
-		public function getRemoteFile($path, $ref = 'master') {
-			$response = $this->api('/:user/:repo/repository/files/' . $path, array('ref' => $ref));
-			if ( is_wp_error($response) || !isset($response->content) || $response->encoding !== 'base64' ) {
-				return null;
-			}
-
-			return base64_decode($response->content);
-		}
-
-		/**
-		 * Generate a URL to download a ZIP archive of the specified branch/tag/etc.
-		 *
-		 * @param string $ref
-		 * @return string
-		 */
-		public function buildArchiveDownloadUrl($ref = 'master') {
-			$url = sprintf(
-				'https://%1$s/%2$s/%3$s/repository/%4$s/archive.zip',
-				$this->repositoryHost,
-				urlencode($this->userName),
-				urlencode($this->repositoryName),
-				urlencode($ref)
-			);
-
-			if ( !empty($this->accessToken) ) {
-				$url = add_query_arg('private_token', $this->accessToken, $url);
-			}
-
-			return $url;
-		}
-
-		/**
-		 * Get a specific tag.
-		 *
-		 * @param string $tagName
-		 * @return Puc_v4p4_Vcs_Reference|null
-		 */
-		public function getTag($tagName) {
-			throw new LogicException('The ' . __METHOD__ . ' method is not implemented and should not be used.');
-		}
-
-		/**
-		 * Figure out which reference (i.e tag or branch) contains the latest version.
-		 *
-		 * @param string $configBranch Start looking in this branch.
-		 * @return null|Puc_v4p4_Vcs_Reference
-		 */
-		public function chooseReference($configBranch) {
-			$updateSource = null;
-
-			// GitLab doesn't handle releases the same as GitHub so just use the latest tag
-			if ( $configBranch === 'master' ) {
-				$updateSource = $this->getLatestTag();
-			}
-
-			if ( empty($updateSource) ) {
-				$updateSource = $this->getBranch($configBranch);
-			}
-
-			return $updateSource;
-		}
-
-		public function setAuthentication($credentials) {
-			parent::setAuthentication($credentials);
-			$this->accessToken = is_string($credentials) ? $credentials : null;
-		}
-	}
+            $response = wp_remote_get($url, $options);
+            if ( is_wp_error($response) ) {
+                do_action('puc_api_error', $response, null, $url, $this->slug);
+                return $response;
+            }
+
+            $code = wp_remote_retrieve_response_code($response);
+            $body = wp_remote_retrieve_body($response);
+            if ( $code === 200 ) {
+                return json_decode($body);
+            }
+
+            $error = new WP_Error(
+                'puc-gitlab-http-error',
+                sprintf('GitLab API error. URL: "%s",  HTTP status code: %d.', $baseUrl, $code)
+            );
+            do_action('puc_api_error', $error, $response, $url, $this->slug);
+
+            return $error;
+        }
+
+        /**
+         * Build a fully qualified URL for an API request.
+         *
+         * @param string $url
+         * @param array $queryParams
+         * @return string
+         */
+        protected function buildApiUrl($url, $queryParams) {
+            $variables = array(
+                'user' => $this->userName,
+                'repo' => $this->repositoryName
+            );
+
+            foreach ($variables as $name => $value) {
+                $url = str_replace("/:{$name}", urlencode('/' . $value), $url);
+            }
+
+            $url = substr($url, 3);
+            $url = sprintf('https://%1$s/api/v4/projects/%2$s', $this->repositoryHost, $url);
+
+            if ( !empty($this->accessToken) ) {
+                $queryParams['private_token'] = $this->accessToken;
+            }
+
+            if ( !empty($queryParams) ) {
+                $url = add_query_arg($queryParams, $url);
+            }
+
+            return $url;
+        }
+
+        /**
+         * Get the contents of a file from a specific branch or tag.
+         *
+         * @param string $path File name.
+         * @param string $ref
+         * @return null|string Either the contents of the file, or null if the file doesn't exist or there's an error.
+         */
+        public function getRemoteFile($path, $ref = 'master') {
+            $response = $this->api('/:user/:repo/repository/files/' . $path, array('ref' => $ref));
+            if ( is_wp_error($response) || !isset($response->content) || $response->encoding !== 'base64' ) {
+                return null;
+            }
+
+            return base64_decode($response->content);
+        }
+
+        /**
+         * Generate a URL to download a ZIP archive of the specified branch/tag/etc.
+         *
+         * @param string $ref
+         * @return string
+         */
+        public function buildArchiveDownloadUrl($ref = 'master') {
+            $url = sprintf(
+                'https://%1$s/%2$s/%3$s/repository/%4$s/archive.zip',
+                $this->repositoryHost,
+                urlencode($this->userName),
+                urlencode($this->repositoryName),
+                urlencode($ref)
+            );
+
+            if ( !empty($this->accessToken) ) {
+                $url = add_query_arg('private_token', $this->accessToken, $url);
+            }
+
+            return $url;
+        }
+
+        /**
+         * Get a specific tag.
+         *
+         * @param string $tagName
+         * @return Puc_v4p4_Vcs_Reference|null
+         */
+        public function getTag($tagName) {
+            throw new LogicException('The ' . __METHOD__ . ' method is not implemented and should not be used.');
+        }
+
+        /**
+         * Figure out which reference (i.e tag or branch) contains the latest version.
+         *
+         * @param string $configBranch Start looking in this branch.
+         * @return null|Puc_v4p4_Vcs_Reference
+         */
+        public function chooseReference($configBranch) {
+            $updateSource = null;
+
+            // GitLab doesn't handle releases the same as GitHub so just use the latest tag
+            if ( $configBranch === 'master' ) {
+                $updateSource = $this->getLatestTag();
+            }
+
+            if ( empty($updateSource) ) {
+                $updateSource = $this->getBranch($configBranch);
+            }
+
+            return $updateSource;
+        }
+
+        public function setAuthentication($credentials) {
+            parent::setAuthentication($credentials);
+            $this->accessToken = is_string($credentials) ? $credentials : null;
+        }
+    }
 
 endif;
\ No newline at end of file

classes/external/php/plugin-update-checker/Puc/v4p4/Vcs/Api.php

Indentation +297 added lines, -297 removed lines

@@ -1,302 +1,302 @@
 <?php
 if ( !class_exists('Puc_v4p4_Vcs_Api') ):
 
-	abstract class Puc_v4p4_Vcs_Api {
-		protected $tagNameProperty = 'name';
-		protected $slug = '';
-
-		/**
-		 * @var string
-		 */
-		protected $repositoryUrl = '';
-
-		/**
-		 * @var mixed Authentication details for private repositories. Format depends on service.
-		 */
-		protected $credentials = null;
-
-		/**
-		 * @var string The filter tag that's used to filter options passed to wp_remote_get.
-		 * For example, "puc_request_info_options-slug" or "puc_request_update_options_theme-slug".
-		 */
-		protected $httpFilterName = '';
-
-		/**
-		 * @var string|null
-		 */
-		protected $localDirectory = null;
-
-		/**
-		 * Puc_v4p4_Vcs_Api constructor.
-		 *
-		 * @param string $repositoryUrl
-		 * @param array|string|null $credentials
-		 */
-		public function __construct($repositoryUrl, $credentials = null) {
-			$this->repositoryUrl = $repositoryUrl;
-			$this->setAuthentication($credentials);
-		}
-
-		/**
-		 * @return string
-		 */
-		public function getRepositoryUrl() {
-			return $this->repositoryUrl;
-		}
-
-		/**
-		 * Figure out which reference (i.e tag or branch) contains the latest version.
-		 *
-		 * @param string $configBranch Start looking in this branch.
-		 * @return null|Puc_v4p4_Vcs_Reference
-		 */
-		abstract public function chooseReference($configBranch);
-
-		/**
-		 * Get the readme.txt file from the remote repository and parse it
-		 * according to the plugin readme standard.
-		 *
-		 * @param string $ref Tag or branch name.
-		 * @return array Parsed readme.
-		 */
-		public function getRemoteReadme($ref = 'master') {
-			$fileContents = $this->getRemoteFile($this->getLocalReadmeName(), $ref);
-			if ( empty($fileContents) ) {
-				return array();
-			}
-
-			$parser = new PucReadmeParser();
-			return $parser->parse_readme_contents($fileContents);
-		}
-
-		/**
-		 * Get the case-sensitive name of the local readme.txt file.
-		 *
-		 * In most cases it should just be called "readme.txt", but some plugins call it "README.txt",
-		 * "README.TXT", or even "Readme.txt". Most VCS are case-sensitive so we need to know the correct
-		 * capitalization.
-		 *
-		 * Defaults to "readme.txt" (all lowercase).
-		 *
-		 * @return string
-		 */
-		public function getLocalReadmeName() {
-			static $fileName = null;
-			if ( $fileName !== null ) {
-				return $fileName;
-			}
-
-			$fileName = 'readme.txt';
-			if ( isset($this->localDirectory) ) {
-				$files = scandir($this->localDirectory);
-				if ( !empty($files) ) {
-					foreach ($files as $possibleFileName) {
-						if ( strcasecmp($possibleFileName, 'readme.txt') === 0 ) {
-							$fileName = $possibleFileName;
-							break;
-						}
-					}
-				}
-			}
-			return $fileName;
-		}
-
-		/**
-		 * Get a branch.
-		 *
-		 * @param string $branchName
-		 * @return Puc_v4p4_Vcs_Reference|null
-		 */
-		abstract public function getBranch($branchName);
-
-		/**
-		 * Get a specific tag.
-		 *
-		 * @param string $tagName
-		 * @return Puc_v4p4_Vcs_Reference|null
-		 */
-		abstract public function getTag($tagName);
-
-		/**
-		 * Get the tag that looks like the highest version number.
-		 * (Implementations should skip pre-release versions if possible.)
-		 *
-		 * @return Puc_v4p4_Vcs_Reference|null
-		 */
-		abstract public function getLatestTag();
-
-		/**
-		 * Check if a tag name string looks like a version number.
-		 *
-		 * @param string $name
-		 * @return bool
-		 */
-		protected function looksLikeVersion($name) {
-			//Tag names may be prefixed with "v", e.g. "v1.2.3".
-			$name = ltrim($name, 'v');
-
-			//The version string must start with a number.
-			if ( !is_numeric(substr($name, 0, 1)) ) {
-				return false;
-			}
-
-			//The goal is to accept any SemVer-compatible or "PHP-standardized" version number.
-			return (preg_match('@^(\d{1,5}?)(\.\d{1,10}?){0,4}?($|[abrdp+_\-]|\s)@i', $name) === 1);
-		}
-
-		/**
-		 * Check if a tag appears to be named like a version number.
-		 *
-		 * @param stdClass $tag
-		 * @return bool
-		 */
-		protected function isVersionTag($tag) {
-			$property = $this->tagNameProperty;
-			return isset($tag->$property) && $this->looksLikeVersion($tag->$property);
-		}
-
-		/**
-		 * Sort a list of tags as if they were version numbers.
-		 * Tags that don't look like version number will be removed.
-		 *
-		 * @param stdClass[] $tags Array of tag objects.
-		 * @return stdClass[] Filtered array of tags sorted in descending order.
-		 */
-		protected function sortTagsByVersion($tags) {
-			//Keep only those tags that look like version numbers.
-			$versionTags = array_filter($tags, array($this, 'isVersionTag'));
-			//Sort them in descending order.
-			usort($versionTags, array($this, 'compareTagNames'));
-
-			return $versionTags;
-		}
-
-		/**
-		 * Compare two tags as if they were version number.
-		 *
-		 * @param stdClass $tag1 Tag object.
-		 * @param stdClass $tag2 Another tag object.
-		 * @return int
-		 */
-		protected function compareTagNames($tag1, $tag2) {
-			$property = $this->tagNameProperty;
-			if ( !isset($tag1->$property) ) {
-				return 1;
-			}
-			if ( !isset($tag2->$property) ) {
-				return -1;
-			}
-			return -version_compare(ltrim($tag1->$property, 'v'), ltrim($tag2->$property, 'v'));
-		}
-
-		/**
-		 * Get the contents of a file from a specific branch or tag.
-		 *
-		 * @param string $path File name.
-		 * @param string $ref
-		 * @return null|string Either the contents of the file, or null if the file doesn't exist or there's an error.
-		 */
-		abstract public function getRemoteFile($path, $ref = 'master');
-
-		/**
-		 * Get the timestamp of the latest commit that changed the specified branch or tag.
-		 *
-		 * @param string $ref Reference name (e.g. branch or tag).
-		 * @return string|null
-		 */
-		abstract public function getLatestCommitTime($ref);
-
-		/**
-		 * Get the contents of the changelog file from the repository.
-		 *
-		 * @param string $ref
-		 * @param string $localDirectory Full path to the local plugin or theme directory.
-		 * @return null|string The HTML contents of the changelog.
-		 */
-		public function getRemoteChangelog($ref, $localDirectory) {
-			$filename = $this->findChangelogName($localDirectory);
-			if ( empty($filename) ) {
-				return null;
-			}
-
-			$changelog = $this->getRemoteFile($filename, $ref);
-			if ( $changelog === null ) {
-				return null;
-			}
-
-			/** @noinspection PhpUndefinedClassInspection */
-			return Parsedown::instance()->text($changelog);
-		}
-
-		/**
-		 * Guess the name of the changelog file.
-		 *
-		 * @param string $directory
-		 * @return string|null
-		 */
-		protected function findChangelogName($directory = null) {
-			if ( !isset($directory) ) {
-				$directory = $this->localDirectory;
-			}
-			if ( empty($directory) || !is_dir($directory) || ($directory === '.') ) {
-				return null;
-			}
-
-			$possibleNames = array('CHANGES.md', 'CHANGELOG.md', 'changes.md', 'changelog.md');
-			$files = scandir($directory);
-			$foundNames = array_intersect($possibleNames, $files);
-
-			if ( !empty($foundNames) ) {
-				return reset($foundNames);
-			}
-			return null;
-		}
-
-		/**
-		 * Set authentication credentials.
-		 *
-		 * @param $credentials
-		 */
-		public function setAuthentication($credentials) {
-			$this->credentials = $credentials;
-		}
-
-		public function isAuthenticationEnabled() {
-			return !empty($this->credentials);
-		}
-
-		/**
-		 * @param string $url
-		 * @return string
-		 */
-		public function signDownloadUrl($url) {
-			return $url;
-		}
-
-		/**
-		 * @param string $filterName
-		 */
-		public function setHttpFilterName($filterName) {
-			$this->httpFilterName = $filterName;
-		}
-
-		/**
-		 * @param string $directory
-		 */
-		public function setLocalDirectory($directory) {
-			if ( empty($directory) || !is_dir($directory) || ($directory === '.') ) {
-				$this->localDirectory = null;
-			} else {
-				$this->localDirectory = $directory;
-			}
-		}
-
-		/**
-		 * @param string $slug
-		 */
-		public function setSlug($slug) {
-			$this->slug = $slug;
-		}
-	}
+    abstract class Puc_v4p4_Vcs_Api {
+        protected $tagNameProperty = 'name';
+        protected $slug = '';
+
+        /**
+         * @var string
+         */
+        protected $repositoryUrl = '';
+
+        /**
+         * @var mixed Authentication details for private repositories. Format depends on service.
+         */
+        protected $credentials = null;
+
+        /**
+         * @var string The filter tag that's used to filter options passed to wp_remote_get.
+         * For example, "puc_request_info_options-slug" or "puc_request_update_options_theme-slug".
+         */
+        protected $httpFilterName = '';
+
+        /**
+         * @var string|null
+         */
+        protected $localDirectory = null;
+
+        /**
+         * Puc_v4p4_Vcs_Api constructor.
+         *
+         * @param string $repositoryUrl
+         * @param array|string|null $credentials
+         */
+        public function __construct($repositoryUrl, $credentials = null) {
+            $this->repositoryUrl = $repositoryUrl;
+            $this->setAuthentication($credentials);
+        }
+
+        /**
+         * @return string
+         */
+        public function getRepositoryUrl() {
+            return $this->repositoryUrl;
+        }
+
+        /**
+         * Figure out which reference (i.e tag or branch) contains the latest version.
+         *
+         * @param string $configBranch Start looking in this branch.
+         * @return null|Puc_v4p4_Vcs_Reference
+         */
+        abstract public function chooseReference($configBranch);
+
+        /**
+         * Get the readme.txt file from the remote repository and parse it
+         * according to the plugin readme standard.
+         *
+         * @param string $ref Tag or branch name.
+         * @return array Parsed readme.
+         */
+        public function getRemoteReadme($ref = 'master') {
+            $fileContents = $this->getRemoteFile($this->getLocalReadmeName(), $ref);
+            if ( empty($fileContents) ) {
+                return array();
+            }
+
+            $parser = new PucReadmeParser();
+            return $parser->parse_readme_contents($fileContents);
+        }
+
+        /**
+         * Get the case-sensitive name of the local readme.txt file.
+         *
+         * In most cases it should just be called "readme.txt", but some plugins call it "README.txt",
+         * "README.TXT", or even "Readme.txt". Most VCS are case-sensitive so we need to know the correct
+         * capitalization.
+         *
+         * Defaults to "readme.txt" (all lowercase).
+         *
+         * @return string
+         */
+        public function getLocalReadmeName() {
+            static $fileName = null;
+            if ( $fileName !== null ) {
+                return $fileName;
+            }
+
+            $fileName = 'readme.txt';
+            if ( isset($this->localDirectory) ) {
+                $files = scandir($this->localDirectory);
+                if ( !empty($files) ) {
+                    foreach ($files as $possibleFileName) {
+                        if ( strcasecmp($possibleFileName, 'readme.txt') === 0 ) {
+                            $fileName = $possibleFileName;
+                            break;
+                        }
+                    }
+                }
+            }
+            return $fileName;
+        }
+
+        /**
+         * Get a branch.
+         *
+         * @param string $branchName
+         * @return Puc_v4p4_Vcs_Reference|null
+         */
+        abstract public function getBranch($branchName);
+
+        /**
+         * Get a specific tag.
+         *
+         * @param string $tagName
+         * @return Puc_v4p4_Vcs_Reference|null
+         */
+        abstract public function getTag($tagName);
+
+        /**
+         * Get the tag that looks like the highest version number.
+         * (Implementations should skip pre-release versions if possible.)
+         *
+         * @return Puc_v4p4_Vcs_Reference|null
+         */
+        abstract public function getLatestTag();
+
+        /**
+         * Check if a tag name string looks like a version number.
+         *
+         * @param string $name
+         * @return bool
+         */
+        protected function looksLikeVersion($name) {
+            //Tag names may be prefixed with "v", e.g. "v1.2.3".
+            $name = ltrim($name, 'v');
+
+            //The version string must start with a number.
+            if ( !is_numeric(substr($name, 0, 1)) ) {
+                return false;
+            }
+
+            //The goal is to accept any SemVer-compatible or "PHP-standardized" version number.
+            return (preg_match('@^(\d{1,5}?)(\.\d{1,10}?){0,4}?($|[abrdp+_\-]|\s)@i', $name) === 1);
+        }
+
+        /**
+         * Check if a tag appears to be named like a version number.
+         *
+         * @param stdClass $tag
+         * @return bool
+         */
+        protected function isVersionTag($tag) {
+            $property = $this->tagNameProperty;
+            return isset($tag->$property) && $this->looksLikeVersion($tag->$property);
+        }
+
+        /**
+         * Sort a list of tags as if they were version numbers.
+         * Tags that don't look like version number will be removed.
+         *
+         * @param stdClass[] $tags Array of tag objects.
+         * @return stdClass[] Filtered array of tags sorted in descending order.
+         */
+        protected function sortTagsByVersion($tags) {
+            //Keep only those tags that look like version numbers.
+            $versionTags = array_filter($tags, array($this, 'isVersionTag'));
+            //Sort them in descending order.
+            usort($versionTags, array($this, 'compareTagNames'));
+
+            return $versionTags;
+        }
+
+        /**
+         * Compare two tags as if they were version number.
+         *
+         * @param stdClass $tag1 Tag object.
+         * @param stdClass $tag2 Another tag object.
+         * @return int
+         */
+        protected function compareTagNames($tag1, $tag2) {
+            $property = $this->tagNameProperty;
+            if ( !isset($tag1->$property) ) {
+                return 1;
+            }
+            if ( !isset($tag2->$property) ) {
+                return -1;
+            }
+            return -version_compare(ltrim($tag1->$property, 'v'), ltrim($tag2->$property, 'v'));
+        }
+
+        /**
+         * Get the contents of a file from a specific branch or tag.
+         *
+         * @param string $path File name.
+         * @param string $ref
+         * @return null|string Either the contents of the file, or null if the file doesn't exist or there's an error.
+         */
+        abstract public function getRemoteFile($path, $ref = 'master');
+
+        /**
+         * Get the timestamp of the latest commit that changed the specified branch or tag.
+         *
+         * @param string $ref Reference name (e.g. branch or tag).
+         * @return string|null
+         */
+        abstract public function getLatestCommitTime($ref);
+
+        /**
+         * Get the contents of the changelog file from the repository.
+         *
+         * @param string $ref
+         * @param string $localDirectory Full path to the local plugin or theme directory.
+         * @return null|string The HTML contents of the changelog.
+         */
+        public function getRemoteChangelog($ref, $localDirectory) {
+            $filename = $this->findChangelogName($localDirectory);
+            if ( empty($filename) ) {
+                return null;
+            }
+
+            $changelog = $this->getRemoteFile($filename, $ref);
+            if ( $changelog === null ) {
+                return null;
+            }
+
+            /** @noinspection PhpUndefinedClassInspection */
+            return Parsedown::instance()->text($changelog);
+        }
+
+        /**
+         * Guess the name of the changelog file.
+         *
+         * @param string $directory
+         * @return string|null
+         */
+        protected function findChangelogName($directory = null) {
+            if ( !isset($directory) ) {
+                $directory = $this->localDirectory;
+            }
+            if ( empty($directory) || !is_dir($directory) || ($directory === '.') ) {
+                return null;
+            }
+
+            $possibleNames = array('CHANGES.md', 'CHANGELOG.md', 'changes.md', 'changelog.md');
+            $files = scandir($directory);
+            $foundNames = array_intersect($possibleNames, $files);
+
+            if ( !empty($foundNames) ) {
+                return reset($foundNames);
+            }
+            return null;
+        }
+
+        /**
+         * Set authentication credentials.
+         *
+         * @param $credentials
+         */
+        public function setAuthentication($credentials) {
+            $this->credentials = $credentials;
+        }
+
+        public function isAuthenticationEnabled() {
+            return !empty($this->credentials);
+        }
+
+        /**
+         * @param string $url
+         * @return string
+         */
+        public function signDownloadUrl($url) {
+            return $url;
+        }
+
+        /**
+         * @param string $filterName
+         */
+        public function setHttpFilterName($filterName) {
+            $this->httpFilterName = $filterName;
+        }
+
+        /**
+         * @param string $directory
+         */
+        public function setLocalDirectory($directory) {
+            if ( empty($directory) || !is_dir($directory) || ($directory === '.') ) {
+                $this->localDirectory = null;
+            } else {
+                $this->localDirectory = $directory;
+            }
+        }
+
+        /**
+         * @param string $slug
+         */
+        public function setSlug($slug) {
+            $this->slug = $slug;
+        }
+    }
 
 endif;

classes/external/php/plugin-update-checker/Puc/v4p4/Vcs/BitBucketApi.php

Indentation +251 added lines, -251 removed lines

@@ -1,256 +1,256 @@
 <?php
 if ( !class_exists('Puc_v4p4_Vcs_BitBucketApi', false) ):
 
-	class Puc_v4p4_Vcs_BitBucketApi extends Puc_v4p4_Vcs_Api {
-		/**
-		 * @var Puc_v4p4_OAuthSignature
-		 */
-		private $oauth = null;
-
-		/**
-		 * @var string
-		 */
-		private $username;
-
-		/**
-		 * @var string
-		 */
-		private $repository;
-
-		public function __construct($repositoryUrl, $credentials = array()) {
-			$path = @parse_url($repositoryUrl, PHP_URL_PATH);
-			if ( preg_match('@^/?(?P<username>[^/]+?)/(?P<repository>[^/#?&]+?)/?$@', $path, $matches) ) {
-				$this->username = $matches['username'];
-				$this->repository = $matches['repository'];
-			} else {
-				throw new InvalidArgumentException('Invalid BitBucket repository URL: "' . $repositoryUrl . '"');
-			}
-
-			parent::__construct($repositoryUrl, $credentials);
-		}
-
-		/**
-		 * Figure out which reference (i.e tag or branch) contains the latest version.
-		 *
-		 * @param string $configBranch Start looking in this branch.
-		 * @return null|Puc_v4p4_Vcs_Reference
-		 */
-		public function chooseReference($configBranch) {
-			$updateSource = null;
-
-			//Check if there's a "Stable tag: 1.2.3" header that points to a valid tag.
-			$updateSource = $this->getStableTag($configBranch);
-
-			//Look for version-like tags.
-			if ( !$updateSource && ($configBranch === 'master') ) {
-				$updateSource = $this->getLatestTag();
-			}
-			//If all else fails, use the specified branch itself.
-			if ( !$updateSource ) {
-				$updateSource = $this->getBranch($configBranch);
-			}
-
-			return $updateSource;
-		}
-
-		public function getBranch($branchName) {
-			$branch = $this->api('/refs/branches/' . $branchName);
-			if ( is_wp_error($branch) || empty($branch) ) {
-				return null;
-			}
-
-			return new Puc_v4p4_Vcs_Reference(array(
-				'name' => $branch->name,
-				'updated' => $branch->target->date,
-				'downloadUrl' => $this->getDownloadUrl($branch->name),
-			));
-		}
-
-		/**
-		 * Get a specific tag.
-		 *
-		 * @param string $tagName
-		 * @return Puc_v4p4_Vcs_Reference|null
-		 */
-		public function getTag($tagName) {
-			$tag = $this->api('/refs/tags/' . $tagName);
-			if ( is_wp_error($tag) || empty($tag) ) {
-				return null;
-			}
-
-			return new Puc_v4p4_Vcs_Reference(array(
-				'name' => $tag->name,
-				'version' => ltrim($tag->name, 'v'),
-				'updated' => $tag->target->date,
-				'downloadUrl' => $this->getDownloadUrl($tag->name),
-			));
-		}
-
-		/**
-		 * Get the tag that looks like the highest version number.
-		 *
-		 * @return Puc_v4p4_Vcs_Reference|null
-		 */
-		public function getLatestTag() {
-			$tags = $this->api('/refs/tags?sort=-target.date');
-			if ( !isset($tags, $tags->values) || !is_array($tags->values) ) {
-				return null;
-			}
-
-			//Filter and sort the list of tags.
-			$versionTags = $this->sortTagsByVersion($tags->values);
-
-			//Return the first result.
-			if ( !empty($versionTags) ) {
-				$tag = $versionTags[0];
-				return new Puc_v4p4_Vcs_Reference(array(
-					'name' => $tag->name,
-					'version' => ltrim($tag->name, 'v'),
-					'updated' => $tag->target->date,
-					'downloadUrl' => $this->getDownloadUrl($tag->name),
-				));
-			}
-			return null;
-		}
-
-		/**
-		 * Get the tag/ref specified by the "Stable tag" header in the readme.txt of a given branch.
-		 *
-		 * @param string $branch
-		 * @return null|Puc_v4p4_Vcs_Reference
-		 */
-		protected function getStableTag($branch) {
-			$remoteReadme = $this->getRemoteReadme($branch);
-			if ( !empty($remoteReadme['stable_tag']) ) {
-				$tag = $remoteReadme['stable_tag'];
-
-				//You can explicitly opt out of using tags by setting "Stable tag" to
-				//"trunk" or the name of the current branch.
-				if ( ($tag === $branch) || ($tag === 'trunk') ) {
-					return $this->getBranch($branch);
-				}
-
-				return $this->getTag($tag);
-			}
-
-			return null;
-		}
-
-		/**
-		 * @param string $ref
-		 * @return string
-		 */
-		protected function getDownloadUrl($ref) {
-			return sprintf(
-				'https://bitbucket.org/%s/%s/get/%s.zip',
-				$this->username,
-				$this->repository,
-				$ref
-			);
-		}
-
-		/**
-		 * Get the contents of a file from a specific branch or tag.
-		 *
-		 * @param string $path File name.
-		 * @param string $ref
-		 * @return null|string Either the contents of the file, or null if the file doesn't exist or there's an error.
-		 */
-		public function getRemoteFile($path, $ref = 'master') {
-			$response = $this->api('src/' . $ref . '/' . ltrim($path), '1.0');
-			if ( is_wp_error($response) || !isset($response, $response->data) ) {
-				return null;
-			}
-			return $response->data;
-		}
-
-		/**
-		 * Get the timestamp of the latest commit that changed the specified branch or tag.
-		 *
-		 * @param string $ref Reference name (e.g. branch or tag).
-		 * @return string|null
-		 */
-		public function getLatestCommitTime($ref) {
-			$response = $this->api('commits/' . $ref);
-			if ( isset($response->values, $response->values[0], $response->values[0]->date) ) {
-				return $response->values[0]->date;
-			}
-			return null;
-		}
-
-		/**
-		 * Perform a BitBucket API 2.0 request.
-		 *
-		 * @param string $url
-		 * @param string $version
-		 * @return mixed|WP_Error
-		 */
-		public function api($url, $version = '2.0') {
-			$url = implode('/', array(
-				'https://api.bitbucket.org',
-				$version,
-				'repositories',
-				$this->username,
-				$this->repository,
-				ltrim($url, '/')
-			));
-			$baseUrl = $url;
-
-			if ( $this->oauth ) {
-				$url = $this->oauth->sign($url,'GET');
-			}
-
-			$options = array('timeout' => 10);
-			if ( !empty($this->httpFilterName) ) {
-				$options = apply_filters($this->httpFilterName, $options);
-			}
-			$response = wp_remote_get($url, $options);
-			if ( is_wp_error($response) ) {
-				do_action('puc_api_error', $response, null, $url, $this->slug);
-				return $response;
-			}
-
-			$code = wp_remote_retrieve_response_code($response);
-			$body = wp_remote_retrieve_body($response);
-			if ( $code === 200 ) {
-				$document = json_decode($body);
-				return $document;
-			}
-
-			$error = new WP_Error(
-				'puc-bitbucket-http-error',
-				sprintf('BitBucket API error. Base URL: "%s",  HTTP status code: %d.', $baseUrl, $code)
-			);
-			do_action('puc_api_error', $error, $response, $url, $this->slug);
-
-			return $error;
-		}
-
-		/**
-		 * @param array $credentials
-		 */
-		public function setAuthentication($credentials) {
-			parent::setAuthentication($credentials);
-
-			if ( !empty($credentials) && !empty($credentials['consumer_key']) ) {
-				$this->oauth = new Puc_v4p4_OAuthSignature(
-					$credentials['consumer_key'],
-					$credentials['consumer_secret']
-				);
-			} else {
-				$this->oauth = null;
-			}
-		}
-
-		public function signDownloadUrl($url) {
-			//Add authentication data to download URLs. Since OAuth signatures incorporate
-			//timestamps, we have to do this immediately before inserting the update. Otherwise
-			//authentication could fail due to a stale timestamp.
-			if ( $this->oauth ) {
-				$url = $this->oauth->sign($url);
-			}
-			return $url;
-		}
-	}
+    class Puc_v4p4_Vcs_BitBucketApi extends Puc_v4p4_Vcs_Api {
+        /**
+         * @var Puc_v4p4_OAuthSignature
+         */
+        private $oauth = null;
+
+        /**
+         * @var string
+         */
+        private $username;
+
+        /**
+         * @var string
+         */
+        private $repository;
+
+        public function __construct($repositoryUrl, $credentials = array()) {
+            $path = @parse_url($repositoryUrl, PHP_URL_PATH);
+            if ( preg_match('@^/?(?P<username>[^/]+?)/(?P<repository>[^/#?&]+?)/?$@', $path, $matches) ) {
+                $this->username = $matches['username'];
+                $this->repository = $matches['repository'];
+            } else {
+                throw new InvalidArgumentException('Invalid BitBucket repository URL: "' . $repositoryUrl . '"');
+            }
+
+            parent::__construct($repositoryUrl, $credentials);
+        }
+
+        /**
+         * Figure out which reference (i.e tag or branch) contains the latest version.
+         *
+         * @param string $configBranch Start looking in this branch.
+         * @return null|Puc_v4p4_Vcs_Reference
+         */
+        public function chooseReference($configBranch) {
+            $updateSource = null;
+
+            //Check if there's a "Stable tag: 1.2.3" header that points to a valid tag.
+            $updateSource = $this->getStableTag($configBranch);
+
+            //Look for version-like tags.
+            if ( !$updateSource && ($configBranch === 'master') ) {
+                $updateSource = $this->getLatestTag();
+            }
+            //If all else fails, use the specified branch itself.
+            if ( !$updateSource ) {
+                $updateSource = $this->getBranch($configBranch);
+            }
+
+            return $updateSource;
+        }
+
+        public function getBranch($branchName) {
+            $branch = $this->api('/refs/branches/' . $branchName);
+            if ( is_wp_error($branch) || empty($branch) ) {
+                return null;
+            }
+
+            return new Puc_v4p4_Vcs_Reference(array(
+                'name' => $branch->name,
+                'updated' => $branch->target->date,
+                'downloadUrl' => $this->getDownloadUrl($branch->name),
+            ));
+        }
+
+        /**
+         * Get a specific tag.
+         *
+         * @param string $tagName
+         * @return Puc_v4p4_Vcs_Reference|null
+         */
+        public function getTag($tagName) {
+            $tag = $this->api('/refs/tags/' . $tagName);
+            if ( is_wp_error($tag) || empty($tag) ) {
+                return null;
+            }
+
+            return new Puc_v4p4_Vcs_Reference(array(
+                'name' => $tag->name,
+                'version' => ltrim($tag->name, 'v'),
+                'updated' => $tag->target->date,
+                'downloadUrl' => $this->getDownloadUrl($tag->name),
+            ));
+        }
+
+        /**
+         * Get the tag that looks like the highest version number.
+         *
+         * @return Puc_v4p4_Vcs_Reference|null
+         */
+        public function getLatestTag() {
+            $tags = $this->api('/refs/tags?sort=-target.date');
+            if ( !isset($tags, $tags->values) || !is_array($tags->values) ) {
+                return null;
+            }
+
+            //Filter and sort the list of tags.
+            $versionTags = $this->sortTagsByVersion($tags->values);
+
+            //Return the first result.
+            if ( !empty($versionTags) ) {
+                $tag = $versionTags[0];
+                return new Puc_v4p4_Vcs_Reference(array(
+                    'name' => $tag->name,
+                    'version' => ltrim($tag->name, 'v'),
+                    'updated' => $tag->target->date,
+                    'downloadUrl' => $this->getDownloadUrl($tag->name),
+                ));
+            }
+            return null;
+        }
+
+        /**
+         * Get the tag/ref specified by the "Stable tag" header in the readme.txt of a given branch.
+         *
+         * @param string $branch
+         * @return null|Puc_v4p4_Vcs_Reference
+         */
+        protected function getStableTag($branch) {
+            $remoteReadme = $this->getRemoteReadme($branch);
+            if ( !empty($remoteReadme['stable_tag']) ) {
+                $tag = $remoteReadme['stable_tag'];
+
+                //You can explicitly opt out of using tags by setting "Stable tag" to
+                //"trunk" or the name of the current branch.
+                if ( ($tag === $branch) || ($tag === 'trunk') ) {
+                    return $this->getBranch($branch);
+                }
+
+                return $this->getTag($tag);
+            }
+
+            return null;
+        }
+
+        /**
+         * @param string $ref
+         * @return string
+         */
+        protected function getDownloadUrl($ref) {
+            return sprintf(
+                'https://bitbucket.org/%s/%s/get/%s.zip',
+                $this->username,
+                $this->repository,
+                $ref
+            );
+        }
+
+        /**
+         * Get the contents of a file from a specific branch or tag.
+         *
+         * @param string $path File name.
+         * @param string $ref
+         * @return null|string Either the contents of the file, or null if the file doesn't exist or there's an error.
+         */
+        public function getRemoteFile($path, $ref = 'master') {
+            $response = $this->api('src/' . $ref . '/' . ltrim($path), '1.0');
+            if ( is_wp_error($response) || !isset($response, $response->data) ) {
+                return null;
+            }
+            return $response->data;
+        }
+
+        /**
+         * Get the timestamp of the latest commit that changed the specified branch or tag.
+         *
+         * @param string $ref Reference name (e.g. branch or tag).
+         * @return string|null
+         */
+        public function getLatestCommitTime($ref) {
+            $response = $this->api('commits/' . $ref);
+            if ( isset($response->values, $response->values[0], $response->values[0]->date) ) {
+                return $response->values[0]->date;
+            }
+            return null;
+        }
+
+        /**
+         * Perform a BitBucket API 2.0 request.
+         *
+         * @param string $url
+         * @param string $version
+         * @return mixed|WP_Error
+         */
+        public function api($url, $version = '2.0') {
+            $url = implode('/', array(
+                'https://api.bitbucket.org',
+                $version,
+                'repositories',
+                $this->username,
+                $this->repository,
+                ltrim($url, '/')
+            ));
+            $baseUrl = $url;
+
+            if ( $this->oauth ) {
+                $url = $this->oauth->sign($url,'GET');
+            }
+
+            $options = array('timeout' => 10);
+            if ( !empty($this->httpFilterName) ) {
+                $options = apply_filters($this->httpFilterName, $options);
+            }
+            $response = wp_remote_get($url, $options);
+            if ( is_wp_error($response) ) {
+                do_action('puc_api_error', $response, null, $url, $this->slug);
+                return $response;
+            }
+
+            $code = wp_remote_retrieve_response_code($response);
+            $body = wp_remote_retrieve_body($response);
+            if ( $code === 200 ) {
+                $document = json_decode($body);
+                return $document;
+            }
+
+            $error = new WP_Error(
+                'puc-bitbucket-http-error',
+                sprintf('BitBucket API error. Base URL: "%s",  HTTP status code: %d.', $baseUrl, $code)
+            );
+            do_action('puc_api_error', $error, $response, $url, $this->slug);
+
+            return $error;
+        }
+
+        /**
+         * @param array $credentials
+         */
+        public function setAuthentication($credentials) {
+            parent::setAuthentication($credentials);
+
+            if ( !empty($credentials) && !empty($credentials['consumer_key']) ) {
+                $this->oauth = new Puc_v4p4_OAuthSignature(
+                    $credentials['consumer_key'],
+                    $credentials['consumer_secret']
+                );
+            } else {
+                $this->oauth = null;
+            }
+        }
+
+        public function signDownloadUrl($url) {
+            //Add authentication data to download URLs. Since OAuth signatures incorporate
+            //timestamps, we have to do this immediately before inserting the update. Otherwise
+            //authentication could fail due to a stale timestamp.
+            if ( $this->oauth ) {
+                $url = $this->oauth->sign($url);
+            }
+            return $url;
+        }
+    }
 
 endif;

classes/external/php/plugin-update-checker/Puc/v4p4/Vcs/GitHubApi.php

Indentation +407 added lines, -407 removed lines

@@ -2,412 +2,412 @@
 
 if ( !class_exists('Puc_v4p4_Vcs_GitHubApi', false) ):
 
-	class Puc_v4p4_Vcs_GitHubApi extends Puc_v4p4_Vcs_Api {
-		/**
-		 * @var string GitHub username.
-		 */
-		protected $userName;
-		/**
-		 * @var string GitHub repository name.
-		 */
-		protected $repositoryName;
-
-		/**
-		 * @var string Either a fully qualified repository URL, or just "user/repo-name".
-		 */
-		protected $repositoryUrl;
-
-		/**
-		 * @var string GitHub authentication token. Optional.
-		 */
-		protected $accessToken;
-
-		/**
-		 * @var bool Whether to download release assets instead of the auto-generated source code archives.
-		 */
-		protected $releaseAssetsEnabled = false;
-
-		/**
-		 * @var string|null Regular expression that's used to filter release assets by name. Optional.
-		 */
-		protected $assetFilterRegex = null;
-
-		/**
-		 * @var string|null The unchanging part of a release asset URL. Used to identify download attempts.
-		 */
-		protected $assetApiBaseUrl = null;
-
-		public function __construct($repositoryUrl, $accessToken = null) {
-			$path = @parse_url($repositoryUrl, PHP_URL_PATH);
-			if ( preg_match('@^/?(?P<username>[^/]+?)/(?P<repository>[^/#?&]+?)/?$@', $path, $matches) ) {
-				$this->userName = $matches['username'];
-				$this->repositoryName = $matches['repository'];
-			} else {
-				throw new InvalidArgumentException('Invalid GitHub repository URL: "' . $repositoryUrl . '"');
-			}
-
-			parent::__construct($repositoryUrl, $accessToken);
-		}
-
-		/**
-		 * Get the latest release from GitHub.
-		 *
-		 * @return Puc_v4p4_Vcs_Reference|null
-		 */
-		public function getLatestRelease() {
-			$release = $this->api('/repos/:user/:repo/releases/latest');
-			if ( is_wp_error($release) || !is_object($release) || !isset($release->tag_name) ) {
-				return null;
-			}
-
-			$reference = new Puc_v4p4_Vcs_Reference(array(
-				'name'        => $release->tag_name,
-				'version'     => ltrim($release->tag_name, 'v'), //Remove the "v" prefix from "v1.2.3".
-				'downloadUrl' => $this->signDownloadUrl($release->zipball_url),
-				'updated'     => $release->created_at,
-				'apiResponse' => $release,
-			));
-
-			if ( isset($release->assets[0]) ) {
-				$reference->downloadCount = $release->assets[0]->download_count;
-			}
-
-			if ( $this->releaseAssetsEnabled && isset($release->assets, $release->assets[0]) ) {
-				//Use the first release asset that matches the specified regular expression.
-				$matchingAssets = array_filter($release->assets, array($this, 'matchesAssetFilter'));
-				if ( !empty($matchingAssets) ) {
-					if ( $this->isAuthenticationEnabled() ) {
-						/**
-						 * Keep in mind that we'll need to add an "Accept" header to download this asset.
-						 * @see setReleaseDownloadHeader()
-						 */
-						$reference->downloadUrl = $this->signDownloadUrl($matchingAssets[0]->url);
-					} else {
-						//It seems that browser_download_url only works for public repositories.
-						//Using an access_token doesn't help. Maybe OAuth would work?
-						$reference->downloadUrl = $matchingAssets[0]->browser_download_url;
-					}
-
-					$reference->downloadCount = $matchingAssets[0]->download_count;
-				}
-			}
-
-			if ( !empty($release->body) ) {
-				/** @noinspection PhpUndefinedClassInspection */
-				$reference->changelog = Parsedown::instance()->text($release->body);
-			}
-
-			return $reference;
-		}
-
-		/**
-		 * Get the tag that looks like the highest version number.
-		 *
-		 * @return Puc_v4p4_Vcs_Reference|null
-		 */
-		public function getLatestTag() {
-			$tags = $this->api('/repos/:user/:repo/tags');
-
-			if ( is_wp_error($tags) || empty($tags) || !is_array($tags) ) {
-				return null;
-			}
-
-			$versionTags = $this->sortTagsByVersion($tags);
-			if ( empty($versionTags) ) {
-				return null;
-			}
-
-			$tag = $versionTags[0];
-			return new Puc_v4p4_Vcs_Reference(array(
-				'name'        => $tag->name,
-				'version'     => ltrim($tag->name, 'v'),
-				'downloadUrl' => $this->signDownloadUrl($tag->zipball_url),
-				'apiResponse' => $tag,
-			));
-		}
-
-		/**
-		 * Get a branch by name.
-		 *
-		 * @param string $branchName
-		 * @return null|Puc_v4p4_Vcs_Reference
-		 */
-		public function getBranch($branchName) {
-			$branch = $this->api('/repos/:user/:repo/branches/' . $branchName);
-			if ( is_wp_error($branch) || empty($branch) ) {
-				return null;
-			}
-
-			$reference = new Puc_v4p4_Vcs_Reference(array(
-				'name'        => $branch->name,
-				'downloadUrl' => $this->buildArchiveDownloadUrl($branch->name),
-				'apiResponse' => $branch,
-			));
-
-			if ( isset($branch->commit, $branch->commit->commit, $branch->commit->commit->author->date) ) {
-				$reference->updated = $branch->commit->commit->author->date;
-			}
-
-			return $reference;
-		}
-
-		/**
-		 * Get the latest commit that changed the specified file.
-		 *
-		 * @param string $filename
-		 * @param string $ref Reference name (e.g. branch or tag).
-		 * @return StdClass|null
-		 */
-		public function getLatestCommit($filename, $ref = 'master') {
-			$commits = $this->api(
-				'/repos/:user/:repo/commits',
-				array(
-					'path' => $filename,
-					'sha'  => $ref,
-				)
-			);
-			if ( !is_wp_error($commits) && is_array($commits) && isset($commits[0]) ) {
-				return $commits[0];
-			}
-			return null;
-		}
-
-		/**
-		 * Get the timestamp of the latest commit that changed the specified branch or tag.
-		 *
-		 * @param string $ref Reference name (e.g. branch or tag).
-		 * @return string|null
-		 */
-		public function getLatestCommitTime($ref) {
-			$commits = $this->api('/repos/:user/:repo/commits', array('sha' => $ref));
-			if ( !is_wp_error($commits) && is_array($commits) && isset($commits[0]) ) {
-				return $commits[0]->commit->author->date;
-			}
-			return null;
-		}
-
-		/**
-		 * Perform a GitHub API request.
-		 *
-		 * @param string $url
-		 * @param array $queryParams
-		 * @return mixed|WP_Error
-		 */
-		protected function api($url, $queryParams = array()) {
-			$baseUrl = $url;
-			$url = $this->buildApiUrl($url, $queryParams);
-
-			$options = array('timeout' => 10);
-			if ( !empty($this->httpFilterName) ) {
-				$options = apply_filters($this->httpFilterName, $options);
-			}
-			$response = wp_remote_get($url, $options);
-			if ( is_wp_error($response) ) {
-				do_action('puc_api_error', $response, null, $url, $this->slug);
-				return $response;
-			}
-
-			$code = wp_remote_retrieve_response_code($response);
-			$body = wp_remote_retrieve_body($response);
-			if ( $code === 200 ) {
-				$document = json_decode($body);
-				return $document;
-			}
-
-			$error = new WP_Error(
-				'puc-github-http-error',
-				sprintf('GitHub API error. Base URL: "%s",  HTTP status code: %d.', $baseUrl, $code)
-			);
-			do_action('puc_api_error', $error, $response, $url, $this->slug);
-
-			return $error;
-		}
-
-		/**
-		 * Build a fully qualified URL for an API request.
-		 *
-		 * @param string $url
-		 * @param array $queryParams
-		 * @return string
-		 */
-		protected function buildApiUrl($url, $queryParams) {
-			$variables = array(
-				'user' => $this->userName,
-				'repo' => $this->repositoryName,
-			);
-			foreach ($variables as $name => $value) {
-				$url = str_replace('/:' . $name, '/' . urlencode($value), $url);
-			}
-			$url = 'https://api.github.com' . $url;
-
-			if ( !empty($this->accessToken) ) {
-				$queryParams['access_token'] = $this->accessToken;
-			}
-			if ( !empty($queryParams) ) {
-				$url = add_query_arg($queryParams, $url);
-			}
-
-			return $url;
-		}
-
-		/**
-		 * Get the contents of a file from a specific branch or tag.
-		 *
-		 * @param string $path File name.
-		 * @param string $ref
-		 * @return null|string Either the contents of the file, or null if the file doesn't exist or there's an error.
-		 */
-		public function getRemoteFile($path, $ref = 'master') {
-			$apiUrl = '/repos/:user/:repo/contents/' . $path;
-			$response = $this->api($apiUrl, array('ref' => $ref));
-
-			if ( is_wp_error($response) || !isset($response->content) || ($response->encoding !== 'base64') ) {
-				return null;
-			}
-			return base64_decode($response->content);
-		}
-
-		/**
-		 * Generate a URL to download a ZIP archive of the specified branch/tag/etc.
-		 *
-		 * @param string $ref
-		 * @return string
-		 */
-		public function buildArchiveDownloadUrl($ref = 'master') {
-			$url = sprintf(
-				'https://api.github.com/repos/%1$s/%2$s/zipball/%3$s',
-				urlencode($this->userName),
-				urlencode($this->repositoryName),
-				urlencode($ref)
-			);
-			if ( !empty($this->accessToken) ) {
-				$url = $this->signDownloadUrl($url);
-			}
-			return $url;
-		}
-
-		/**
-		 * Get a specific tag.
-		 *
-		 * @param string $tagName
-		 * @return Puc_v4p4_Vcs_Reference|null
-		 */
-		public function getTag($tagName) {
-			//The current GitHub update checker doesn't use getTag, so I didn't bother to implement it.
-			throw new LogicException('The ' . __METHOD__ . ' method is not implemented and should not be used.');
-		}
-
-		public function setAuthentication($credentials) {
-			parent::setAuthentication($credentials);
-			$this->accessToken = is_string($credentials) ? $credentials : null;
-		}
-
-		/**
-		 * Figure out which reference (i.e tag or branch) contains the latest version.
-		 *
-		 * @param string $configBranch Start looking in this branch.
-		 * @return null|Puc_v4p4_Vcs_Reference
-		 */
-		public function chooseReference($configBranch) {
-			$updateSource = null;
-
-			if ( $configBranch === 'master' ) {
-				//Use the latest release.
-				$updateSource = $this->getLatestRelease();
-				if ( $updateSource === null ) {
-					//Failing that, use the tag with the highest version number.
-					$updateSource = $this->getLatestTag();
-				}
-			}
-			//Alternatively, just use the branch itself.
-			if ( empty($updateSource) ) {
-				$updateSource = $this->getBranch($configBranch);
-			}
-
-			return $updateSource;
-		}
-
-		/**
-		 * @param string $url
-		 * @return string
-		 */
-		public function signDownloadUrl($url) {
-			if ( empty($this->credentials) ) {
-				return $url;
-			}
-			return add_query_arg('access_token', $this->credentials, $url);
-		}
-
-		/**
-		 * Enable updating via release assets.
-		 *
-		 * If the latest release contains no usable assets, the update checker
-		 * will fall back to using the automatically generated ZIP archive.
-		 *
-		 * Private repositories will only work with WordPress 3.7 or later.
-		 *
-		 * @param string|null $fileNameRegex Optional. Use only those assets where the file name matches this regex.
-		 */
-		public function enableReleaseAssets($fileNameRegex = null) {
-			$this->releaseAssetsEnabled = true;
-			$this->assetFilterRegex = $fileNameRegex;
-			$this->assetApiBaseUrl = sprintf(
-				'//api.github.com/repos/%1$s/%2$s/releases/assets/',
-				$this->userName,
-				$this->repositoryName
-			);
-
-			//Optimization: Instead of filtering all HTTP requests, let's do it only when
-			//WordPress is about to download an update.
-			add_filter('upgrader_pre_download', array($this, 'addHttpRequestFilter'), 10, 1); //WP 3.7+
-		}
-
-		/**
-		 * Does this asset match the file name regex?
-		 *
-		 * @param stdClass $releaseAsset
-		 * @return bool
-		 */
-		protected function matchesAssetFilter($releaseAsset) {
-			if ( $this->assetFilterRegex === null ) {
-				//The default is to accept all assets.
-				return true;
-			}
-			return isset($releaseAsset->name) && preg_match($this->assetFilterRegex, $releaseAsset->name);
-		}
-
-		/**
-		 * @internal
-		 * @param bool $result
-		 * @return bool
-		 */
-		public function addHttpRequestFilter($result) {
-			static $filterAdded = false;
-			if ( $this->releaseAssetsEnabled && !$filterAdded && $this->isAuthenticationEnabled() ) {
-				add_filter('http_request_args', array($this, 'setReleaseDownloadHeader'), 10, 2);
-				$filterAdded = true;
-			}
-			return $result;
-		}
-
-		/**
-		 * Set the HTTP header that's necessary to download private release assets.
-		 *
-		 * See GitHub docs:
-		 * @link https://developer.github.com/v3/repos/releases/#get-a-single-release-asset
-		 *
-		 * @internal
-		 * @param array $requestArgs
-		 * @param string $url
-		 * @return array
-		 */
-		public function setReleaseDownloadHeader($requestArgs, $url = '') {
-			//Is WordPress trying to download one of our assets?
-			if ( strpos($url, $this->assetApiBaseUrl) !== false ) {
-				$requestArgs['headers']['accept'] = 'application/octet-stream';
-			}
-			return $requestArgs;
-		}
-	}
+    class Puc_v4p4_Vcs_GitHubApi extends Puc_v4p4_Vcs_Api {
+        /**
+         * @var string GitHub username.
+         */
+        protected $userName;
+        /**
+         * @var string GitHub repository name.
+         */
+        protected $repositoryName;
+
+        /**
+         * @var string Either a fully qualified repository URL, or just "user/repo-name".
+         */
+        protected $repositoryUrl;
+
+        /**
+         * @var string GitHub authentication token. Optional.
+         */
+        protected $accessToken;
+
+        /**
+         * @var bool Whether to download release assets instead of the auto-generated source code archives.
+         */
+        protected $releaseAssetsEnabled = false;
+
+        /**
+         * @var string|null Regular expression that's used to filter release assets by name. Optional.
+         */
+        protected $assetFilterRegex = null;
+
+        /**
+         * @var string|null The unchanging part of a release asset URL. Used to identify download attempts.
+         */
+        protected $assetApiBaseUrl = null;
+
+        public function __construct($repositoryUrl, $accessToken = null) {
+            $path = @parse_url($repositoryUrl, PHP_URL_PATH);
+            if ( preg_match('@^/?(?P<username>[^/]+?)/(?P<repository>[^/#?&]+?)/?$@', $path, $matches) ) {
+                $this->userName = $matches['username'];
+                $this->repositoryName = $matches['repository'];
+            } else {
+                throw new InvalidArgumentException('Invalid GitHub repository URL: "' . $repositoryUrl . '"');
+            }
+
+            parent::__construct($repositoryUrl, $accessToken);
+        }
+
+        /**
+         * Get the latest release from GitHub.
+         *
+         * @return Puc_v4p4_Vcs_Reference|null
+         */
+        public function getLatestRelease() {
+            $release = $this->api('/repos/:user/:repo/releases/latest');
+            if ( is_wp_error($release) || !is_object($release) || !isset($release->tag_name) ) {
+                return null;
+            }
+
+            $reference = new Puc_v4p4_Vcs_Reference(array(
+                'name'        => $release->tag_name,
+                'version'     => ltrim($release->tag_name, 'v'), //Remove the "v" prefix from "v1.2.3".
+                'downloadUrl' => $this->signDownloadUrl($release->zipball_url),
+                'updated'     => $release->created_at,
+                'apiResponse' => $release,
+            ));
+
+            if ( isset($release->assets[0]) ) {
+                $reference->downloadCount = $release->assets[0]->download_count;
+            }
+
+            if ( $this->releaseAssetsEnabled && isset($release->assets, $release->assets[0]) ) {
+                //Use the first release asset that matches the specified regular expression.
+                $matchingAssets = array_filter($release->assets, array($this, 'matchesAssetFilter'));
+                if ( !empty($matchingAssets) ) {
+                    if ( $this->isAuthenticationEnabled() ) {
+                        /**
+                         * Keep in mind that we'll need to add an "Accept" header to download this asset.
+                         * @see setReleaseDownloadHeader()
+                         */
+                        $reference->downloadUrl = $this->signDownloadUrl($matchingAssets[0]->url);
+                    } else {
+                        //It seems that browser_download_url only works for public repositories.
+                        //Using an access_token doesn't help. Maybe OAuth would work?
+                        $reference->downloadUrl = $matchingAssets[0]->browser_download_url;
+                    }
+
+                    $reference->downloadCount = $matchingAssets[0]->download_count;
+                }
+            }
+
+            if ( !empty($release->body) ) {
+                /** @noinspection PhpUndefinedClassInspection */
+                $reference->changelog = Parsedown::instance()->text($release->body);
+            }
+
+            return $reference;
+        }
+
+        /**
+         * Get the tag that looks like the highest version number.
+         *
+         * @return Puc_v4p4_Vcs_Reference|null
+         */
+        public function getLatestTag() {
+            $tags = $this->api('/repos/:user/:repo/tags');
+
+            if ( is_wp_error($tags) || empty($tags) || !is_array($tags) ) {
+                return null;
+            }
+
+            $versionTags = $this->sortTagsByVersion($tags);
+            if ( empty($versionTags) ) {
+                return null;
+            }
+
+            $tag = $versionTags[0];
+            return new Puc_v4p4_Vcs_Reference(array(
+                'name'        => $tag->name,
+                'version'     => ltrim($tag->name, 'v'),
+                'downloadUrl' => $this->signDownloadUrl($tag->zipball_url),
+                'apiResponse' => $tag,
+            ));
+        }
+
+        /**
+         * Get a branch by name.
+         *
+         * @param string $branchName
+         * @return null|Puc_v4p4_Vcs_Reference
+         */
+        public function getBranch($branchName) {
+            $branch = $this->api('/repos/:user/:repo/branches/' . $branchName);
+            if ( is_wp_error($branch) || empty($branch) ) {
+                return null;
+            }
+
+            $reference = new Puc_v4p4_Vcs_Reference(array(
+                'name'        => $branch->name,
+                'downloadUrl' => $this->buildArchiveDownloadUrl($branch->name),
+                'apiResponse' => $branch,
+            ));
+
+            if ( isset($branch->commit, $branch->commit->commit, $branch->commit->commit->author->date) ) {
+                $reference->updated = $branch->commit->commit->author->date;
+            }
+
+            return $reference;
+        }
+
+        /**
+         * Get the latest commit that changed the specified file.
+         *
+         * @param string $filename
+         * @param string $ref Reference name (e.g. branch or tag).
+         * @return StdClass|null
+         */
+        public function getLatestCommit($filename, $ref = 'master') {
+            $commits = $this->api(
+                '/repos/:user/:repo/commits',
+                array(
+                    'path' => $filename,
+                    'sha'  => $ref,
+                )
+            );
+            if ( !is_wp_error($commits) && is_array($commits) && isset($commits[0]) ) {
+                return $commits[0];
+            }
+            return null;
+        }
+
+        /**
+         * Get the timestamp of the latest commit that changed the specified branch or tag.
+         *
+         * @param string $ref Reference name (e.g. branch or tag).
+         * @return string|null
+         */
+        public function getLatestCommitTime($ref) {
+            $commits = $this->api('/repos/:user/:repo/commits', array('sha' => $ref));
+            if ( !is_wp_error($commits) && is_array($commits) && isset($commits[0]) ) {
+                return $commits[0]->commit->author->date;
+            }
+            return null;
+        }
+
+        /**
+         * Perform a GitHub API request.
+         *
+         * @param string $url
+         * @param array $queryParams
+         * @return mixed|WP_Error
+         */
+        protected function api($url, $queryParams = array()) {
+            $baseUrl = $url;
+            $url = $this->buildApiUrl($url, $queryParams);
+
+            $options = array('timeout' => 10);
+            if ( !empty($this->httpFilterName) ) {
+                $options = apply_filters($this->httpFilterName, $options);
+            }
+            $response = wp_remote_get($url, $options);
+            if ( is_wp_error($response) ) {
+                do_action('puc_api_error', $response, null, $url, $this->slug);
+                return $response;
+            }
+
+            $code = wp_remote_retrieve_response_code($response);
+            $body = wp_remote_retrieve_body($response);
+            if ( $code === 200 ) {
+                $document = json_decode($body);
+                return $document;
+            }
+
+            $error = new WP_Error(
+                'puc-github-http-error',
+                sprintf('GitHub API error. Base URL: "%s",  HTTP status code: %d.', $baseUrl, $code)
+            );
+            do_action('puc_api_error', $error, $response, $url, $this->slug);
+
+            return $error;
+        }
+
+        /**
+         * Build a fully qualified URL for an API request.
+         *
+         * @param string $url
+         * @param array $queryParams
+         * @return string
+         */
+        protected function buildApiUrl($url, $queryParams) {
+            $variables = array(
+                'user' => $this->userName,
+                'repo' => $this->repositoryName,
+            );
+            foreach ($variables as $name => $value) {
+                $url = str_replace('/:' . $name, '/' . urlencode($value), $url);
+            }
+            $url = 'https://api.github.com' . $url;
+
+            if ( !empty($this->accessToken) ) {
+                $queryParams['access_token'] = $this->accessToken;
+            }
+            if ( !empty($queryParams) ) {
+                $url = add_query_arg($queryParams, $url);
+            }
+
+            return $url;
+        }
+
+        /**
+         * Get the contents of a file from a specific branch or tag.
+         *
+         * @param string $path File name.
+         * @param string $ref
+         * @return null|string Either the contents of the file, or null if the file doesn't exist or there's an error.
+         */
+        public function getRemoteFile($path, $ref = 'master') {
+            $apiUrl = '/repos/:user/:repo/contents/' . $path;
+            $response = $this->api($apiUrl, array('ref' => $ref));
+
+            if ( is_wp_error($response) || !isset($response->content) || ($response->encoding !== 'base64') ) {
+                return null;
+            }
+            return base64_decode($response->content);
+        }
+
+        /**
+         * Generate a URL to download a ZIP archive of the specified branch/tag/etc.
+         *
+         * @param string $ref
+         * @return string
+         */
+        public function buildArchiveDownloadUrl($ref = 'master') {
+            $url = sprintf(
+                'https://api.github.com/repos/%1$s/%2$s/zipball/%3$s',
+                urlencode($this->userName),
+                urlencode($this->repositoryName),
+                urlencode($ref)
+            );
+            if ( !empty($this->accessToken) ) {
+                $url = $this->signDownloadUrl($url);
+            }
+            return $url;
+        }
+
+        /**
+         * Get a specific tag.
+         *
+         * @param string $tagName
+         * @return Puc_v4p4_Vcs_Reference|null
+         */
+        public function getTag($tagName) {
+            //The current GitHub update checker doesn't use getTag, so I didn't bother to implement it.
+            throw new LogicException('The ' . __METHOD__ . ' method is not implemented and should not be used.');
+        }
+
+        public function setAuthentication($credentials) {
+            parent::setAuthentication($credentials);
+            $this->accessToken = is_string($credentials) ? $credentials : null;
+        }
+
+        /**
+         * Figure out which reference (i.e tag or branch) contains the latest version.
+         *
+         * @param string $configBranch Start looking in this branch.
+         * @return null|Puc_v4p4_Vcs_Reference
+         */
+        public function chooseReference($configBranch) {
+            $updateSource = null;
+
+            if ( $configBranch === 'master' ) {
+                //Use the latest release.
+                $updateSource = $this->getLatestRelease();
+                if ( $updateSource === null ) {
+                    //Failing that, use the tag with the highest version number.
+                    $updateSource = $this->getLatestTag();
+                }
+            }
+            //Alternatively, just use the branch itself.
+            if ( empty($updateSource) ) {
+                $updateSource = $this->getBranch($configBranch);
+            }
+
+            return $updateSource;
+        }
+
+        /**
+         * @param string $url
+         * @return string
+         */
+        public function signDownloadUrl($url) {
+            if ( empty($this->credentials) ) {
+                return $url;
+            }
+            return add_query_arg('access_token', $this->credentials, $url);
+        }
+
+        /**
+         * Enable updating via release assets.
+         *
+         * If the latest release contains no usable assets, the update checker
+         * will fall back to using the automatically generated ZIP archive.
+         *
+         * Private repositories will only work with WordPress 3.7 or later.
+         *
+         * @param string|null $fileNameRegex Optional. Use only those assets where the file name matches this regex.
+         */
+        public function enableReleaseAssets($fileNameRegex = null) {
+            $this->releaseAssetsEnabled = true;
+            $this->assetFilterRegex = $fileNameRegex;
+            $this->assetApiBaseUrl = sprintf(
+                '//api.github.com/repos/%1$s/%2$s/releases/assets/',
+                $this->userName,
+                $this->repositoryName
+            );
+
+            //Optimization: Instead of filtering all HTTP requests, let's do it only when
+            //WordPress is about to download an update.
+            add_filter('upgrader_pre_download', array($this, 'addHttpRequestFilter'), 10, 1); //WP 3.7+
+        }
+
+        /**
+         * Does this asset match the file name regex?
+         *
+         * @param stdClass $releaseAsset
+         * @return bool
+         */
+        protected function matchesAssetFilter($releaseAsset) {
+            if ( $this->assetFilterRegex === null ) {
+                //The default is to accept all assets.
+                return true;
+            }
+            return isset($releaseAsset->name) && preg_match($this->assetFilterRegex, $releaseAsset->name);
+        }
+
+        /**
+         * @internal
+         * @param bool $result
+         * @return bool
+         */
+        public function addHttpRequestFilter($result) {
+            static $filterAdded = false;
+            if ( $this->releaseAssetsEnabled && !$filterAdded && $this->isAuthenticationEnabled() ) {
+                add_filter('http_request_args', array($this, 'setReleaseDownloadHeader'), 10, 2);
+                $filterAdded = true;
+            }
+            return $result;
+        }
+
+        /**
+         * Set the HTTP header that's necessary to download private release assets.
+         *
+         * See GitHub docs:
+         * @link https://developer.github.com/v3/repos/releases/#get-a-single-release-asset
+         *
+         * @internal
+         * @param array $requestArgs
+         * @param string $url
+         * @return array
+         */
+        public function setReleaseDownloadHeader($requestArgs, $url = '') {
+            //Is WordPress trying to download one of our assets?
+            if ( strpos($url, $this->assetApiBaseUrl) !== false ) {
+                $requestArgs['headers']['accept'] = 'application/octet-stream';
+            }
+            return $requestArgs;
+        }
+    }
 
 endif;
\ No newline at end of file

classes/external/php/plugin-update-checker/Puc/v4p4/Vcs/PluginUpdateChecker.php

Indentation +212 added lines, -212 removed lines

@@ -1,217 +1,217 @@
 <?php
 if ( !class_exists('Puc_v4p4_Vcs_PluginUpdateChecker') ):
 
-	class Puc_v4p4_Vcs_PluginUpdateChecker extends Puc_v4p4_Plugin_UpdateChecker implements Puc_v4p4_Vcs_BaseChecker {
-		/**
-		 * @var string The branch where to look for updates. Defaults to "master".
-		 */
-		protected $branch = 'master';
-
-		/**
-		 * @var Puc_v4p4_Vcs_Api Repository API client.
-		 */
-		protected $api = null;
-
-		/**
-		 * Puc_v4p4_Vcs_PluginUpdateChecker constructor.
-		 *
-		 * @param Puc_v4p4_Vcs_Api $api
-		 * @param string $pluginFile
-		 * @param string $slug
-		 * @param int $checkPeriod
-		 * @param string $optionName
-		 * @param string $muPluginFile
-		 */
-		public function __construct($api, $pluginFile, $slug = '', $checkPeriod = 12, $optionName = '', $muPluginFile = '') {
-			$this->api = $api;
-			$this->api->setHttpFilterName($this->getUniqueName('request_info_options'));
-
-			parent::__construct($api->getRepositoryUrl(), $pluginFile, $slug, $checkPeriod, $optionName, $muPluginFile);
-
-			$this->api->setSlug($this->slug);
-		}
-
-		public function requestInfo($unusedParameter = null) {
-			//We have to make several remote API requests to gather all the necessary info
-			//which can take a while on slow networks.
-			if ( function_exists('set_time_limit') ) {
-				@set_time_limit(60);
-			}
-
-			$api = $this->api;
-			$api->setLocalDirectory($this->getAbsoluteDirectoryPath());
-
-			$info = new Puc_v4p4_Plugin_Info();
-			$info->filename = $this->pluginFile;
-			$info->slug = $this->slug;
-
-			$this->setInfoFromHeader($this->getPluginHeader(), $info);
-
-			//Pick a branch or tag.
-			$updateSource = $api->chooseReference($this->branch);
-			if ( $updateSource ) {
-				$ref = $updateSource->name;
-				$info->version = $updateSource->version;
-				$info->last_updated = $updateSource->updated;
-				$info->download_url = $updateSource->downloadUrl;
-
-				if ( !empty($updateSource->changelog) ) {
-					$info->sections['changelog'] = $updateSource->changelog;
-				}
-				if ( isset($updateSource->downloadCount) ) {
-					$info->downloaded = $updateSource->downloadCount;
-				}
-			} else {
-				//There's probably a network problem or an authentication error.
-				do_action(
-					'puc_api_error',
-					new WP_Error(
-						'puc-no-update-source',
-						'Could not retrieve version information from the repository. '
-						. 'This usually means that the update checker either can\'t connect '
-						. 'to the repository or it\'s configured incorrectly.'
-					),
-					null, null, $this->slug
-				);
-				return null;
-			}
-
-			//Get headers from the main plugin file in this branch/tag. Its "Version" header and other metadata
-			//are what the WordPress install will actually see after upgrading, so they take precedence over releases/tags.
-			$mainPluginFile = basename($this->pluginFile);
-			$remotePlugin = $api->getRemoteFile($mainPluginFile, $ref);
-			if ( !empty($remotePlugin) ) {
-				$remoteHeader = $this->getFileHeader($remotePlugin);
-				$this->setInfoFromHeader($remoteHeader, $info);
-			}
-
-			//Try parsing readme.txt. If it's formatted according to WordPress.org standards, it will contain
-			//a lot of useful information like the required/tested WP version, changelog, and so on.
-			if ( $this->readmeTxtExistsLocally() ) {
-				$this->setInfoFromRemoteReadme($ref, $info);
-			}
-
-			//The changelog might be in a separate file.
-			if ( empty($info->sections['changelog']) ) {
-				$info->sections['changelog'] = $api->getRemoteChangelog($ref, dirname($this->getAbsolutePath()));
-				if ( empty($info->sections['changelog']) ) {
-					$info->sections['changelog'] = __('There is no changelog available.', 'plugin-update-checker');
-				}
-			}
-
-			if ( empty($info->last_updated) ) {
-				//Fetch the latest commit that changed the tag or branch and use it as the "last_updated" date.
-				$latestCommitTime = $api->getLatestCommitTime($ref);
-				if ( $latestCommitTime !== null ) {
-					$info->last_updated = $latestCommitTime;
-				}
-			}
-
-			$info = apply_filters($this->getUniqueName('request_info_result'), $info, null);
-			return $info;
-		}
-
-		/**
-		 * Check if the currently installed version has a readme.txt file.
-		 *
-		 * @return bool
-		 */
-		protected function readmeTxtExistsLocally() {
-			$pluginDirectory = $this->getAbsoluteDirectoryPath();
-			if ( empty($pluginDirectory) || !is_dir($pluginDirectory) || ($pluginDirectory === '.') ) {
-				return false;
-			}
-			return is_file($pluginDirectory . '/' . $this->api->getLocalReadmeName());
-		}
-
-		/**
-		 * Copy plugin metadata from a file header to a Plugin Info object.
-		 *
-		 * @param array $fileHeader
-		 * @param Puc_v4p4_Plugin_Info $pluginInfo
-		 */
-		protected function setInfoFromHeader($fileHeader, $pluginInfo) {
-			$headerToPropertyMap = array(
-				'Version' => 'version',
-				'Name' => 'name',
-				'PluginURI' => 'homepage',
-				'Author' => 'author',
-				'AuthorName' => 'author',
-				'AuthorURI' => 'author_homepage',
-
-				'Requires WP' => 'requires',
-				'Tested WP' => 'tested',
-				'Requires at least' => 'requires',
-				'Tested up to' => 'tested',
-			);
-			foreach ($headerToPropertyMap as $headerName => $property) {
-				if ( isset($fileHeader[$headerName]) && !empty($fileHeader[$headerName]) ) {
-					$pluginInfo->$property = $fileHeader[$headerName];
-				}
-			}
-
-			if ( !empty($fileHeader['Description']) ) {
-				$pluginInfo->sections['description'] = $fileHeader['Description'];
-			}
-		}
-
-		/**
-		 * Copy plugin metadata from the remote readme.txt file.
-		 *
-		 * @param string $ref GitHub tag or branch where to look for the readme.
-		 * @param Puc_v4p4_Plugin_Info $pluginInfo
-		 */
-		protected function setInfoFromRemoteReadme($ref, $pluginInfo) {
-			$readme = $this->api->getRemoteReadme($ref);
-			if ( empty($readme) ) {
-				return;
-			}
-
-			if ( isset($readme['sections']) ) {
-				$pluginInfo->sections = array_merge($pluginInfo->sections, $readme['sections']);
-			}
-			if ( !empty($readme['tested_up_to']) ) {
-				$pluginInfo->tested = $readme['tested_up_to'];
-			}
-			if ( !empty($readme['requires_at_least']) ) {
-				$pluginInfo->requires = $readme['requires_at_least'];
-			}
-
-			if ( isset($readme['upgrade_notice'], $readme['upgrade_notice'][$pluginInfo->version]) ) {
-				$pluginInfo->upgrade_notice = $readme['upgrade_notice'][$pluginInfo->version];
-			}
-		}
-
-		public function setBranch($branch) {
-			$this->branch = $branch;
-			return $this;
-		}
-
-		public function setAuthentication($credentials) {
-			$this->api->setAuthentication($credentials);
-			return $this;
-		}
-
-		public function getVcsApi() {
-			return $this->api;
-		}
-
-		public function getUpdate() {
-			$update = parent::getUpdate();
-
-			if ( isset($update) && !empty($update->download_url) ) {
-				$update->download_url = $this->api->signDownloadUrl($update->download_url);
-			}
-
-			return $update;
-		}
-
-		public function onDisplayConfiguration($panel) {
-			parent::onDisplayConfiguration($panel);
-			$panel->row('Branch', $this->branch);
-			$panel->row('Authentication enabled', $this->api->isAuthenticationEnabled() ? 'Yes' : 'No');
-			$panel->row('API client', get_class($this->api));
-		}
-	}
+    class Puc_v4p4_Vcs_PluginUpdateChecker extends Puc_v4p4_Plugin_UpdateChecker implements Puc_v4p4_Vcs_BaseChecker {
+        /**
+         * @var string The branch where to look for updates. Defaults to "master".
+         */
+        protected $branch = 'master';
+
+        /**
+         * @var Puc_v4p4_Vcs_Api Repository API client.
+         */
+        protected $api = null;
+
+        /**
+         * Puc_v4p4_Vcs_PluginUpdateChecker constructor.
+         *
+         * @param Puc_v4p4_Vcs_Api $api
+         * @param string $pluginFile
+         * @param string $slug
+         * @param int $checkPeriod
+         * @param string $optionName
+         * @param string $muPluginFile
+         */
+        public function __construct($api, $pluginFile, $slug = '', $checkPeriod = 12, $optionName = '', $muPluginFile = '') {
+            $this->api = $api;
+            $this->api->setHttpFilterName($this->getUniqueName('request_info_options'));
+
+            parent::__construct($api->getRepositoryUrl(), $pluginFile, $slug, $checkPeriod, $optionName, $muPluginFile);
+
+            $this->api->setSlug($this->slug);
+        }
+
+        public function requestInfo($unusedParameter = null) {
+            //We have to make several remote API requests to gather all the necessary info
+            //which can take a while on slow networks.
+            if ( function_exists('set_time_limit') ) {
+                @set_time_limit(60);
+            }
+
+            $api = $this->api;
+            $api->setLocalDirectory($this->getAbsoluteDirectoryPath());
+
+            $info = new Puc_v4p4_Plugin_Info();
+            $info->filename = $this->pluginFile;
+            $info->slug = $this->slug;
+
+            $this->setInfoFromHeader($this->getPluginHeader(), $info);
+
+            //Pick a branch or tag.
+            $updateSource = $api->chooseReference($this->branch);
+            if ( $updateSource ) {
+                $ref = $updateSource->name;
+                $info->version = $updateSource->version;
+                $info->last_updated = $updateSource->updated;
+                $info->download_url = $updateSource->downloadUrl;
+
+                if ( !empty($updateSource->changelog) ) {
+                    $info->sections['changelog'] = $updateSource->changelog;
+                }
+                if ( isset($updateSource->downloadCount) ) {
+                    $info->downloaded = $updateSource->downloadCount;
+                }
+            } else {
+                //There's probably a network problem or an authentication error.
+                do_action(
+                    'puc_api_error',
+                    new WP_Error(
+                        'puc-no-update-source',
+                        'Could not retrieve version information from the repository. '
+                        . 'This usually means that the update checker either can\'t connect '
+                        . 'to the repository or it\'s configured incorrectly.'
+                    ),
+                    null, null, $this->slug
+                );
+                return null;
+            }
+
+            //Get headers from the main plugin file in this branch/tag. Its "Version" header and other metadata
+            //are what the WordPress install will actually see after upgrading, so they take precedence over releases/tags.
+            $mainPluginFile = basename($this->pluginFile);
+            $remotePlugin = $api->getRemoteFile($mainPluginFile, $ref);
+            if ( !empty($remotePlugin) ) {
+                $remoteHeader = $this->getFileHeader($remotePlugin);
+                $this->setInfoFromHeader($remoteHeader, $info);
+            }
+
+            //Try parsing readme.txt. If it's formatted according to WordPress.org standards, it will contain
+            //a lot of useful information like the required/tested WP version, changelog, and so on.
+            if ( $this->readmeTxtExistsLocally() ) {
+                $this->setInfoFromRemoteReadme($ref, $info);
+            }
+
+            //The changelog might be in a separate file.
+            if ( empty($info->sections['changelog']) ) {
+                $info->sections['changelog'] = $api->getRemoteChangelog($ref, dirname($this->getAbsolutePath()));
+                if ( empty($info->sections['changelog']) ) {
+                    $info->sections['changelog'] = __('There is no changelog available.', 'plugin-update-checker');
+                }
+            }
+
+            if ( empty($info->last_updated) ) {
+                //Fetch the latest commit that changed the tag or branch and use it as the "last_updated" date.
+                $latestCommitTime = $api->getLatestCommitTime($ref);
+                if ( $latestCommitTime !== null ) {
+                    $info->last_updated = $latestCommitTime;
+                }
+            }
+
+            $info = apply_filters($this->getUniqueName('request_info_result'), $info, null);
+            return $info;
+        }
+
+        /**
+         * Check if the currently installed version has a readme.txt file.
+         *
+         * @return bool
+         */
+        protected function readmeTxtExistsLocally() {
+            $pluginDirectory = $this->getAbsoluteDirectoryPath();
+            if ( empty($pluginDirectory) || !is_dir($pluginDirectory) || ($pluginDirectory === '.') ) {
+                return false;
+            }
+            return is_file($pluginDirectory . '/' . $this->api->getLocalReadmeName());
+        }
+
+        /**
+         * Copy plugin metadata from a file header to a Plugin Info object.
+         *
+         * @param array $fileHeader
+         * @param Puc_v4p4_Plugin_Info $pluginInfo
+         */
+        protected function setInfoFromHeader($fileHeader, $pluginInfo) {
+            $headerToPropertyMap = array(
+                'Version' => 'version',
+                'Name' => 'name',
+                'PluginURI' => 'homepage',
+                'Author' => 'author',
+                'AuthorName' => 'author',
+                'AuthorURI' => 'author_homepage',
+
+                'Requires WP' => 'requires',
+                'Tested WP' => 'tested',
+                'Requires at least' => 'requires',
+                'Tested up to' => 'tested',
+            );
+            foreach ($headerToPropertyMap as $headerName => $property) {
+                if ( isset($fileHeader[$headerName]) && !empty($fileHeader[$headerName]) ) {
+                    $pluginInfo->$property = $fileHeader[$headerName];
+                }
+            }
+
+            if ( !empty($fileHeader['Description']) ) {
+                $pluginInfo->sections['description'] = $fileHeader['Description'];
+            }
+        }
+
+        /**
+         * Copy plugin metadata from the remote readme.txt file.
+         *
+         * @param string $ref GitHub tag or branch where to look for the readme.
+         * @param Puc_v4p4_Plugin_Info $pluginInfo
+         */
+        protected function setInfoFromRemoteReadme($ref, $pluginInfo) {
+            $readme = $this->api->getRemoteReadme($ref);
+            if ( empty($readme) ) {
+                return;
+            }
+
+            if ( isset($readme['sections']) ) {
+                $pluginInfo->sections = array_merge($pluginInfo->sections, $readme['sections']);
+            }
+            if ( !empty($readme['tested_up_to']) ) {
+                $pluginInfo->tested = $readme['tested_up_to'];
+            }
+            if ( !empty($readme['requires_at_least']) ) {
+                $pluginInfo->requires = $readme['requires_at_least'];
+            }
+
+            if ( isset($readme['upgrade_notice'], $readme['upgrade_notice'][$pluginInfo->version]) ) {
+                $pluginInfo->upgrade_notice = $readme['upgrade_notice'][$pluginInfo->version];
+            }
+        }
+
+        public function setBranch($branch) {
+            $this->branch = $branch;
+            return $this;
+        }
+
+        public function setAuthentication($credentials) {
+            $this->api->setAuthentication($credentials);
+            return $this;
+        }
+
+        public function getVcsApi() {
+            return $this->api;
+        }
+
+        public function getUpdate() {
+            $update = parent::getUpdate();
+
+            if ( isset($update) && !empty($update->download_url) ) {
+                $update->download_url = $this->api->signDownloadUrl($update->download_url);
+            }
+
+            return $update;
+        }
+
+        public function onDisplayConfiguration($panel) {
+            parent::onDisplayConfiguration($panel);
+            $panel->row('Branch', $this->branch);
+            $panel->row('Authentication enabled', $this->api->isAuthenticationEnabled() ? 'Yes' : 'No');
+            $panel->row('API client', get_class($this->api));
+        }
+    }
 
 endif;
\ No newline at end of file

classes/external/php/plugin-update-checker/Puc/v4p4/StateStore.php

Indentation +201 added lines, -201 removed lines

@@ -2,206 +2,206 @@
 
 if ( !class_exists('Puc_v4p4_StateStore', false) ):
 
-	class Puc_v4p4_StateStore {
-		/**
-		 * @var int Last update check timestamp.
-		 */
-		protected $lastCheck = 0;
-
-		/**
-		 * @var string Version number.
-		 */
-		protected $checkedVersion = '';
-
-		/**
-		 * @var Puc_v4p4_Update|null Cached update.
-		 */
-		protected $update = null;
-
-		/**
-		 * @var string Site option name.
-		 */
-		private $optionName = '';
-
-		/**
-		 * @var bool Whether we've already tried to load the state from the database.
-		 */
-		private $isLoaded = false;
-
-		public function __construct($optionName) {
-			$this->optionName = $optionName;
-		}
-
-		/**
-		 * Get time elapsed since the last update check.
-		 *
-		 * If there are no recorded update checks, this method returns a large arbitrary number
-		 * (i.e. time since the Unix epoch).
-		 *
-		 * @return int Elapsed time in seconds.
-		 */
-		public function timeSinceLastCheck() {
-			$this->lazyLoad();
-			return time() - $this->lastCheck;
-		}
-
-		/**
-		 * @return int
-		 */
-		public function getLastCheck() {
-			$this->lazyLoad();
-			return $this->lastCheck;
-		}
-
-		/**
-		 * Set the time of the last update check to the current timestamp.
-		 *
-		 * @return $this
-		 */
-		public function setLastCheckToNow() {
-			$this->lazyLoad();
-			$this->lastCheck = time();
-			return $this;
-		}
-
-		/**
-		 * @return null|Puc_v4p4_Update
-		 */
-		public function getUpdate() {
-			$this->lazyLoad();
-			return $this->update;
-		}
-
-		/**
-		 * @param Puc_v4p4_Update|null $update
-		 * @return $this
-		 */
-		public function setUpdate(Puc_v4p4_Update $update = null) {
-			$this->lazyLoad();
-			$this->update = $update;
-			return $this;
-		}
-
-		/**
-		 * @return string
-		 */
-		public function getCheckedVersion() {
-			$this->lazyLoad();
-			return $this->checkedVersion;
-		}
-
-		/**
-		 * @param string $version
-		 * @return $this
-		 */
-		public function setCheckedVersion($version) {
-			$this->lazyLoad();
-			$this->checkedVersion = strval($version);
-			return $this;
-		}
-
-		/**
-		 * Get translation updates.
-		 *
-		 * @return array
-		 */
-		public function getTranslations() {
-			$this->lazyLoad();
-			if ( isset($this->update, $this->update->translations) ) {
-				return $this->update->translations;
-			}
-			return array();
-		}
-
-		/**
-		 * Set translation updates.
-		 *
-		 * @param array $translationUpdates
-		 */
-		public function setTranslations($translationUpdates) {
-			$this->lazyLoad();
-			if ( isset($this->update) ) {
-				$this->update->translations = $translationUpdates;
-				$this->save();
-			}
-		}
-
-		public function save() {
-			$state = new stdClass();
-
-			$state->lastCheck = $this->lastCheck;
-			$state->checkedVersion = $this->checkedVersion;
-
-			if ( isset($this->update)) {
-				$state->update = $this->update->toStdClass();
-
-				$updateClass = get_class($this->update);
-				$state->updateClass = $updateClass;
-				$prefix = $this->getLibPrefix();
-				if ( Puc_v4p4_Utils::startsWith($updateClass, $prefix) ) {
-					$state->updateBaseClass = substr($updateClass, strlen($prefix));
-				}
-			}
-
-			update_site_option($this->optionName, $state);
-			$this->isLoaded = true;
-		}
-
-		/**
-		 * @return $this
-		 */
-		public function lazyLoad() {
-			if ( !$this->isLoaded ) {
-				$this->load();
-			}
-			return $this;
-		}
-
-		protected function load() {
-			$this->isLoaded = true;
-
-			$state = get_site_option($this->optionName, null);
-
-			if ( !is_object($state) ) {
-				$this->lastCheck = 0;
-				$this->checkedVersion = '';
-				$this->update = null;
-				return;
-			}
-
-			$this->lastCheck = intval(Puc_v4p4_Utils::get($state, 'lastCheck', 0));
-			$this->checkedVersion = Puc_v4p4_Utils::get($state, 'checkedVersion', '');
-			$this->update = null;
-
-			if ( isset($state->update) ) {
-				//This mess is due to the fact that the want the update class from this version
-				//of the library, not the version that saved the update.
-
-				$updateClass = null;
-				if ( isset($state->updateBaseClass) ) {
-					$updateClass = $this->getLibPrefix() . $state->updateBaseClass;
-				} else if ( isset($state->updateClass) && class_exists($state->updateClass) ) {
-					$updateClass = $state->updateClass;
-				}
-
-				if ( $updateClass !== null ) {
-					$this->update = call_user_func(array($updateClass, 'fromObject'), $state->update);
-				}
-			}
-		}
-
-		public function delete() {
-			delete_site_option($this->optionName);
-
-			$this->lastCheck = 0;
-			$this->checkedVersion = '';
-			$this->update = null;
-		}
-
-		private function getLibPrefix() {
-			$parts = explode('_', __CLASS__, 3);
-			return $parts[0] . '_' . $parts[1] . '_';
-		}
-	}
+    class Puc_v4p4_StateStore {
+        /**
+         * @var int Last update check timestamp.
+         */
+        protected $lastCheck = 0;
+
+        /**
+         * @var string Version number.
+         */
+        protected $checkedVersion = '';
+
+        /**
+         * @var Puc_v4p4_Update|null Cached update.
+         */
+        protected $update = null;
+
+        /**
+         * @var string Site option name.
+         */
+        private $optionName = '';
+
+        /**
+         * @var bool Whether we've already tried to load the state from the database.
+         */
+        private $isLoaded = false;
+
+        public function __construct($optionName) {
+            $this->optionName = $optionName;
+        }
+
+        /**
+         * Get time elapsed since the last update check.
+         *
+         * If there are no recorded update checks, this method returns a large arbitrary number
+         * (i.e. time since the Unix epoch).
+         *
+         * @return int Elapsed time in seconds.
+         */
+        public function timeSinceLastCheck() {
+            $this->lazyLoad();
+            return time() - $this->lastCheck;
+        }
+
+        /**
+         * @return int
+         */
+        public function getLastCheck() {
+            $this->lazyLoad();
+            return $this->lastCheck;
+        }
+
+        /**
+         * Set the time of the last update check to the current timestamp.
+         *
+         * @return $this
+         */
+        public function setLastCheckToNow() {
+            $this->lazyLoad();
+            $this->lastCheck = time();
+            return $this;
+        }
+
+        /**
+         * @return null|Puc_v4p4_Update
+         */
+        public function getUpdate() {
+            $this->lazyLoad();
+            return $this->update;
+        }
+
+        /**
+         * @param Puc_v4p4_Update|null $update
+         * @return $this
+         */
+        public function setUpdate(Puc_v4p4_Update $update = null) {
+            $this->lazyLoad();
+            $this->update = $update;
+            return $this;
+        }
+
+        /**
+         * @return string
+         */
+        public function getCheckedVersion() {
+            $this->lazyLoad();
+            return $this->checkedVersion;
+        }
+
+        /**
+         * @param string $version
+         * @return $this
+         */
+        public function setCheckedVersion($version) {
+            $this->lazyLoad();
+            $this->checkedVersion = strval($version);
+            return $this;
+        }
+
+        /**
+         * Get translation updates.
+         *
+         * @return array
+         */
+        public function getTranslations() {
+            $this->lazyLoad();
+            if ( isset($this->update, $this->update->translations) ) {
+                return $this->update->translations;
+            }
+            return array();
+        }
+
+        /**
+         * Set translation updates.
+         *
+         * @param array $translationUpdates
+         */
+        public function setTranslations($translationUpdates) {
+            $this->lazyLoad();
+            if ( isset($this->update) ) {
+                $this->update->translations = $translationUpdates;
+                $this->save();
+            }
+        }
+
+        public function save() {
+            $state = new stdClass();
+
+            $state->lastCheck = $this->lastCheck;
+            $state->checkedVersion = $this->checkedVersion;
+
+            if ( isset($this->update)) {
+                $state->update = $this->update->toStdClass();
+
+                $updateClass = get_class($this->update);
+                $state->updateClass = $updateClass;
+                $prefix = $this->getLibPrefix();
+                if ( Puc_v4p4_Utils::startsWith($updateClass, $prefix) ) {
+                    $state->updateBaseClass = substr($updateClass, strlen($prefix));
+                }
+            }
+
+            update_site_option($this->optionName, $state);
+            $this->isLoaded = true;
+        }
+
+        /**
+         * @return $this
+         */
+        public function lazyLoad() {
+            if ( !$this->isLoaded ) {
+                $this->load();
+            }
+            return $this;
+        }
+
+        protected function load() {
+            $this->isLoaded = true;
+
+            $state = get_site_option($this->optionName, null);
+
+            if ( !is_object($state) ) {
+                $this->lastCheck = 0;
+                $this->checkedVersion = '';
+                $this->update = null;
+                return;
+            }
+
+            $this->lastCheck = intval(Puc_v4p4_Utils::get($state, 'lastCheck', 0));
+            $this->checkedVersion = Puc_v4p4_Utils::get($state, 'checkedVersion', '');
+            $this->update = null;
+
+            if ( isset($state->update) ) {
+                //This mess is due to the fact that the want the update class from this version
+                //of the library, not the version that saved the update.
+
+                $updateClass = null;
+                if ( isset($state->updateBaseClass) ) {
+                    $updateClass = $this->getLibPrefix() . $state->updateBaseClass;
+                } else if ( isset($state->updateClass) && class_exists($state->updateClass) ) {
+                    $updateClass = $state->updateClass;
+                }
+
+                if ( $updateClass !== null ) {
+                    $this->update = call_user_func(array($updateClass, 'fromObject'), $state->update);
+                }
+            }
+        }
+
+        public function delete() {
+            delete_site_option($this->optionName);
+
+            $this->lastCheck = 0;
+            $this->checkedVersion = '';
+            $this->update = null;
+        }
+
+        private function getLibPrefix() {
+            $parts = explode('_', __CLASS__, 3);
+            return $parts[0] . '_' . $parts[1] . '_';
+        }
+    }
 
 endif;

classes/external/php/plugin-update-checker/Puc/v4p4/OAuthSignature.php

Indentation +71 added lines, -71 removed lines

@@ -2,87 +2,87 @@
 
 if ( !class_exists('Puc_v4p4_OAuthSignature', false) ):
 
-	/**
-	 * A basic signature generator for zero-legged OAuth 1.0.
-	 */
-	class Puc_v4p4_OAuthSignature {
-		private $consumerKey = '';
-		private $consumerSecret = '';
+    /**
+     * A basic signature generator for zero-legged OAuth 1.0.
+     */
+    class Puc_v4p4_OAuthSignature {
+        private $consumerKey = '';
+        private $consumerSecret = '';
 
-		public function __construct($consumerKey, $consumerSecret) {
-			$this->consumerKey = $consumerKey;
-			$this->consumerSecret = $consumerSecret;
-		}
+        public function __construct($consumerKey, $consumerSecret) {
+            $this->consumerKey = $consumerKey;
+            $this->consumerSecret = $consumerSecret;
+        }
 
-		/**
-		 * Sign a URL using OAuth 1.0.
-		 *
-		 * @param string $url The URL to be signed. It may contain query parameters.
-		 * @param string $method HTTP method such as "GET", "POST" and so on.
-		 * @return string The signed URL.
-		 */
-		public function sign($url, $method = 'GET') {
-			$parameters = array();
+        /**
+         * Sign a URL using OAuth 1.0.
+         *
+         * @param string $url The URL to be signed. It may contain query parameters.
+         * @param string $method HTTP method such as "GET", "POST" and so on.
+         * @return string The signed URL.
+         */
+        public function sign($url, $method = 'GET') {
+            $parameters = array();
 
-			//Parse query parameters.
-			$query = @parse_url($url, PHP_URL_QUERY);
-			if ( !empty($query) ) {
-				parse_str($query, $parsedParams);
-				if ( is_array($parameters) ) {
-					$parameters = $parsedParams;
-				}
-				//Remove the query string from the URL. We'll replace it later.
-				$url = substr($url, 0, strpos($url, '?'));
-			}
+            //Parse query parameters.
+            $query = @parse_url($url, PHP_URL_QUERY);
+            if ( !empty($query) ) {
+                parse_str($query, $parsedParams);
+                if ( is_array($parameters) ) {
+                    $parameters = $parsedParams;
+                }
+                //Remove the query string from the URL. We'll replace it later.
+                $url = substr($url, 0, strpos($url, '?'));
+            }
 
-			$parameters = array_merge(
-				$parameters,
-				array(
-					'oauth_consumer_key' => $this->consumerKey,
-					'oauth_nonce' => $this->nonce(),
-					'oauth_signature_method' => 'HMAC-SHA1',
-					'oauth_timestamp' => time(),
-					'oauth_version' => '1.0',
-				)
-			);
-			unset($parameters['oauth_signature']);
+            $parameters = array_merge(
+                $parameters,
+                array(
+                    'oauth_consumer_key' => $this->consumerKey,
+                    'oauth_nonce' => $this->nonce(),
+                    'oauth_signature_method' => 'HMAC-SHA1',
+                    'oauth_timestamp' => time(),
+                    'oauth_version' => '1.0',
+                )
+            );
+            unset($parameters['oauth_signature']);
 
-			//Parameters must be sorted alphabetically before signing.
-			ksort($parameters);
+            //Parameters must be sorted alphabetically before signing.
+            ksort($parameters);
 
-			//The most complicated part of the request - generating the signature.
-			//The string to sign contains the HTTP method, the URL path, and all of
-			//our query parameters. Everything is URL encoded. Then we concatenate
-			//them with ampersands into a single string to hash.
-			$encodedVerb = urlencode($method);
-			$encodedUrl = urlencode($url);
-			$encodedParams = urlencode(http_build_query($parameters, '', '&'));
+            //The most complicated part of the request - generating the signature.
+            //The string to sign contains the HTTP method, the URL path, and all of
+            //our query parameters. Everything is URL encoded. Then we concatenate
+            //them with ampersands into a single string to hash.
+            $encodedVerb = urlencode($method);
+            $encodedUrl = urlencode($url);
+            $encodedParams = urlencode(http_build_query($parameters, '', '&'));
 
-			$stringToSign = $encodedVerb . '&' . $encodedUrl . '&' . $encodedParams;
+            $stringToSign = $encodedVerb . '&' . $encodedUrl . '&' . $encodedParams;
 
-			//Since we only have one OAuth token (the consumer secret) we only have
-			//to use it as our HMAC key. However, we still have to append an & to it
-			//as if we were using it with additional tokens.
-			$secret = urlencode($this->consumerSecret) . '&';
+            //Since we only have one OAuth token (the consumer secret) we only have
+            //to use it as our HMAC key. However, we still have to append an & to it
+            //as if we were using it with additional tokens.
+            $secret = urlencode($this->consumerSecret) . '&';
 
-			//The signature is a hash of the consumer key and the base string. Note
-			//that we have to get the raw output from hash_hmac and base64 encode
-			//the binary data result.
-			$parameters['oauth_signature'] = base64_encode(hash_hmac('sha1', $stringToSign, $secret, true));
+            //The signature is a hash of the consumer key and the base string. Note
+            //that we have to get the raw output from hash_hmac and base64 encode
+            //the binary data result.
+            $parameters['oauth_signature'] = base64_encode(hash_hmac('sha1', $stringToSign, $secret, true));
 
-			return ($url . '?' . http_build_query($parameters));
-		}
+            return ($url . '?' . http_build_query($parameters));
+        }
 
-		/**
-		 * Generate a random nonce.
-		 *
-		 * @return string
-		 */
-		private function nonce() {
-			$mt = microtime();
-			$rand = mt_rand();
-			return md5($mt . '_' . $rand);
-		}
-	}
+        /**
+         * Generate a random nonce.
+         *
+         * @return string
+         */
+        private function nonce() {
+            $mt = microtime();
+            $rand = mt_rand();
+            return md5($mt . '_' . $rand);
+        }
+    }
 
 endif;
\ No newline at end of file

classes/external/php/plugin-update-checker/Puc/v4p4/Metadata.php

Indentation +127 added lines, -127 removed lines

@@ -1,132 +1,132 @@
 <?php
 if ( !class_exists('Puc_v4p4_Metadata', false) ):
 
-	/**
-	 * A base container for holding information about updates and plugin metadata.
-	 *
-	 * @author Janis Elsts
-	 * @copyright 2016
-	 * @access public
-	 */
-	abstract class Puc_v4p4_Metadata {
-
-		/**
-		 * Create an instance of this class from a JSON document.
-		 *
-		 * @abstract
-		 * @param string $json
-		 * @return self
-		 */
-		public static function fromJson(/** @noinspection PhpUnusedParameterInspection */ $json) {
-			throw new LogicException('The ' . __METHOD__ . ' method must be implemented by subclasses');
-		}
-
-		/**
-		 * @param string $json
-		 * @param self $target
-		 * @return bool
-		 */
-		protected static function createFromJson($json, $target) {
-			/** @var StdClass $apiResponse */
-			$apiResponse = json_decode($json);
-			if ( empty($apiResponse) || !is_object($apiResponse) ){
-				$errorMessage = "Failed to parse update metadata. Try validating your .json file with http://jsonlint.com/";
-				do_action('puc_api_error', new WP_Error('puc-invalid-json', $errorMessage));
-				trigger_error($errorMessage, E_USER_NOTICE);
-				return false;
-			}
-
-			$valid = $target->validateMetadata($apiResponse);
-			if ( is_wp_error($valid) ){
-				do_action('puc_api_error', $valid);
-				trigger_error($valid->get_error_message(), E_USER_NOTICE);
-				return false;
-			}
-
-			foreach(get_object_vars($apiResponse) as $key => $value){
-				$target->$key = $value;
-			}
-
-			return true;
-		}
-
-		/**
-		 * No validation by default! Subclasses should check that the required fields are present.
-		 *
-		 * @param StdClass $apiResponse
-		 * @return bool|WP_Error
-		 */
-		protected function validateMetadata(/** @noinspection PhpUnusedParameterInspection */ $apiResponse) {
-			return true;
-		}
-
-		/**
-		 * Create a new instance by copying the necessary fields from another object.
-		 *
-		 * @abstract
-		 * @param StdClass|self $object The source object.
-		 * @return self The new copy.
-		 */
-		public static function fromObject(/** @noinspection PhpUnusedParameterInspection */ $object) {
-			throw new LogicException('The ' . __METHOD__ . ' method must be implemented by subclasses');
-		}
-
-		/**
-		 * Create an instance of StdClass that can later be converted back to an
-		 * update or info container. Useful for serialization and caching, as it
-		 * avoids the "incomplete object" problem if the cached value is loaded
-		 * before this class.
-		 *
-		 * @return StdClass
-		 */
-		public function toStdClass() {
-			$object = new stdClass();
-			$this->copyFields($this, $object);
-			return $object;
-		}
-
-		/**
-		 * Transform the metadata into the format used by WordPress core.
-		 *
-		 * @return object
-		 */
-		abstract public function toWpFormat();
-
-		/**
-		 * Copy known fields from one object to another.
-		 *
-		 * @param StdClass|self $from
-		 * @param StdClass|self $to
-		 */
-		protected function copyFields($from, $to) {
-			$fields = $this->getFieldNames();
-
-			if ( property_exists($from, 'slug') && !empty($from->slug) ) {
-				//Let plugins add extra fields without having to create subclasses.
-				$fields = apply_filters($this->getPrefixedFilter('retain_fields') . '-' . $from->slug, $fields);
-			}
-
-			foreach ($fields as $field) {
-				if ( property_exists($from, $field) ) {
-					$to->$field = $from->$field;
-				}
-			}
-		}
-
-		/**
-		 * @return string[]
-		 */
-		protected function getFieldNames() {
-			return array();
-		}
-
-		/**
-		 * @param string $tag
-		 * @return string
-		 */
-		protected function getPrefixedFilter($tag) {
-			return 'puc_' . $tag;
-		}
-	}
+    /**
+     * A base container for holding information about updates and plugin metadata.
+     *
+     * @author Janis Elsts
+     * @copyright 2016
+     * @access public
+     */
+    abstract class Puc_v4p4_Metadata {
+
+        /**
+         * Create an instance of this class from a JSON document.
+         *
+         * @abstract
+         * @param string $json
+         * @return self
+         */
+        public static function fromJson(/** @noinspection PhpUnusedParameterInspection */ $json) {
+            throw new LogicException('The ' . __METHOD__ . ' method must be implemented by subclasses');
+        }
+
+        /**
+         * @param string $json
+         * @param self $target
+         * @return bool
+         */
+        protected static function createFromJson($json, $target) {
+            /** @var StdClass $apiResponse */
+            $apiResponse = json_decode($json);
+            if ( empty($apiResponse) || !is_object($apiResponse) ){
+                $errorMessage = "Failed to parse update metadata. Try validating your .json file with http://jsonlint.com/";
+                do_action('puc_api_error', new WP_Error('puc-invalid-json', $errorMessage));
+                trigger_error($errorMessage, E_USER_NOTICE);
+                return false;
+            }
+
+            $valid = $target->validateMetadata($apiResponse);
+            if ( is_wp_error($valid) ){
+                do_action('puc_api_error', $valid);
+                trigger_error($valid->get_error_message(), E_USER_NOTICE);
+                return false;
+            }
+
+            foreach(get_object_vars($apiResponse) as $key => $value){
+                $target->$key = $value;
+            }
+
+            return true;
+        }
+
+        /**
+         * No validation by default! Subclasses should check that the required fields are present.
+         *
+         * @param StdClass $apiResponse
+         * @return bool|WP_Error
+         */
+        protected function validateMetadata(/** @noinspection PhpUnusedParameterInspection */ $apiResponse) {
+            return true;
+        }
+
+        /**
+         * Create a new instance by copying the necessary fields from another object.
+         *
+         * @abstract
+         * @param StdClass|self $object The source object.
+         * @return self The new copy.
+         */
+        public static function fromObject(/** @noinspection PhpUnusedParameterInspection */ $object) {
+            throw new LogicException('The ' . __METHOD__ . ' method must be implemented by subclasses');
+        }
+
+        /**
+         * Create an instance of StdClass that can later be converted back to an
+         * update or info container. Useful for serialization and caching, as it
+         * avoids the "incomplete object" problem if the cached value is loaded
+         * before this class.
+         *
+         * @return StdClass
+         */
+        public function toStdClass() {
+            $object = new stdClass();
+            $this->copyFields($this, $object);
+            return $object;
+        }
+
+        /**
+         * Transform the metadata into the format used by WordPress core.
+         *
+         * @return object
+         */
+        abstract public function toWpFormat();
+
+        /**
+         * Copy known fields from one object to another.
+         *
+         * @param StdClass|self $from
+         * @param StdClass|self $to
+         */
+        protected function copyFields($from, $to) {
+            $fields = $this->getFieldNames();
+
+            if ( property_exists($from, 'slug') && !empty($from->slug) ) {
+                //Let plugins add extra fields without having to create subclasses.
+                $fields = apply_filters($this->getPrefixedFilter('retain_fields') . '-' . $from->slug, $fields);
+            }
+
+            foreach ($fields as $field) {
+                if ( property_exists($from, $field) ) {
+                    $to->$field = $from->$field;
+                }
+            }
+        }
+
+        /**
+         * @return string[]
+         */
+        protected function getFieldNames() {
+            return array();
+        }
+
+        /**
+         * @param string $tag
+         * @return string
+         */
+        protected function getPrefixedFilter($tag) {
+            return 'puc_' . $tag;
+        }
+    }
 
 endif;
\ No newline at end of file

classes/external/php/plugin-update-checker/Puc/v4p4/Update.php

Indentation +25 added lines, -25 removed lines

@@ -1,34 +1,34 @@
 <?php
 if ( !class_exists('Puc_v4p4_Update', false) ):
 
-	/**
-	 * A simple container class for holding information about an available update.
-	 *
-	 * @author Janis Elsts
-	 * @access public
-	 */
-	abstract class Puc_v4p4_Update extends Puc_v4p4_Metadata {
-		public $slug;
-		public $version;
-		public $download_url;
-		public $translations = array();
+    /**
+     * A simple container class for holding information about an available update.
+     *
+     * @author Janis Elsts
+     * @access public
+     */
+    abstract class Puc_v4p4_Update extends Puc_v4p4_Metadata {
+        public $slug;
+        public $version;
+        public $download_url;
+        public $translations = array();
 
-		/**
-		 * @return string[]
-		 */
-		protected function getFieldNames() {
-			return array('slug', 'version', 'download_url', 'translations');
-		}
+        /**
+         * @return string[]
+         */
+        protected function getFieldNames() {
+            return array('slug', 'version', 'download_url', 'translations');
+        }
 
-		public function toWpFormat() {
-			$update = new stdClass();
+        public function toWpFormat() {
+            $update = new stdClass();
 
-			$update->slug = $this->slug;
-			$update->new_version = $this->version;
-			$update->package = $this->download_url;
+            $update->slug = $this->slug;
+            $update->new_version = $this->version;
+            $update->package = $this->download_url;
 
-			return $update;
-		}
-	}
+            return $update;
+        }
+    }
 
 endif;
\ No newline at end of file