mypy-boto3-guardduty

What it is and what it does

This package provides type stubs for boto3's GuardDuty service, generated by mypy-boto3-builder. It enables static type checkers (mypy, pyright) and IDEs (VSCode, PyCharm, Emacs, Sublime Text) to understand and validate GuardDuty client calls, offering autocomplete and catching type errors at development time rather than runtime.

The package is purely a type-annotation layer—it has no runtime behavior and depends only on typing-extensions. It's designed to be installed alongside boto3 and works by providing type information for GuardDuty's client, paginators, waiters, and service models. Installation is straightforward via pip, and it integrates transparently with most Python development environments.

Use it for:

• Enable IDE autocompletion and type checking when writing boto3 GuardDuty code in VSCode or PyCharm.
• Catch GuardDuty API call errors (wrong parameters, missing arguments) before runtime using mypy or pyright.
• Document GuardDuty client method signatures and return types for team members reading the code.
• Validate paginator and waiter usage with full type hints for GuardDuty operations.
• Integrate GuardDuty type checking into CI/CD pipelines using mypy or pyright without runtime overhead.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides type annotations and IDE autocompletion for boto3's GuardDuty service, enabling static type checking with mypy, pyright, and editor support.

Yes, if you use boto3 GuardDuty in a typed Python project. The package is actively maintained, has no security vulnerabilities, carries a permissive MIT license, and adds negligible install friction. It's particularly valuable in codebases using mypy or pyright, or in IDEs like VSCode with Pylance. The only caveat: PyCharm users may experience performance issues with the full type stubs and should consider boto3-stubs-lite instead.

Install

mypy-boto3-guardduty on PyPI

pip install mypy-boto3-guardduty

uv add mypy-boto3-guardduty

poetry add mypy-boto3-guardduty

Installing mypy-boto3-guardduty

Before you install

Low friction: single runtime dependency (typing-extensions), wheel-only distribution, and actively maintained with recent releases. Designed as a lightweight type-stub package with no complex build requirements.

License in practice

MIT license permits unrestricted use, modification, and distribution. Safe to include in commercial or proprietary projects without licensing obligations.

Quickstart

pip install mypy-boto3-guardduty

from boto3.session import Session
from mypy_boto3_guardduty import GuardDutyClient

client: GuardDutyClient = Session().client("guardduty")
# Type checking and IDE autocompletion now work on client methods

Requires Python 3.9 or later; boto3 itself must be installed separately for runtime use.

Verify before relying

• Whether the package works with all boto3 versions or only 1.43.54 and nearby releases.
• Performance impact on PyCharm (documentation mentions potential slowness with Literal overloads).
• Whether paginators and waiters are fully typed or only partially covered.

Package facts

Evidence: mypy_boto3_guardduty-1.43.54-py3-none-any.whl

Keywords: boto3, guardduty, boto3-stubs, type-annotations, mypy, typeshed, autocomplete

Tags

More Software Development packages