Metadata-Version: 2.4
Name: little-a2s
Version: 0.2.1
Summary: A synchronous and sans-I/O library implementing the A2S Valve Source Query protocol.
Author: thegamecracks
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
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 :: SQL
Classifier: Topic :: Internet
Classifier: Topic :: System :: Networking
Classifier: Typing :: Typed
Requires-Python: >=3.11
Project-URL: Documentation, https://little-a2s.rtfd.io/
Project-URL: GitHub, https://github.com/thegamecracks/little-a2s
Project-URL: Homepage, https://little-a2s.rtfd.io/
Project-URL: Issues, https://github.com/thegamecracks/little-a2s/issues
Description-Content-Type: text/markdown

# little-a2s

[![](https://img.shields.io/pypi/v/little-a2s?style=flat-square&logo=pypi)](https://pypi.org/project/little-a2s/)
[![](https://readthedocs.org/projects/little-a2s/badge/?style=flat-square)](http://little-a2s.readthedocs.io/)
[![](https://img.shields.io/github/actions/workflow/status/thegamecracks/little-a2s/publish.yml?style=flat-square&logo=uv&label=build)](https://docs.astral.sh/uv/)
[![](https://img.shields.io/github/actions/workflow/status/thegamecracks/little-a2s/pytest.yml?style=flat-square&logo=pytest&label=tests)](https://docs.pytest.org/)
[![](https://img.shields.io/github/actions/workflow/status/thegamecracks/little-a2s/pyright-lint.yml?style=flat-square&label=pyright)](https://microsoft.github.io/pyright/#/)
[![](https://img.shields.io/github/actions/workflow/status/thegamecracks/little-a2s/ruff-check.yml?style=flat-square&logo=ruff&label=lints)](https://docs.astral.sh/ruff/)
[![](https://img.shields.io/github/actions/workflow/status/thegamecracks/little-a2s/ruff-format.yml?style=flat-square&logo=ruff&label=style)](https://docs.astral.sh/ruff/)

A synchronous and sans-I/O library implementing the A2S Valve Source Query protocol.

```py
from little_a2s import A2S

with A2S.from_addr("example.com", 27015, timeout=1) as a2s:
    print(a2s.info())
    print(a2s.players())
    print(a2s.rules())
```

## Installation

This project requires Python 3.11 or newer.

```sh
$ python3 -m venv
$ .venv/bin/activate
(.venv) $ pip install little-a2s
```

## Usage

For now, see the [examples] directory for basic usage or the [documentation]
for a complete API reference.

[examples]: https://github.com/thegamecracks/little-a2s/tree/main/examples
[documentation]: https://little-a2s.rtfd.io/

## License

This project is written under the [MIT License].

[MIT License]: /LICENSE
