使用 mypy-boto3-builder 7.11.10 生成的 aiobotocore.Backup 2.4.0 服务的类型注释
项目描述
类型-aiobotocore-备份
为aiobotocore.Backup 2.4.0服务键入注释, 兼容VSCode、 PyCharm、 Emacs、 Sublime Text、 mypy、 pyright和其他工具。
由 mypy-boto3-builder 7.11.10 生成。
更多信息可以在 types-aiobotocore页面和 types-aiobotocore-backup 文档中找到。
了解它如何帮助查找和修复潜在错误:
如何安装
来自带有 pip 的 PyPI
安装types-aiobotocore
服务Backup
。
# install with aiobotocore type annotations
python -m pip install 'types-aiobotocore[backup]'
# Lite version does not provide session.client/resource overloads
# it is more RAM-friendly, but requires explicit type annotations
python -m pip install 'types-aiobotocore-lite[backup]'
# standalone installation
python -m pip install types-aiobotocore-backup
如何卸载
python -m pip uninstall -y types-aiobotocore-backup
用法
VSCode
- 安装 Python 扩展
- 安装 Pylance 扩展
- 设置
Pylance
为您的 Python 语言服务器 types-aiobotocore[backup]
在您的环境中安装:
python -m pip install 'types-aiobotocore[backup]'
类型检查和代码完成现在都应该可以工作了。不需要显式类型注释,aiobotocore
像往常一样编写代码。
PyCharm
types-aiobotocore-lite[backup]
在您的环境中安装:
python -m pip install 'types-aiobotocore-lite[backup]'`
类型检查和代码完成现在都应该可以工作了。需要显式类型注释。
使用types-aiobotocore
包代替隐式类型发现。
Emacs
- 安装
types-aiobotocore
您在环境中使用的服务:
python -m pip install 'types-aiobotocore[backup]'
- 安装use-package、 lsp、 company和 flycheck包
- 安装lsp-pyright包
(use-package lsp-pyright
:ensure t
:hook (python-mode . (lambda ()
(require 'lsp-pyright)
(lsp))) ; or lsp-deferred
:init (when (executable-find "python3")
(setq lsp-pyright-python-executable-cmd "python3"))
)
- 确保 emacs 使用您安装的环境
types-aiobotocore
类型检查现在应该可以工作了。不需要显式类型注释,aiobotocore
像往常一样编写代码。
崇高的文本
- 安装
types-aiobotocore[backup]
您在环境中使用的服务:
python -m pip install 'types-aiobotocore[backup]'
- 安装LSP-pyright包
类型检查现在应该可以工作了。不需要显式类型注释,aiobotocore
像往常一样编写代码。
其他 IDE
未经测试,但只要您的 IDE 支持mypy
or pyright
,一切都应该工作。
我的
- 安装
mypy
:python -m pip install mypy
types-aiobotocore[backup]
在您的环境中安装:
python -m pip install 'types-aiobotocore[backup]'`
类型检查现在应该可以工作了。不需要显式类型注释,aiobotocore
像往常一样编写代码。
版权
- 安装
pyright
:npm i -g pyright
types-aiobotocore[backup]
在您的环境中安装:
python -m pip install 'types-aiobotocore[backup]'
或者,您可以安装types-aiobotocore
到typings
文件夹。
类型检查现在应该可以工作了。不需要显式类型注释,aiobotocore
像往常一样编写代码。
显式类型注释
客户端注释
BackupClient
为session.create_client("backup")
.
from aiobotocore.session import get_session
from types_aiobotocore_backup import BackupClient
session = get_session()
async with session.create_client("backup") as client:
client: BackupClient
# now client usage is checked by mypy and IDE should provide code completion
分页器注释
types_aiobotocore_backup.paginator
模块包含所有分页器的类型注释。
from aiobotocore.session import get_session
from types_aiobotocore_backup import BackupClient
from types_aiobotocore_backup.paginator import (
ListBackupJobsPaginator,
ListBackupPlanTemplatesPaginator,
ListBackupPlanVersionsPaginator,
ListBackupPlansPaginator,
ListBackupSelectionsPaginator,
ListBackupVaultsPaginator,
ListCopyJobsPaginator,
ListProtectedResourcesPaginator,
ListRecoveryPointsByBackupVaultPaginator,
ListRecoveryPointsByResourcePaginator,
ListRestoreJobsPaginator,
)
session = get_session()
async with session.create_client("backup") as client:
client: BackupClient
# Explicit type annotations are optional here
# Types should be correctly discovered by mypy and IDEs
list_backup_jobs_paginator: ListBackupJobsPaginator = client.get_paginator("list_backup_jobs")
list_backup_plan_templates_paginator: ListBackupPlanTemplatesPaginator = client.get_paginator(
"list_backup_plan_templates"
)
list_backup_plan_versions_paginator: ListBackupPlanVersionsPaginator = client.get_paginator(
"list_backup_plan_versions"
)
list_backup_plans_paginator: ListBackupPlansPaginator = client.get_paginator(
"list_backup_plans"
)
list_backup_selections_paginator: ListBackupSelectionsPaginator = client.get_paginator(
"list_backup_selections"
)
list_backup_vaults_paginator: ListBackupVaultsPaginator = client.get_paginator(
"list_backup_vaults"
)
list_copy_jobs_paginator: ListCopyJobsPaginator = client.get_paginator("list_copy_jobs")
list_protected_resources_paginator: ListProtectedResourcesPaginator = client.get_paginator(
"list_protected_resources"
)
list_recovery_points_by_backup_vault_paginator: ListRecoveryPointsByBackupVaultPaginator = (
client.get_paginator("list_recovery_points_by_backup_vault")
)
list_recovery_points_by_resource_paginator: ListRecoveryPointsByResourcePaginator = (
client.get_paginator("list_recovery_points_by_resource")
)
list_restore_jobs_paginator: ListRestoreJobsPaginator = client.get_paginator(
"list_restore_jobs"
)
字面量
types_aiobotocore_backup.literals
模块包含从形状中提取的文字,可在用户代码中用于类型检查。
from types_aiobotocore_backup.literals import (
BackupJobStateType,
BackupVaultEventType,
ConditionTypeType,
CopyJobStateType,
ListBackupJobsPaginatorName,
ListBackupPlanTemplatesPaginatorName,
ListBackupPlanVersionsPaginatorName,
ListBackupPlansPaginatorName,
ListBackupSelectionsPaginatorName,
ListBackupVaultsPaginatorName,
ListCopyJobsPaginatorName,
ListProtectedResourcesPaginatorName,
ListRecoveryPointsByBackupVaultPaginatorName,
ListRecoveryPointsByResourcePaginatorName,
ListRestoreJobsPaginatorName,
RecoveryPointStatusType,
RestoreJobStatusType,
StorageClassType,
BackupServiceName,
ServiceName,
ResourceServiceName,
PaginatorName,
RegionName,
)
def check_value(value: BackupJobStateType) -> bool:
...
打字字典
types_aiobotocore_backup.type_defs
模块包含组装到类型化字典的结构和形状,以进行额外的类型检查。
from types_aiobotocore_backup.type_defs import (
AdvancedBackupSettingTypeDef,
RecoveryPointCreatorTypeDef,
BackupPlanTemplatesListMemberTypeDef,
LifecycleTypeDef,
ConditionTypeDef,
BackupSelectionsListMemberTypeDef,
BackupVaultListMemberTypeDef,
CalculatedLifecycleTypeDef,
ConditionParameterTypeDef,
ControlInputParameterTypeDef,
ControlScopeTypeDef,
ResponseMetadataTypeDef,
CreateBackupVaultInputRequestTypeDef,
ReportDeliveryChannelTypeDef,
ReportSettingTypeDef,
DeleteBackupPlanInputRequestTypeDef,
DeleteBackupSelectionInputRequestTypeDef,
DeleteBackupVaultAccessPolicyInputRequestTypeDef,
DeleteBackupVaultInputRequestTypeDef,
DeleteBackupVaultLockConfigurationInputRequestTypeDef,
DeleteBackupVaultNotificationsInputRequestTypeDef,
DeleteFrameworkInputRequestTypeDef,
DeleteRecoveryPointInputRequestTypeDef,
DeleteReportPlanInputRequestTypeDef,
DescribeBackupJobInputRequestTypeDef,
DescribeBackupVaultInputRequestTypeDef,
DescribeCopyJobInputRequestTypeDef,
DescribeFrameworkInputRequestTypeDef,
DescribeProtectedResourceInputRequestTypeDef,
DescribeRecoveryPointInputRequestTypeDef,
DescribeReportJobInputRequestTypeDef,
DescribeReportPlanInputRequestTypeDef,
DescribeRestoreJobInputRequestTypeDef,
DisassociateRecoveryPointInputRequestTypeDef,
ExportBackupPlanTemplateInputRequestTypeDef,
FrameworkTypeDef,
GetBackupPlanFromJSONInputRequestTypeDef,
GetBackupPlanFromTemplateInputRequestTypeDef,
GetBackupPlanInputRequestTypeDef,
GetBackupSelectionInputRequestTypeDef,
GetBackupVaultAccessPolicyInputRequestTypeDef,
GetBackupVaultNotificationsInputRequestTypeDef,
GetRecoveryPointRestoreMetadataInputRequestTypeDef,
PaginatorConfigTypeDef,
ListBackupJobsInputRequestTypeDef,
ListBackupPlanTemplatesInputRequestTypeDef,
ListBackupPlanVersionsInputRequestTypeDef,
ListBackupPlansInputRequestTypeDef,
ListBackupSelectionsInputRequestTypeDef,
ListBackupVaultsInputRequestTypeDef,
ListCopyJobsInputRequestTypeDef,
ListFrameworksInputRequestTypeDef,
ListProtectedResourcesInputRequestTypeDef,
ProtectedResourceTypeDef,
ListRecoveryPointsByBackupVaultInputRequestTypeDef,
ListRecoveryPointsByResourceInputRequestTypeDef,
RecoveryPointByResourceTypeDef,
ListReportJobsInputRequestTypeDef,
ListReportPlansInputRequestTypeDef,
ListRestoreJobsInputRequestTypeDef,
RestoreJobsListMemberTypeDef,
ListTagsInputRequestTypeDef,
PutBackupVaultAccessPolicyInputRequestTypeDef,
PutBackupVaultLockConfigurationInputRequestTypeDef,
PutBackupVaultNotificationsInputRequestTypeDef,
ReportDestinationTypeDef,
StartReportJobInputRequestTypeDef,
StartRestoreJobInputRequestTypeDef,
StopBackupJobInputRequestTypeDef,
TagResourceInputRequestTypeDef,
UntagResourceInputRequestTypeDef,
UpdateGlobalSettingsInputRequestTypeDef,
UpdateRegionSettingsInputRequestTypeDef,
BackupPlansListMemberTypeDef,
BackupJobTypeDef,
CopyJobTypeDef,
CopyActionTypeDef,
StartBackupJobInputRequestTypeDef,
StartCopyJobInputRequestTypeDef,
UpdateRecoveryPointLifecycleInputRequestTypeDef,
RecoveryPointByBackupVaultTypeDef,
ConditionsTypeDef,
FrameworkControlTypeDef,
CreateBackupPlanOutputTypeDef,
CreateBackupSelectionOutputTypeDef,
CreateBackupVaultOutputTypeDef,
CreateFrameworkOutputTypeDef,
CreateReportPlanOutputTypeDef,
DeleteBackupPlanOutputTypeDef,
DescribeBackupJobOutputTypeDef,
DescribeBackupVaultOutputTypeDef,
DescribeGlobalSettingsOutputTypeDef,
DescribeProtectedResourceOutputTypeDef,
DescribeRecoveryPointOutputTypeDef,
DescribeRegionSettingsOutputTypeDef,
DescribeRestoreJobOutputTypeDef,
EmptyResponseMetadataTypeDef,
ExportBackupPlanTemplateOutputTypeDef,
GetBackupVaultAccessPolicyOutputTypeDef,
GetBackupVaultNotificationsOutputTypeDef,
GetRecoveryPointRestoreMetadataOutputTypeDef,
GetSupportedResourceTypesOutputTypeDef,
ListBackupPlanTemplatesOutputTypeDef,
ListBackupSelectionsOutputTypeDef,
ListBackupVaultsOutputTypeDef,
ListTagsOutputTypeDef,
StartBackupJobOutputTypeDef,
StartCopyJobOutputTypeDef,
StartReportJobOutputTypeDef,
StartRestoreJobOutputTypeDef,
UpdateBackupPlanOutputTypeDef,
UpdateFrameworkOutputTypeDef,
UpdateRecoveryPointLifecycleOutputTypeDef,
UpdateReportPlanOutputTypeDef,
CreateReportPlanInputRequestTypeDef,
ReportPlanTypeDef,
UpdateReportPlanInputRequestTypeDef,
ListFrameworksOutputTypeDef,
ListBackupJobsInputListBackupJobsPaginateTypeDef,
ListBackupPlanTemplatesInputListBackupPlanTemplatesPaginateTypeDef,
ListBackupPlanVersionsInputListBackupPlanVersionsPaginateTypeDef,
ListBackupPlansInputListBackupPlansPaginateTypeDef,
ListBackupSelectionsInputListBackupSelectionsPaginateTypeDef,
ListBackupVaultsInputListBackupVaultsPaginateTypeDef,
ListCopyJobsInputListCopyJobsPaginateTypeDef,
ListProtectedResourcesInputListProtectedResourcesPaginateTypeDef,
ListRecoveryPointsByBackupVaultInputListRecoveryPointsByBackupVaultPaginateTypeDef,
ListRecoveryPointsByResourceInputListRecoveryPointsByResourcePaginateTypeDef,
ListRestoreJobsInputListRestoreJobsPaginateTypeDef,
ListProtectedResourcesOutputTypeDef,
ListRecoveryPointsByResourceOutputTypeDef,
ListRestoreJobsOutputTypeDef,
ReportJobTypeDef,
ListBackupPlanVersionsOutputTypeDef,
ListBackupPlansOutputTypeDef,
ListBackupJobsOutputTypeDef,
DescribeCopyJobOutputTypeDef,
ListCopyJobsOutputTypeDef,
BackupRuleInputTypeDef,
BackupRuleTypeDef,
ListRecoveryPointsByBackupVaultOutputTypeDef,
BackupSelectionTypeDef,
CreateFrameworkInputRequestTypeDef,
DescribeFrameworkOutputTypeDef,
UpdateFrameworkInputRequestTypeDef,
DescribeReportPlanOutputTypeDef,
ListReportPlansOutputTypeDef,
DescribeReportJobOutputTypeDef,
ListReportJobsOutputTypeDef,
BackupPlanInputTypeDef,
BackupPlanTypeDef,
CreateBackupSelectionInputRequestTypeDef,
GetBackupSelectionOutputTypeDef,
CreateBackupPlanInputRequestTypeDef,
UpdateBackupPlanInputRequestTypeDef,
GetBackupPlanFromJSONOutputTypeDef,
GetBackupPlanFromTemplateOutputTypeDef,
GetBackupPlanOutputTypeDef,
)
def get_structure() -> AdvancedBackupSettingTypeDef:
return {...}
这个怎么运作
全自动
的mypy-boto3-builder为每个服务仔细生成类型注解,耐心等待
aiobotocore
更新。它为您提供插入式注释,并确保:
- 涵盖所有可用
aiobotocore
服务。 - 每个
aiobotocore
服务的每个公共类和方法都会从文档中提取有效的类型注释(botocore
如果类型不正确,请归咎于文档)。 - 类型注释包括最新的文档。
- 每种方法都提供了文档链接。
- 为了可读性,代码由black和 isort处理。
什么是新的
实现的功能
- 全类型注释
boto3
和botocore
库aiobotocore
mypy
,pyright
,VSCode
,PyCharm
,Sublime Text
和Emacs
兼容性Client
,ServiceResource
,Resource
,Waiter
Paginator
为每个服务键入注释TypeDefs
为每个服务生成Literals
为每个服务生成- 自动发现类型
boto3.client
和boto3.session
调用 - 自动发现类型
session.client
和session.session
调用 - 自动发现类型
client.get_waiter
和client.get_paginator
调用 - 自动发现类型
ServiceResource
和Resource
集合 - 自动发现
aiobotocore.Session.create_client
呼叫类型
最新变化
生成器更改日志可以在 Releases中找到。
版本控制
types-aiobotocore-backup
版本与相关aiobotocore
版本相同,遵循PEP 440格式。
谢谢
- Allie Fitter for boto3-type-annotations,这个包是基于他的工作
- 一个很棒的格式化工具的黑人开发者
- 蒂莫西·埃德蒙·克罗斯利 (Timothy Edmund Crosley ) 的 isort及其灵活度
- mypy开发人员为我们做了所有肮脏的工作
- pyright团队为类型化 Python 的新时代
文档
所有服务类型注释都可以在 aiobotocore 文档中找到
支持和贡献
这个包是自动生成的。请在mypy-boto3-builder存储库中报告任何错误或请求新功能 。