caste 0.1.1__cp314-cp314-musllinux_1_2_x86_64.whl

caste/__init__.py

@@ -0,0 +1,15 @@
+"""
+Opinionated hardware classification library.
+
+Caste inspects a user's machine and assigns it to a practical hardware category
+(Mini, User, Developer, Workstation, or Rig) to help set sensible application defaults.
+"""
+
+from ._caste import __version__, detect_caste, detect_caste_word, detect_hw_facts
+
+__all__ = [
+    "__version__",
+    "detect_caste",
+    "detect_caste_word",
+    "detect_hw_facts",
+]

caste-0.1.1.dist-info/METADATA

@@ -0,0 +1,74 @@
+Metadata-Version: 2.4
+Name: caste
+Version: 0.1.1
+Summary: Opinionated hardware classification library.
+Keywords: hardware,classification,system-info,gpu,cpu
+Author-Email: Zeth <holdercardteam+caste@gmail.com>
+License-Expression: MIT
+Project-URL: Repository, https://github.com/zeth/caste
+Project-URL: Issues, https://github.com/zeth/caste/issues
+Requires-Python: >=3.8
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Description-Content-Type: text/markdown
+
+# caste - T-Shirt sizes for hardware
+
+Opinionated hardware classification library for Python.
+
+`caste` is a deliberately simple library that inspects a user’s machine and assigns it to a small, practical "hardware caste" (like Mini, User, or Developer). This helps you set sensible defaults for your application based on the user's hardware without manually parsing RAM, CPU, and GPU stats.
+
+## Installation
+
+```bash
+pip install caste
+```
+
+## Quick Start
+
+```python
+import caste
+
+# Get a simple one-word label for the machine
+print(caste.detect_caste_word())  # e.g., "User"
+
+# Get the label and the reason for the classification
+label, reason = caste.detect_caste()
+print(f"Caste: {label} (Reason: {reason})")
+
+# Get raw hardware facts if you want to perform your own logic
+facts = caste.detect_hw_facts()
+print(f"RAM: {facts['ram_bytes'] / 1024**3:.1f} GB")
+print(f"Discrete GPU: {facts['has_discrete_gpu']}")
+```
+
+## Hardware Castes
+
+- **Mini** — Microcomputers, embedded systems, classic/legacy PCs.
+- **User** — Standard consumer-level machines.
+- **Developer** — High-end personal computers.
+- **Workstation** — Professional content-creation or high-end gaming machines.
+- **Rig** — Dedicated servers or specialised compute systems.
+
+## API Reference
+
+`detect_hw_facts()` returns a dictionary with:
+
+- `ram_bytes` (int)
+- `physical_cores` (int)
+- `logical_threads` (int)
+- `gpu_kind` (0=None, 1=Integrated, 2=Unified, 3=Discrete)
+- `vram_bytes` (int)
+- `has_discrete_gpu` (bool)
+- `is_apple_silicon` (bool)
+- `is_intel_arc` (bool)
+
+## Why use caste?
+
+Modern applications often launch with no idea of the underlying hardware capability. If defaults are tuned only for a developer’s machine, it can lead to sluggish experiences on low-end hardware or not showing off your apps's best capabilities on high-end systems. `caste` provides a standardized way to bridge this gap.
+
+There is also a C++ library and an executable for shell scripts and build systems. See the Github repo for details.
+
+## License
+
+MIT

caste-0.1.1.dist-info/RECORD

