Metadata-Version: 2.4
Name: python-socketio-stubs
Version: 5.16.1.0.20260211
Summary: python-socketio stubs
Project-URL: Repository, https://github.com/phi-friday/python-socketio-stubs
Author-email: phi <phi.friday@gmail.com>
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Typing :: Stubs Only
Requires-Python: >=3.11
Requires-Dist: python-socketio==5.16.1
Requires-Dist: typing-extensions>=4.4.0
Provides-Extra: mypy
Requires-Dist: mypy>=1.19.1; extra == 'mypy'
Provides-Extra: mypy-strict
Requires-Dist: mypy==1.19.1; extra == 'mypy-strict'
Requires-Dist: mypy>=1.19.1; extra == 'mypy-strict'
Description-Content-Type: text/markdown

# python-socketio-stubs

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![PyPI version](https://badge.fury.io/py/python-socketio-stubs.svg)](https://badge.fury.io/py/python-socketio-stubs)
[![python version](https://img.shields.io/pypi/pyversions/python-socketio-stubs.svg)](#)

Type stubs for the [python-socketio](https://github.com/miguelgrinberg/python-socketio) library.

> [!NOTE]  
> This package provides type hints only and contains no runtime code.  
> For the actual runtime implementation, install [`python-socketio`](https://github.com/miguelgrinberg/python-socketio).

## Installation

```shell
pip install python-socketio-stubs
```

## Usage

Once installed, type checkers will automatically discover and use these stubs when analyzing code that uses `python-socketio`:

```python
from typing import Any, assert_type

import socketio

# Your type checker will now understand python-socketio's types
sio = socketio.Server()

@sio.event
def connect(sid: str, environ: dict[str, Any], auth: dict[str, Any] | None) -> None:
    session = sio.get_session(sid)
    assert_type(session, dict[str, Any])
```

## License

MIT - see [LICENSE](https://github.com/phi-friday/python-socketio-stubs/blob/main/LICENSE) for details.
