Gecko [ v3.cesa.co.za ]

Name	Size	Permission	Date
Batch	[ DIR ]	drwxr-sr-x	2026-03-17 23:07
Compute	[ DIR ]	drwxr-sr-x	2026-03-17 23:07
Exception	[ DIR ]	drwxr-sr-x	2026-03-17 23:07
Iam	[ DIR ]	drwxr-sr-x	2026-03-17 23:07
Iterator	[ DIR ]	drwxr-sr-x	2026-03-17 23:07
Lock	[ DIR ]	drwxr-sr-x	2026-03-17 23:07
Logger	[ DIR ]	drwxr-sr-x	2026-03-17 23:07
LongRunning	[ DIR ]	drwxr-sr-x	2026-03-17 23:07
Report	[ DIR ]	drwxr-sr-x	2026-03-17 23:07
Testing	[ DIR ]	drwxr-sr-x	2026-03-17 23:07
Upload	[ DIR ]	drwxr-sr-x	2026-03-17 23:07
AnonymousCredentials.php	2.4 KB	-rw-r--r--	2026-03-17 23:07
ApiHelperTrait.php	8.01 KB	-rw-r--r--	2026-03-17 23:07
ArrayTrait.php	3.45 KB	-rw-r--r--	2026-03-17 23:07
Blob.php	2.02 KB	-rw-r--r--	2026-03-17 23:07
ClientTrait.php	8.36 KB	-rw-r--r--	2026-03-17 23:07
ConcurrencyControlTrait.php	1.35 KB	-rw-r--r--	2026-03-17 23:07
DebugInfoTrait.php	1.28 KB	-rw-r--r--	2026-03-17 23:07
DetectProjectIdTrait.php	2.98 KB	-rw-r--r--	2026-03-17 23:07
Duration.php	2.1 KB	-rw-r--r--	2026-03-17 23:07
EmulatorTrait.php	2.74 KB	-rw-r--r--	2026-03-17 23:07
ExponentialBackoff.php	4.71 KB	-rw-r--r--	2026-03-17 23:07
GeoPoint.php	5.99 KB	-rw-r--r--	2026-03-17 23:07
GrpcRequestWrapper.php	4.59 KB	-rw-r--r--	2026-03-17 23:07
GrpcTrait.php	8.92 KB	-rw-r--r--	2026-03-17 23:07
InsecureCredentialsWrapper.php	982 B	-rw-r--r--	2026-03-17 23:07
Int64.php	1.7 KB	-rw-r--r--	2026-03-17 23:07
JsonTrait.php	2.15 KB	-rw-r--r--	2026-03-17 23:07
OptionsValidator.php	4 KB	-rw-r--r--	2026-03-17 23:07
PhpArray.php	7.2 KB	-rw-r--r--	2026-03-17 23:07
RequestBuilder.php	5.18 KB	-rw-r--r--	2026-03-17 23:07
RequestHandler.php	4.18 KB	-rw-r--r--	2026-03-17 23:07
RequestProcessorTrait.php	4.47 KB	-rw-r--r--	2026-03-17 23:07
RequestWrapper.php	20.98 KB	-rw-r--r--	2026-03-17 23:07
RequestWrapperTrait.php	6.94 KB	-rw-r--r--	2026-03-17 23:07
RestTrait.php	4.78 KB	-rw-r--r--	2026-03-17 23:07
Retry.php	3.33 KB	-rw-r--r--	2026-03-17 23:07
RetryDeciderTrait.php	2.79 KB	-rw-r--r--	2026-03-17 23:07
ServiceBuilder.php	14.2 KB	-rw-r--r--	2026-03-17 23:07
SysvTrait.php	1.81 KB	-rw-r--r--	2026-03-17 23:07
TimeTrait.php	4.46 KB	-rw-r--r--	2026-03-17 23:07
Timestamp.php	4.02 KB	-rw-r--r--	2026-03-17 23:07
TimestampTrait.php	1.53 KB	-rw-r--r--	2026-03-17 23:07
UriTrait.php	1.78 KB	-rw-r--r--	2026-03-17 23:07
ValidateTrait.php	2.27 KB	-rw-r--r--	2026-03-17 23:07
ValueMapperTrait.php	1.74 KB	-rw-r--r--	2026-03-17 23:07
WhitelistTrait.php	1.13 KB	-rw-r--r--	2026-03-17 23:07