@@ -0,0 +1,16 @@
+caste/__init__.py,sha256=MJlHCvtpkMulHvGIqMeEkJgrOXMflPvZzDem-AONXc4,407
+caste/_caste.cpython-314-x86_64-linux-musl.so,sha256=rZkZ4fjmtyQl0o7mzJWvn4pDDZJFkY_sXvELzHT9Gz0,191913
+caste.libs/libgcc_s-0cd532bd.so.1,sha256=yPk0-VjyKzucjnkP3mvC0vVaua6Ln17qZUJbICcXgtA,181737
+caste.libs/libstdc++-5d72f927.so.6.0.33,sha256=fogxHsmB1_D6C-a_-uHh8Ei_6Qh52a8vLlicJRM3ehk,3562401
+include/caste/caste.hpp,sha256=3SWO24J59dRG9LtHh6YgvI4dxT9Tvjd0iP8CKVoJE-E,1304
+lib/libcaste.a,sha256=FbLVHyfiw6bskHmprW3QRQYBJ6uh3yCNy1UiEoO2IKs,56516
+lib/cmake/caste/casteConfig.cmake,sha256=MQiqwhWln2NUUXYSsuqkWIKqGo3JG9YaSEMUfXeNRFc,935
+lib/cmake/caste/casteConfigVersion.cmake,sha256=REDN-rfH5OT__PDYHWmPzYApDE8qjTLE-CQpk7CvlR0,2762
+lib/cmake/caste/casteTargets-release.cmake,sha256=azYExIX60eoPQgJMl-jRHxYePK5kucetIOrQU4EypPs,831
+lib/cmake/caste/casteTargets.cmake,sha256=cAshrk68d0y6rXuzWbfYMqO2z7NeV1itor8VmA6oW0U,4187
+share/doc/caste/LICENSE,sha256=nKZjaL__KpJTeJioBnR2Np2AAxZkH8R1DTXjhFRJ1IA,1061
+share/man/man1/caste.1,sha256=tijtiabbdGwW5nVGm6vIC5wsHVT5l8q7oDY5IlNiOVE,690
+caste-0.1.1.dist-info/METADATA,sha256=E-hForFUoAKWWaVn0wXsBSw595c63_QylMhr7RpqviM,2496
+caste-0.1.1.dist-info/WHEEL,sha256=pEBxBeO8W2ULYAGwFktgcoZsiuSJ4czyKsyQXQJ2Itg,117
+caste-0.1.1.dist-info/RECORD,,
+caste-0.1.1.dist-info/sboms/auditwheel.cdx.json,sha256=kxVcqSjUjYk41Ou0yOiQ4BEHoXSXdjtYp48UlcsaHhs,1654

caste-0.1.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: scikit-build-core 0.11.6
+Root-Is-Purelib: false
+Tag: cp314-cp314-musllinux_1_2_x86_64
+

caste-0.1.1.dist-info/sboms/auditwheel.cdx.json

@@ -0,0 +1 @@
+{"bomFormat": "CycloneDX", "specVersion": "1.4", "version": 1, "metadata": {"component": {"type": "library", "bom-ref": "pkg:pypi/caste@0.1.1?file_name=caste-0.1.1-cp314-cp314-musllinux_1_2_x86_64.whl", "name": "caste", "version": "0.1.1", "purl": "pkg:pypi/caste@0.1.1?file_name=caste-0.1.1-cp314-cp314-musllinux_1_2_x86_64.whl"}, "tools": [{"name": "auditwheel", "version": "6.6.0"}]}, "components": [{"type": "library", "bom-ref": "pkg:pypi/caste@0.1.1?file_name=caste-0.1.1-cp314-cp314-musllinux_1_2_x86_64.whl", "name": "caste", "version": "0.1.1", "purl": "pkg:pypi/caste@0.1.1?file_name=caste-0.1.1-cp314-cp314-musllinux_1_2_x86_64.whl"}, {"type": "library", "bom-ref": "pkg:apk/alpine/libstdc%2B%2B@14.2.0-r6#76f023cbc3d7b369d6008f354e88aa983d13e4bd8f06e4e49a01686039fe1509", "name": "libstdc++", "version": "14.2.0-r6", "purl": "pkg:apk/alpine/libstdc%2B%2B@14.2.0-r6"}, {"type": "library", "bom-ref": "pkg:apk/alpine/libgcc@14.2.0-r6#933a623c9e323e83b1734e630a342f206999adc096732a3fea9896fa0181ea29", "name": "libgcc", "version": "14.2.0-r6", "purl": "pkg:apk/alpine/libgcc@14.2.0-r6"}], "dependencies": [{"ref": "pkg:pypi/caste@0.1.1?file_name=caste-0.1.1-cp314-cp314-musllinux_1_2_x86_64.whl", "dependsOn": ["pkg:apk/alpine/libstdc%2B%2B@14.2.0-r6#76f023cbc3d7b369d6008f354e88aa983d13e4bd8f06e4e49a01686039fe1509", "pkg:apk/alpine/libgcc@14.2.0-r6#933a623c9e323e83b1734e630a342f206999adc096732a3fea9896fa0181ea29"]}, {"ref": "pkg:apk/alpine/libstdc%2B%2B@14.2.0-r6#76f023cbc3d7b369d6008f354e88aa983d13e4bd8f06e4e49a01686039fe1509"}, {"ref": "pkg:apk/alpine/libgcc@14.2.0-r6#933a623c9e323e83b1734e630a342f206999adc096732a3fea9896fa0181ea29"}]}

