Metadata-Version: 2.5
Name: rboto
Version: 0.1.0
Summary: rboto: async-only, typed AWS clients for Python, powered by Rust. Alpha preview.
Project-URL: Documentation, https://ferrumio.github.io/rboto
Project-URL: Repository, https://github.com/ferrumio/rboto
Project-URL: Homepage, https://ferrumio.github.io/rboto/
Project-URL: Issues, https://github.com/ferrumio/rboto/issues
Project-URL: Changelog, https://github.com/ferrumio/rboto/releases
Author-email: Leandro Cavalcante Damascena <leandro.damascena@gmail.com>
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: asyncio,aws,rboto,rust,sdk,typing
Classifier: Development Status :: 3 - Alpha
Classifier: Framework :: AsyncIO
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: 3.15
Classifier: Programming Language :: Rust
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.12
Provides-Extra: all
Requires-Dist: rboto-api-gateway==0.1.0; extra == 'all'
Requires-Dist: rboto-bedrock-agent-runtime==0.1.0; extra == 'all'
Requires-Dist: rboto-bedrock-agent==0.1.0; extra == 'all'
Requires-Dist: rboto-bedrock-agentcore-control==0.1.0; extra == 'all'
Requires-Dist: rboto-bedrock-agentcore==0.1.0; extra == 'all'
Requires-Dist: rboto-bedrock-data-automation-runtime==0.1.0; extra == 'all'
Requires-Dist: rboto-bedrock-data-automation==0.1.0; extra == 'all'
Requires-Dist: rboto-bedrock-runtime==0.1.0; extra == 'all'
Requires-Dist: rboto-bedrock==0.1.0; extra == 'all'
Requires-Dist: rboto-cloudtrail==0.1.0; extra == 'all'
Requires-Dist: rboto-cloudwatch-logs==0.1.0; extra == 'all'
Requires-Dist: rboto-cognito-identity==0.1.0; extra == 'all'
Requires-Dist: rboto-connecthealth==0.1.0; extra == 'all'
Requires-Dist: rboto-dynamodb==0.1.0; extra == 'all'
Requires-Dist: rboto-eventbridge==0.1.0; extra == 'all'
Requires-Dist: rboto-guardduty==0.1.0; extra == 'all'
Requires-Dist: rboto-kms==0.1.0; extra == 'all'
Requires-Dist: rboto-lambda==0.1.0; extra == 'all'
Requires-Dist: rboto-lex-runtime-v2==0.1.0; extra == 'all'
Requires-Dist: rboto-pipes==0.1.0; extra == 'all'
Requires-Dist: rboto-polly==0.1.0; extra == 'all'
Requires-Dist: rboto-qbusiness==0.1.0; extra == 'all'
Requires-Dist: rboto-s3==0.1.0; extra == 'all'
Requires-Dist: rboto-sagemaker-runtime-http2==0.1.0; extra == 'all'
Requires-Dist: rboto-scheduler==0.1.0; extra == 'all'
Requires-Dist: rboto-secrets-manager==0.1.0; extra == 'all'
Requires-Dist: rboto-sesv2==0.1.0; extra == 'all'
Requires-Dist: rboto-sfn==0.1.0; extra == 'all'
Requires-Dist: rboto-signin==0.1.0; extra == 'all'
Requires-Dist: rboto-sns==0.1.0; extra == 'all'
Requires-Dist: rboto-sqs==0.1.0; extra == 'all'
Requires-Dist: rboto-ssm==0.1.0; extra == 'all'
Requires-Dist: rboto-sts==0.1.0; extra == 'all'
Requires-Dist: rboto-transcribe-streaming==0.1.0; extra == 'all'
Provides-Extra: api-gateway
Requires-Dist: rboto-api-gateway==0.1.0; extra == 'api-gateway'
Provides-Extra: bedrock
Requires-Dist: rboto-bedrock==0.1.0; extra == 'bedrock'
Provides-Extra: bedrock-agent
Requires-Dist: rboto-bedrock-agent==0.1.0; extra == 'bedrock-agent'
Provides-Extra: bedrock-agent-runtime
Requires-Dist: rboto-bedrock-agent-runtime==0.1.0; extra == 'bedrock-agent-runtime'
Provides-Extra: bedrock-agentcore
Requires-Dist: rboto-bedrock-agentcore==0.1.0; extra == 'bedrock-agentcore'
Provides-Extra: bedrock-agentcore-control
Requires-Dist: rboto-bedrock-agentcore-control==0.1.0; extra == 'bedrock-agentcore-control'
Provides-Extra: bedrock-data-automation
Requires-Dist: rboto-bedrock-data-automation==0.1.0; extra == 'bedrock-data-automation'
Provides-Extra: bedrock-data-automation-runtime
Requires-Dist: rboto-bedrock-data-automation-runtime==0.1.0; extra == 'bedrock-data-automation-runtime'
Provides-Extra: bedrock-runtime
Requires-Dist: rboto-bedrock-runtime==0.1.0; extra == 'bedrock-runtime'
Provides-Extra: cloudtrail
Requires-Dist: rboto-cloudtrail==0.1.0; extra == 'cloudtrail'
Provides-Extra: cloudwatch-logs
Requires-Dist: rboto-cloudwatch-logs==0.1.0; extra == 'cloudwatch-logs'
Provides-Extra: cognito-identity
Requires-Dist: rboto-cognito-identity==0.1.0; extra == 'cognito-identity'
Provides-Extra: connecthealth
Requires-Dist: rboto-connecthealth==0.1.0; extra == 'connecthealth'
Provides-Extra: dynamodb
Requires-Dist: rboto-dynamodb==0.1.0; extra == 'dynamodb'
Provides-Extra: eventbridge
Requires-Dist: rboto-eventbridge==0.1.0; extra == 'eventbridge'
Provides-Extra: guardduty
Requires-Dist: rboto-guardduty==0.1.0; extra == 'guardduty'
Provides-Extra: kms
Requires-Dist: rboto-kms==0.1.0; extra == 'kms'
Provides-Extra: lambda
Requires-Dist: rboto-lambda==0.1.0; extra == 'lambda'
Provides-Extra: lex-runtime-v2
Requires-Dist: rboto-lex-runtime-v2==0.1.0; extra == 'lex-runtime-v2'
Provides-Extra: pipes
Requires-Dist: rboto-pipes==0.1.0; extra == 'pipes'
Provides-Extra: polly
Requires-Dist: rboto-polly==0.1.0; extra == 'polly'
Provides-Extra: qbusiness
Requires-Dist: rboto-qbusiness==0.1.0; extra == 'qbusiness'
Provides-Extra: s3
Requires-Dist: rboto-s3==0.1.0; extra == 's3'
Provides-Extra: sagemaker-runtime-http2
Requires-Dist: rboto-sagemaker-runtime-http2==0.1.0; extra == 'sagemaker-runtime-http2'
Provides-Extra: scheduler
Requires-Dist: rboto-scheduler==0.1.0; extra == 'scheduler'
Provides-Extra: secrets-manager
Requires-Dist: rboto-secrets-manager==0.1.0; extra == 'secrets-manager'
Provides-Extra: sesv2
Requires-Dist: rboto-sesv2==0.1.0; extra == 'sesv2'
Provides-Extra: sfn
Requires-Dist: rboto-sfn==0.1.0; extra == 'sfn'
Provides-Extra: signin
Requires-Dist: rboto-signin==0.1.0; extra == 'signin'
Provides-Extra: sns
Requires-Dist: rboto-sns==0.1.0; extra == 'sns'
Provides-Extra: sqs
Requires-Dist: rboto-sqs==0.1.0; extra == 'sqs'
Provides-Extra: ssm
Requires-Dist: rboto-ssm==0.1.0; extra == 'ssm'
Provides-Extra: sts
Requires-Dist: rboto-sts==0.1.0; extra == 'sts'
Provides-Extra: transcribe-streaming
Requires-Dist: rboto-transcribe-streaming==0.1.0; extra == 'transcribe-streaming'
Description-Content-Type: text/markdown

