styly-mdm 0.2.1__tar.gz

styly_mdm-0.2.1/PKG-INFO

@@ -0,0 +1,71 @@
+Metadata-Version: 2.4
+Name: styly-mdm
+Version: 0.2.1
+Summary: Lightweight MDM control server for LBE VR headsets (PICO), with a web console and LAN discovery.
+Author: STYLY, Inc.
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/styly-dev/STYLY-MDM
+Project-URL: Repository, https://github.com/styly-dev/STYLY-MDM
+Project-URL: Issues, https://github.com/styly-dev/STYLY-MDM/issues
+Keywords: mdm,vr,pico,lbe,device-management,aiohttp
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Framework :: aiohttp
+Classifier: Intended Audience :: System Administrators
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: aiohttp<4,>=3.9
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+
+# styly-mdm
+
+The control server for **STYLY-MDM** — a lightweight Mobile Device Management
+system for Location Based Experience (LBE) VR headsets. It bridges PICO VR HMDs
+and a browser-based admin console, letting you launch apps and install APKs on
+many headsets at once over the LAN.
+
+> STYLY-MDM is designed for use within a local area network (LAN). It has no
+> authentication. **Do not expose the server to the public internet.**
+
+## Install & run
+
+Run without cloning the repository:
+
+```bash
+# One-off, no install (recommended):
+uvx styly-mdm
+
+# Or install, then run:
+pip install styly-mdm
+styly-mdm
+```
+
+The server starts on port **7070** and prints its LAN IP addresses. Open
+`http://<server-ip>:7070` in a browser for the web console. Devices on the LAN
+discover the server automatically via UDP broadcast (port **7071**).
+
+## Configuration
+
+| Option | Env var | Flag | Default |
+|--------|---------|------|---------|
+| HTTP/WebSocket port | `MDM_WS_PORT` | `--port` | `7070` |
+| UDP discovery port | `MDM_DISCOVERY_PORT` | — | `7071` |
+| Data directory (uploaded APKs + device registry) | `MDM_DATA_DIR` | `--data-dir` | current directory |
+
+Uploaded APKs are written to `<data-dir>/apks/` and the persistent device
+registry to `<data-dir>/device_registry.json`.
+
+You can also start it as a module: `python -m styly_mdm`.
+
+## Documentation
+
+Full documentation, protocol references, and the Android MDM client live in the
+project repository: <https://github.com/styly-dev/STYLY-MDM>.

styly_mdm-0.2.1/README.md

@@ -0,0 +1,44 @@
+# styly-mdm
+
+The control server for **STYLY-MDM** — a lightweight Mobile Device Management
+system for Location Based Experience (LBE) VR headsets. It bridges PICO VR HMDs
+and a browser-based admin console, letting you launch apps and install APKs on
+many headsets at once over the LAN.
+
+> STYLY-MDM is designed for use within a local area network (LAN). It has no
+> authentication. **Do not expose the server to the public internet.**
+
+## Install & run
+
+Run without cloning the repository:
+
+```bash
+# One-off, no install (recommended):
+uvx styly-mdm
+
+# Or install, then run:
+pip install styly-mdm
+styly-mdm
+```
+
+The server starts on port **7070** and prints its LAN IP addresses. Open
+`http://<server-ip>:7070` in a browser for the web console. Devices on the LAN
+discover the server automatically via UDP broadcast (port **7071**).
+
+## Configuration
+
+| Option | Env var | Flag | Default |
+|--------|---------|------|---------|
+| HTTP/WebSocket port | `MDM_WS_PORT` | `--port` | `7070` |
+| UDP discovery port | `MDM_DISCOVERY_PORT` | — | `7071` |
+| Data directory (uploaded APKs + device registry) | `MDM_DATA_DIR` | `--data-dir` | current directory |
+
+Uploaded APKs are written to `<data-dir>/apks/` and the persistent device
+registry to `<data-dir>/device_registry.json`.
+
+You can also start it as a module: `python -m styly_mdm`.
+
+## Documentation
+
+Full documentation, protocol references, and the Android MDM client live in the
+project repository: <https://github.com/styly-dev/STYLY-MDM>.

styly_mdm-0.2.1/pyproject.toml