include/caste/caste.hpp

@@ -0,0 +1,48 @@
+#pragma once
+
+#include <cstdint>
+#include <string>
+
+enum class Caste {
+    Mini,
+    User,
+    Developer,
+    Workstation,
+    Rig
+};
+
+enum class GpuKind {
+    None,
+    Integrated,   // Intel UHD/Iris Xe, AMD iGPU, etc. (shared memory)
+    Unified,      // Apple Silicon style unified memory (shared, but fast)
+    Discrete      // NVIDIA/AMD dGPU with dedicated VRAM
+};
+
+struct HwFacts {
+    // Memory
+    uint64_t ram_bytes = 0;
+
+    // CPU (use whatever you can get; physical if known, else set to 0)
+    int physical_cores = 0;
+    int logical_threads = 0;
+
+    // GPU summary (your detection layer fills this)
+    GpuKind gpu_kind = GpuKind::None;
+    uint64_t vram_bytes = 0;          // only meaningful if gpu_kind == Discrete
+    bool has_discrete_gpu = false;    // convenience (often same as gpu_kind==Discrete)
+    bool is_apple_silicon = false;    // macOS arm64
+    bool is_intel_arc = false;        // Arc dGPU OR Arc-class iGPU (your detection decides)
+};
+
+struct CasteResult {
+    Caste caste = Caste::Mini;
+    std::string reason; // for logs/UI
+};
+
+CasteResult classify_caste(const HwFacts& hw);
+const char* caste_name(Caste t);
+
+// Simple public API: call this and get a single word bucket name.
+HwFacts detect_hw_facts();
+CasteResult detect_caste();
+std::string detect_caste_word();

lib/cmake/caste/casteConfig.cmake

@@ -0,0 +1,27 @@
+
+####### Expanded from @PACKAGE_INIT@ by configure_package_config_file() #######
+####### Any changes to this file will be overwritten by the next CMake run ####
+####### The input file was casteConfig.cmake.in                            ########
+
+get_filename_component(PACKAGE_PREFIX_DIR "${CMAKE_CURRENT_LIST_DIR}/../../../" ABSOLUTE)
+
+macro(set_and_check _var _file)
+  set(${_var} "${_file}")
+  if(NOT EXISTS "${_file}")
+    message(FATAL_ERROR "File or directory ${_file} referenced by variable ${_var} does not exist !")
+  endif()
+endmacro()
+
+macro(check_required_components _NAME)
+  foreach(comp ${${_NAME}_FIND_COMPONENTS})
+    if(NOT ${_NAME}_${comp}_FOUND)
+      if(${_NAME}_FIND_REQUIRED_${comp})
+        set(${_NAME}_FOUND FALSE)
+      endif()
+    endif()
+  endforeach()
+endmacro()
+
+####################################################################################
+
+include("${CMAKE_CURRENT_LIST_DIR}/casteTargets.cmake")

