first commit -> move some files from one-api

vendor/aws_v3/Aws/Arn/S3/AccessPointArn.php

@@ -0,0 +1,27 @@
+<?php
+namespace Aws\Arn\S3;
+
+use Aws\Arn\AccessPointArn as BaseAccessPointArn;
+use Aws\Arn\AccessPointArnInterface;
+use Aws\Arn\ArnInterface;
+use Aws\Arn\Exception\InvalidArnException;
+
+/**
+ * @internal
+ */
+class AccessPointArn extends BaseAccessPointArn implements AccessPointArnInterface
+{
+    /**
+     * Validation specific to AccessPointArn
+     *
+     * @param array $data
+     */
+    public static function validate(array $data)
+    {
+        parent::validate($data);
+        if ($data['service'] !== 's3') {
+            throw new InvalidArnException("The 3rd component of an S3 access"
+                . " point ARN represents the region and must be 's3'.");
+        }
+    }
+}

vendor/aws_v3/Aws/Arn/S3/BucketArnInterface.php

@@ -0,0 +1,12 @@
+<?php
+namespace Aws\Arn\S3;
+
+use Aws\Arn\ArnInterface;
+
+/**
+ * @internal
+ */
+interface BucketArnInterface extends ArnInterface
+{
+    public function getBucketName();
+}

vendor/aws_v3/Aws/Arn/S3/MultiRegionAccessPointArn.php

@@ -0,0 +1,38 @@
+<?php
+namespace Aws\Arn\S3;
+
+use Aws\Arn\Arn;
+use Aws\Arn\ResourceTypeAndIdTrait;
+
+/**
+ * This class represents an S3 multi-region bucket ARN, which is in the
+ * following format:
+ *
+ * @internal
+ */
+class MultiRegionAccessPointArn extends AccessPointArn
+{
+    use ResourceTypeAndIdTrait;
+
+    /**
+     * Parses a string into an associative array of components that represent
+     * a MultiRegionArn
+     *
+     * @param $string
+     * @return array
+     */
+    public static function parse($string)
+    {
+        return parent::parse($string);
+    }
+
+    /**
+     *
+     * @param array $data
+     */
+    public static function validate(array $data)
+    {
+        Arn::validate($data);
+    }
+
+}

vendor/aws_v3/Aws/Arn/S3/OutpostsAccessPointArn.php

@@ -0,0 +1,110 @@
+<?php
+namespace Aws\Arn\S3;
+
+use Aws\Arn\AccessPointArn as BaseAccessPointArn;
+use Aws\Arn\AccessPointArnInterface;
+use Aws\Arn\Arn;
+use Aws\Arn\Exception\InvalidArnException;
+
+/**
+ * This class represents an S3 Outposts access point ARN, which is in the
+ * following format:
+ *
+ * arn:{partition}:s3-outposts:{region}:{accountId}:outpost:{outpostId}:accesspoint:{accesspointName}
+ *
+ * ':' and '/' can be used interchangeably as delimiters for components after
+ * the account ID.
+ *
+ * @internal
+ */
+class OutpostsAccessPointArn extends BaseAccessPointArn implements
+    AccessPointArnInterface,
+    OutpostsArnInterface
+{
+    public static function parse($string)
+    {
+        $data = parent::parse($string);
+        return self::parseOutpostData($data);
+    }
+
+    public function getOutpostId()
+    {
+        return $this->data['outpost_id'];
+    }
+
+    public function getAccesspointName()
+    {
+        return $this->data['accesspoint_name'];
+    }
+
+    private static function parseOutpostData(array $data)
+    {
+        $resourceData = preg_split("/[\/:]/", $data['resource_id']);
+
+        $data['outpost_id'] = isset($resourceData[0])
+            ? $resourceData[0]
+            : null;
+        $data['accesspoint_type'] = isset($resourceData[1])
+            ? $resourceData[1]
+            : null;
+        $data['accesspoint_name'] = isset($resourceData[2])
+            ? $resourceData[2]
+            : null;
+        if (isset($resourceData[3])) {
+            $data['resource_extra'] = implode(':', array_slice($resourceData, 3));
+        }
+
+        return $data;
+    }
+
+    /**
+     * Validation specific to OutpostsAccessPointArn. Note this uses the base Arn
+     * class validation instead of the direct parent due to it having slightly
+     * differing requirements from its parent.
+     *
+     * @param array $data
+     */
+    public static function validate(array $data)
+    {
+        Arn::validate($data);
+
+        if (($data['service'] !== 's3-outposts')) {
+            throw new InvalidArnException("The 3rd component of an S3 Outposts"
+                . " access point ARN represents the service and must be"
+                . " 's3-outposts'.");
+        }
+
+        self::validateRegion($data, 'S3 Outposts access point ARN');
+        self::validateAccountId($data, 'S3 Outposts access point ARN');
+
+        if (($data['resource_type'] !== 'outpost')) {
+            throw new InvalidArnException("The 6th component of an S3 Outposts"
+                . " access point ARN represents the resource type and must be"
+                . " 'outpost'.");
+        }
+
+        if (!self::isValidHostLabel($data['outpost_id'])) {
+            throw new InvalidArnException("The 7th component of an S3 Outposts"
+                . " access point ARN is required, represents the outpost ID, and"
+                . " must be a valid host label.");
+        }
+
+        if ($data['accesspoint_type'] !== 'accesspoint') {
+            throw new InvalidArnException("The 8th component of an S3 Outposts"
+                . " access point ARN must be 'accesspoint'");
+        }
+
+        if (!self::isValidHostLabel($data['accesspoint_name'])) {
+            throw new InvalidArnException("The 9th component of an S3 Outposts"
+                . " access point ARN is required, represents the accesspoint name,"
+                . " and must be a valid host label.");
+        }
+
+        if (!empty($data['resource_extra'])) {
+            throw new InvalidArnException("An S3 Outposts access point ARN"
+                . " should only have 9 components, delimited by the characters"
+                . " ':' and '/'. '{$data['resource_extra']}' was found after the"
+                . " 9th component.");
+        }
+    }
+}

