Add nats-server package

Signed-off-by: Casper Beyer <[email protected]>

Author: caspervonb

.github/workflows/test.yml

@@ -9,7 +9,7 @@ on:
             - "**"
 
 jobs:
-    test:
+    nats:
         runs-on: ubuntu-latest
         timeout-minutes: 20
         env:
@@ -42,6 +42,45 @@ jobs:
             - name: Run tests
               run: |
                   pipenv run flake8 --ignore="W391, W503, W504" ./nats/js/
-                  pipenv run pytest -x -vv -s --continue-on-collection-errors
+                  pipenv run pytest -x -vv -s --continue-on-collection-errors ./tests
               env:
                   PATH: $HOME/nats-server:$PATH
+
+    project:
+        name: ${{ matrix.project }} (python-${{ matrix.python-version }}, nats-server-${{ matrix.nats-server-version }}, ${{ matrix.os }})
+        runs-on: ${{ matrix.os }}
+        strategy:
+            matrix:
+                python-version: ["3.11", "3.12", "3.13"]
+                os: ["ubuntu-latest", "macos-latest", "windows-latest"]
+                nats-server-version: ["latest"]
+                project: ["nats-server"]
+        steps:
+            - name: Checkout repository
+              uses: actions/checkout@v5
+
+            - name: Set up Go
+              uses: actions/setup-go@v6
+              with:
+                  go-version: "stable"
+
+            - name: Install NATS Server
+              run: |
+                  go install github.com/nats-io/nats-server/v2@${{ matrix.nats-server-version }}
+              shell: bash
+
+            - name: Set up Python ${{ matrix.python-version }}
+              uses: actions/setup-python@v6
+              with:
+                  python-version: ${{ matrix.python-version }}
+
+            - name: Install uv
+              uses: astral-sh/setup-uv@v6
+
+            - name: Install dependencies
+              run: uv sync --dev
+              working-directory: ${{ matrix.project }}
+
+            - name: Run tests for ${{ matrix.project }}
+              run: uv run pytest -v -n auto
+              working-directory: ${{ matrix.project }}

nats-server/.DS_Store

@@ -0,0 +1,43 @@
+# 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.

nats-server/README.md

@@ -0,0 +1,48 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "nats-server"
+version = "0.0.0"
+description = 'Python library for managing NATS servers for development and testing'
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+keywords = ["nats", "messaging", "testing"]
+authors = [
+  { name = "Casper Beyer", email = "[email protected]" },
+]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Programming Language :: Python",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: Implementation :: CPython",
+  "Programming Language :: Python :: Implementation :: PyPy",
+]
+dependencies = []
+
+[project.urls]
+Documentation = "https://github.com/nats-io/nats.py"
+Issues = "https://github.com/nats-io/nats.py/issues"
+Source = "https://github.com/nats-io/nats.py"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.uv]
+dev-dependencies = [
+  "pytest>=7.0.0",
+  "pytest-asyncio>=0.21.0",
+  "pytest-cov>=7.0.0",
+  "pytest-xdist>=3.0.0",
+]
+
+[tool.pytest.ini_options]
+asyncio_default_fixture_loop_scope = "function"
+asyncio_mode = "auto"
+
+[tool.ruff.lint]
+ignore = ["TRY301", "S104"]