lib/cmake/caste/casteConfigVersion.cmake

@@ -0,0 +1,65 @@
+# This is a basic version file for the Config-mode of find_package().
+# It is used by write_basic_package_version_file() as input file for configure_file()
+# to create a version-file which can be installed along a config.cmake file.
+#
+# The created file sets PACKAGE_VERSION_EXACT if the current version string and
+# the requested version string are exactly the same and it sets
+# PACKAGE_VERSION_COMPATIBLE if the current version is >= requested version,
+# but only if the requested major version is the same as the current one.
+# The variable CVF_VERSION must be set before calling configure_file().
+
+
+set(PACKAGE_VERSION "0.1.0")
+
+if(PACKAGE_VERSION VERSION_LESS PACKAGE_FIND_VERSION)
+  set(PACKAGE_VERSION_COMPATIBLE FALSE)
+else()
+
+  if("0.1.0" MATCHES "^([0-9]+)\\.")
+    set(CVF_VERSION_MAJOR "${CMAKE_MATCH_1}")
+    if(NOT CVF_VERSION_MAJOR VERSION_EQUAL 0)
+      string(REGEX REPLACE "^0+" "" CVF_VERSION_MAJOR "${CVF_VERSION_MAJOR}")
+    endif()
+  else()
+    set(CVF_VERSION_MAJOR "0.1.0")
+  endif()
+
+  if(PACKAGE_FIND_VERSION_RANGE)
+    # both endpoints of the range must have the expected major version
+    math (EXPR CVF_VERSION_MAJOR_NEXT "${CVF_VERSION_MAJOR} + 1")
+    if (NOT PACKAGE_FIND_VERSION_MIN_MAJOR STREQUAL CVF_VERSION_MAJOR
+        OR ((PACKAGE_FIND_VERSION_RANGE_MAX STREQUAL "INCLUDE" AND NOT PACKAGE_FIND_VERSION_MAX_MAJOR STREQUAL CVF_VERSION_MAJOR)
+          OR (PACKAGE_FIND_VERSION_RANGE_MAX STREQUAL "EXCLUDE" AND NOT PACKAGE_FIND_VERSION_MAX VERSION_LESS_EQUAL CVF_VERSION_MAJOR_NEXT)))
+      set(PACKAGE_VERSION_COMPATIBLE FALSE)
+    elseif(PACKAGE_FIND_VERSION_MIN_MAJOR STREQUAL CVF_VERSION_MAJOR
+        AND ((PACKAGE_FIND_VERSION_RANGE_MAX STREQUAL "INCLUDE" AND PACKAGE_VERSION VERSION_LESS_EQUAL PACKAGE_FIND_VERSION_MAX)
+        OR (PACKAGE_FIND_VERSION_RANGE_MAX STREQUAL "EXCLUDE" AND PACKAGE_VERSION VERSION_LESS PACKAGE_FIND_VERSION_MAX)))
+      set(PACKAGE_VERSION_COMPATIBLE TRUE)
+    else()
+      set(PACKAGE_VERSION_COMPATIBLE FALSE)
+    endif()
+  else()
+    if(PACKAGE_FIND_VERSION_MAJOR STREQUAL CVF_VERSION_MAJOR)
+      set(PACKAGE_VERSION_COMPATIBLE TRUE)
+    else()
+      set(PACKAGE_VERSION_COMPATIBLE FALSE)
+    endif()
+
+    if(PACKAGE_FIND_VERSION STREQUAL PACKAGE_VERSION)
+      set(PACKAGE_VERSION_EXACT TRUE)
+    endif()
+  endif()
+endif()
+
+
+# if the installed or the using project don't have CMAKE_SIZEOF_VOID_P set, ignore it:
+if("${CMAKE_SIZEOF_VOID_P}" STREQUAL "" OR "8" STREQUAL "")
+  return()
+endif()
+
+# check that the installed version has the same 32/64bit-ness as the one which is currently searching:
+if(NOT CMAKE_SIZEOF_VOID_P STREQUAL "8")
+  math(EXPR installedBits "8 * 8")
+  set(PACKAGE_VERSION "${PACKAGE_VERSION} (${installedBits}bit)")
+  set(PACKAGE_VERSION_UNSUITABLE TRUE)
+endif()

