types-appdirs

What it is and what it does

types-appdirs is a PEP 561 type stub package that adds static type information to the appdirs library. It allows type checkers like mypy, pyright, and pytype to understand and validate code that uses appdirs, catching type errors at development time rather than runtime.

The package is generated from typeshed and serves as a bridge for projects still using appdirs. However, the description explicitly states the package is unmaintained and won't be updated. The appdirs library itself has been deprecated in favor of platformdirs, which includes native type support via a py.typed file, making this stub package unnecessary for new projects.

Use it for:

• Enable type checking in legacy codebases that still depend on appdirs without migrating to platformdirs.
• Satisfy type checker requirements in projects using appdirs while maintaining compatibility with existing code.
• Provide IDE autocomplete and type hints for appdirs calls in editors like PyCharm and VS Code.

Worth the install?

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

Provides type stubs for the appdirs package to enable static type checking with mypy, pyright, pytype, and similar tools.

No, unless you are maintaining legacy code that uses appdirs and cannot migrate to platformdirs. The package is unmaintained and will not receive updates. New projects should use platformdirs directly, which provides native type support without requiring a separate stub package.

Install

types-appdirs on PyPI

pip install types-appdirs

uv add types-appdirs

poetry add types-appdirs

Installing types-appdirs

Before you install

Low install friction with no runtime dependencies. However, the package is unmaintained and won't be updated; the description explicitly recommends migrating to platformdirs instead, which ships with native type support.

License in practice

Apache-2.0 license is permissive and poses no restrictions on use, modification, or distribution in most contexts.

Quickstart

pip install types-appdirs

# Then use appdirs in your code; type checkers will now understand its types
import appdirs
config_dir = appdirs.user_config_dir('myapp')

Requires appdirs to be installed separately; this package only provides type information for it.

Verify before relying

• Whether type coverage is complete for all appdirs APIs or if gaps remain.
• Compatibility with the latest versions of mypy, pyright, and other type checkers.

Package facts

Evidence: types_appdirs-1.4.3.5-py3-none-any.whl

Tags

More Software Development packages