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,43 @@ 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"]
+                nats-server-version: ["latest"]
+                project: ["nats-server"]
+        steps:
+            - name: Checkout repository
+              uses: actions/checkout@v2
+
+            - name: Set up Go
+              uses: actions/setup-go@v2
+              with:
+                  go-version: "1.23.4"
+
+            - 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@v2
+              with:
+                  python-version: ${{ matrix.python-version }}
+
+            - name: Install hatch
+              run: |
+                  python -m pip install --upgrade pip
+                  pip install hatch
+
+            - name: Run tests for ${{ matrix.project }}
+              run: hatch test -v
+              working-directory: ${{ matrix.project }}

nats-server/README.md

@@ -0,0 +1,42 @@
+# NATS Server for Python
+
+Manage NATS server instances from python.
+
+## Features
+
+- Asynchronous server control
+
+## Installation
+
+```bash
+pip install nats-server
+```
+
+Requires Python 3.8+ 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...
+
+    # Clean shutdown
+    await server.shutdown()
+
+asyncio.run(main())
+```
+
+## License
+
+MIT
+
+## Contributing
+
+Contributions welcome. Submit a Pull Request on GitHub.

nats-server/pyproject.toml

@@ -0,0 +1,58 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[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.8"
+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.8",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: Implementation :: CPython",
+  "Programming Language :: Python :: Implementation :: PyPy",
+]
+dependencies = [
+"typing-extensions>=4.0"
+]
+
+[project.urls]
+Documentation = "https://github.com/caspervonb/nats.py"
+Issues = "https://github.com/caspervonb/nats.py/issues"
+Source = "https://github.com/caspervonb/nats.py"
+
+[tool.hatch.metadata]
+allow-direct-references = true
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/nats"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+  "/src",
+  "/tests",
+]
+
+[tool.hatch.envs.hatch-test]
+extra-dependencies = [
+  "pytest-asyncio>=0.21.0",
+]
+
+[tool.pytest.ini_options]
+asyncio_default_fixture_loop_scope = "function"
+asyncio_mode = "auto"
+
+[tool.ruff.lint]
+ignore = ["TRY301", "S104"]