lib/cmake/caste/casteTargets-release.cmake

@@ -0,0 +1,19 @@
+#----------------------------------------------------------------
+# Generated CMake target import file for configuration "Release".
+#----------------------------------------------------------------
+
+# Commands may need to know the format version.
+set(CMAKE_IMPORT_FILE_VERSION 1)
+
+# Import target "caste::caste" for configuration "Release"
+set_property(TARGET caste::caste APPEND PROPERTY IMPORTED_CONFIGURATIONS RELEASE)
+set_target_properties(caste::caste PROPERTIES
+  IMPORTED_LINK_INTERFACE_LANGUAGES_RELEASE "CXX"
+  IMPORTED_LOCATION_RELEASE "${_IMPORT_PREFIX}/lib/libcaste.a"
+  )
+
+list(APPEND _cmake_import_check_targets caste::caste )
+list(APPEND _cmake_import_check_files_for_caste::caste "${_IMPORT_PREFIX}/lib/libcaste.a" )
+
+# Commands beyond this point should not need to know the version.
+set(CMAKE_IMPORT_FILE_VERSION)

lib/cmake/caste/casteTargets.cmake

@@ -0,0 +1,108 @@
+# Generated by CMake
+
+if("${CMAKE_MAJOR_VERSION}.${CMAKE_MINOR_VERSION}" LESS 2.8)
+   message(FATAL_ERROR "CMake >= 2.8.3 required")
+endif()
+if(CMAKE_VERSION VERSION_LESS "2.8.3")
+   message(FATAL_ERROR "CMake >= 2.8.3 required")
+endif()
+cmake_policy(PUSH)
+cmake_policy(VERSION 2.8.3...4.0)
+#----------------------------------------------------------------
+# Generated CMake target import file.
+#----------------------------------------------------------------
+
+# Commands may need to know the format version.
+set(CMAKE_IMPORT_FILE_VERSION 1)
+
+# Protect against multiple inclusion, which would fail when already imported targets are added once more.
+set(_cmake_targets_defined "")
+set(_cmake_targets_not_defined "")
+set(_cmake_expected_targets "")
+foreach(_cmake_expected_target IN ITEMS caste::caste)
+  list(APPEND _cmake_expected_targets "${_cmake_expected_target}")
+  if(TARGET "${_cmake_expected_target}")
+    list(APPEND _cmake_targets_defined "${_cmake_expected_target}")
+  else()
+    list(APPEND _cmake_targets_not_defined "${_cmake_expected_target}")
+  endif()
+endforeach()
+unset(_cmake_expected_target)
+if(_cmake_targets_defined STREQUAL _cmake_expected_targets)
+  unset(_cmake_targets_defined)
+  unset(_cmake_targets_not_defined)
+  unset(_cmake_expected_targets)
+  unset(CMAKE_IMPORT_FILE_VERSION)
+  cmake_policy(POP)
+  return()
+endif()
+if(NOT _cmake_targets_defined STREQUAL "")
+  string(REPLACE ";" ", " _cmake_targets_defined_text "${_cmake_targets_defined}")
+  string(REPLACE ";" ", " _cmake_targets_not_defined_text "${_cmake_targets_not_defined}")
+  message(FATAL_ERROR "Some (but not all) targets in this export set were already defined.\nTargets Defined: ${_cmake_targets_defined_text}\nTargets not yet defined: ${_cmake_targets_not_defined_text}\n")
+endif()
+unset(_cmake_targets_defined)
+unset(_cmake_targets_not_defined)
+unset(_cmake_expected_targets)
+
+
+# Compute the installation prefix relative to this file.
+get_filename_component(_IMPORT_PREFIX "${CMAKE_CURRENT_LIST_FILE}" PATH)
+get_filename_component(_IMPORT_PREFIX "${_IMPORT_PREFIX}" PATH)
+get_filename_component(_IMPORT_PREFIX "${_IMPORT_PREFIX}" PATH)
+get_filename_component(_IMPORT_PREFIX "${_IMPORT_PREFIX}" PATH)
+if(_IMPORT_PREFIX STREQUAL "/")
+  set(_IMPORT_PREFIX "")
+endif()
+
+# Create imported target caste::caste
+add_library(caste::caste STATIC IMPORTED)
+
+set_target_properties(caste::caste PROPERTIES
+  INTERFACE_COMPILE_DEFINITIONS "CASTE_VERSION=\"0.1.0\""
+  INTERFACE_COMPILE_FEATURES "cxx_std_20"
+  INTERFACE_INCLUDE_DIRECTORIES "/caste"
+)
+
+# Load information for each installed configuration.
+file(GLOB _cmake_config_files "${CMAKE_CURRENT_LIST_DIR}/casteTargets-*.cmake")
+foreach(_cmake_config_file IN LISTS _cmake_config_files)
+  include("${_cmake_config_file}")
+endforeach()
+unset(_cmake_config_file)
+unset(_cmake_config_files)
+
+# Cleanup temporary variables.
+set(_IMPORT_PREFIX)
+
+# Loop over all imported files and verify that they actually exist
+foreach(_cmake_target IN LISTS _cmake_import_check_targets)
+  if(CMAKE_VERSION VERSION_LESS "3.28"
+      OR NOT DEFINED _cmake_import_check_xcframework_for_${_cmake_target}
+      OR NOT IS_DIRECTORY "${_cmake_import_check_xcframework_for_${_cmake_target}}")
+    foreach(_cmake_file IN LISTS "_cmake_import_check_files_for_${_cmake_target}")
+      if(NOT EXISTS "${_cmake_file}")
+        message(FATAL_ERROR "The imported target \"${_cmake_target}\" references the file
+   \"${_cmake_file}\"
+but this file does not exist.  Possible reasons include:
+* The file was deleted, renamed, or moved to another location.
+* An install or uninstall procedure did not complete successfully.
+* The installation package was faulty and contained
+   \"${CMAKE_CURRENT_LIST_FILE}\"
+but not all the files it references.
+")
+      endif()
+    endforeach()
+  endif()
+  unset(_cmake_file)
+  unset("_cmake_import_check_files_for_${_cmake_target}")
+endforeach()
+unset(_cmake_target)
+unset(_cmake_import_check_targets)
+
+# This file does not depend on other imported targets which have
+# been exported from the same project but in a separate export set.
+
+# Commands beyond this point should not need to know the version.
+set(CMAKE_IMPORT_FILE_VERSION)
+cmake_policy(POP)

share/doc/caste/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zeth
+
+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.

share/man/man1/caste.1

@@ -0,0 +1,36 @@
+.TH CASTE 1 "February 1, 2026" "caste 0.1.0" "User Commands"
+.SH NAME
+caste \- print a single-word hardware class
+.SH SYNOPSIS
+.B caste
+[\fB\-\-reason\fR]
+[\fB\-\-version\fR]
+[\fB\-h\fR|\fB\-\-help\fR]
+.SH DESCRIPTION
+The
+.B caste
+command prints a single-word hardware class inferred from the system:
+Mini, User, Developer, Workstation, or Rig.
+.SH OPTIONS
+.TP
+.B \-\-reason
+Include a short explanation after the class.
+.TP
+.B \-\-version
+Print the version and exit.
+.TP
+.B \-h, \-\-help
+Show a brief usage message.
+.SH EXAMPLES
+.TP
+.B caste
+Print the class only.
+.TP
+.B caste \-\-reason
+Print the class and a short explanation.
+.SH EXIT STATUS
+.TP
+.B 0
+Success.
+.SH SEE ALSO
+.BR uname (1)