Gecko [ v3.cesa.co.za ]

Name	Size	Permission	Date
Middleware	[ DIR ]	drwxr-sr-x	2026-03-12 21:22
Options	[ DIR ]	drwxr-sr-x	2026-03-12 21:22
ResourceTemplate	[ DIR ]	drwxr-sr-x	2026-03-12 21:22
Testing	[ DIR ]	drwxr-sr-x	2026-03-12 21:22
Transport	[ DIR ]	drwxr-sr-x	2026-03-12 21:22
AgentHeader.php	5.84 KB	-rw-r--r--	2026-03-12 21:22
ApiException.php	12.17 KB	-rw-r--r--	2026-03-12 21:22
ApiKeyHeaderCredentials.php	3.71 KB	-rw-r--r--	2026-03-12 21:22
ApiStatus.php	6.51 KB	-rw-r--r--	2026-03-12 21:22
ArrayTrait.php	4.57 KB	-rw-r--r--	2026-03-12 21:22
BidiStream.php	7.11 KB	-rw-r--r--	2026-03-12 21:22
Call.php	3.46 KB	-rw-r--r--	2026-03-12 21:22
ClientOptionsTrait.php	15.28 KB	-rw-r--r--	2026-03-12 21:22
ClientStream.php	4.72 KB	-rw-r--r--	2026-03-12 21:22
CredentialsWrapper.php	13.6 KB	-rw-r--r--	2026-03-12 21:22
FixedSizeCollection.php	6.26 KB	-rw-r--r--	2026-03-12 21:22
GPBLabel.php	1.82 KB	-rw-r--r--	2026-03-12 21:22
GPBType.php	2.19 KB	-rw-r--r--	2026-03-12 21:22
GapicClientTrait.php	38.24 KB	-rw-r--r--	2026-03-12 21:22
GrpcSupportTrait.php	2.24 KB	-rw-r--r--	2026-03-12 21:22
HeaderCredentialsInterface.php	2.1 KB	-rw-r--r--	2026-03-12 21:22
InsecureCredentialsWrapper.php	2.09 KB	-rw-r--r--	2026-03-12 21:22
InsecureRequestBuilder.php	649 B	-rw-r--r--	2026-03-12 21:22
KnownTypes.php	3.87 KB	-rw-r--r--	2026-03-12 21:22
OperationResponse.php	20.86 KB	-rw-r--r--	2026-03-12 21:22
Page.php	9.22 KB	-rw-r--r--	2026-03-12 21:22
PageStreamingDescriptor.php	6.18 KB	-rw-r--r--	2026-03-12 21:22
PagedListResponse.php	6.78 KB	-rw-r--r--	2026-03-12 21:22
PathTemplate.php	4.06 KB	-rw-r--r--	2026-03-12 21:22
PollingTrait.php	3.65 KB	-rw-r--r--	2026-03-12 21:22
RequestBuilder.php	9.77 KB	-rw-r--r--	2026-03-12 21:22
RequestParamsHeaderDescriptor.php	2.57 KB	-rw-r--r--	2026-03-12 21:22
ResourceHelperTrait.php	3.93 KB	-rw-r--r--	2026-03-12 21:22
RetrySettings.php	21.64 KB	-rw-r--r--	2026-03-12 21:22
Serializer.php	19.45 KB	-rw-r--r--	2026-03-12 21:22
ServerStream.php	4.49 KB	-rw-r--r--	2026-03-12 21:22
ServerStreamingCallInterface.php	2.94 KB	-rw-r--r--	2026-03-12 21:22
ServiceAddressTrait.php	2.48 KB	-rw-r--r--	2026-03-12 21:22
UriTrait.php	2.33 KB	-rw-r--r--	2026-03-12 21:22
ValidationException.php	1.7 KB	-rw-r--r--	2026-03-12 21:22
ValidationTrait.php	2.93 KB	-rw-r--r--	2026-03-12 21:22
Version.php	2.49 KB	-rw-r--r--	2026-03-12 21:22

Rename

<?php
/*
 * Copyright 2022 Google LLC
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are
 * met:
 *
 *     * Redistributions of source code must retain the above copyright
 * notice, this list of conditions and the following disclaimer.
 *     * Redistributions in binary form must reproduce the above
 * copyright notice, this list of conditions and the following disclaimer
 * in the documentation and/or other materials provided with the
 * distribution.
 *     * Neither the name of Google Inc. nor the names of its
 * contributors may be used to endorse or promote products derived from
 * this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */

namespace Google\ApiCore;

/**
 * Provides functionality for loading a resource name template map from a descriptor config,
 * retrieving a PathTemplate, and parsing values using registered templates.
 *
 * @internal
 */
trait ResourceHelperTrait
{
    /** @var array|null */
    private static $templateMap;

/**
     * placeholder for this function like we have in GapicClientTrait
     */
    private static function getClientDefaults()
    {
        return [];
    }

private static function registerPathTemplates()
    {
        $templateConfigPath = self::getClientDefaults()['descriptorsConfigPath'];
        // self::SERVICE_NAME is a constant set per-client.
        self::loadPathTemplates($templateConfigPath, self::SERVICE_NAME);
    }

private static function loadPathTemplates(string $configPath, string $serviceName)
    {
        // TODO: Add void return type hint.
        if (!is_null(self::$templateMap)) {
            return;
        }

$descriptors = require($configPath);
        $templates = $descriptors['interfaces'][$serviceName]['templateMap'] ?? [];
        self::$templateMap = [];
        foreach ($templates as $name => $template) {
            self::$templateMap[$name] = new PathTemplate($template);
        }
    }

private static function getPathTemplate(string $key)
    {
        // TODO: Add nullable return type reference once PHP 7.1 is minimum.
        if (is_null(self::$templateMap)) {
            self::registerPathTemplates();
        }
        return self::$templateMap[$key] ?? null;
    }

private static function parseFormattedName(string $formattedName, ?string $template = null): array
    {
        if (is_null(self::$templateMap)) {
            self::registerPathTemplates();
        }
        if ($template) {
            if (!isset(self::$templateMap[$template])) {
                throw new ValidationException("Template name $template does not exist");
            }

return self::$templateMap[$template]->match($formattedName);
        }

foreach (self::$templateMap as $templateName => $pathTemplate) {
            try {
                return $pathTemplate->match($formattedName);
            } catch (ValidationException $ex) {
                // Swallow the exception to continue trying other path templates
            }
        }

throw new ValidationException("Input did not match any known format. Input: $formattedName");
    }
}