<!-- Generated by rboto-codegen. Edit the template or example source. -->
# rboto

rboto is an independent project maintained by [Ferrumio](https://github.com/ferrumio).
It is not affiliated with, sponsored by, or endorsed by Amazon Web Services (AWS).

**Preview (Alpha).** rboto is under active development. APIs may change between releases.

rboto provides **async-only, typed AWS clients for Python, powered by Rust**.
Install the services you use, import their client classes from `rboto`, and await
operations. Python 3.12 or newer is required.

## Installation

```bash
python -m pip install "rboto[sts]"
```

Each extra installs its service package. The `rboto` package alone supplies shared
configuration, logging, middleware, and lazy client imports. Importing a client
requires its service package. Use `rboto[s3,dynamodb]` for multiple clients or
`rboto[all]` for every client.

These are the package names to use when a release is available on your package index.
If your index has no release yet, follow the
[source installation instructions](https://ferrumio.github.io/rboto/getting-started/).

## Usage

Configure credentials with environment variables, a shared profile, or your workload's
role. This request reports the identity used by your credentials:

```python
import asyncio

from rboto import STSClient


async def main() -> None:
    client = STSClient(region="us-east-1")
    response = await client.get_caller_identity()
    print(response.account)
    print(response.arn)


if __name__ == "__main__":
    asyncio.run(main())
```

In an application with an event loop, use `await main()`. Operations have keyword-only
arguments. Structured inputs use typed dictionaries; regular outputs have typed
attributes. Reuse clients across calls. A `Session` shares settings between clients:

```python
from rboto import DynamoDBClient, S3Client, Session

session = Session(region="us-east-1", profile="development")
objects = S3Client(session=session)
items = DynamoDBClient(session=session)
```

## Clients and operation references

The 34 service packages below each contain a usage example, a complete
operation catalog, required arguments, return types, and full Python signatures.
Use the installed package's README and type definitions for its exact API.

| Import from `rboto` | Service | Package and operation reference |
|---|---|---|
| `APIGatewayClient` | Amazon API Gateway | [rboto-api-gateway](https://github.com/ferrumio/rboto/tree/main/packages/rboto-api-gateway) |
| `BedrockClient` | Amazon Bedrock | [rboto-bedrock](https://github.com/ferrumio/rboto/tree/main/packages/rboto-bedrock) |
| `BedrockAgentClient` | Amazon Bedrock Agents | [rboto-bedrock-agent](https://github.com/ferrumio/rboto/tree/main/packages/rboto-bedrock-agent) |
| `BedrockAgentRuntimeClient` | Amazon Bedrock Agent Runtime | [rboto-bedrock-agent-runtime](https://github.com/ferrumio/rboto/tree/main/packages/rboto-bedrock-agent-runtime) |
| `BedrockAgentCoreClient` | Amazon Bedrock AgentCore | [rboto-bedrock-agentcore](https://github.com/ferrumio/rboto/tree/main/packages/rboto-bedrock-agentcore) |
| `BedrockAgentCoreControlClient` | Amazon Bedrock AgentCore Control | [rboto-bedrock-agentcore-control](https://github.com/ferrumio/rboto/tree/main/packages/rboto-bedrock-agentcore-control) |
| `BedrockDataAutomationClient` | Amazon Bedrock Data Automation | [rboto-bedrock-data-automation](https://github.com/ferrumio/rboto/tree/main/packages/rboto-bedrock-data-automation) |
| `BedrockDataAutomationRuntimeClient` | Amazon Bedrock Data Automation Runtime | [rboto-bedrock-data-automation-runtime](https://github.com/ferrumio/rboto/tree/main/packages/rboto-bedrock-data-automation-runtime) |
| `BedrockRuntimeClient` | Amazon Bedrock Runtime | [rboto-bedrock-runtime](https://github.com/ferrumio/rboto/tree/main/packages/rboto-bedrock-runtime) |
| `CloudTrailClient` | AWS CloudTrail | [rboto-cloudtrail](https://github.com/ferrumio/rboto/tree/main/packages/rboto-cloudtrail) |
| `CloudWatchLogsClient` | Amazon CloudWatch Logs | [rboto-cloudwatch-logs](https://github.com/ferrumio/rboto/tree/main/packages/rboto-cloudwatch-logs) |
| `CognitoIdentityClient` | Amazon Cognito Identity | [rboto-cognito-identity](https://github.com/ferrumio/rboto/tree/main/packages/rboto-cognito-identity) |
| `ConnectHealthClient` | Amazon Connect Health | [rboto-connecthealth](https://github.com/ferrumio/rboto/tree/main/packages/rboto-connecthealth) |
| `DynamoDBClient` | Amazon DynamoDB | [rboto-dynamodb](https://github.com/ferrumio/rboto/tree/main/packages/rboto-dynamodb) |
| `EventBridgeClient` | Amazon EventBridge | [rboto-eventbridge](https://github.com/ferrumio/rboto/tree/main/packages/rboto-eventbridge) |
| `GuardDutyClient` | Amazon GuardDuty | [rboto-guardduty](https://github.com/ferrumio/rboto/tree/main/packages/rboto-guardduty) |
| `KMSClient` | AWS KMS | [rboto-kms](https://github.com/ferrumio/rboto/tree/main/packages/rboto-kms) |
| `LambdaClient` | AWS Lambda | [rboto-lambda](https://github.com/ferrumio/rboto/tree/main/packages/rboto-lambda) |
| `LexRuntimeV2Client` | Amazon Lex Runtime V2 | [rboto-lex-runtime-v2](https://github.com/ferrumio/rboto/tree/main/packages/rboto-lex-runtime-v2) |
| `EventBridgePipesClient` | Amazon EventBridge Pipes | [rboto-pipes](https://github.com/ferrumio/rboto/tree/main/packages/rboto-pipes) |
| `PollyClient` | Amazon Polly | [rboto-polly](https://github.com/ferrumio/rboto/tree/main/packages/rboto-polly) |
| `QBusinessClient` | Amazon Q Business | [rboto-qbusiness](https://github.com/ferrumio/rboto/tree/main/packages/rboto-qbusiness) |
| `S3Client` | Amazon S3 | [rboto-s3](https://github.com/ferrumio/rboto/tree/main/packages/rboto-s3) |
| `SageMakerRuntimeHTTP2Client` | Amazon SageMaker Runtime HTTP/2 | [rboto-sagemaker-runtime-http2](https://github.com/ferrumio/rboto/tree/main/packages/rboto-sagemaker-runtime-http2) |
| `EventBridgeSchedulerClient` | Amazon EventBridge Scheduler | [rboto-scheduler](https://github.com/ferrumio/rboto/tree/main/packages/rboto-scheduler) |
| `SecretsManagerClient` | AWS Secrets Manager | [rboto-secrets-manager](https://github.com/ferrumio/rboto/tree/main/packages/rboto-secrets-manager) |
| `SESV2Client` | Amazon SES V2 | [rboto-sesv2](https://github.com/ferrumio/rboto/tree/main/packages/rboto-sesv2) |
| `StepFunctionsClient` | AWS Step Functions | [rboto-sfn](https://github.com/ferrumio/rboto/tree/main/packages/rboto-sfn) |
| `SignInClient` | AWS Sign-In | [rboto-signin](https://github.com/ferrumio/rboto/tree/main/packages/rboto-signin) |
| `SNSClient` | Amazon SNS | [rboto-sns](https://github.com/ferrumio/rboto/tree/main/packages/rboto-sns) |
| `SQSClient` | Amazon SQS | [rboto-sqs](https://github.com/ferrumio/rboto/tree/main/packages/rboto-sqs) |
| `SSMClient` | AWS Systems Manager | [rboto-ssm](https://github.com/ferrumio/rboto/tree/main/packages/rboto-ssm) |
| `STSClient` | AWS STS | [rboto-sts](https://github.com/ferrumio/rboto/tree/main/packages/rboto-sts) |
| `TranscribeStreamingClient` | Amazon Transcribe Streaming | [rboto-transcribe-streaming](https://github.com/ferrumio/rboto/tree/main/packages/rboto-transcribe-streaming) |

## Documentation

- [Getting started](https://ferrumio.github.io/rboto/getting-started/)
- [Client catalog](https://ferrumio.github.io/rboto/clients/)
- [Async execution](https://ferrumio.github.io/rboto/guides/async-only/)
- [Configuration](https://ferrumio.github.io/rboto/guides/configuration/)
- [Errors](https://ferrumio.github.io/rboto/guides/errors/)
- [Logging](https://ferrumio.github.io/rboto/guides/logging/)
- [Interceptors](https://ferrumio.github.io/rboto/guides/interceptors/)

[Repository](https://github.com/ferrumio/rboto) ·
[Issues](https://github.com/ferrumio/rboto/issues) ·
[Releases](https://github.com/ferrumio/rboto/releases)

Licensed under Apache-2.0.
