cpu-loader 0.0.2__tar.gz

cpu_loader-0.0.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 the78mole
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cpu_loader-0.0.2/MANIFEST.in

@@ -0,0 +1,5 @@
+include README.md
+include LICENSE
+include pyproject.toml
+include setup.py
+recursive-include src *.py *.c *.h

cpu_loader-0.0.2/PKG-INFO

@@ -0,0 +1,269 @@
+Metadata-Version: 2.4
+Name: cpu-loader
+Version: 0.0.2
+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: MIT
+Project-URL: Homepage, https://github.com/the78mole/cpu-loader
+Project-URL: Repository, https://github.com/the78mole/cpu-loader
+Project-URL: Issues, https://github.com/the78mole/cpu-loader/issues
+Project-URL: Changelog, https://github.com/the78mole/cpu-loader/releases
+Keywords: cpu,load,testing,stress-test,performance,benchmark
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: C
+Classifier: Topic :: System :: Benchmark
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastapi==0.115.0
+Requires-Dist: uvicorn[standard]==0.32.0
+Requires-Dist: pydantic==2.10.0
+Requires-Dist: requests==2.32.3
+Requires-Dist: psutil>=5.9.0
+Requires-Dist: websockets>=12.0
+Dynamic: license-file
+
+# CPU Loader
+
+[![CI](https://github.com/the78mole/cpu-loader/actions/workflows/ci.yml/badge.svg)](https://github.com/the78mole/cpu-loader/actions/workflows/ci.yml)
+[![Build Wheels](https://github.com/the78mole/cpu-loader/actions/workflows/build-wheels.yml/badge.svg)](https://github.com/the78mole/cpu-loader/actions/workflows/build-wheels.yml)
+[![Python Version](https://img.shields.io/pypi/pyversions/cpu-loader)](https://pypi.org/project/cpu-loader/)
+[![License](https://img.shields.io/github/license/the78mole/cpu-loader)](https://github.com/the78mole/cpu-loader/blob/main/LICENSE)
+
+A tool to generate CPU load on a system with runtime configuration through a WebUI and REST API.
+
+## Features
+
+- 🔥 **Controllable CPU Load**: Generate precise CPU load per thread
+- 🎛️ **Per-Thread Control**: Individual sliders for each CPU thread
+- 🚀 **REST API**: Full programmatic control via HTTP endpoints
+- 🌐 **Modern WebUI**: Beautiful, responsive interface for real-time control
+- ⚡ **Instant Response**: Changes take effect immediately
+- 📊 **Live Monitoring**: View active threads and average load in real-time
+
+## Screenshots
+
+### WebUI Interface
+![CPU Loader Control - 25% Load](https://github.com/user-attachments/assets/94f5a1a1-4328-46af-9155-e7d50cc8ba0e)
+*Individual thread control with sliders and preset buttons*
+
+![CPU Loader Control - 50% Load](https://github.com/user-attachments/assets/bcab1f61-03a6-48ea-83b7-4402ec0d1389)
+*Setting all threads to 50% load*
+
+![CPU Loader Control - 100% Load](https://github.com/user-attachments/assets/542afa1c-16da-4aff-a021-1e905e6f3372)
+*Maximum load across all threads*
+
+## Installation
+
+### From Pre-built Wheels (Recommended)
+
+Pre-compiled wheels are available for Linux (x86_64, ARM64) and macOS (x86_64, ARM64):
+
+```bash
+pip install cpu-loader
+```
+
+### From Source
+
+1. Clone the repository:
+```bash
+git clone https://github.com/the78mole/cpu-loader.git
+cd cpu-loader
+```
+
+2. Install dependencies and build C extension:
+```bash
+uv pip install -e .
+```
+
+This will compile the high-performance C extension for efficient CPU load generation.
+
+3. (Optional) Set up pre-commit hooks for development:
+```bash
+pre-commit install
+```
+
+4. (Optional) Set up commit message template for semantic versioning:
+```bash
+git config commit.template .gitmessage
+```
+
+See [COMMIT_MESSAGE_FORMAT.md](COMMIT_MESSAGE_FORMAT.md) for commit message guidelines.
+
+## Usage
+
+### Starting the Server
+
+```bash
+uv run src/main.py
+```
+
+The server will start on `http://localhost:8000`
+
+### WebUI
+
+Open your browser and navigate to `http://localhost:8000`
+
+**Features:**
+- **Individual Thread Control**: Use sliders to set load for each thread (0-100%)
+- **Preset Buttons**: Quick-set all threads to 0%, 10%, 25%, 50%, 80%, 90%, or 100%
+- **Live Stats**: View active thread count and average load
+- **Real-time Updates**: Changes are applied instantly with visual feedback
+
+### REST API
+
+#### Get Thread Status
+```bash
+curl http://localhost:8000/api/threads
+```
+
+Response:
+```json
+{
+  "num_threads": 4,
+  "loads": {
+    "0": 0.0,
+    "1": 0.0,
+    "2": 0.0,
+    "3": 0.0
+  }
+}
+```
+
+#### Set Load for Specific Thread
+```bash
+curl -X PUT http://localhost:8000/api/threads/0/load \
+  -H "Content-Type: application/json" \
+  -d '{"load_percent": 50.0}'
+```
+
+#### Set Load for All Threads
+```bash
+curl -X POST http://localhost:8000/api/threads/load/all \
+  -H "Content-Type: application/json" \
+  -d '{"load_percent": 75.0}'
+```
+
+#### Change Number of Threads
+```bash
+curl -X POST http://localhost:8000/api/threads \
+  -H "Content-Type: application/json" \
+  -d '{"num_threads": 8}'
+```
+
+## API Documentation
+
+Once the server is running, visit `http://localhost:8000/docs` for interactive API documentation powered by Swagger UI.
+
+## Example Script
+
+An example script (`src/example.py`) is provided to demonstrate programmatic control:
+
+```bash
+# Start the server first
+uv run src/main.py
+
+# In another terminal, run the example
+uv run src/example.py
+```
+
+The example demonstrates:
+- Getting current status
+- Setting all threads to a specific load
+- Gradually increasing load
+- Individual thread control
+- Resetting to idle
+
+## Architecture
+
+- **src/cpu_loader_core.c**: High-performance C implementation using pthreads for CPU load generation
+- **src/cpu_loader.py**: Python wrapper providing a clean API to the C extension
+- **src/main.py**: FastAPI application with REST API and embedded WebUI
+- **Threading Model**: Native pthreads for maximum efficiency and precise timing
+- **Load Algorithm**: High-resolution busy-wait loops with nanosecond precision
+
+## Requirements
+
+- Python 3.8+
+- FastAPI 0.115.0+
+- Uvicorn 0.32.0+
+- Pydantic 2.10.0+
+- C compiler (gcc or clang) for building the extension
+
+## Use Cases
+
+- **Performance Testing**: Test application behavior under various CPU loads
+- **Stress Testing**: Validate system stability under high CPU utilization
+- **Thermal Testing**: Check cooling system effectiveness
+- **Power Consumption Analysis**: Measure power usage at different load levels
+- **Benchmarking**: Create reproducible load scenarios
+
+## Development
+
+### Pre-commit Hooks
+
+This project uses pre-commit hooks to ensure code quality. The hooks include:
+
+- **Code Formatting**: Black and isort for consistent Python formatting
+- **Linting**: Flake8 for code quality checks
+- **Type Checking**: Mypy for static type analysis
+- **General Checks**: Trailing whitespace, end-of-file fixes, YAML/JSON/TOML validation
+
+To run pre-commit manually on all files:
+```bash
+pre-commit run --all-files
+```
+
+The hooks will run automatically on `git commit` after installation.
+
+### Building and Publishing Releases
+
+The project uses **automatic semantic versioning** with GitHub Actions:
+
+#### Versioning Rules
+
+Versions are automatically determined based on commit messages:
+
+- **Patch bump** (0.0.X): Every commit to main
+- **Minor bump** (0.X.0): Commits prefixed with `feat:`
+  ```bash
+  git commit -m "feat: add new CPU monitoring feature"
+  ```
+- **Major bump** (X.0.0): Commits with `major:`, `breaking:`, or `BREAKING CHANGE:`
+  ```bash
+  git commit -m "major: redesign API interface"
+  git commit -m "breaking: remove deprecated endpoints"
+  ```
+
+#### Release Process
+
+1. **Commit and push to main**:
+   ```bash
+   git add .
+   git commit -m "feat: add WebSocket support"
+   git push origin main
+   ```
+
+2. **Automated workflow**:
+   - Version is automatically calculated using semantic versioning
+   - Wheels are built for Linux (x86_64, ARM64) and macOS (x86_64, ARM64)
+   - Python versions: 3.8, 3.9, 3.10, 3.11, 3.12
+   - Source distribution (sdist) is created
+   - All artifacts are published to PyPI
+   - A GitHub Release is created with version tag and artifacts
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.

cpu_loader-0.0.2/README.md

@@ -0,0 +1,232 @@
+# CPU Loader
+
+[![CI](https://github.com/the78mole/cpu-loader/actions/workflows/ci.yml/badge.svg)](https://github.com/the78mole/cpu-loader/actions/workflows/ci.yml)
+[![Build Wheels](https://github.com/the78mole/cpu-loader/actions/workflows/build-wheels.yml/badge.svg)](https://github.com/the78mole/cpu-loader/actions/workflows/build-wheels.yml)
+[![Python Version](https://img.shields.io/pypi/pyversions/cpu-loader)](https://pypi.org/project/cpu-loader/)
+[![License](https://img.shields.io/github/license/the78mole/cpu-loader)](https://github.com/the78mole/cpu-loader/blob/main/LICENSE)
+
+A tool to generate CPU load on a system with runtime configuration through a WebUI and REST API.
+
+## Features
+
+- 🔥 **Controllable CPU Load**: Generate precise CPU load per thread
+- 🎛️ **Per-Thread Control**: Individual sliders for each CPU thread
+- 🚀 **REST API**: Full programmatic control via HTTP endpoints
+- 🌐 **Modern WebUI**: Beautiful, responsive interface for real-time control
+- ⚡ **Instant Response**: Changes take effect immediately
+- 📊 **Live Monitoring**: View active threads and average load in real-time
+
+## Screenshots
+
+### WebUI Interface
+![CPU Loader Control - 25% Load](https://github.com/user-attachments/assets/94f5a1a1-4328-46af-9155-e7d50cc8ba0e)
+*Individual thread control with sliders and preset buttons*
+
+![CPU Loader Control - 50% Load](https://github.com/user-attachments/assets/bcab1f61-03a6-48ea-83b7-4402ec0d1389)
+*Setting all threads to 50% load*
+
+![CPU Loader Control - 100% Load](https://github.com/user-attachments/assets/542afa1c-16da-4aff-a021-1e905e6f3372)
+*Maximum load across all threads*
+
+## Installation
+
+### From Pre-built Wheels (Recommended)
+
+Pre-compiled wheels are available for Linux (x86_64, ARM64) and macOS (x86_64, ARM64):
+
+```bash
+pip install cpu-loader
+```
+
+### From Source
+
+1. Clone the repository:
+```bash
+git clone https://github.com/the78mole/cpu-loader.git
+cd cpu-loader
+```
+
+2. Install dependencies and build C extension:
+```bash
+uv pip install -e .
+```
+
+This will compile the high-performance C extension for efficient CPU load generation.
+
+3. (Optional) Set up pre-commit hooks for development:
+```bash
+pre-commit install
+```
+
+4. (Optional) Set up commit message template for semantic versioning:
+```bash
+git config commit.template .gitmessage
+```
+
+See [COMMIT_MESSAGE_FORMAT.md](COMMIT_MESSAGE_FORMAT.md) for commit message guidelines.
+
+## Usage
+
+### Starting the Server
+
+```bash
+uv run src/main.py
+```
+
+The server will start on `http://localhost:8000`
+
+### WebUI
+
+Open your browser and navigate to `http://localhost:8000`
+
+**Features:**
+- **Individual Thread Control**: Use sliders to set load for each thread (0-100%)
+- **Preset Buttons**: Quick-set all threads to 0%, 10%, 25%, 50%, 80%, 90%, or 100%
+- **Live Stats**: View active thread count and average load
+- **Real-time Updates**: Changes are applied instantly with visual feedback
+
+### REST API
+
+#### Get Thread Status
+```bash
+curl http://localhost:8000/api/threads
+```
+
+Response:
+```json
+{
+  "num_threads": 4,
+  "loads": {
+    "0": 0.0,
+    "1": 0.0,
+    "2": 0.0,
+    "3": 0.0
+  }
+}
+```
+
+#### Set Load for Specific Thread
+```bash
+curl -X PUT http://localhost:8000/api/threads/0/load \
+  -H "Content-Type: application/json" \
+  -d '{"load_percent": 50.0}'
+```
+
+#### Set Load for All Threads
+```bash
+curl -X POST http://localhost:8000/api/threads/load/all \
+  -H "Content-Type: application/json" \
+  -d '{"load_percent": 75.0}'
+```
+
+#### Change Number of Threads
+```bash
+curl -X POST http://localhost:8000/api/threads \
+  -H "Content-Type: application/json" \
+  -d '{"num_threads": 8}'
+```
+
+## API Documentation
+
+Once the server is running, visit `http://localhost:8000/docs` for interactive API documentation powered by Swagger UI.
+
+## Example Script
+
+An example script (`src/example.py`) is provided to demonstrate programmatic control:
+
+```bash
+# Start the server first
+uv run src/main.py
+
+# In another terminal, run the example
+uv run src/example.py
+```
+
+The example demonstrates:
+- Getting current status
+- Setting all threads to a specific load
+- Gradually increasing load
+- Individual thread control
+- Resetting to idle
+
+## Architecture
+
+- **src/cpu_loader_core.c**: High-performance C implementation using pthreads for CPU load generation
+- **src/cpu_loader.py**: Python wrapper providing a clean API to the C extension
+- **src/main.py**: FastAPI application with REST API and embedded WebUI
+- **Threading Model**: Native pthreads for maximum efficiency and precise timing
+- **Load Algorithm**: High-resolution busy-wait loops with nanosecond precision
+
+## Requirements
+
+- Python 3.8+
+- FastAPI 0.115.0+
+- Uvicorn 0.32.0+
+- Pydantic 2.10.0+
+- C compiler (gcc or clang) for building the extension
+
+## Use Cases
+
+- **Performance Testing**: Test application behavior under various CPU loads
+- **Stress Testing**: Validate system stability under high CPU utilization
+- **Thermal Testing**: Check cooling system effectiveness
+- **Power Consumption Analysis**: Measure power usage at different load levels
+- **Benchmarking**: Create reproducible load scenarios
+
+## Development
+
+### Pre-commit Hooks
+
+This project uses pre-commit hooks to ensure code quality. The hooks include:
+
+- **Code Formatting**: Black and isort for consistent Python formatting
+- **Linting**: Flake8 for code quality checks
+- **Type Checking**: Mypy for static type analysis
+- **General Checks**: Trailing whitespace, end-of-file fixes, YAML/JSON/TOML validation
+
+To run pre-commit manually on all files:
+```bash
+pre-commit run --all-files
+```
+
+The hooks will run automatically on `git commit` after installation.
+
+### Building and Publishing Releases
+
+The project uses **automatic semantic versioning** with GitHub Actions:
+
+#### Versioning Rules
+
+Versions are automatically determined based on commit messages:
+
+- **Patch bump** (0.0.X): Every commit to main
+- **Minor bump** (0.X.0): Commits prefixed with `feat:`
+  ```bash
+  git commit -m "feat: add new CPU monitoring feature"
+  ```
+- **Major bump** (X.0.0): Commits with `major:`, `breaking:`, or `BREAKING CHANGE:`
+  ```bash
+  git commit -m "major: redesign API interface"
+  git commit -m "breaking: remove deprecated endpoints"
+  ```
+
+#### Release Process
+
+1. **Commit and push to main**:
+   ```bash
+   git add .
+   git commit -m "feat: add WebSocket support"
+   git push origin main
+   ```
+
+2. **Automated workflow**:
+   - Version is automatically calculated using semantic versioning
+   - Wheels are built for Linux (x86_64, ARM64) and macOS (x86_64, ARM64)
+   - Python versions: 3.8, 3.9, 3.10, 3.11, 3.12
+   - Source distribution (sdist) is created
+   - All artifacts are published to PyPI
+   - A GitHub Release is created with version tag and artifacts
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.

cpu_loader-0.0.2/pyproject.toml

@@ -0,0 +1,53 @@
+[project]
+name = "cpu-loader"
+version = "0.0.2"
+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.8"
+license = {text = "MIT"}
+authors = [
+    {name = "the78mole", email = "the78mole@users.noreply.github.com"}
+]
+keywords = ["cpu", "load", "testing", "stress-test", "performance", "benchmark"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: System Administrators",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: MacOS",
+    "Programming Language :: Python :: 3",
+    "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 :: C",
+    "Topic :: System :: Benchmark",
+    "Topic :: System :: Monitoring",
+]
+dependencies = [
+    "fastapi==0.115.0",
+    "uvicorn[standard]==0.32.0",
+    "pydantic==2.10.0",
+    "requests==2.32.3",
+    "psutil>=5.9.0",
+    "websockets>=12.0",
+]
+
+[project.scripts]
+cpu-loader = "main:run"
+
+[project.urls]
+Homepage = "https://github.com/the78mole/cpu-loader"
+Repository = "https://github.com/the78mole/cpu-loader"
+Issues = "https://github.com/the78mole/cpu-loader/issues"
+Changelog = "https://github.com/the78mole/cpu-loader/releases"
+
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+py-modules = ["cpu_loader", "main", "example"]

cpu_loader-0.0.2/setup.cfg

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

cpu_loader-0.0.2/setup.py

@@ -0,0 +1,20 @@
+from setuptools import setup, Extension
+import platform
+
+extra_compile_args = []
+extra_link_args = []
+
+if platform.system() != 'Windows':
+    extra_compile_args = ['-pthread', '-O3']
+    extra_link_args = ['-pthread']
+
+module = Extension(
+    'cpu_loader_core',
+    sources=['src/cpu_loader_core.c'],
+    extra_compile_args=extra_compile_args,
+    extra_link_args=extra_link_args,
+)
+
+setup(
+    ext_modules=[module],
+)