From e2403cbbe31708c2b7a161c634a67c64b9123bd2 Mon Sep 17 00:00:00 2001 From: Todd Hill Date: Thu, 18 Sep 2025 12:55:09 -0400 Subject: [PATCH] update README for DDB "Learn the basics" --- .doc_gen/metadata/dynamodb_metadata.yaml | 2 +- .../transcribe-streaming_metadata.yaml | 38 +--- .../transcribe-streaming/README.md | 21 +- .../transcribe-streaming/README.md | 36 +--- .../TranscribeStreamingDemoApp.java | 45 ++--- php/README.md | 59 +++++- php/example_code/dynamodb/DynamoDBService.php | 4 +- php/example_code/dynamodb/README.md | 12 +- .../dynamodb/dynamodb_basics/Runner.php | 2 +- .../dynamodb/dynamodb_basics/composer.json | 10 +- .../dynamodb/dynamodb_basics/composer.lock | 190 +++++++++--------- .../transcribe-streaming/README.md | 8 +- 12 files changed, 198 insertions(+), 229 deletions(-) diff --git a/.doc_gen/metadata/dynamodb_metadata.yaml b/.doc_gen/metadata/dynamodb_metadata.yaml index 3ef1f8c31b4..c73a28da109 100644 --- a/.doc_gen/metadata/dynamodb_metadata.yaml +++ b/.doc_gen/metadata/dynamodb_metadata.yaml @@ -1960,7 +1960,7 @@ dynamodb_Scenario_GettingStartedMovies: - sdk_version: 3 github: php/example_code/dynamodb excerpts: - - description: + - description: Because this example uses supporting files, be sure to read the guidance in the PHP examples README.md file. snippet_tags: - php.example_code.dynamodb.basics.scenario Python: diff --git a/.doc_gen/metadata/transcribe-streaming_metadata.yaml b/.doc_gen/metadata/transcribe-streaming_metadata.yaml index 6690a6c227c..ef04120c61e 100644 --- a/.doc_gen/metadata/transcribe-streaming_metadata.yaml +++ b/.doc_gen/metadata/transcribe-streaming_metadata.yaml @@ -42,8 +42,8 @@ transcribe-streaming_StartMedicalStreamTranscription: - transcribe.java-medical-streaming-demo services: transcribe-streaming: {StartMedicalStreamTranscription} -transcribe-streaming_Scenario_StreamEvents_File: - title: Generate a transcription of a file using an &AWS; SDK +transcribe-streaming_Scenario_StreamEvents: + title: Generate a transcription of an audio stream using an &AWS; SDK title_abbrev: Transcribe an audio file synopsis: generate a transcription of a source audio file using &TSC; streaming. category: Scenarios @@ -58,39 +58,5 @@ transcribe-streaming_Scenario_StreamEvents_File: snippet_tags: - swift.transcribe-streaming.all - swift.transcribe-streaming.transcribeerror - Java: - versions: - - sdk_version: 2 - github: javav2/example_code/transcribe-streaming - sdkguide: - excerpts: - - description: - snippet_tags: - - transcribe.java-streaming-demo-file.main - C++: - versions: - - sdk_version: 1 - github: cpp/example_code/transcribe-streaming - excerpts: - - description: - snippet_tags: - - transcribe.cpp.stream_transcription_async.code - services: - transcribe-streaming: {StartStreamTranscription} -transcribe-streaming_Scenario_StreamEvents_Microphone: - title: Generate a transcription from a microphone using an &AWS; SDK - title_abbrev: Transcribe audio from a microphone - synopsis: generate a transcription from a microphone using &TSC; streaming. - category: Scenarios - languages: - Java: - versions: - - sdk_version: 2 - github: javav2/example_code/transcribe-streaming - sdkguide: - excerpts: - - description: - snippet_tags: - - transcribe.java-streaming-demo services: transcribe-streaming: {StartStreamTranscription} diff --git a/cpp/example_code/transcribe-streaming/README.md b/cpp/example_code/transcribe-streaming/README.md index 66e06eae64e..0f9dab3a97e 100644 --- a/cpp/example_code/transcribe-streaming/README.md +++ b/cpp/example_code/transcribe-streaming/README.md @@ -43,13 +43,6 @@ Code excerpts that show you how to call individual service functions. - [StartStreamTranscription](get_transcript.cpp#L28) -### Scenarios - -Code examples that show you how to accomplish a specific task by calling multiple -functions within the same service. - -- [Transcribe an audio file](get_transcript.cpp) - @@ -76,18 +69,6 @@ folder. -#### Transcribe an audio file - -This example shows you how to generate a transcription of a source audio file using Amazon Transcribe streaming. - - - - - - - - - ### Tests ⚠ Running tests might result in charges to your AWS account. @@ -118,4 +99,4 @@ This example shows you how to generate a transcription of a source audio file us Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. -SPDX-License-Identifier: Apache-2.0 +SPDX-License-Identifier: Apache-2.0 \ No newline at end of file diff --git a/javav2/example_code/transcribe-streaming/README.md b/javav2/example_code/transcribe-streaming/README.md index 11415049bae..b68221aa797 100644 --- a/javav2/example_code/transcribe-streaming/README.md +++ b/javav2/example_code/transcribe-streaming/README.md @@ -34,15 +34,7 @@ For prerequisites, see the [README](../../README.md#Prerequisites) in the `javav Code excerpts that show you how to call individual service functions. - [StartMedicalStreamTranscription](src/main/java/com/amazonaws/transcribestreaming/TranscribeMedicalStreamingDemoApp.java#L25) -- [StartStreamTranscription](src/main/java/com/amazonaws/transcribestreaming/TranscribeStreamingDemoApp.java#L36) - -### Scenarios - -Code examples that show you how to accomplish a specific task by calling multiple -functions within the same service. - -- [Transcribe an audio file](src/main/java/com/amazonaws/transcribestreaming/TranscribeStreamingDemoFile.java) -- [Transcribe audio from a microphone](src/main/java/com/amazonaws/transcribestreaming/TranscribeStreamingDemoApp.java) +- [StartStreamTranscription](src/main/java/com/amazonaws/transcribestreaming/TranscribeStreamingDemoApp.java#L26) @@ -58,30 +50,6 @@ functions within the same service. -#### Transcribe an audio file - -This example shows you how to generate a transcription of a source audio file using Amazon Transcribe streaming. - - - - - - - - - -#### Transcribe audio from a microphone - -This example shows you how to generate a transcription from a microphone using Amazon Transcribe streaming. - - - - - - - - - ### Tests ⚠ Running tests might result in charges to your AWS account. @@ -108,4 +76,4 @@ in the `javav2` folder. Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. -SPDX-License-Identifier: Apache-2.0 +SPDX-License-Identifier: Apache-2.0 \ No newline at end of file diff --git a/javav2/example_code/transcribe-streaming/src/main/java/com/amazonaws/transcribestreaming/TranscribeStreamingDemoApp.java b/javav2/example_code/transcribe-streaming/src/main/java/com/amazonaws/transcribestreaming/TranscribeStreamingDemoApp.java index d1559e5afd6..b68f92c784b 100644 --- a/javav2/example_code/transcribe-streaming/src/main/java/com/amazonaws/transcribestreaming/TranscribeStreamingDemoApp.java +++ b/javav2/example_code/transcribe-streaming/src/main/java/com/amazonaws/transcribestreaming/TranscribeStreamingDemoApp.java @@ -12,18 +12,8 @@ import software.amazon.awssdk.regions.Region; import software.amazon.awssdk.services.transcribestreaming.TranscribeStreamingAsyncClient; import software.amazon.awssdk.services.transcribestreaming.model.*; - -import javax.sound.sampled.AudioFormat; -import javax.sound.sampled.AudioInputStream; -import javax.sound.sampled.AudioSystem; -import javax.sound.sampled.DataLine; -import javax.sound.sampled.LineUnavailableException; -import javax.sound.sampled.TargetDataLine; -import java.io.IOException; -import java.io.InputStream; -import java.io.PrintWriter; -import java.io.StringWriter; -import java.io.UncheckedIOException; +import javax.sound.sampled.*; +import java.io.*; import java.net.URISyntaxException; import java.nio.ByteBuffer; import java.util.List; @@ -38,7 +28,7 @@ public class TranscribeStreamingDemoApp { private static final Region REGION = Region.US_EAST_1; private static TranscribeStreamingAsyncClient client; - public static void main(String[] args) + public static void main(String args[]) throws URISyntaxException, ExecutionException, InterruptedException, LineUnavailableException { client = TranscribeStreamingAsyncClient.builder() @@ -95,7 +85,7 @@ private static StartStreamTranscriptionResponseHandler getResponseHandler() { System.out.println(e.getMessage()); StringWriter sw = new StringWriter(); e.printStackTrace(new PrintWriter(sw)); - System.out.println("Error Occurred: " + sw); + System.out.println("Error Occurred: " + sw.toString()); }) .onComplete(() -> { System.out.println("=== All records stream successfully ==="); @@ -111,10 +101,19 @@ private static StartStreamTranscriptionResponseHandler getResponseHandler() { .build(); } - + private InputStream getStreamFromFile(String audioFileName) { + try { + File inputFile = new File(getClass().getClassLoader().getResource(audioFileName).getFile()); + InputStream audioStream = new FileInputStream(inputFile); + return audioStream; + } catch (FileNotFoundException e) { + throw new RuntimeException(e); + } + } + private static class AudioStreamPublisher implements Publisher { - private static Subscription currentSubscription; private final InputStream inputStream; + private static Subscription currentSubscription; private AudioStreamPublisher(InputStream inputStream) { this.inputStream = inputStream; @@ -123,22 +122,22 @@ private AudioStreamPublisher(InputStream inputStream) { @Override public void subscribe(Subscriber s) { - if (currentSubscription == null) { - currentSubscription = new SubscriptionImpl(s, inputStream); + if (this.currentSubscription == null) { + this.currentSubscription = new SubscriptionImpl(s, inputStream); } else { - currentSubscription.cancel(); - currentSubscription = new SubscriptionImpl(s, inputStream); + this.currentSubscription.cancel(); + this.currentSubscription = new SubscriptionImpl(s, inputStream); } s.onSubscribe(currentSubscription); } } public static class SubscriptionImpl implements Subscription { - private static final int CHUNK_SIZE_IN_BYTES = 1024; + private static final int CHUNK_SIZE_IN_BYTES = 1024 * 1; private final Subscriber subscriber; private final InputStream inputStream; - private final ExecutorService executor = Executors.newFixedThreadPool(1); - private final AtomicLong demand = new AtomicLong(0); + private ExecutorService executor = Executors.newFixedThreadPool(1); + private AtomicLong demand = new AtomicLong(0); SubscriptionImpl(Subscriber s, InputStream inputStream) { this.subscriber = s; diff --git a/php/README.md b/php/README.md index 2127dbf9761..b16e9881b4b 100644 --- a/php/README.md +++ b/php/README.md @@ -22,8 +22,54 @@ Cross-service examples are located in the [*cross-services folder*](cross_servic * We recommend that you grant your code least privilege. At most, grant only the minimum permissions required to perform the task. For more information, see [Grant least privilege](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#grant-least-privilege). * This code is not tested in every AWS Region. For more information, see [AWS Regional Services](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services). +## Prerequisites -### Prerequisites +To run these code examples, you need: + +* [PHP](https://www.php.net/) version 8.1 or higher +* [Composer](https://getcomposer.org) for dependency management +* [PHPUnit](https://phpunit.de/) for unit testing +* The [AWS SDK for PHP](https://aws.amazon.com/sdk-for-php/) +* [AWS credentials](https://docs.aws.amazon.com/sdk-for-php/v3/developer-guide/guide_credentials.html) set up + +For more information, see [Getting Started](https://docs.aws.amazon.com/sdk-for-php/v3/developer-guide/getting-started_index.html) in the AWS SDK for PHP Developer Guide. + +## Set up the examples + +Some examples require supporting files from the GitHub repository in addition to the AWS SDK for PHP. For these examples: + +1. Clone, fork, or download the entire [aws-doc-sdk-examples repository](https://github.com/awsdocs/aws-doc-sdk-examples) from GitHub. + + You need the entire repository, not just individual files, so supporting files can be accessed by the examples. + +2. Install dependencies + + From the directory that contains the composer.json file for the example, run: + ```bash + composer install + ``` + +3. Run examples from within the repository structure and from the directory that contains the initiating code + + Run examples from within the cloned directory structure to ensure access to supporting files. + +## Run the examples + +By default, these code examples run using the default AWS credential provider chain, which includes using the AWS shared credentials and config files with a `default` profile. +For more information, about using AWS shared files and the `default` profile, see [Using shared config and credentials files to globally configure AWS SDKs and tools](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html) in the *AWS SDKs and Tools +Reference Guide*. + +Important: Running these code examples might result in charges to the AWS account associated with the AWS credentials being used. + +Many examples include a `Runner.php` file to abstract the logic from running the code. From any example directory with a Runner.php file, run: + +```bash +php Runner.php +``` + +--------- + +## Prerequisites To run or test these code examples, you need the following: - [PHP](https://www.php.net/) version 8.1 or higher @@ -31,13 +77,20 @@ To run or test these code examples, you need the following: - [PHPUnit](https://phpunit.de/), for unit testing - The [AWS SDK for PHP](https://aws.amazon.com/sdk-for-php/) - [AWS credentials](https://docs.aws.amazon.com/sdk-for-php/v3/developer-guide/guide_credentials.html) set up +- For examples that use supporting files that are available only in the GitHub repository +and not available for installation by Composer, you need to + - clone, fork, or download a zip of the entire [aws-doc-sdk-examples repository](https://github.com/awsdocs/aws-doc-sdk-examples) from GitHub. +You want the entire repository, not just indvidual files, so supporting files can be accessed by the examples. + - Run the example from within the directory structure and from within the directory that contains the composer.json file. + - Install the dependencies and configuration settings with Composer. For more information, see [Getting Started](https://docs.aws.amazon.com/sdk-for-php/v3/developer-guide/getting-started_index.html) in the *AWS SDK for PHP Developer Guide*. ## Run the code -By default, these code examples run using the default AWS credential provider chain, which includes using an AWS shared credentials file and profiles. -For more information, see [Using the AWS Credentials File and Credential Profiles](https://docs.aws.amazon.com/sdk-for-php/v3/developer-guide/guide_credentials_profiles.html) in the *AWS SDK for PHP Developer Guide*. +By default, these code examples run using the default AWS credential provider chain, which includes using the AWS shared credentials and config files with a `default` profile. +For more information, about using AWS shared files and the `default` profile, see [Using shared config and credentials files to globally configure AWS SDKs and tools](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html) in the *AWS SDKs and Tools +Reference Guide*. Running these code examples might result in charges to the AWS account that is associated with the AWS credentials being used. diff --git a/php/example_code/dynamodb/DynamoDBService.php b/php/example_code/dynamodb/DynamoDBService.php index 625d5c0eeae..3355177960a 100644 --- a/php/example_code/dynamodb/DynamoDBService.php +++ b/php/example_code/dynamodb/DynamoDBService.php @@ -17,8 +17,7 @@ class DynamoDBService extends AWSServiceClass public function __construct( DynamoDbClient $client = null, string $region = 'us-west-2', - string $version = 'latest', - string $profile = 'default' + string $version = 'latest' ) { if (gettype($client) == DynamoDbClient::class) { $this->dynamoDbClient = $client; @@ -27,7 +26,6 @@ public function __construct( $this->dynamoDbClient = new DynamoDbClient([ 'region' => $region, 'version' => $version, - 'profile' => $profile, 'http' => [ 'verify' => false, ], diff --git a/php/example_code/dynamodb/README.md b/php/example_code/dynamodb/README.md index b1891c57f40..04c750ea3ff 100644 --- a/php/example_code/dynamodb/README.md +++ b/php/example_code/dynamodb/README.md @@ -40,14 +40,14 @@ Code examples that show you how to perform the essential operations within a ser Code excerpts that show you how to call individual service functions. -- [BatchExecuteStatement](DynamoDBService.php#L319) -- [BatchWriteItem](DynamoDBService.php#L201) +- [BatchExecuteStatement](DynamoDBService.php#L317) +- [BatchWriteItem](DynamoDBService.php#L199) - [CreateTable](dynamodb_basics/GettingStartedWithDynamoDB.php#L52) - [DeleteItem](dynamodb_basics/GettingStartedWithDynamoDB.php#L148) -- [DeleteTable](DynamoDBService.php#L84) -- [ExecuteStatement](DynamoDBService.php#L263) +- [DeleteTable](DynamoDBService.php#L82) +- [ExecuteStatement](DynamoDBService.php#L261) - [GetItem](dynamodb_basics/GettingStartedWithDynamoDB.php#L131) -- [ListTables](DynamoDBService.php#L64) +- [ListTables](DynamoDBService.php#L62) - [PutItem](dynamodb_basics/GettingStartedWithDynamoDB.php#L67) - [Query](dynamodb_basics/GettingStartedWithDynamoDB.php#L158) - [Scan](dynamodb_basics/GettingStartedWithDynamoDB.php#L178) @@ -164,4 +164,4 @@ in the `php` folder. Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. -SPDX-License-Identifier: Apache-2.0 \ No newline at end of file +SPDX-License-Identifier: Apache-2.0 diff --git a/php/example_code/dynamodb/dynamodb_basics/Runner.php b/php/example_code/dynamodb/dynamodb_basics/Runner.php index f396835a667..84030c4f1b4 100644 --- a/php/example_code/dynamodb/dynamodb_basics/Runner.php +++ b/php/example_code/dynamodb/dynamodb_basics/Runner.php @@ -4,7 +4,7 @@ use DynamoDb\Basics\GettingStartedWithDynamoDB; -include "vendor\autoload.php"; +include "vendor/autoload.php"; include "GettingStartedWithDynamoDB.php"; diff --git a/php/example_code/dynamodb/dynamodb_basics/composer.json b/php/example_code/dynamodb/dynamodb_basics/composer.json index 1a22e66f43f..ce8d94900d6 100644 --- a/php/example_code/dynamodb/dynamodb_basics/composer.json +++ b/php/example_code/dynamodb/dynamodb_basics/composer.json @@ -4,14 +4,14 @@ "guzzlehttp/guzzle": "^7.0" }, "autoload": { - "psr-0": { - "": "*" - }, + "files": [ + "../../aws_utilities/TestableReadline.php", + "../../aws_utilities/LoadMovieData.php" + ], "psr-4": { "DynamoDb\\": "../../dynamodb/", "DynamoDb\\Basics\\": "../../dynamodb/dynamodb_basics", "AwsUtilities\\": "../../aws_utilities" - }, - "files": ["../../aws_utilities/TestableReadline.php"] + } } } diff --git a/php/example_code/dynamodb/dynamodb_basics/composer.lock b/php/example_code/dynamodb/dynamodb_basics/composer.lock index 2759606e9c2..e5c9154f27f 100644 --- a/php/example_code/dynamodb/dynamodb_basics/composer.lock +++ b/php/example_code/dynamodb/dynamodb_basics/composer.lock @@ -8,16 +8,16 @@ "packages": [ { "name": "aws/aws-crt-php", - "version": "v1.2.4", + "version": "v1.2.7", "source": { "type": "git", "url": "https://github.com/awslabs/aws-crt-php.git", - "reference": "eb0c6e4e142224a10b08f49ebf87f32611d162b2" + "reference": "d71d9906c7bb63a28295447ba12e74723bd3730e" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/awslabs/aws-crt-php/zipball/eb0c6e4e142224a10b08f49ebf87f32611d162b2", - "reference": "eb0c6e4e142224a10b08f49ebf87f32611d162b2", + "url": "https://api.github.com/repos/awslabs/aws-crt-php/zipball/d71d9906c7bb63a28295447ba12e74723bd3730e", + "reference": "d71d9906c7bb63a28295447ba12e74723bd3730e", "shasum": "" }, "require": { @@ -56,22 +56,22 @@ ], "support": { "issues": "https://github.com/awslabs/aws-crt-php/issues", - "source": "https://github.com/awslabs/aws-crt-php/tree/v1.2.4" + "source": "https://github.com/awslabs/aws-crt-php/tree/v1.2.7" }, - "time": "2023-11-08T00:42:13+00:00" + "time": "2024-10-18T22:15:13+00:00" }, { "name": "aws/aws-sdk-php", - "version": "3.288.1", + "version": "3.356.18", "source": { "type": "git", "url": "https://github.com/aws/aws-sdk-php.git", - "reference": "a1dfa12c7165de0b731ae8074c4ba1f3ae733f89" + "reference": "af1bf3dee5e66cf9b3d5d2507b08d9465636df29" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/aws/aws-sdk-php/zipball/a1dfa12c7165de0b731ae8074c4ba1f3ae733f89", - "reference": "a1dfa12c7165de0b731ae8074c4ba1f3ae733f89", + "url": "https://api.github.com/repos/aws/aws-sdk-php/zipball/af1bf3dee5e66cf9b3d5d2507b08d9465636df29", + "reference": "af1bf3dee5e66cf9b3d5d2507b08d9465636df29", "shasum": "" }, "require": { @@ -79,31 +79,30 @@ "ext-json": "*", "ext-pcre": "*", "ext-simplexml": "*", - "guzzlehttp/guzzle": "^6.5.8 || ^7.4.5", - "guzzlehttp/promises": "^1.4.0 || ^2.0", - "guzzlehttp/psr7": "^1.9.1 || ^2.4.5", - "mtdowling/jmespath.php": "^2.6", - "php": ">=7.2.5", + "guzzlehttp/guzzle": "^7.4.5", + "guzzlehttp/promises": "^2.0", + "guzzlehttp/psr7": "^2.4.5", + "mtdowling/jmespath.php": "^2.8.0", + "php": ">=8.1", "psr/http-message": "^1.0 || ^2.0" }, "require-dev": { "andrewsville/php-token-reflection": "^1.4", "aws/aws-php-sns-message-validator": "~1.0", "behat/behat": "~3.0", - "composer/composer": "^1.10.22", + "composer/composer": "^2.7.8", "dms/phpunit-arraysubset-asserts": "^0.4.0", "doctrine/cache": "~1.4", "ext-dom": "*", "ext-openssl": "*", "ext-pcntl": "*", "ext-sockets": "*", - "nette/neon": "^2.3", - "paragonie/random_compat": ">= 2", "phpunit/phpunit": "^5.6.3 || ^8.5 || ^9.5", - "psr/cache": "^1.0", - "psr/simple-cache": "^1.0", - "sebastian/comparator": "^1.2.3 || ^4.0", - "yoast/phpunit-polyfills": "^1.0" + "psr/cache": "^2.0 || ^3.0", + "psr/simple-cache": "^2.0 || ^3.0", + "sebastian/comparator": "^1.2.3 || ^4.0 || ^5.0", + "symfony/filesystem": "^v6.4.0 || ^v7.1.0", + "yoast/phpunit-polyfills": "^2.0" }, "suggest": { "aws/aws-php-sns-message-validator": "To validate incoming SNS notifications", @@ -124,7 +123,10 @@ ], "psr-4": { "Aws\\": "src/" - } + }, + "exclude-from-classmap": [ + "src/data/" + ] }, "notification-url": "https://packagist.org/downloads/", "license": [ @@ -149,30 +151,30 @@ "sdk" ], "support": { - "forum": "https://forums.aws.amazon.com/forum.jspa?forumID=80", + "forum": "https://github.com/aws/aws-sdk-php/discussions", "issues": "https://github.com/aws/aws-sdk-php/issues", - "source": "https://github.com/aws/aws-sdk-php/tree/3.288.1" + "source": "https://github.com/aws/aws-sdk-php/tree/3.356.18" }, - "time": "2023-11-22T19:35:38+00:00" + "time": "2025-09-15T18:21:28+00:00" }, { "name": "guzzlehttp/guzzle", - "version": "7.8.1", + "version": "7.10.0", "source": { "type": "git", "url": "https://github.com/guzzle/guzzle.git", - "reference": "41042bc7ab002487b876a0683fc8dce04ddce104" + "reference": "b51ac707cfa420b7bfd4e4d5e510ba8008e822b4" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/guzzle/guzzle/zipball/41042bc7ab002487b876a0683fc8dce04ddce104", - "reference": "41042bc7ab002487b876a0683fc8dce04ddce104", + "url": "https://api.github.com/repos/guzzle/guzzle/zipball/b51ac707cfa420b7bfd4e4d5e510ba8008e822b4", + "reference": "b51ac707cfa420b7bfd4e4d5e510ba8008e822b4", "shasum": "" }, "require": { "ext-json": "*", - "guzzlehttp/promises": "^1.5.3 || ^2.0.1", - "guzzlehttp/psr7": "^1.9.1 || ^2.5.1", + "guzzlehttp/promises": "^2.3", + "guzzlehttp/psr7": "^2.8", "php": "^7.2.5 || ^8.0", "psr/http-client": "^1.0", "symfony/deprecation-contracts": "^2.2 || ^3.0" @@ -183,9 +185,9 @@ "require-dev": { "bamarni/composer-bin-plugin": "^1.8.2", "ext-curl": "*", - "php-http/client-integration-tests": "dev-master#2c025848417c1135031fdf9c728ee53d0a7ceaee as 3.0.999", + "guzzle/client-integration-tests": "3.0.2", "php-http/message-factory": "^1.1", - "phpunit/phpunit": "^8.5.36 || ^9.6.15", + "phpunit/phpunit": "^8.5.39 || ^9.6.20", "psr/log": "^1.1 || ^2.0 || ^3.0" }, "suggest": { @@ -263,7 +265,7 @@ ], "support": { "issues": "https://github.com/guzzle/guzzle/issues", - "source": "https://github.com/guzzle/guzzle/tree/7.8.1" + "source": "https://github.com/guzzle/guzzle/tree/7.10.0" }, "funding": [ { @@ -279,20 +281,20 @@ "type": "tidelift" } ], - "time": "2023-12-03T20:35:24+00:00" + "time": "2025-08-23T22:36:01+00:00" }, { "name": "guzzlehttp/promises", - "version": "2.0.2", + "version": "2.3.0", "source": { "type": "git", "url": "https://github.com/guzzle/promises.git", - "reference": "bbff78d96034045e58e13dedd6ad91b5d1253223" + "reference": "481557b130ef3790cf82b713667b43030dc9c957" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/guzzle/promises/zipball/bbff78d96034045e58e13dedd6ad91b5d1253223", - "reference": "bbff78d96034045e58e13dedd6ad91b5d1253223", + "url": "https://api.github.com/repos/guzzle/promises/zipball/481557b130ef3790cf82b713667b43030dc9c957", + "reference": "481557b130ef3790cf82b713667b43030dc9c957", "shasum": "" }, "require": { @@ -300,7 +302,7 @@ }, "require-dev": { "bamarni/composer-bin-plugin": "^1.8.2", - "phpunit/phpunit": "^8.5.36 || ^9.6.15" + "phpunit/phpunit": "^8.5.44 || ^9.6.25" }, "type": "library", "extra": { @@ -346,7 +348,7 @@ ], "support": { "issues": "https://github.com/guzzle/promises/issues", - "source": "https://github.com/guzzle/promises/tree/2.0.2" + "source": "https://github.com/guzzle/promises/tree/2.3.0" }, "funding": [ { @@ -362,20 +364,20 @@ "type": "tidelift" } ], - "time": "2023-12-03T20:19:20+00:00" + "time": "2025-08-22T14:34:08+00:00" }, { "name": "guzzlehttp/psr7", - "version": "2.6.2", + "version": "2.8.0", "source": { "type": "git", "url": "https://github.com/guzzle/psr7.git", - "reference": "45b30f99ac27b5ca93cb4831afe16285f57b8221" + "reference": "21dc724a0583619cd1652f673303492272778051" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/guzzle/psr7/zipball/45b30f99ac27b5ca93cb4831afe16285f57b8221", - "reference": "45b30f99ac27b5ca93cb4831afe16285f57b8221", + "url": "https://api.github.com/repos/guzzle/psr7/zipball/21dc724a0583619cd1652f673303492272778051", + "reference": "21dc724a0583619cd1652f673303492272778051", "shasum": "" }, "require": { @@ -390,8 +392,8 @@ }, "require-dev": { "bamarni/composer-bin-plugin": "^1.8.2", - "http-interop/http-factory-tests": "^0.9", - "phpunit/phpunit": "^8.5.36 || ^9.6.15" + "http-interop/http-factory-tests": "0.9.0", + "phpunit/phpunit": "^8.5.44 || ^9.6.25" }, "suggest": { "laminas/laminas-httphandlerrunner": "Emit PSR-7 responses" @@ -462,7 +464,7 @@ ], "support": { "issues": "https://github.com/guzzle/psr7/issues", - "source": "https://github.com/guzzle/psr7/tree/2.6.2" + "source": "https://github.com/guzzle/psr7/tree/2.8.0" }, "funding": [ { @@ -478,20 +480,20 @@ "type": "tidelift" } ], - "time": "2023-12-03T20:05:35+00:00" + "time": "2025-08-23T21:21:41+00:00" }, { "name": "mtdowling/jmespath.php", - "version": "2.7.0", + "version": "2.8.0", "source": { "type": "git", "url": "https://github.com/jmespath/jmespath.php.git", - "reference": "bbb69a935c2cbb0c03d7f481a238027430f6440b" + "reference": "a2a865e05d5f420b50cc2f85bb78d565db12a6bc" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/jmespath/jmespath.php/zipball/bbb69a935c2cbb0c03d7f481a238027430f6440b", - "reference": "bbb69a935c2cbb0c03d7f481a238027430f6440b", + "url": "https://api.github.com/repos/jmespath/jmespath.php/zipball/a2a865e05d5f420b50cc2f85bb78d565db12a6bc", + "reference": "a2a865e05d5f420b50cc2f85bb78d565db12a6bc", "shasum": "" }, "require": { @@ -508,7 +510,7 @@ "type": "library", "extra": { "branch-alias": { - "dev-master": "2.7-dev" + "dev-master": "2.8-dev" } }, "autoload": { @@ -542,9 +544,9 @@ ], "support": { "issues": "https://github.com/jmespath/jmespath.php/issues", - "source": "https://github.com/jmespath/jmespath.php/tree/2.7.0" + "source": "https://github.com/jmespath/jmespath.php/tree/2.8.0" }, - "time": "2023-08-25T10:54:48+00:00" + "time": "2024-09-04T18:46:31+00:00" }, { "name": "psr/http-client", @@ -600,20 +602,20 @@ }, { "name": "psr/http-factory", - "version": "1.0.2", + "version": "1.1.0", "source": { "type": "git", "url": "https://github.com/php-fig/http-factory.git", - "reference": "e616d01114759c4c489f93b099585439f795fe35" + "reference": "2b4765fddfe3b508ac62f829e852b1501d3f6e8a" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/php-fig/http-factory/zipball/e616d01114759c4c489f93b099585439f795fe35", - "reference": "e616d01114759c4c489f93b099585439f795fe35", + "url": "https://api.github.com/repos/php-fig/http-factory/zipball/2b4765fddfe3b508ac62f829e852b1501d3f6e8a", + "reference": "2b4765fddfe3b508ac62f829e852b1501d3f6e8a", "shasum": "" }, "require": { - "php": ">=7.0.0", + "php": ">=7.1", "psr/http-message": "^1.0 || ^2.0" }, "type": "library", @@ -637,7 +639,7 @@ "homepage": "https://www.php-fig.org/" } ], - "description": "Common interfaces for PSR-7 HTTP message factories", + "description": "PSR-17: Common interfaces for PSR-7 HTTP message factories", "keywords": [ "factory", "http", @@ -649,9 +651,9 @@ "response" ], "support": { - "source": "https://github.com/php-fig/http-factory/tree/1.0.2" + "source": "https://github.com/php-fig/http-factory" }, - "time": "2023-04-10T20:10:41+00:00" + "time": "2024-04-15T12:06:14+00:00" }, { "name": "psr/http-message", @@ -752,29 +754,29 @@ }, { "name": "symfony/deprecation-contracts", - "version": "v2.5.2", + "version": "v3.6.0", "source": { "type": "git", "url": "https://github.com/symfony/deprecation-contracts.git", - "reference": "e8b495ea28c1d97b5e0c121748d6f9b53d075c66" + "reference": "63afe740e99a13ba87ec199bb07bbdee937a5b62" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/symfony/deprecation-contracts/zipball/e8b495ea28c1d97b5e0c121748d6f9b53d075c66", - "reference": "e8b495ea28c1d97b5e0c121748d6f9b53d075c66", + "url": "https://api.github.com/repos/symfony/deprecation-contracts/zipball/63afe740e99a13ba87ec199bb07bbdee937a5b62", + "reference": "63afe740e99a13ba87ec199bb07bbdee937a5b62", "shasum": "" }, "require": { - "php": ">=7.1" + "php": ">=8.1" }, "type": "library", "extra": { - "branch-alias": { - "dev-main": "2.5-dev" - }, "thanks": { - "name": "symfony/contracts", - "url": "https://github.com/symfony/contracts" + "url": "https://github.com/symfony/contracts", + "name": "symfony/contracts" + }, + "branch-alias": { + "dev-main": "3.6-dev" } }, "autoload": { @@ -799,7 +801,7 @@ "description": "A generic function and convention to trigger deprecation notices", "homepage": "https://symfony.com", "support": { - "source": "https://github.com/symfony/deprecation-contracts/tree/v2.5.2" + "source": "https://github.com/symfony/deprecation-contracts/tree/v3.6.0" }, "funding": [ { @@ -815,24 +817,25 @@ "type": "tidelift" } ], - "time": "2022-01-02T09:53:40+00:00" + "time": "2024-09-25T14:21:43+00:00" }, { "name": "symfony/polyfill-mbstring", - "version": "v1.28.0", + "version": "v1.33.0", "source": { "type": "git", "url": "https://github.com/symfony/polyfill-mbstring.git", - "reference": "42292d99c55abe617799667f454222c54c60e229" + "reference": "6d857f4d76bd4b343eac26d6b539585d2bc56493" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/symfony/polyfill-mbstring/zipball/42292d99c55abe617799667f454222c54c60e229", - "reference": "42292d99c55abe617799667f454222c54c60e229", + "url": "https://api.github.com/repos/symfony/polyfill-mbstring/zipball/6d857f4d76bd4b343eac26d6b539585d2bc56493", + "reference": "6d857f4d76bd4b343eac26d6b539585d2bc56493", "shasum": "" }, "require": { - "php": ">=7.1" + "ext-iconv": "*", + "php": ">=7.2" }, "provide": { "ext-mbstring": "*" @@ -842,12 +845,9 @@ }, "type": "library", "extra": { - "branch-alias": { - "dev-main": "1.28-dev" - }, "thanks": { - "name": "symfony/polyfill", - "url": "https://github.com/symfony/polyfill" + "url": "https://github.com/symfony/polyfill", + "name": "symfony/polyfill" } }, "autoload": { @@ -882,7 +882,7 @@ "shim" ], "support": { - "source": "https://github.com/symfony/polyfill-mbstring/tree/v1.28.0" + "source": "https://github.com/symfony/polyfill-mbstring/tree/v1.33.0" }, "funding": [ { @@ -893,21 +893,25 @@ "url": "https://github.com/fabpot", "type": "github" }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, { "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", "type": "tidelift" } ], - "time": "2023-07-28T09:04:16+00:00" + "time": "2024-12-23T08:48:59+00:00" } ], "packages-dev": [], "aliases": [], "minimum-stability": "stable", - "stability-flags": [], + "stability-flags": {}, "prefer-stable": false, "prefer-lowest": false, - "platform": [], - "platform-dev": [], + "platform": {}, + "platform-dev": {}, "plugin-api-version": "2.6.0" } diff --git a/swift/example_code/transcribe-streaming/README.md b/swift/example_code/transcribe-streaming/README.md index 2c8f025d187..fd74fdc871c 100644 --- a/swift/example_code/transcribe-streaming/README.md +++ b/swift/example_code/transcribe-streaming/README.md @@ -72,12 +72,12 @@ and run commands. This example shows you how to generate a transcription of a source audio file using Amazon Transcribe streaming. - - + + - - + + ### Tests