{"id":44751555,"url":"https://github.com/adriantomas/boto3-errors","last_synced_at":"2026-03-07T11:09:35.642Z","repository":{"id":337787876,"uuid":"1155170384","full_name":"adriantomas/boto3-errors","owner":"adriantomas","description":"Typed, statically-importable exception classes for every AWS service","archived":false,"fork":false,"pushed_at":"2026-02-28T10:55:59.000Z","size":587,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-28T15:30:09.985Z","etag":null,"topics":["aws","boto3","botocore","python","python3"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/boto3-errors/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/adriantomas.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-11T07:48:42.000Z","updated_at":"2026-02-28T10:55:54.000Z","dependencies_parsed_at":"2026-02-18T01:01:10.974Z","dependency_job_id":null,"html_url":"https://github.com/adriantomas/boto3-errors","commit_stats":null,"previous_names":["adriantomas/boto3-errors"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/adriantomas/boto3-errors","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adriantomas%2Fboto3-errors","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adriantomas%2Fboto3-errors/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adriantomas%2Fboto3-errors/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adriantomas%2Fboto3-errors/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adriantomas","download_url":"https://codeload.github.com/adriantomas/boto3-errors/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adriantomas%2Fboto3-errors/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30212106,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-07T09:02:10.694Z","status":"ssl_error","status_checked_at":"2026-03-07T09:02:08.429Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws","boto3","botocore","python","python3"],"created_at":"2026-02-15T23:13:18.883Z","updated_at":"2026-03-07T11:09:35.604Z","avatar_url":"https://github.com/adriantomas.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# (Better) boto3 errors\n\n[![Python 3.10 | 3.11 | 3.12 | 3.13 | 3.14](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue.svg)](https://www.python.org/downloads/)\n[![PyPI](https://img.shields.io/pypi/v/boto3_errors.svg)](https://pypi.org/project/boto3_errors/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nTyped, statically-importable exception classes for every AWS service.\n\n## Install\n\n```bash\npip install boto3-errors\n```\n\n## Quick start\n\n```python\nimport boto3\nfrom boto3_errors import patch_client\nfrom boto3_errors.dynamodb import ConditionalCheckFailedException\n\nclient = boto3.client(\"dynamodb\")\npatch_client(client)\n\ntry:\n    client.put_item(\n        TableName=\"users\",\n        Item={\"pk\": {\"S\": \"user#1\"}, \"name\": {\"S\": \"Ada\"}},\n        ConditionExpression=\"attribute_not_exists(pk)\",\n    )\nexcept ConditionalCheckFailedException as e:\n    print(e.message)  # \"The conditional request failed\"\n    print(e.error_code)  # \"ConditionalCheckFailedException\"\n    print(e.item)  # {\"pk\": {\"S\": \"user#1\"}, \"name\": {\"S\": \"Ada\"}}\n```\n\n## The problem\n\nEvery boto3 error comes back as a `ClientError`. The only way to distinguish them is by parsing `e.response[\"Error\"][\"Code\"]` — a stringly-typed dict lookup with no autocomplete, no type checking, and no IDE support. A typo in the error code string won't be caught until it crashes.\n\n## What you get\n\nAll AWS services with exception classes auto-generated from botocore's service model.\n\n### Exception hierarchy\n\n```text\nClientError                     # botocore base — still works\n└── Boto3Error                  # boto3-errors base\n    └── DynamoDBError           # per-service base\n        ├── ConditionalCheckFailedException\n        ├── ResourceNotFoundException\n        ├── TransactionCanceledException\n        └── ...\n```\n\nEvery exception is a `ClientError` subclass, so existing `except ClientError` handlers keep working.\n\n### Built-in properties\n\nEvery `Boto3Error` exposes:\n\n| Property | Type | Source |\n| ------------------ | ----- | ----------------------------------- |\n| `message` | `str` | `Error.Message` |\n| `error_code` | `str` | `Error.Code` |\n| `http_status_code` | `int` | `ResponseMetadata.HTTPStatusCode` |\n| `request_id` | `str` | `ResponseMetadata.RequestId` |\n\n### Service-specific properties\n\nSome exceptions expose extra fields from the API response:\n\n```python\nfrom boto3_errors.dynamodb import (\n    ConditionalCheckFailedException,\n    TransactionCanceledException,\n)\n\n# ConditionalCheckFailedException.item -\u003e dict | None\n# TransactionCanceledException.cancellation_reasons -\u003e list | None\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadriantomas%2Fboto3-errors","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadriantomas%2Fboto3-errors","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadriantomas%2Fboto3-errors/lists"}