types-PySocks

What it is and what it does

types-pysocks is a type stub package that bridges the gap between the PySocks SOCKS proxy library and static type checkers. It provides type annotations for PySocks so that tools like mypy and pyright can understand and validate how you're using the library in your code, catching type errors before runtime.

The stubs are generated and maintained as part of the typeshed project, which is the canonical repository for type information for the Python standard library and popular third-party packages. This package is a thin distribution layer that makes those stubs available via pip. It has no runtime dependencies and is designed purely to support development-time type checking.

Use it for:

• Enable mypy or pyright to type-check code that imports and uses PySocks for SOCKS proxy connections
• Catch type mismatches in proxy configuration or socket operations before running code
• Integrate PySocks into a typed Python project without disabling type checking for that module
• Validate correct usage of PySocks API when refactoring or adding new proxy functionality

Worth the install?

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

Provides type stubs for PySocks, enabling static type checkers like mypy and pyright to validate code using the PySocks SOCKS proxy library.

Yes, if you use PySocks and want static type checking. Install it alongside your type checker (mypy or pyright) to get accurate type validation for PySocks code. It has no runtime cost and is actively maintained. If you don't use a type checker or don't use PySocks, there's no reason to install it.

Install

types-pysocks on PyPI

pip install types-pysocks

uv add types-pysocks

poetry add types-pysocks

Installing types-PySocks

Before you install

Low friction installation with no runtime dependencies. Actively maintained as part of typeshed, with recent releases and no known vulnerabilities.

License in practice

Apache-2.0 permissive license allows use in most projects without restriction.

Quickstart

pip install types-pysocks

# Then use with your type checker in your project
# mypy or pyright will automatically discover the stubs when checking code that imports PySocks

Requires Python 3.10 or later. Stubs are only useful when used alongside a type checker (mypy 2.1.0, pyright 1.1.409, or compatible).

Verify before relying

• Whether stubs remain accurate for PySocks versions other than 1.7.1
• Compatibility with type checkers beyond mypy 2.1.0 and pyright 1.1.409

Package facts

Evidence: types_pysocks-1.7.1.20260518-py3-none-any.whl

Tags

More Software Development packages