cpu-loader 0.5.7__tar.gz → 0.5.9__tar.gz

{cpu_loader-0.5.7/src/cpu_loader.egg-info → cpu_loader-0.5.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cpu-loader
-Version: 0.5.7
+Version: 0.5.9
 Summary: A tool to generate CPU load on a system with runtime configuration through a WebUI and REST API
 Author-email: the78mole <the78mole@users.noreply.github.com>
 License-Expression: MIT
@@ -25,7 +25,7 @@ Classifier: Topic :: System :: Monitoring
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: fastapi==0.122.0
+Requires-Dist: fastapi==0.124.0
 Requires-Dist: uvicorn[standard]==0.38.0
 Requires-Dist: pydantic==2.12.5
 Requires-Dist: requests==2.32.5
@@ -93,7 +93,22 @@ A tool to generate CPU load on a system with runtime configuration through a Web
 
 ## Installation
 
-### From Pre-built Wheels (Recommended)
+### Using uv tool (Recommended for CLI usage)
+
+For users who want the `cpu-loader` command available system-wide, use `uv tool install`:
+
+```bash
+uv tool install cpu-loader
+```
+
+This installs cpu-loader as a standalone tool that can be run from anywhere:
+
+```bash
+cpu-loader --help
+cpu-loader --host 0.0.0.0 --port 8000
+```
+
+### From Pre-built Wheels
 
 Pre-compiled wheels are available for Linux (x86_64, ARM64) and macOS (x86_64, ARM64):
 
@@ -381,6 +396,134 @@ The demo script:
 - Provides performance comparisons between algorithms
 - Shows timing accuracy for each computation method
 
+## Running as a Systemd Service
+
+You can run CPU Loader as a systemd service to start automatically on boot and run in the background.
+
+### Create Systemd Service File
+
+Create `/etc/systemd/system/cpu-loader.service`:
+
+```ini
+[Unit]
+Description=CPU Loader Service
+After=network.target
+
+[Service]
+Type=simple
+User=your-username
+WorkingDirectory=/home/your-username
+ExecStart=/home/your-username/.local/bin/cpu-loader --host 0.0.0.0 --port 8000
+Restart=on-failure
+RestartSec=5
+
+# Optional: Set environment variables for MQTT
+#Environment="MQTT_BROKER_HOST=mqtt.example.com"
+#Environment="MQTT_BROKER_PORT=1883"
+#Environment="MQTT_USERNAME=myuser"
+#Environment="MQTT_PASSWORD=mypassword"
+#Environment="MQTT_TOPIC_PREFIX=cpu-loader"
+#Environment="MQTT_CLIENT_ID=cpu-loader-001"
+
+# Optional: Disable temperature monitoring
+#Environment="DISABLE_TEMPERATURE=1"
+
+[Install]
+WantedBy=multi-user.target
+```
+
+**Important:** Replace `your-username` with your actual username, and adjust the `ExecStart` path to point to where `cpu-loader` is installed:
+- If installed with `uv tool install`: Usually `~/.local/bin/cpu-loader`
+- If installed with `pip install --user`: Usually `~/.local/bin/cpu-loader`
+- If installed system-wide: Usually `/usr/local/bin/cpu-loader`
+
+### Enable and Start the Service
+
+```bash
+# Reload systemd to recognize the new service
+sudo systemctl daemon-reload
+
+# Enable the service to start on boot
+sudo systemctl enable cpu-loader
+
+# Start the service now
+sudo systemctl start cpu-loader
+
+# Check service status
+sudo systemctl status cpu-loader
+
+# View service logs
+sudo journalctl -u cpu-loader -f
+```
+
+### Manage the Service
+
+```bash
+# Stop the service
+sudo systemctl stop cpu-loader
+
+# Restart the service
+sudo systemctl restart cpu-loader
+
+# Disable auto-start on boot
+sudo systemctl disable cpu-loader
+```
+
+### Example Service Configurations
+
+**Basic Service (no MQTT):**
+```ini
+[Unit]
+Description=CPU Loader Service
+After=network.target
+
+[Service]
+Type=simple
+User=cpuloader
+ExecStart=/home/cpuloader/.local/bin/cpu-loader --host 0.0.0.0 --port 8000
+Restart=on-failure
+
+[Install]
+WantedBy=multi-user.target
+```
+
+**Service with MQTT Integration:**
+```ini
+[Unit]
+Description=CPU Loader Service with MQTT
+After=network.target
+
+[Service]
+Type=simple
+User=cpuloader
+ExecStart=/home/cpuloader/.local/bin/cpu-loader --host 0.0.0.0 --port 8000
+Environment="MQTT_BROKER_HOST=192.168.1.100"
+Environment="MQTT_BROKER_PORT=1883"
+Environment="MQTT_USERNAME=cpuloader"
+Environment="MQTT_PASSWORD=secretpassword"
+Environment="MQTT_TOPIC_PREFIX=home/sensors/cpu-loader"
+Restart=on-failure
+
+[Install]
+WantedBy=multi-user.target
+```
+
+**Service with Custom Computation Type:**
+```ini
+[Unit]
+Description=CPU Loader Service (Matrix Computation)
+After=network.target
+
+[Service]
+Type=simple
+User=cpuloader
+ExecStart=/home/cpuloader/.local/bin/cpu-loader --host 0.0.0.0 --port 8080 --computation-type matrix
+Restart=on-failure
+
+[Install]
+WantedBy=multi-user.target
+```
+
 ## Architecture
 
 - **src/cpu_loader_core.c**: High-performance C implementation using pthreads for CPU load generation

{cpu_loader-0.5.7 → cpu_loader-0.5.9}/README.md

@@ -57,7 +57,22 @@ A tool to generate CPU load on a system with runtime configuration through a Web
 
 ## Installation
 
-### From Pre-built Wheels (Recommended)
+### Using uv tool (Recommended for CLI usage)
+
+For users who want the `cpu-loader` command available system-wide, use `uv tool install`:
+
+```bash
+uv tool install cpu-loader
+```
+
+This installs cpu-loader as a standalone tool that can be run from anywhere:
+
+```bash
+cpu-loader --help
+cpu-loader --host 0.0.0.0 --port 8000
+```
+
+### From Pre-built Wheels
 
 Pre-compiled wheels are available for Linux (x86_64, ARM64) and macOS (x86_64, ARM64):
 
@@ -345,6 +360,134 @@ The demo script:
 - Provides performance comparisons between algorithms
 - Shows timing accuracy for each computation method
 
+## Running as a Systemd Service
+
+You can run CPU Loader as a systemd service to start automatically on boot and run in the background.
+
+### Create Systemd Service File
+
+Create `/etc/systemd/system/cpu-loader.service`:
+
+```ini
+[Unit]
+Description=CPU Loader Service
+After=network.target
+
+[Service]
+Type=simple
+User=your-username
+WorkingDirectory=/home/your-username
+ExecStart=/home/your-username/.local/bin/cpu-loader --host 0.0.0.0 --port 8000
+Restart=on-failure
+RestartSec=5
+
+# Optional: Set environment variables for MQTT
+#Environment="MQTT_BROKER_HOST=mqtt.example.com"
+#Environment="MQTT_BROKER_PORT=1883"
+#Environment="MQTT_USERNAME=myuser"
+#Environment="MQTT_PASSWORD=mypassword"
+#Environment="MQTT_TOPIC_PREFIX=cpu-loader"
+#Environment="MQTT_CLIENT_ID=cpu-loader-001"
+
+# Optional: Disable temperature monitoring
+#Environment="DISABLE_TEMPERATURE=1"
+
+[Install]
+WantedBy=multi-user.target
+```
+
+**Important:** Replace `your-username` with your actual username, and adjust the `ExecStart` path to point to where `cpu-loader` is installed:
+- If installed with `uv tool install`: Usually `~/.local/bin/cpu-loader`
+- If installed with `pip install --user`: Usually `~/.local/bin/cpu-loader`
+- If installed system-wide: Usually `/usr/local/bin/cpu-loader`
+
+### Enable and Start the Service
+
+```bash
+# Reload systemd to recognize the new service
+sudo systemctl daemon-reload
+
+# Enable the service to start on boot
+sudo systemctl enable cpu-loader
+
+# Start the service now
+sudo systemctl start cpu-loader
+
+# Check service status
+sudo systemctl status cpu-loader
+
+# View service logs
+sudo journalctl -u cpu-loader -f
+```
+
+### Manage the Service
+
+```bash
+# Stop the service
+sudo systemctl stop cpu-loader
+
+# Restart the service
+sudo systemctl restart cpu-loader
+
+# Disable auto-start on boot
+sudo systemctl disable cpu-loader
+```
+
+### Example Service Configurations
+
+**Basic Service (no MQTT):**
+```ini
+[Unit]
+Description=CPU Loader Service
+After=network.target
+
+[Service]
+Type=simple
+User=cpuloader
+ExecStart=/home/cpuloader/.local/bin/cpu-loader --host 0.0.0.0 --port 8000
+Restart=on-failure
+
+[Install]
+WantedBy=multi-user.target
+```
+
+**Service with MQTT Integration:**
+```ini
+[Unit]
+Description=CPU Loader Service with MQTT
+After=network.target
+
+[Service]
+Type=simple
+User=cpuloader
+ExecStart=/home/cpuloader/.local/bin/cpu-loader --host 0.0.0.0 --port 8000
+Environment="MQTT_BROKER_HOST=192.168.1.100"
+Environment="MQTT_BROKER_PORT=1883"
+Environment="MQTT_USERNAME=cpuloader"
+Environment="MQTT_PASSWORD=secretpassword"
+Environment="MQTT_TOPIC_PREFIX=home/sensors/cpu-loader"
+Restart=on-failure
+
+[Install]
+WantedBy=multi-user.target
+```
+
+**Service with Custom Computation Type:**
+```ini
+[Unit]
+Description=CPU Loader Service (Matrix Computation)
+After=network.target
+
+[Service]
+Type=simple
+User=cpuloader
+ExecStart=/home/cpuloader/.local/bin/cpu-loader --host 0.0.0.0 --port 8080 --computation-type matrix
+Restart=on-failure
+
+[Install]
+WantedBy=multi-user.target
+```
+
 ## Architecture
 
 - **src/cpu_loader_core.c**: High-performance C implementation using pthreads for CPU load generation

{cpu_loader-0.5.7 → cpu_loader-0.5.9}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "cpu-loader"
-version = "0.5.7"
+version = "0.5.9"
 description = "A tool to generate CPU load on a system with runtime configuration through a WebUI and REST API"
 readme = "README.md"
 requires-python = ">=3.9"
@@ -25,7 +25,7 @@ classifiers = [
     "Topic :: System :: Monitoring",
 ]
 dependencies = [
-    "fastapi==0.122.0",
+    "fastapi==0.124.0",
     "uvicorn[standard]==0.38.0",
     "pydantic==2.12.5",
     "requests==2.32.5",

{cpu_loader-0.5.7 → cpu_loader-0.5.9/src/cpu_loader.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cpu-loader
-Version: 0.5.7
+Version: 0.5.9
 Summary: A tool to generate CPU load on a system with runtime configuration through a WebUI and REST API
 Author-email: the78mole <the78mole@users.noreply.github.com>
 License-Expression: MIT
@@ -25,7 +25,7 @@ Classifier: Topic :: System :: Monitoring
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: fastapi==0.122.0
+Requires-Dist: fastapi==0.124.0
 Requires-Dist: uvicorn[standard]==0.38.0
 Requires-Dist: pydantic==2.12.5
 Requires-Dist: requests==2.32.5
@@ -93,7 +93,22 @@ A tool to generate CPU load on a system with runtime configuration through a Web
 
 ## Installation
 
-### From Pre-built Wheels (Recommended)
+### Using uv tool (Recommended for CLI usage)
+
+For users who want the `cpu-loader` command available system-wide, use `uv tool install`:
+
+```bash
+uv tool install cpu-loader
+```
+
+This installs cpu-loader as a standalone tool that can be run from anywhere:
+
+```bash
+cpu-loader --help
+cpu-loader --host 0.0.0.0 --port 8000
+```
+
+### From Pre-built Wheels
 
 Pre-compiled wheels are available for Linux (x86_64, ARM64) and macOS (x86_64, ARM64):
 
@@ -381,6 +396,134 @@ The demo script:
 - Provides performance comparisons between algorithms
 - Shows timing accuracy for each computation method
 
+## Running as a Systemd Service
+
+You can run CPU Loader as a systemd service to start automatically on boot and run in the background.
+
+### Create Systemd Service File
+
+Create `/etc/systemd/system/cpu-loader.service`:
+
+```ini
+[Unit]
+Description=CPU Loader Service
+After=network.target
+
+[Service]
+Type=simple
+User=your-username
+WorkingDirectory=/home/your-username
+ExecStart=/home/your-username/.local/bin/cpu-loader --host 0.0.0.0 --port 8000
+Restart=on-failure
+RestartSec=5
+
+# Optional: Set environment variables for MQTT
+#Environment="MQTT_BROKER_HOST=mqtt.example.com"
+#Environment="MQTT_BROKER_PORT=1883"
+#Environment="MQTT_USERNAME=myuser"
+#Environment="MQTT_PASSWORD=mypassword"
+#Environment="MQTT_TOPIC_PREFIX=cpu-loader"
+#Environment="MQTT_CLIENT_ID=cpu-loader-001"
+
+# Optional: Disable temperature monitoring
+#Environment="DISABLE_TEMPERATURE=1"
+
+[Install]
+WantedBy=multi-user.target
+```
+
+**Important:** Replace `your-username` with your actual username, and adjust the `ExecStart` path to point to where `cpu-loader` is installed:
+- If installed with `uv tool install`: Usually `~/.local/bin/cpu-loader`
+- If installed with `pip install --user`: Usually `~/.local/bin/cpu-loader`
+- If installed system-wide: Usually `/usr/local/bin/cpu-loader`
+
+### Enable and Start the Service
+
+```bash
+# Reload systemd to recognize the new service
+sudo systemctl daemon-reload
+
+# Enable the service to start on boot
+sudo systemctl enable cpu-loader
+
+# Start the service now
+sudo systemctl start cpu-loader
+
+# Check service status
+sudo systemctl status cpu-loader
+
+# View service logs
+sudo journalctl -u cpu-loader -f
+```
+
+### Manage the Service
+
+```bash
+# Stop the service
+sudo systemctl stop cpu-loader
+
+# Restart the service
+sudo systemctl restart cpu-loader
+
+# Disable auto-start on boot
+sudo systemctl disable cpu-loader
+```
+
+### Example Service Configurations
+
+**Basic Service (no MQTT):**
+```ini
+[Unit]
+Description=CPU Loader Service
+After=network.target
+
+[Service]
+Type=simple
+User=cpuloader
+ExecStart=/home/cpuloader/.local/bin/cpu-loader --host 0.0.0.0 --port 8000
+Restart=on-failure
+
+[Install]
+WantedBy=multi-user.target
+```
+
+**Service with MQTT Integration:**
+```ini
+[Unit]
+Description=CPU Loader Service with MQTT
+After=network.target
+
+[Service]
+Type=simple
+User=cpuloader
+ExecStart=/home/cpuloader/.local/bin/cpu-loader --host 0.0.0.0 --port 8000
+Environment="MQTT_BROKER_HOST=192.168.1.100"
+Environment="MQTT_BROKER_PORT=1883"
+Environment="MQTT_USERNAME=cpuloader"
+Environment="MQTT_PASSWORD=secretpassword"
+Environment="MQTT_TOPIC_PREFIX=home/sensors/cpu-loader"
+Restart=on-failure
+
+[Install]
+WantedBy=multi-user.target
+```
+
+**Service with Custom Computation Type:**
+```ini
+[Unit]
+Description=CPU Loader Service (Matrix Computation)
+After=network.target
+
+[Service]
+Type=simple
+User=cpuloader
+ExecStart=/home/cpuloader/.local/bin/cpu-loader --host 0.0.0.0 --port 8080 --computation-type matrix
+Restart=on-failure
+
+[Install]
+WantedBy=multi-user.target
+```
+
 ## Architecture
 
 - **src/cpu_loader_core.c**: High-performance C implementation using pthreads for CPU load generation

{cpu_loader-0.5.7 → cpu_loader-0.5.9}/src/cpu_loader.egg-info/requires.txt

@@ -1,4 +1,4 @@
-fastapi==0.122.0
+fastapi==0.124.0
 uvicorn[standard]==0.38.0
 pydantic==2.12.5
 requests==2.32.5