Skip to main content

使用 mypy-boto3-builder 7.11.10 生成的 aiobotocore.Backup 2.4.0 服务的类型注释

项目描述

类型-aiobotocore-备份

PyPI - 类型-aiobotocore-备份 PyPI - Python 版本 文档 PyPI - 下载

boto3.typed

为aiobotocore.Backup 2.4.0服务键入注释, 兼容VSCodePyCharmEmacsSublime Textmypypyright和其他工具。

mypy-boto3-builder 7.11.10 生成

更多信息可以在 types-aiobotocore页面和 types-aiobotocore-backup 文档中找到。

了解它如何帮助查找和修复潜在错误:

boto3-stubs 演示

如何安装

来自带有 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-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]'

类型检查现在应该可以工作了。不需要显式类型注释,aiobotocore像往常一样编写代码。

其他 IDE

未经测试,但只要您的 IDE 支持mypyor pyright,一切都应该工作。

我的

  • 安装mypypython -m pip install mypy
  • types-aiobotocore[backup]在您的环境中安装:
python -m pip install 'types-aiobotocore[backup]'`

类型检查现在应该可以工作了。不需要显式类型注释,aiobotocore像往常一样编写代码。

版权

  • 安装pyrightnpm i -g pyright
  • types-aiobotocore[backup]在您的环境中安装:
python -m pip install 'types-aiobotocore[backup]'

或者,您可以安装types-aiobotocoretypings文件夹。

类型检查现在应该可以工作了。不需要显式类型注释,aiobotocore像往常一样编写代码。

显式类型注释

客户端注释

BackupClientsession.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如果类型不正确,请归咎于文档)。
  • 类型注释包括最新的文档。
  • 每种方法都提供了文档链接。
  • 为了可读性,代码由blackisort处理。

什么是新的

实现的功能

  • 全类型注释boto3botocoreaiobotocore
  • mypy, pyright, VSCode, PyCharm,Sublime TextEmacs 兼容性
  • Client, ServiceResource, Resource,Waiter Paginator为每个服务键入注释
  • TypeDefs为每个服务生成
  • Literals为每个服务生成
  • 自动发现类型boto3.clientboto3.session调用
  • 自动发现类型session.clientsession.session调用
  • 自动发现类型client.get_waiterclient.get_paginator 调用
  • 自动发现类型ServiceResourceResource集合
  • 自动发现aiobotocore.Session.create_client呼叫类型

最新变化

生成器更改日志可以在 Releases中找到。

版本控制

types-aiobotocore-backup版本与相关aiobotocore版本相同,遵循PEP 440格式。

谢谢

文档

所有服务类型注释都可以在 aiobotocore 文档中找到

支持和贡献

这个包是自动生成的。请在mypy-boto3-builder存储库中报告任何错误或请求新功能 。

项目详情