Metadata-Version: 2.4
Name: nats-server
Version: 0.0.0
Summary: Python library for managing NATS servers for development and testing
Author-email: Casper Beyer <casper@synadia.com>
License-Expression: MIT
Project-URL: Documentation, https://github.com/nats-io/nats.py
Project-URL: Issues, https://github.com/nats-io/nats.py/issues
Project-URL: Source, https://github.com/nats-io/nats.py
Keywords: nats,messaging,testing
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Private :: Do Not Upload
Requires-Python: >=3.11
Description-Content-Type: text/markdown

# NATS Server for Python

Manage NATS server instances from python.

## Features

- Asynchronous server control

## Installation

```bash
pip install nats-server
```

Requires Python 3.11+ and the NATS server binary in your PATH.

## Usage

```python
import asyncio
import nats.server

async def main():
    # Start server with auto port assignment
    server = await nats.server.run(port=0, jetstream=True)
    print(f"Server running on {server.host}:{server.port}")

    # Do something with the server...
    # e.g connect with server.client_url

    # Clean shutdown
    await server.shutdown()

asyncio.run(main())
```

## License

MIT

## Contributing

Contributions welcome. Submit a Pull Request on GitHub.
