Create releasable version

.github/FUNDING.yml

@@ -0,0 +1 @@
+github: Grub4K

.github/workflows/checks.yml

@@ -0,0 +1,23 @@
+name: Checks
+on:
+  push:
+    branches:
+    - main
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  check:
+    name: Code check
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    - uses: actions/setup-python@v5
+      with:
+        python-version: '3.10'
+    - name: Install hatch
+      run: pip install hatch
+    - name: Run check
+      run: hatch fmt --check

.github/workflows/release.yml

@@ -0,0 +1,39 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - '*'
+
+permissions:
+  contents: read
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      # trusted publishing
+      id-token: write
+      # creating a release
+      contents: write
+
+    steps:
+    - uses: actions/checkout@v4
+    - uses: actions/setup-python@v5
+      with:
+        python-version: '3.10'
+    - name: Install hatch
+      run: pip install hatch
+
+    - name: Build package
+      run: hatch build
+
+    - name: Create release
+      env:
+        GH_TOKEN: ${{ github.token }}
+        tag: ${{ github.ref_name }}
+      run: |
+        gh release create --notes-from-tag "${tag}" dist/*
+
+    - name: Publish to PyPI
+      uses: pypa/[email protected]

.gitignore

@@ -1 +1,3 @@
 *.pyc
+/dist/
+/vrcar/_version.py

README.md

@@ -1,5 +1,23 @@
 # vrcar
 VR controlled Raspberry Pi car
 
+Initially developed using the [Freenove 4WD](<https://store.freenove.com/products/fnk0043>), a [Raspberry Pi 4 Model B 4GB](<https://www.raspberrypi.com/products/raspberry-pi-4-model-b/?variant=raspberry-pi-4-model-b-4gb>) and a [Meta Quest 3](<https://www.meta.com/de/en/quest/quest-3>)
+
+## Usage
+The client is easiest installed using [`pipx`](<https://pipx.pypa.io/>):
+
+```shell
+pipx install "vrcar[pygame,vr]"
+```
+
+These are what the available groups will be able to load:
+- `pygame`
+	- Window with the camera video feed
+	- Keyboard controls
+	- Joystick controls
+- `vr`
+	- Camera video feed in the headset
+	- Headset rotation controls camera rotation
+
 ## License
-`vrcar` is distributed under the terms of the [MIT](https://spdx.org/licenses/MIT.html) license.
+`vrcar` is distributed under the terms of the [MIT](<https://spdx.org/licenses/MIT.html>) license.

pyproject.toml

@@ -1,5 +1,5 @@
 [build-system]
-requires = ["hatchling"]
+requires = ["hatchling", "hatch-vcs"]
 build-backend = "hatchling.build"
 
 [project]
@@ -34,9 +34,6 @@ vr = [
   # "PyOpenGL-accelerate",
   "Pillow",
 ]
-server = [
-  # TODO
-]
 
 [project.scripts]
 vrcar = "vrcar.__main__:main"
@@ -47,7 +44,10 @@ Issues = "https://github.com/Grub4K/vrcar/issues"
 Source = "https://github.com/Grub4K/vrcar"
 
 [tool.hatch.version]
-path = "vrcar/__init__.py"
+source = "vcs"
+
+[tool.hatch.build.hooks.vcs]
+version-file = "vrcar/_version.py"
 
 [tool.hatch.envs.default]
 path = ".venv"
@@ -62,18 +62,6 @@ init = "pre-commit install -c pre-commit.yml"
 deinit = "pre-commit uninstall"
 vrcar = "python -m vrcar {args}"
 
-[tool.hatch.envs.testing]
-installer = "uv"
-features = ["testing"]
-
-[tool.hatch.envs.testing.scripts]
-testing = "python -m vrcar.client.provider.testing"
-
-[tool.hatch.envs.server]
-detached = true
-installer = "uv"
-features = ["server"]
-
 [tool.hatch.envs.hatch-static-analysis]
 dependencies = ["ruff==0.4.*"]
 config-path = "pyproject.toml"

vrcar/__init__.py

@@ -1,4 +1,5 @@
 from __future__ import annotations
 
-__version__ = "0.1.0"
-version_tuple = tuple(map(int, __version__.split(".")))
+from vrcar._version import __version__, __version_tuple__
+
+__all__ = ["__version__", "__version_tuple__"]

vrcar/__main__.py

@@ -60,9 +60,16 @@ def parse_args():
 
 
 def main():
+    import logging
+
+    import vrcar
     import vrcar.log
 
+    logger = logging.getLogger(vrcar.__name__)
+
     vrcar.log.setup(name_length=30, debug=True)
+    logger.info(f"{vrcar.__name__} v{vrcar.__version__}")
+
     args = parse_args()
 
     if args.mode == "server":

vrcar/client/provider/openxr.py → vrcar/client/provider/openxr/__init__.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import importlib.resources
 import importlib.util
 import logging
 import threading
@@ -23,6 +24,7 @@
     import io
 
 logger = logging.getLogger(__name__)
+resources = importlib.resources.files()
 
 
 class OpenXRProvider:
@@ -36,8 +38,8 @@ def __init__(self):
         self._context = xr.ContextObject(
             instance_create_info=xr.InstanceCreateInfo(
                 application_info=xr.ApplicationInfo(
-                    application_name="vrcar",
-                    application_version=xr.Version(*vrcar.version_tuple),
+                    application_name=vrcar.__name__,
+                    application_version=xr.Version(*vrcar.__version_tuple__),
                 ),
                 enabled_extension_names=[
                     xr.KHR_OPENGL_ENABLE_EXTENSION_NAME,
@@ -59,11 +61,8 @@ def __enter__(self):
 
         self._texture = GL.glGenTextures(1)
 
-        with open("shader/plane.vert") as file:
-            vertex_shader_data = file.read()
-
-        with open("shader/plane.frag") as file:
-            fragment_shader_data = file.read()
+        vertex_shader_data = resources.joinpath("plane.vert").read_text()
+        fragment_shader_data = resources.joinpath("plane.frag").read_text()
 
         try:
             vertex_shader = shaders.compileShader(

vrcar/log.py

@@ -9,25 +9,25 @@
 
 class PrettyFormatter(logging.Formatter):
     LOG_FORMAT = (
-        "{record.asctime}"
+        "{record.asctime}.{record.msecs:03}"
         " | {record.levelname:<8}"
         " | {record.name:<{name_length}}"
         " | {record.message}"
     )
     LOG_FORMAT_COLOR = (
-        "\x1b[30;1m{record.asctime}\x1b[0m"
+        "\x1b[32;1m{record.asctime}.{record.msecs:03}\x1b[0m"
         " | {level_color}{record.levelname:<8}\x1b[0m"
         " | \x1b[35m{record.name:<{name_length}}\x1b[0m"
         " | {record.message}"
     )
     EXC_FORMAT = "{record.exc_text}"
     EXC_FORMAT_COLOR = "\x1b[31m{record.exc_text}\x1b[0m"
     LEVEL_COLORS: Mapping[int, str] = {
-        logging.DEBUG: "\x1b[96;1m",
+        logging.DEBUG: "\x1b[36;1m",
         logging.INFO: "\x1b[34;1m",
         logging.WARNING: "\x1b[33;1m",
-        logging.ERROR: "\x1b[31m",
-        logging.CRITICAL: "\x1b[41m",
+        logging.ERROR: "\x1b[31m;1",
+        logging.CRITICAL: "\x1b[41m;1",
     }
 
     def __init__(
@@ -41,7 +41,7 @@ def __init__(
         self._exc_format = self.EXC_FORMAT_COLOR if use_color else self.EXC_FORMAT
         # HACK: preformat name length so we don't have to store it for later
         self._log_format = self._log_format.replace("{name_length}", str(name_length))
-        super().__init__(self._log_format, style="{")
+        super().__init__(self._log_format, style="{", datefmt="%Y-%m-%d %H:%M:%s")
 
     def format(self, /, record: logging.LogRecord) -> str:
         record.asctime = self.formatTime(record, self.datefmt)