vendor/aws_v3/Aws/Arn/S3/OutpostsArnInterface.php

@@ -0,0 +1,12 @@
+<?php
+namespace Aws\Arn\S3;
+
+use Aws\Arn\ArnInterface;
+
+/**
+ * @internal
+ */
+interface OutpostsArnInterface extends ArnInterface
+{
+    public function getOutpostId();
+}

vendor/aws_v3/Aws/Arn/S3/OutpostsBucketArn.php

@@ -0,0 +1,99 @@
+<?php
+namespace Aws\Arn\S3;
+
+use Aws\Arn\Arn;
+use Aws\Arn\Exception\InvalidArnException;
+use Aws\Arn\ResourceTypeAndIdTrait;
+
+/**
+ * This class represents an S3 Outposts bucket ARN, which is in the
+ * following format:
+ *
+ * @internal
+ */
+class OutpostsBucketArn extends Arn implements
+    BucketArnInterface,
+    OutpostsArnInterface
+{
+    use ResourceTypeAndIdTrait;
+
+    /**
+     * Parses a string into an associative array of components that represent
+     * a OutpostsBucketArn
+     *
+     * @param $string
+     * @return array
+     */
+    public static function parse($string)
+    {
+        $data = parent::parse($string);
+        $data = self::parseResourceTypeAndId($data);
+        return self::parseOutpostData($data);
+    }
+
+    public function getBucketName()
+    {
+        return $this->data['bucket_name'];
+    }
+
+    public function getOutpostId()
+    {
+        return $this->data['outpost_id'];
+    }
+
+    private static function parseOutpostData(array $data)
+    {
+        $resourceData = preg_split("/[\/:]/", $data['resource_id'], 3);
+
+        $data['outpost_id'] = isset($resourceData[0])
+            ? $resourceData[0]
+            : null;
+        $data['bucket_label'] = isset($resourceData[1])
+            ? $resourceData[1]
+            : null;
+        $data['bucket_name'] = isset($resourceData[2])
+            ? $resourceData[2]
+            : null;
+
+        return $data;
+    }
+
+    /**
+     *
+     * @param array $data
+     */
+    public static function validate(array $data)
+    {
+        Arn::validate($data);
+
+        if (($data['service'] !== 's3-outposts')) {
+            throw new InvalidArnException("The 3rd component of an S3 Outposts"
+                . " bucket ARN represents the service and must be 's3-outposts'.");
+        }
+
+        self::validateRegion($data, 'S3 Outposts bucket ARN');
+        self::validateAccountId($data, 'S3 Outposts bucket ARN');
+
+        if (($data['resource_type'] !== 'outpost')) {
+            throw new InvalidArnException("The 6th component of an S3 Outposts"
+                . " bucket ARN represents the resource type and must be"
+                . " 'outpost'.");
+        }
+
+        if (!self::isValidHostLabel($data['outpost_id'])) {
+            throw new InvalidArnException("The 7th component of an S3 Outposts"
+                . " bucket ARN is required, represents the outpost ID, and"
+                . " must be a valid host label.");
+        }
+
+        if ($data['bucket_label'] !== 'bucket') {
+            throw new InvalidArnException("The 8th component of an S3 Outposts"
+                . " bucket ARN must be 'bucket'");
+        }
+
+        if (empty($data['bucket_name'])) {
+            throw new InvalidArnException("The 9th component of an S3 Outposts"
+                . " bucket ARN represents the bucket name and must not be empty.");
+        }
+    }
+}