@@ -0,0 +1,58 @@
+[build-system]
+requires = ["setuptools>=77", "setuptools-scm>=8"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "styly-mdm"
+dynamic = ["version"]
+description = "Lightweight MDM control server for LBE VR headsets (PICO), with a web console and LAN discovery."
+readme = "README.md"
+requires-python = ">=3.10"
+# SPDX expression (PEP 639). The full license text lives at the repo root
+# (../LICENSE); it is not bundled here because license-files cannot reference a
+# path outside the package project directory.
+license = "Apache-2.0"
+authors = [{ name = "STYLY, Inc." }]
+keywords = ["mdm", "vr", "pico", "lbe", "device-management", "aiohttp"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Web Environment",
+    "Framework :: aiohttp",
+    "Intended Audience :: System Administrators",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: System :: Systems Administration",
+]
+dependencies = ["aiohttp>=3.9,<4"]
+
+[project.optional-dependencies]
+dev = ["pytest>=7"]
+
+[project.urls]
+Homepage = "https://github.com/styly-dev/STYLY-MDM"
+Repository = "https://github.com/styly-dev/STYLY-MDM"
+Issues = "https://github.com/styly-dev/STYLY-MDM/issues"
+
+[project.scripts]
+styly-mdm = "styly_mdm.server:main"
+
+[tool.setuptools]
+packages = ["styly_mdm"]
+
+[tool.setuptools.package-data]
+styly_mdm = ["static/*"]
+
+# Version is derived from git tags (vX.Y.Z) — single source of truth shared with
+# the APK release flow. The git root is the repo root, one level up from this
+# pyproject.toml. In CI the version is injected via
+# SETUPTOOLS_SCM_PRETEND_VERSION_FOR_STYLY_MDM so a shallow checkout needs no tags.
+[tool.setuptools_scm]
+root = ".."
+fallback_version = "0.0.0"
+# Drop the "+g<hash>" local segment: PEP 440 local versions are rejected on
+# upload, so this keeps non-tagged (Test PyPI dry-run) builds publishable.
+local_scheme = "no-local-version"

styly_mdm-0.2.1/run.sh

@@ -0,0 +1,39 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+cd "$SCRIPT_DIR"
+
+# --- helpers ----------------------------------------------------------------
+info()  { printf '\033[1;34m[INFO]\033[0m  %s\n' "$1"; }
+error() { printf '\033[1;31m[ERROR]\033[0m %s\n' "$1" >&2; exit 1; }
+
+# --- prerequisite checks ----------------------------------------------------
+command -v python >/dev/null 2>&1 || error "python not found. Please install Python 3.10+."
+
+# --- environment ------------------------------------------------------------
+# Usage: ./run.sh [prod|dev]   (default: prod)
+# Dev uses separate discovery/WebSocket ports so a dev server can run on the same
+# LAN as production without the two stealing each other's clients. Keep these in
+# sync with the client's dev flavor in mdm-client/app/build.gradle (DISCOVERY_PORT,
+# DEFAULT_WS_PORT).
+ENVIRONMENT="${1:-prod}"
+
+case "$ENVIRONMENT" in
+    prod)
+        # The server falls back to the production ports (7071 / 7070) when unset.
+        ;;
+    dev)
+        export MDM_DISCOVERY_PORT=7081
+        export MDM_WS_PORT=7080
+        ;;
+    *)
+        error "Unknown environment: $ENVIRONMENT (specify prod or dev)"
+        ;;
+esac
+
+# --- run --------------------------------------------------------------------
+# CWD is SCRIPT_DIR (mdm-server/), so the default data directory (apks/,
+# device_registry.json) stays under mdm-server/ as before.
+info "Starting STYLY-MDM server (${ENVIRONMENT}) ..."
+exec python -m styly_mdm

styly_mdm-0.2.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

styly_mdm-0.2.1/styly_mdm/__init__.py

@@ -0,0 +1,18 @@
+"""STYLY-MDM control server package.
+
+Exposes the aiohttp application factory and the console entrypoint. The server is
+started with the ``styly-mdm`` console script (or ``python -m styly_mdm``); it is
+not an ASGI app, because the LAN UDP discovery responder is started in the same
+asyncio loop as the HTTP server (see server.run_server).
+"""
+
+from importlib.metadata import PackageNotFoundError, version
+
+from .server import create_app, main, run_server
+
+try:
+    __version__ = version("styly-mdm")
+except PackageNotFoundError:  # running from a source tree that isn't installed
+    __version__ = "0.0.0"
+
+__all__ = ["create_app", "main", "run_server", "__version__"]

styly_mdm-0.2.1/styly_mdm/__main__.py

@@ -0,0 +1,6 @@
+"""Enable ``python -m styly_mdm`` to start the control server."""
+
+from .server import main
+
+if __name__ == "__main__":
+    main()