Rename

<?php
/**
 * Copyright 2016 Google Inc. All Rights Reserved.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

namespace Google\Cloud\Core;

use GuzzleHttp\Psr7\Request;
use GuzzleHttp\Psr7\Uri;
use Psr\Http\Message\RequestInterface;

/**
 * Builds a PSR7 request from a service definition.
 */
class RequestBuilder
{
    use JsonTrait;
    use UriTrait;

/**
     * @var string
     */
    private $servicePath;

/**
     * @var string
     */
    private $baseUri;

/**
     * @var array
     */
    private $resourceRoot;

/**
     * @var array
     */
    private $service;

/**
     * @param string $servicePath
     * @param string $baseUri
     * @param array  $resourceRoot [optional]
     */
    public function __construct($servicePath, $baseUri, array $resourceRoot = [])
    {
        $this->service = $this->loadServiceDefinition($servicePath);
        $this->resourceRoot = $resourceRoot;

// Append service definition base path if bare apiEndpoint domain is given.
        if (isset($this->service['basePath'])) {
            $uriParts = parse_url($baseUri) + ['path' => null];
            if (!$uriParts['path'] || $uriParts['path'] === '/') {
                $uriParts['path'] = $this->service['basePath'];

// Recreate the URI from its modified parts and ensure it ends in a single slash.
                $this->baseUri = rtrim((string) Uri::fromParts($uriParts), '/') . '/';

return;
            }
        }

$this->baseUri = rtrim($baseUri, '/') . '/';
    }

/**
     * Build the request.
     *
     * @param string $resource
     * @param string $method
     * @param array $options [optional]
     * @return RequestInterface
     * @todo complexity high, revisit
     * @todo consider validating against the schemas
     */
    public function build($resource, $method, array $options = [])
    {
        $root = $this->resourceRoot;

array_push($root, 'resources');
        $root = array_merge($root, explode('.', $resource));
        array_push($root, 'methods', $method);

$action = $this->service;
        foreach ($root as $rootItem) {
            if (!isset($action[$rootItem])) {
                throw new \InvalidArgumentException('Provided path item ' . $rootItem . ' does not exist.');
            }
            $action = $action[$rootItem];
        }

$path = [];
        $query = [];
        $body = [];

if (isset($action['parameters'])) {
            foreach ($action['parameters'] as $parameter => $parameterOptions) {
                if ($parameterOptions['location'] === 'path' && array_key_exists($parameter, $options)) {
                    $path[$parameter] = $options[$parameter];
                    unset($options[$parameter]);
                }

if ($parameterOptions['location'] === 'query') {
                    // flatten nested querystring parameters into dot-syntax
                    if (false !== strpos($parameter, '.')) {
                        list($object, $property) = explode('.', $parameter, 2);
                        if (isset($options[$object][$property])) {
                            $options[$parameter] = $options[$object][$property];
                        }
                    }
                    if (array_key_exists($parameter, $options)) {
                        $query[$parameter] = $options[$parameter];
                    }
                }
            }
        }

if (isset($this->service['parameters'])) {
            foreach ($this->service['parameters'] as $parameter => $parameterOptions) {
                if ($parameterOptions['location'] === 'query' && array_key_exists($parameter, $options)) {
                    $query[$parameter] = $options[$parameter];
                }
            }
        }

if (isset($action['request'])) {
            $schema = $action['request']['$ref'];

foreach ($this->service['schemas'][$schema]['properties'] as $property => $propertyOptions) {
                if (array_key_exists($property, $options)) {
                    $body[$property] = $options[$property];
                }
            }
        }

$uri = $this->buildUriWithQuery(
            $this->expandUri($this->baseUri . $action['path'], $path),
            $query
        );

return new Request(
            $action['httpMethod'],
            $uri,
            ['Content-Type' => 'application/json'],
            $body ? $this->jsonEncode($body) : null
        );
    }

/**
     * @param string $servicePath
     * @return array
     */
    private function loadServiceDefinition($servicePath)
    {
        return $this->jsonDecode(
            file_get_contents($servicePath, true),
            true
        );
    }
}